Neue API-Zuordnungen für Dienste erstellen
API-Zuordnungen ordnen Attribute für einen Endpunkt (vom Back-End-System) zu Attributen in einem Data Shape zu. API-Zuordnungen sind Teil eines Diensts in Ihrem Integrations-Konnektor-Ding.
1. Verwenden Sie einen der folgenden Prozesse:
◦ Erstellen Sie eine API-Zuordnung, wenn Sie Dienste bereitstellen. Auf der Seite Dienste befindet sich die Aktion unter Routing-Informationen.
◦ Erstellen Sie zuerst eine API-Zuordnung, und ordnen Sie sie anschließend einem Dienst zu.
Klicken Sie auf der Seite API-Zuordnungen auf Hinzufügen.
2. Geben Sie auf der Seite Neue API-Zuordnung Informationen in die folgenden Felder ein:
a. Zuordnungs-ID: Geben Sie einen Namen für die Zuordnung ein.
b. Endpunkt: Wählen Sie eine Option aus der Dropdown-Liste aus. Endpunkte werden im Back-End-System abgerufen, das Sie auf der Seite Konfiguration einrichten.
Die APIs, die vom ausgewählten Endpunkt bereitgestellt werden, werden in der Tabelle API angezeigt.
 | • Informationen zu den WindchillSwaggerConnector-Endpunkten finden Sie unter WindchillSwaggerConnector – Voraussetzungen. |
c. Basistyp: Für diese Version ist INFOTABLE der einzig gültige Basistyp.
d. Data Shape auswählen: Wählen Sie den Data Shape aus, der die Attribute anzeigt, die Sie der API zuordnen möchten. Die Attribute werden in der Tabelle Rückgabetyp angezeigt.
| | Wenn Sie einen Data Shape aktualisieren oder löschen, nachdem er in einer API-Zuordnung verwendet wurde, müssen Sie die API-Zuordnung ebenfalls aktualisieren, um die Änderung zu berücksichtigen. |
e. Ziehen Sie die Auswahl aus der Tabelle API in die Tabelle Rückgabetyp, und legen Sie sie dort ab, um die Eigenschaften zuzuordnen.
| | • Die Funktion führt nur eine direkte Zuordnung durch und kombiniert keine Parameter. Daten müssen HTML-Format aufweisen. • Die Attribute, die vom Endpunkt zurückgegeben werden, können primitive Typen (beispielsweise Nummer und Zeichenfolge) oder verschachtelte Typen sein. Verschachtelte Typen können eine Hierarchie von Attributen anzeigen, die maximal auf drei Ebenen erweitert wird. |
3. Klicken Sie auf Fertig.
| | Klicken Sie auf Fertig, bevor Sie das Ding speichern. Andernfalls geht die neue Zuordnung verloren. |
4. Speichern Sie das Ding.