Integrationsdesign-Checkliste

Revised: 12 November 2021

Einleitung

Dieses Dokument enthält eine Standard-Checkliste, die mit jedem Kunden oder Partner überprüft werden sollte, der Integrationen zwischen Coupa und jedem anderen System aufbaut, um die folgenden Ziele zu erreichen:

  • Stellen Sie sicher, dass Integrationen so konzipiert sind, dass sie alle möglichen Datenszenarien berücksichtigen, die bei der Integration von benutzerdefinierten Daten zwischen Systemen auftreten können
  • Stellen Sie sicher, dass die Integrationen lose gekoppelt sind, um zu verhindern, dass Formatänderungen in einem System die Integrationen beeinträchtigen

CSV-Integrationen

Schritt Details Erfordert Genehmigung*
  Parsen nach Spaltenname, nicht Position Ja
  Nur inkrementelle / Deltadaten werden an Coupa/Objekt gesendet und senden nur die Daten, die in Coupa verwendet werden Ja
  Es werden nur inkrementelle /Delta-Daten von Coupa gesendet und nur für den endgültigen Status (z. B.: Rechnung OKOTOPAY: Status „Genehmigt“ oder „Für ungültig erklärt“) Ja
  Für die automatische Integration sollten keine geplanten Berichte (benutzerdefinierte Ansichten des Objekts) verwendet werden, da Coupa diese nicht als Standardintegration unterstützt. Geplanter Bericht, falls vorhanden, sollte eine Bedingung zur Begrenzung der Datenausgabe haben (z. B. täglicher Lauf für die letzte Aktualisierung innerhalb von 24 Stunden) Ja
  Feldnamen und Formate sind konfigurierbar und nicht fest codiert Nein
  CSV-Dateien verwenden die folgenden Konventionen aus RFC 4180.
  • Das Trennzeichen ist ein Komma: ,
  • Alle Felder sind immer textqualifiziert (beigefügt) mit dem doppelten Anführungszeichen: "
  • Doppelte Anführungszeichen innerhalb eines Feldes werden durch ein anderes doppeltes Anführungszeichen ersetzt. Wenn ein Nutzer eingibt: Status ist "Grün" in einem Kommentarfeld, dies würde als "Status ist" "Grün" "dargestellt werden
  • Neue Zeilenzeichen können in qualifizierten Feldwerten zulässig sein
  • Text-Verschlüsselung: UTF-8 (ohne Byte Order Marker (BOM))
Nein
 

Anpassung aller vom Benutzer eingegebenen Textszenarien

  • wagenrückläufer und andere Sonderzeichen in Textfeldern
  • unbegrenzte Textlängen in Textblockfeldern
  • abschneiden langer Textwerte auf Zielsystemlänge
  • Multi-Byte-Zeichen und Längenüberlegungen (falls erforderlich)
Ja
  Der Kunde muss Dateien aus dem Ausgangsverzeichnis in Coupa Hosted sftp löschen Ja
  Eingehende regelmäßige Delta-Feeds an Coupa sollten in einer Datei zusammengefasst werden und jede Delta-Datensatzaktualisierung im Quellsystem sollte NICHT als eine einzige Datei gesendet werden. Beispiel: 
1. Szenario:
  • Zulieferer Inbound zu Coupa läuft einmal täglich
  • 5 Lieferanten an einem Tag aktualisiert
  • Eine Lieferantendatei sollte am Ende des Tages an Coupa gesendet werden und nicht 5 Dateien
Szenario 2:
  • Der bei Coupa eingehende Lieferant läuft dreimal täglich (10.00 Uhr / 16.00 Uhr / 20.00 Uhr)
  • 10 Lieferanten an einem Tag aktualisiert (3 vor 10 Uhr, 4 zwischen 10 Uhr – 16 Uhr und 3 zwischen 16 Uhr – 20 Uhr)
  • 3 Lieferantendateien sollten an Coupa gesendet werden und jede Datei enthält 3 oder 4 oder 3 Datensätze um 10 Uhr, 16 Uhr bzw. 20 Uhr
Ja
  Ordnen Sie für eingehende und ausgehende CSV-Integrationsdaten nur die Felder zu, die von Coupa benötigt werden und für den Coupa-Geschäftsprozess erforderlich sind. Nein
  Überprüfen Sie immer das Vorhandensein von Elementen in XML/JSON, bevor Sie den Wert abrufen, da sich die Coupa-Nutzlaststruktur in Zukunft ändern kann, sodass bestimmte Felder, die keine oder Nullwerte aufweisen, nicht angezeigt werden. Ja

* Die Genehmigung des Kunden / Partners ist vor der Entwicklung erforderlich und sollte Teil des MTP-Tickets sein

API-Integrationen

Schritt Details Erfordert Genehmigung*
  Daten werden nicht in großen Mengen exportiert oder importiert Ja
  Keine strenge XSD-Validierung Ja
  Nur inkrementelle / Deltadaten werden an Coupa/Objekt gesendet und senden nur die Daten, die in Coupa verwendet werden würden  Ja
  Alle API-Aufrufe MÜSSEN Teil des IRD sein und sollten mit Coupa Integration Architect geteilt und von diesem genehmigt werden  Ja
  Überprüfen Sie das Vorhandensein von Elementen in XML/JSON, bevor Sie den Wert abrufen, da sich die Coupa-Nutzlaststruktur in Zukunft so ändern kann, dass bestimmte Felder, die keine oder Nullwerte aufweisen, nicht angezeigt werden. Ja
  Entkommende/nicht entkommende spezielle XML-Zeichen Nein
  Paging an Ort und Stelle für GET-Anrufe, die 50 Datensätze überschreiten können Nein
  Umgang mit Fehlern bei PUT/Post-Anrufen Nein
  Ordnen Sie für eingehende und ausgehende API-Integrationsdaten nur die Felder zu, die von Coupa benötigt werden und für den Coupa-Geschäftsprozess erforderlich sind Nein
  Verwenden Sie API-Filter/ Flache/ eingeschränkte Optionen für eine optimale API-Leistung Nein

Hinweis: Einige Inhalte wurden maschinell übersetzt.