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 le client plus facilement identifiables.
Aperçu
Avant Coupa 21, tous les champs personnalisés que vous avez ajoutés étaient inclus dans l'espace de nom global de l'API (hors de l'élément racine). Cela a rendu difficile l'identification des champs standard pour Coupa et de ceux (le cas échéant) qui ont été ajoutés par le client. Maintenant, de nouveaux champs personnalisés sont ajoutés à un élément <custom-fields> parent.
Comment ça marche
Nous ne modifions aucun de vos champs personnalisés existants ni la façon dont vous ajoutez des champs personnalisés, mais tous les nouveaux champs personnalisés que vous créez seront intégré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 verrez que la case à cocher Espace de noms global de l'API est activée. Cela signifie que 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écochez cette case et enregistrez vos modifications, votre champ personnalisé hérité sera ajouté à l'espace de noms des champs personnalisés.
Les champs personnalisés nouvellement créés n'ont pas l'option API Global Namespace. Ils sont dans le nouvel espace de noms de champ personnalisé par défaut. 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.
Les champs personnalisés de catégorie de dépense 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 de prendre en charge l'ancien format tant que l'option Espace de noms global de l'API est activée dans le champ personnalisé. Pour le nouveau format, nous enveloppons l'API pour les nouveaux champs personnalisés pour les objets d'intégration. Nous montrons à quoi cela ressemblera dans les exemples ci-dessous.
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 passés dans les nouveaux et anciens formats, Coupa utilisera le nouveau format et ignorera l'ancien format.
Exemple d'API utilisant le format XML
Pour l'API, les nouveaux champs personnalisés sont enveloppés dans un <custom-fields> attribut parent.
<custom-fields>
<custom-field-1>Nom du premier champ personnalisé</custom-field-1>
<custom-field-2>Nom du deuxième champ personnalisé</custom-field-2>
</custom-fields>Exemple d'API utilisant JSON
Pour l'API, les nouveaux champs personnalisés sont contenus dans un attribut de champs personnalisés parent.
{
"custom-fields" : {
"custom-field-1" : "Nom du premier champ personnalisé",
"custom-field-2" : "Nom du deuxième champ personnalisé"
}
}