• Dernière modification le: 18 April 2019

Espace de noms de champ personnalisé

Tous les nouveaux champs personnalisés sont ajoutés à un espace de noms de champs personnalisés pour éviter les conflits de noms et rendre les champs ajoutés par les clients plus facilement identifiables.

Aperçu

Avant Coupa 21, tous les champs personnalisés que vous aviez ajoutés étaient inclus dans l'espace de noms global de l'API (de l'élément racine). Il était donc difficile d'identifier les champs standard de Coupa et ceux (le cas échéant) ajoutés par le client. De nouveaux champs personnalisés sont désormais ajoutés à un <custom-fields> élément parent.

Comment cela fonctionne

Nous ne modifions aucun de vos champs personnalisés existants ou la façon dont vous ajoutez des champs personnalisés, mais tous les nouveaux champs personnalisés que vous créez seront encapsulés (API) lorsque vous les verrez dans l'API.

Dans l'interface utilisateur

Lorsque vous modifiez un champ personnalisé qui a été ajouté avant R21, vous constaterez que Espace de noms global API est cochée. Cela signifie le champ personnalisé n'est pas inclus dans l'espace de noms des champs personnalisés et se comporte comme il l'a toujours fait. Si vous désactivez cette case à cocher et enregistrez vos modifications, votre champ personnalisé hérité sera ajouté à l'espace de noms des champs personnalisés.

Les champs personnalisés créés récemment n'ont pas Espace de noms global API pour afficher les modifications. Ils se trouvent par défaut dans le nouvel espace de noms de champ personnalisé. Si vous désactivez l'option d'espace de noms global pour les champs personnalisés existants, ils seront placés dans l'espace de noms de champ personnalisé, la case à cocher disparaîtra et vous ne pourrez plus les ajouter à l'espace de noms global.

Remarque

Les champs personnalisés de catégorie de dépenses et les champs personnalisés de type participant ne prennent pas encore en charge l'ajout à l'espace de noms des champs personnalisés.

Intégrations

Vos intégrations continueront à prendre en charge l'ancien format tant que le Espace de noms global API est activée dans le champ personnalisé. Pour le nouveau format, nous encapsulons l'API pour les nouveaux champs personnalisés des objets d'intégration. Les exemples ci-dessous montrent à quoi cela ressemblera.

Pour l'API, Coupa prend en charge vos champs personnalisés existants dans le nouvel espace de noms, quelle que soit la configuration. Dans le cas où vos champs personnalisés sont transmis à la fois dans le nouveau et l'ancien format, Coupa utilisera le nouveau format et ignorera l'ancien format.

Exemple API avec XML

Pour l'API, les nouveaux champs personnalisés sont encapsulés dans un parent <custom-fields> attribut.

<custom-fields>
		<custom-field-1>Name of first custom field</custom-field-1>
		<custom-field-2>Name of second custom field</custom-field-2>
</custom-fields>

Exemple API avec JSON

Pour l'API, de nouveaux champs personnalisés sont contenus dans un parent custom-fields attribut.

{
	"custom-fields": {
		"custom-field-1": "Name of first custom field",
		"custom-field-2": "Name of second custom field"
	}
}	

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

Articles associés


API Coupa Core

Notre API RESTful fournit un accès fiable pour lire, modifier ou intégrer vos données à la plateforme Coupa.

Démarrez avec l'API

Informations générales sur l'utilisation de l'API Coupa et quand vous devez envisager d'utiliser CSV.

Transition vers OAuth 2.0 et OIDC

Coupa désapprouve les API Keys héritées et nécessite l'utilisation d'OAuth 2.0 / OIDC. À partir de R34, aucune nouvelle clé API ne sera émise et les clés API ne seront plus prises en charge avec R35.

Ressources

Nous avons organisé nos points de terminaison API par type d'objet : données de référence, données transactionnelles et ressources partagées.