Zum Inhalt springen

Ohne Quell-API integrieren: einen CSV-Übergang planen

Fehlt die passende Quell-API, kann ein Dateiexport weiterhelfen. Ein Beispiel klärt Format, Projektzuordnung, Wiederholung und Rückmeldung.

Tobias Krüger2 Min. Lesezeit
Datenkarte mit Paket-, Orts- und Kalendersymbol; das mittlere Feld ist leer und orange umrandet.

Den verfügbaren Übergang auswählen

Prüfen Sie zuerst, ob die benötigten Daten über einen unterstützten Export zugänglich sind. Eine Middleware, also vermittelnde Software, verarbeitet solche Eingänge; sie schafft keinen Zugriff, den das Quellsystem nicht anbietet.

Verfügbarer Eingang

Möglichkeit im Ziel

Möglicher Übergang

Strukturierte Exportdatei

Passender Dateiimport

Geprüfte Importdatei erzeugen

Strukturierte Exportdatei

Passende API

Datei prüfen, zuordnen und per API übertragen

Nur Bedienoberfläche

Geeignete Eingabemaske

Bildschirmablauf gesondert erproben

Bei der letzten Variante müssen die bedienten Elemente und das Ergebnis zuverlässig erkannt werden. Microsoft beschreibt dafür UI-Selektoren. Nach Änderungen der Oberfläche ist deren Eignung erneut zu prüfen; ein aufgezeichneter Klickablauf allein belegt die Datenübernahme nicht.

Einen ausgefüllten Dateivertrag festhalten

Ein fiktives Softwareunternehmen wählt die zweite Variante. Seine alte Zeiterfassung bietet für freigegebene Zeiten keine API, aber einen täglichen Export. Eine Zwischenverarbeitung soll daraus im ERP einen Abrechnungsentwurf ergänzen. Für dieses eigene Beispiel werden UTF-8, Komma als Trennzeichen und diese Kopfzeile vereinbart:

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

Die Zeile bedeutet: Der stabile Quellbeleg T-81 enthält freigegebene Arbeitszeit in Minuten für Projekt PR-42. Dieses ist ausdrücklich dem ERP-Projekt ERP-903 zugeordnet. Nur freigegebene Zeilen dürfen weitergehen. Felder und Kennungen sind eigene Entwürfe, keine Odoo- oder andere Anbieterstruktur. RFC 4180 beschreibt CSV-Konventionen; der konkrete Importvertrag muss zum Produkt passen. Die Odoo-Dokumentation zeigt beispielsweise, wie externe Kennungen bei Importen und Beziehungen verwendet werden.

Bestätigte und unklare Ergebnisse auseinanderhalten

Für eine bestätigte Übernahme soll die Zwischenverarbeitung Quellbeleg und Zielreferenz verbinden. Eine bereits bestätigte, unveränderte Zeile darf keinen weiteren Entwurfsposten erzeugen. Ändert sich derselbe Quellbeleg später, ist das eine fachliche Korrektur; sie wird im gewählten Entwurf zur Klärung angehalten.

Bricht die Verbindung nach dem Senden ab, kann das Ziel bereits geschrieben haben. Vor einem erneuten Versuch muss der Zustand über eine geeignete Zielreferenz geklärt werden. Lässt das Ziel diese Prüfung nicht zu, bleibt der Vorgang unklar und braucht Bearbeitung. Eine erfolgreiche Dateiübertragung allein bestätigt noch keinen ERP-Eintrag.

Erwartete Ergebnisse vor der Umsetzung vereinbaren

In einer geeigneten Testumgebung wären diese Fälle abzunehmen:

  • Die erste freigegebene Zeile erzeugt einen Entwurfsposten mit 90 Minuten im zugeordneten Projekt.

  • Eine identische Wiederholung nach bestätigtem Erfolg erzeugt keinen weiteren Posten.

  • Ein unbekannter Projektverweis bleibt mit Klärungsgrund offen.

  • Derselbe Beleg mit 120 Minuten wird als Korrektur angehalten, statt den bestätigten Wert still zu überschreiben.

Das Team akzeptiert im Beispiel eine tägliche Verarbeitung um 18:00 in der Zeitzone Europe/Berlin für spätere Abrechnungsentwürfe. Werden aktuelle Werte während des Arbeitstags benötigt, muss der Übergang neu bewertet werden. Exportverantwortung, Fehlerbearbeitung und Rückmeldung gehören deshalb zur Vereinbarung.

Quellen

Geschrieben von

  • Tobias KrügerRedakteur für SystemintegrationTobias Krüger beschäftigt sich bei ASES mit dem Zusammenspiel verschiedener Softwaresysteme. In seinen Beiträgen erklärt er die Anbindung von ERP, CRM und Onlineshops sowie den Umgang mit Fehlern beim Datenaustausch.

ASES folgen

Weiterlesen

Alle Beiträge

Schnittstellen & Integration mit ASES

ERP, CRM und Shop sauber verbunden