Gå til innholdet

Integrasjon uten kilde-API: planlegg en CSV-overføring

En eksportfil kan hjelpe når nødvendig kilde-API mangler. Et eksempel angir format, prosjektkobling, gjentakelse og tilbakemelding.

Tobias Krüger2 min lesetid
Datakort med pakke-, steds- og kalendersymbol; midtfeltet er tomt med oransje ramme.

Velg en tilgjengelig overføring

Undersøk først om de nødvendige dataene er tilgjengelige gjennom en støttet eksport. Middleware, programvare mellom systemene, behandler slike inndata; den skaper ikke en tilgang som kildesystemet ikke tilbyr.

Tilgjengelige inndata

Mulighet i målet

Mulig overføring

Strukturert eksportfil

Egnet filimport

Lag en kontrollert importfil

Strukturert eksportfil

Egnet API

Kontroller og koble data, og overfør via API-et

Bare brukergrensesnitt

Egnet inndataskjerm

Test skjermforløpet separat

Det siste alternativet krever pålitelig gjenkjenning av elementene som betjenes og av resultatet. Microsoft beskriver UI-selektorer til dette formålet. Etter endringer i grensesnittet må egnetheten vurderes på nytt; et innspilt klikkforløp alene beviser ikke at dataene er tatt imot.

Dokumenter en utfylt filkontrakt

Et fiktivt programvareselskap velger det andre alternativet. Det gamle tidsregistreringssystemet har ikke noe API for godkjente tider, men tilbyr en daglig eksport. En mellomliggende behandling skal bruke dataene til å legge en linje til et faktureringsutkast i ERP-systemet. For dette egne eksempelet avtales UTF-8, komma som skilletegn og denne overskriften:

entryId,projectRef,approvedMinutes,approvalState
T-81,PR-42,90,approved

Linjen betyr at den stabile kildeposten T-81 inneholder godkjent arbeidstid i minutter for prosjekt PR-42. Dette er eksplisitt koblet til ERP-prosjekt ERP-903. Bare godkjente linjer får gå videre. Feltene og identifikatorene er våre egne utforminger, ikke et Odoo-skjema eller en annen leverandørs struktur. RFC 4180 beskriver CSV-konvensjoner; den konkrete importkontrakten må passe til produktet. Odoo-dokumentasjonen viser for eksempel bruk av eksterne identifikatorer ved import og relasjoner.

Skill bekreftede resultater fra uklare

Ved bekreftet overføring skal den mellomliggende behandlingen koble kildeposten til målreferansen. En uendret linje som allerede er bekreftet mottatt, skal ikke opprette enda en utkastlinje. Endres samme kildepost senere, er det en forretningsmessig rettelse; den valgte løsningen holder den igjen til avklaring.

Brytes forbindelsen etter sending, kan målet allerede ha skrevet dataene. Før et nytt forsøk må tilstanden avklares gjennom en egnet målreferanse. Hvis målet ikke støtter kontrollen, forblir handlingen uklar og må følges opp. Vellykket filtransport alene bekrefter ingen ERP-post.

Avtal forventede resultater før implementeringen

Disse tilfellene må godkjennes i et egnet testmiljø:

  • Den første godkjente linjen oppretter en utkastlinje med 90 minutter i det koblede prosjektet.

  • En identisk gjentakelse etter bekreftet suksess oppretter ingen ekstra linje.

  • En ukjent prosjektreferanse forblir åpen med en grunn til avklaring.

  • Samme post med 120 minutter holdes igjen som rettelse i stedet for å overskrive den bekreftede verdien i det stille.

I eksempelet godtar teamet daglig behandling klokken 18:00 i tidssonen Europe/Berlin for senere faktureringsutkast. Trengs aktuelle verdier i løpet av arbeidsdagen, må overføringen vurderes på nytt. Ansvar for eksport, feilhåndtering og tilbakemelding hører derfor til avtalen.

Kilder

Skrevet av

  • Tobias KrügerRedaktør for systemintegrasjonTobias Krüger jobber hos ASES med samspillet mellom ulike programvaresystemer. I artiklene sine forklarer han hvordan ERP, CRM og nettbutikker kobles sammen, og hvordan man håndterer feil i datautvekslingen.

Følg ASES

Les videre

Alle artikler

API-er og integrasjon med ASES

ERP, CRM og nettbutikk ryddig koblet sammen