Integreren zonder bron-API: een CSV-overdracht plannen

Een beschikbare overdrachtsroute kiezen

Controleer eerst of de benodigde gegevens via een ondersteunde export toegankelijk zijn. Middleware, software die tussen de systemen werkt, verwerkt zulke invoer; die schept geen toegang die het bronsysteem niet aanbiedt.

De laatste optie vereist dat bediende elementen en het resultaat betrouwbaar worden herkend. Microsoft beschrijft hiervoor UI-selectors. Na wijzigingen aan de interface moet hun geschiktheid opnieuw worden gecontroleerd; een opgenomen klikreeks bewijst op zichzelf nog geen gegevensovername.

Een uitgewerkt bestandscontract vastleggen

Een fictief softwarebedrijf kiest de tweede optie. Zijn oude tijdregistratie biedt geen API voor goedgekeurde uren, maar wel een dagelijkse export. Een tussenliggende verwerking moet daarmee een regel aan een facturatieconcept in het ERP toevoegen. Voor dit eigen voorbeeld worden UTF-8, een komma als scheidingsteken en deze kopregel afgesproken:

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

De regel betekent dat de stabiele bronregistratie T-81 goedgekeurde werktijd in minuten bevat voor project PR-42. Dit is expliciet gekoppeld aan ERP-project ERP-903. Alleen goedgekeurde regels mogen doorgaan. Velden en identificaties zijn eigen ontwerpen, geen Odoo-schema of structuur van een andere leverancier. RFC 4180 beschrijft CSV-conventies; het concrete importcontract moet bij het product passen. De Odoo-documentatie laat bijvoorbeeld zien hoe externe identificaties bij imports en relaties worden gebruikt.

Bevestigde en onzekere resultaten onderscheiden

Bij bevestigde overname moet de tussenliggende verwerking de bronregistratie en de doelreferentie verbinden. Een ongewijzigde regel waarvan de overname al bevestigd is mag geen volgende conceptregel maken. Als dezelfde bronregistratie later wijzigt, is dat een zakelijke correctie; in dit ontwerp wordt die voor opheldering vastgehouden.

Valt de verbinding na het verzenden weg, dan kan het doel de gegevens al hebben geschreven. Voor een nieuwe poging moet de toestand via een geschikte doelreferentie worden vastgesteld. Ondersteunt het doel die controle niet, dan blijft de handeling onzeker en vraagt die behandeling. Geslaagd bestandstransport alleen bevestigt nog geen ERP-registratie.

Verwachte uitkomsten vóór de bouw afspreken

Deze gevallen moeten in een geschikte testomgeving worden afgenomen:

• De eerste goedgekeurde regel maakt een conceptregel met 90 minuten in het gekoppelde project.

• Een identieke herhaling na bevestigd succes maakt geen extra regel.

• Een onbekende projectreferentie blijft open met een reden voor opheldering.

• Dezelfde registratie met 120 minuten wordt als correctie vastgehouden in plaats van de bevestigde waarde stilzwijgend te overschrijven.

In dit voorbeeld accepteert het team dagelijkse verwerking om 18:00 in tijdzone Europe/Berlin voor latere facturatieconcepten. Zijn actuele waarden gedurende de werkdag nodig, dan moet de overdracht opnieuw worden beoordeeld. Exportverantwoordelijkheid, foutafhandeling en terugmelding horen daarom bij de afspraak.

Bronnen

• IETF · RFC 4180 CSV

• Odoo 19 · Export and import data, official source

• Microsoft · Automate using UI elements