Gå til indholdet

Integration uden kilde-API: planlæg en CSV-overførsel

En eksportfil kan hjælpe, når den nødvendige kilde-API mangler. Et eksempel fastlægger format, projektkobling, gentagelse og tilbagemelding.

Tobias Krüger2 min. læsetid
Datakort med pakke-, sted- og kalendersymbol; midterste felt er tomt med orange kant.

Vælg en tilgængelig overførsel

Undersøg først, om de nødvendige data kan hentes gennem en understøttet eksport. Middleware, software mellem systemerne, behandler disse input; den skaber ikke en adgang, som kildesystemet ikke tilbyder.

Tilgængeligt input

Mulighed i målet

Mulig overførsel

Struktureret eksportfil

Egnet filimport

Dan en kontrolleret importfil

Struktureret eksportfil

Egnet API

Kontroller og tilknyt data, og overfør via API’en

Kun brugergrænseflade

Egnet indtastningsskærm

Afprøv skærmforløbet særskilt

Den sidste mulighed kræver pålidelig genkendelse af de betjente elementer og resultatet. Microsoft beskriver UI-selektorer til dette formål. Efter ændringer i grænsefladen skal deres egnethed undersøges igen; et optaget klikforløb beviser ikke alene, at data er overtaget.

Fastlæg en gennemarbejdet filkontrakt

Et fiktivt softwarefirma vælger den anden mulighed. Dets gamle tidsregistrering har ingen API til godkendte tider, men tilbyder en daglig eksport. En mellemliggende behandling skal bruge dataene til at tilføje en linje til et faktureringsudkast i ERP-systemet. Til dette eget eksempel aftales UTF-8, komma som separator og denne overskrift:

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

Linjen betyder, at den stabile kildepost T-81 indeholder godkendt arbejdstid i minutter for projekt PR-42. Dette er udtrykkeligt knyttet til ERP-projekt ERP-903. Kun godkendte linjer må gå videre. Felter og identifikatorer er vores egne design, ikke et Odoo-skema eller en anden leverandørs struktur. RFC 4180 beskriver CSV-konventioner; den konkrete importkontrakt skal passe til produktet. Odoo-dokumentationen viser eksempelvis brugen af eksterne identifikatorer ved import og relationer.

Adskil bekræftede og uklare resultater

Ved en bekræftet overtagelse skal den mellemliggende behandling forbinde kildeposten med målreferencen. En uændret linje, hvis overtagelse allerede er bekræftet, må ikke oprette endnu en kladdelinje. Ændres samme kildepost senere, er det en forretningsmæssig rettelse; det valgte design sætter den i bero til afklaring.

Afbrydes forbindelsen efter afsendelse, kan målet allerede have skrevet dataene. Før et nyt forsøg skal tilstanden afklares gennem en egnet målreference. Muliggør målet ikke den kontrol, forbliver handlingen uklar og kræver behandling. Vellykket filtransport alene bekræfter ikke en ERP-post.

Aftal forventede resultater før implementeringen

Disse tilfælde skal godkendes i et egnet testmiljø:

  • Den første godkendte linje opretter en kladdelinje med 90 minutter i det tilknyttede projekt.

  • En identisk gentagelse efter bekræftet succes opretter ingen ekstra linje.

  • En ukendt projektreference forbliver åben med en begrundelse til afklaring.

  • Samme post med 120 minutter sættes i bero som rettelse i stedet for stiltiende at overskrive den bekræftede værdi.

I eksemplet accepterer teamet daglig behandling klokken 18:00 i tidszonen Europe/Berlin til senere faktureringsudkast. Kræves aktuelle værdier i løbet af arbejdsdagen, må overførslen vurderes igen. Eksportansvar, fejlhåndtering og tilbagemelding hører derfor til aftalen.

Kilder

Skrevet af

  • Tobias KrügerRedaktør for systemintegrationTobias Krüger beskæftiger sig hos ASES med samspillet mellem forskellige softwaresystemer. I sine artikler forklarer han integrationen af ERP, CRM og webshops samt håndteringen af fejl i dataudvekslingen.

Følg ASES

Læs videre

Alle artikler

Snitflader & integration med ASES

ERP, CRM og webshop forbundet ordentligt