Que pouvons-nous vous aider à trouver ? Produits Plateforme Intégration - Playbooks et ressources Articles sur les connaissances sur l'intégration Liste de contrôle de conception d'intégration

Liste de contrôle de conception d'intégration

Revised: 12 November 2021

Introduction

Ce document fournira une liste de contrôle standard qui devrait être examinée avec tout client ou partenaire qui construit des intégrations entre Coupa et tout autre système dans le but d'atteindre les objectifs suivants :

S'assurer que les intégrations sont conçues pour s'adapter à tous les scénarios de données possibles pouvant survenir lors de l'intégration de données saisies par l'utilisateur entre les systèmes
S'assurer que les intégrations sont conçues de manière faiblement couplée, ce qui empêche les changements de format dans n'importe quel système de casser les intégrations

Intégrations CSV

Étape	Détails	Nécessite une approbation*
	Analyse par nom de colonne et non par position	Oui
	Seules les données incrémentielles / delta doivent être envoyées à Coupa/object et envoyer uniquement les données qui seront utilisées dans Coupa	Oui
	Seules les données incrémentielles / delta seront envoyées par Coupa et ce ne sera que pour le statut final (Ex : Facture OKOTOPAY : Statut approuvé ou annulé)	Oui
	Aucun rapport planifié (vues personnalisées sur l'objet) ne doit être utilisé pour l'intégration automatisée, car Coupa ne les prend pas en charge en tant qu'intégration standard. Rapport planifié, le cas échéant, devrait avoir une condition pour limiter la sortie de données (par exemple : exécution quotidienne pour la dernière mise à jour dans les 24 heures seulement)	Oui
	Les noms et formats de champs sont configurables plutôt que codés en dur	Non
	Les fichiers CSV utilisent les conventions suivantes tirées de la RFC 4180. Le délimiteur est une virgule : , Tous les champs sont toujours du texte qualifié (inclus) avec le caractère de guillemet double : " Les caractères de guillemets doubles dans un champ sont échappés par un autre caractère de guillemets doubles. Si un utilisateur entre : Le statut est "Vert" dans un champ de commentaire, cela serait représenté par "Le statut est ""Vert""" Les caractères de nouvelle ligne peuvent être autorisés dans les valeurs de champ qualifiées Text-Encoding : UTF-8 (sans marqueur d'ordre des octets (BOM))	Non
	Adaptation à tous les scénarios de texte saisi par l'utilisateur retours chariot et autres caractères spéciaux dans les champs de texte longueurs de texte illimitées dans les champs de bloc de texte tronquer des valeurs de texte longues en fonction de la longueur du système cible Caractères multi-octets et considérations de longueur (si nécessaire)	Oui
	Le client doit supprimer les fichiers du répertoire sortant dans Coupa hébergé sftp	Oui
	Les flux delta réguliers entrants vers Coupa doivent être combinés en un seul fichier et chaque mise à jour d'enregistrement delta dans le système source NE DOIT PAS être envoyée en un seul fichier. Exemple : Scénario 1 : Le fournisseur entrant dans Coupa fonctionne une fois par jour 5 fournisseurs mis à jour en un jour Un fichier Fournisseur doit être envoyé à Coupa en fin de journée et non 5 fichiers Scénario 2 : Le fournisseur entrant dans Coupa fonctionne 3 fois par jour (10h / 16h / 20h) 10 Fournisseurs mis à jour en une journée (3 avant 10h, 4 entre 10h – 16h et 3 entre 16h – 20h) 3 Les fichiers fournisseurs doivent être envoyés à Coupa et chaque fichier aura 3 ou 4 ou 3 enregistrements à 10h, 16h, 20h respectivement	Oui
	Pour les données des intégrations CSV entrantes et sortantes, mappez uniquement les champs requis par Coupa et requis pour le processus métier Coupa.	Non
	Validez toujours la présence d'éléments dans le XML/JSON avant de récupérer la valeur car la structure de la charge utile Coupa peut changer à l'avenir pour ne pas afficher certains champs qui n'ont aucune valeur ou une valeur nulle.	Oui

* L'approbation du client / partenaire est requise à ce sujet avant le développement et doit faire partie du ticket MTP

Intégration des API

Étape	Détails	Nécessite une approbation*
	Ne pas exporter ou importer de données en vrac	Oui
	Ne pas utiliser la validation stricte XSD	Oui
	Seules les données incrémentielles / delta doivent être envoyées à Coupa/object et envoyer uniquement les données qui seraient utilisées dans Coupa	Oui
	Tous les appels API DOIVENT faire partie de l'IRD et doivent être partagés et approuvés par Coupa Integration Architect	Oui
	Valider la présence d'éléments dans le XML/JSON avant de récupérer la valeur car la structure de la charge utile Coupa peut changer à l'avenir pour ne pas afficher certains champs qui n'ont aucune valeur ou une valeur nulle.	Oui
	Échapper/déséchapper des caractères xml spéciaux	Non
	Pagination en place pour les appels GET qui peuvent dépasser 50 enregistrements	Non
	Traitement des erreurs en place pour les appels PUT/POST	Non
	Pour les données d'intégrations d'API entrantes et sortantes, mappez uniquement les champs requis par Coupa et requis pour le processus métier Coupa	Non
	Utiliser les filtres API/Options peu profondes/ limitées pour des performances API optimales	Non

Une partie ou la totalité de cette page peut avoir été traduite par machine. Toutes nos excuses pour les inexactitudes.