Erstellen Sie eine API-Entitätsoperation im Jitterbit Design Studio

Einführung

Diese Seite beschreibt, wie man eine API-Entitätsoperation erstellt. Die Jitterbit-Entität und die API-Entitätsoperation werden verwendet, um eine OData-Dienst-API zu erstellen. Wenn die API-Entitätsoperation abgeschlossen ist, wird die Operation einer OData-Dienst-API zugewiesen.

Erstellen Sie eine API-Entitätsoperation

1. Öffnen Sie Ihr Projekt in der Design Studio-Anwendung. Der Bildschirm "Erste Schritte" sollte angezeigt werden:

   

   • Das Panel auf der linken Seite des Design Studio listet die Projektelemente auf, die Sie zur Erstellung Ihrer Integration verwenden werden, wie z.B. Operationen, Transformationen, Skripte usw. Scrollen Sie im Panel zu Operationen.
   • Klicken Sie mit der rechten Maustaste auf Operationen und wählen Sie Neue Operation aus dem Dropdown-Menü.

2. Das Select Type Popup-Fenster zeigt die Liste der verfügbaren Operationstypen im Design Studio an. Wählen Sie API Entity Operation aus der Liste der Optionen und klicken Sie dann auf Continue:

   

3. Das Entity Wizard Popup-Fenster sollte ähnlich wie das unten gezeigte Bild angezeigt werden. Eine Entität definiert die Daten, die einem OData-Dienst zur Verfügung stehen, und besteht aus einem Endpunkt, einer Auswahl von Objekten und einer Auswahl spezifischer Felder. Jede vorhandene Entität, die im Projekt verfügbar ist, wird unter dem Jitterbit Entities-Ordner aufgelistet:

   

   • Neue Jitterbit-Entität erstellen: Wählen Sie diese Option, wenn im Projekt keine Entität verfügbar ist und sie im Entity Wizard nicht aufgeführt ist, wie oben gezeigt. Der Entity Wizard führt Sie dann durch die Erstellung der Entität, die Auswahl der Tabellen oder Objekte und die Auswahl der Felder. Befolgen Sie die Anweisungen in Erstellen einer Jitterbit-Entität, während Sie im Entity Wizard fortfahren.
   • Eine vorhandene Jitterbit-Entität im Projekt verwenden: Sie können die Entität erstellen, bevor Sie Ihre Operation erstellen, indem Sie die Anweisungen in Erstellen einer Jitterbit-Entität befolgen. Alle vorhandenen Entitäten, die in Ihrem Projekt verfügbar sind, werden unter dem Jitterbit Entities-Ordner im oberen rechten Bereich des Entity Wizard aufgelistet, wie oben gezeigt. Ein Klick auf eine vorhandene Entität in der Liste der verfügbaren Entitäten wählt automatisch Eine vorhandene Jitterbit-Entität im Projekt verwenden aus.

   • Für dieses Beispiel wird die Customers-Entität ausgewählt. Klicken Sie unten auf dem Bildschirm auf Next, um fortzufahren:

     

4. Der Bildschirm Transformations wird angezeigt:

   

   1. Durchlauf-Transformationen:

      • Jitterbit erstellt standardmäßig eine Durchlaufoperation.
      • Lassen Sie sowohl die Kontrollkästchen für die Anforderungs-Transformation als auch die Antwort-Transformation leer, wenn keine benutzerdefinierte Zuordnung erforderlich ist.

      • In diesem Beispiel haben wir uns für die grundlegende Durchlauf-Transformation entschieden und kein Kontrollkästchen ausgewählt:

        

      • Klicken Sie auf Fertigstellen am unteren Rand des Fensters. Die Durchlaufoperation wird erstellt und wird im Tab Operationen von Design Studio angezeigt:

        

   2. Ich benötige benutzerdefinierte Zuordnungen in der:

      • Anforderungs-Transformation: Aktivieren Sie das Kontrollkästchen, wenn eine benutzerdefinierte Zuordnung der Anfrage erforderlich ist.
      • Antwort-Transformation: Aktivieren Sie das Kontrollkästchen, wenn eine benutzerdefinierte Zuordnung der Antwort erforderlich ist.

      • In diesem Beispiel sind sowohl die Kontrollkästchen für die Antwort-Transformation als auch die Anforderungs-Transformation ausgewählt:

        

      • Die Schaltfläche Weiter wird automatisch aktiviert. Klicken Sie auf Weiter.

      • Eine Warnmeldung wird im Entity Wizard angezeigt: "Benutzerdefinierte Transformation wird nur für GET-Entitäten (OData-APIs) unterstützt".

      • Klicken Sie auf Fertigstellen am unteren Rand des Fensters. Die Operation wird erstellt und wird im Design Studio mit einer benutzerdefinierten Anfrage und einer benutzerdefinierten Antwort-Transformation angezeigt:

        

      • Klicken Sie mit der rechten Maustaste auf die Kunden - Anfrage-Transformation und wählen Sie Kunden - Anfrage bearbeiten, um den Bildschirm für die Feldzuordnung im Tab Transformationen zu öffnen. Sie können bei Bedarf benutzerdefinierte Zuordnungen mit Skripting erstellen:

        

      • Wiederholen Sie diesen Schritt bei der Kunden - Antwort-Transformation, um die Antwortfelder entsprechend zuzuordnen.

      • Sobald die Zuordnung abgeschlossen ist, klicken Sie auf das Speichern-Symbol in der Symbolleiste. Klicken Sie auf das Bereitstellen Symbol in der Symbolleiste, um das gesamte Projekt in Harmony bereitzustellen.

5. Nächster Schritt: Siehe OData-Dienstkonfiguration zur Verwendung der neuen Entität und der API-Entitätsoperation.