Kundenspezifischer Feld-Namespace
Alle neuen benutzerdefinierten Felder werden zu einem benutzerdefinierten Feld-Namespace hinzugefügt, um Namenskonflikte zu vermeiden und vom Kunden hinzugefügte Felder leichter identifizierbar zu machen.
Übersicht
Vor Coupa 21 waren alle benutzerdefinierten Felder, die Sie hinzugefügt haben, im globalen API-Namespace enthalten (außerhalb des Stammelements). Dies machte es schwierig zu identifizieren, welche Felder für Coupa Standard sind und welche (falls zutreffend) vom Kunden hinzugefügt wurden. Nun werden einem <custom-fields> übergeordneten Element neue benutzerdefinierte Felder hinzugefügt.
So funktioniert es
Wir ändern keine Ihrer vorhandenen benutzerdefinierten Felder oder wie Sie benutzerdefinierte Felder hinzufügen, aber alle neuen benutzerdefinierten Felder, die Sie erstellen, werden umgebrochen (API), wenn Sie sie in der API sehen.
In der Benutzeroberfläche
Wenn Sie ein benutzerdefiniertes Feld bearbeiten, das vor R21 hinzugefügt wurde, wird angezeigt, dass das Kontrollkästchen API Global Namespace aktiviert ist. Dies bedeutet, dass das benutzerdefinierte Feld nicht im Namensraum der benutzerdefinierten Felder enthalten ist und sich wie gewohnt verhält. Wenn Sie dieses Kontrollkästchen deaktivieren und Ihre Änderungen speichern, wird Ihr altes benutzerdefiniertes Feld dem Namensraum für benutzerdefinierte Felder hinzugefügt.
Neu erstellte benutzerdefinierte Felder verfügen nicht über die Option API Global Namespace. Sie befinden sich standardmäßig im neuen benutzerdefinierten Feld-Namespace. Wenn Sie die globale Namespace-Option für vorhandene benutzerdefinierte Felder deaktivieren, werden sie im benutzerdefinierten Feld-Namespace platziert, das Kontrollkästchen verschwindet und Sie können sie nicht mehr zum globalen Namespace hinzufügen.
Benutzerdefinierte Felder für Ausgabenkategorien und benutzerdefinierte Felder für Teilnehmer unterstützen noch nicht das Hinzufügen zum Namensraum für benutzerdefinierte Felder.
Integrationen
Ihre Integrationen unterstützen weiterhin das alte Format, solange die Option API Global Namespace im benutzerdefinierten Feld aktiviert ist. Für das neue Format verpacken wir die API für neue benutzerdefinierte Felder für Integrationsobjekte. Wie das aussehen wird, zeigen wir in den folgenden Beispielen.
Für die API unterstützt Coupa Ihre vorhandenen benutzerdefinierten Felder im neuen Namespace, unabhängig von der Konfiguration. Wenn Ihre benutzerdefinierten Felder sowohl im neuen als auch im alten Format übergeben werden, verwendet Coupa das neue Format und ignoriert das ältere Format.
API-Beispiel mit XML
Für die API werden neue benutzerdefinierte Felder in ein übergeordnetes <custom-fields> Attribut eingefügt.
<custom-fields>
<custom-field-1>Name des ersten benutzerdefinierten Felds</custom-field-1>
<custom-field-2>Name des zweiten benutzerdefinierten Felds</custom-field-2>
</custom-fields>API-Beispiel mit json
Für die API sind neue benutzerdefinierte Felder in einem übergeordneten benutzerdefinierten Feldattribut enthalten.
{
"custom-fields": {
"custom-field-1": "Name des ersten benutzerdefinierten Feldes",
"custom-field-2": "Name des zweiten benutzerdefinierten Feldes"
}
}