Hoppa till innehållet

Integrera utan käll-API: planera en CSV-överföring

En exportfil kan hjälpa när det käll-API som behövs saknas. Ett exempel anger format, projektkoppling, upprepning och återkoppling.

Tobias Krüger2 min läsning
Datakort med paket-, plats- och kalendersymbol; mittfältet är tomt med orange ram.

Välj en tillgänglig överföring

Kontrollera först om de data som behövs är tillgängliga genom en export som stöds. Middleware, programvara mellan systemen, behandlar sådana indata; den skapar inte en åtkomst som källsystemet saknar.

Tillgängliga indata

Möjlighet i målsystemet

Möjlig överföring

Strukturerad exportfil

Lämplig filimport

Skapa en kontrollerad importfil

Strukturerad exportfil

Lämpligt API

Kontrollera och koppla data, överför sedan via API:et

Endast användargränssnitt

Lämplig inmatningsvy

Pröva skärmflödet separat

Det sista alternativet kräver tillförlitlig identifiering av de hanterade elementen och resultatet. Microsoft beskriver UI-selektorer för detta. Efter ändringar i gränssnittet behöver deras lämplighet kontrolleras igen; en inspelad klicksekvens bevisar inte ensam att data har tagits emot.

Dokumentera ett konkret filkontrakt

Ett fiktivt programvaruföretag väljer det andra alternativet. Dess gamla tidsregistrering saknar API för godkända tider men erbjuder en daglig export. En mellanliggande bearbetning ska använda uppgifterna för att lägga till en rad i ett faktureringsutkast i ERP-systemet. För vårt eget exempel avtalas UTF-8, komma som avgränsare och denna rubrikrad:

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

Raden betyder att den stabila källposten T-81 innehåller godkänd arbetstid i minuter för projekt PR-42. Detta är uttryckligen kopplat till ERP-projekt ERP-903. Endast godkända rader får gå vidare. Fälten och identifierarna är våra egna konstruktioner, inget Odoo-schema eller någon annan leverantörs struktur. RFC 4180 beskriver CSV-konventioner; det konkreta importkontraktet måste passa produkten. Odoo-dokumentationen visar exempelvis hur externa identifierare används vid import och relationer.

Skilj bekräftade resultat från oklara

Vid bekräftad överföring ska den mellanliggande bearbetningen koppla källposten till målreferensen. En oförändrad rad vars mottagande redan bekräftats får inte skapa ännu en utkastpost. Ändras samma källpost senare är det en verksamhetsmässig rättelse; i det valda upplägget hålls den kvar för utredning.

Om anslutningen bryts efter sändning kan målsystemet redan ha skrivit uppgifterna. Före ett nytt försök måste tillståndet klarläggas via en lämplig målreferens. Om målsystemet inte medger kontrollen förblir åtgärden oklar och kräver handläggning. Lyckad filtransport ensam bekräftar ingen ERP-post.

Avtala förväntade resultat före implementationen

Dessa fall ska godkännas i en lämplig testmiljö:

  • Den första godkända raden skapar en utkastpost med 90 minuter i det kopplade projektet.

  • En identisk upprepning efter bekräftad framgång skapar ingen extra post.

  • En okänd projektreferens förblir öppen med en orsak för utredning.

  • Samma post med 120 minuter hålls kvar som rättelse i stället för att tyst skriva över det bekräftade värdet.

I exemplet accepterar teamet daglig bearbetning klockan 18:00 i tidszonen Europe/Berlin för senare faktureringsutkast. Om aktuella värden behövs under arbetsdagen måste överföringen omprövas. Ansvar för export, felhantering och återkoppling ingår därför i överenskommelsen.

Källor

Skriven av

  • Tobias KrügerRedaktör för systemintegrationTobias Krüger arbetar på ASES med hur olika mjukvarusystem samverkar. I sina artiklar förklarar han hur ERP, CRM och webbutiker kopplas samman och hur man hanterar fel i datautbytet.

Följ ASES

Läs vidare

Alla artiklar

API:er & integration med ASES

ERP, CRM och webbutik smidigt sammankopplade