Erstellen einer Teilintegration (LaunchA360Bot.json)

Wenn Sie eine Teilintegration erstellen, muss der bot, den Sie bereitstellen wollen, im Control Room bereits vorhanden sein.

Anmerkung: Die Beispiele und Grafiken auf dieser Seite dienen nur der Veranschaulichung und spiegeln möglicherweise nicht genau Ihren speziellen Fall wider. Wir übernehmen keine Verantwortung für deren Pflege oder Richtigkeit.

Gehen Sie wie folgt vor, um eine Teilintegration zu erstellen:

  1. Navigieren Sie zu Apigee UI und melden Sie sich an.
  2. Wählen Sie im Dropdown-Menü oben links in der Nutzeroberfläche Ihre Organisation aus.
  3. Um eine Liste der verfügbaren Integrationen anzuzeigen, klicken Sie auf Develop > Integrations (Entwickeln > Integrationen).
  4. Wählen Sie eine vorhandene Integration aus oder klicken Sie auf NEU ERSTELLEN.
  5. Stellen Sie folgende Informationen bereit:
    • Integration name (Name der Integration): Geben Sie einen Namen ein, zum Beispiel launch-bot.
    • (Optional) Beschreibung: Geben Sie eine Beschreibung ein, z. B. „Stellt einen Automation 360-bot zur Verarbeitung von Dateien bereit.“
    • Region: Wählen Sie eine Region aus der Liste aus, z. B. die USA.
  6. Klicken Sie auf Erstellen.

    Der Integration Editor wird angezeigt.

  7. Fügen Sie im Integration Editor dem Designer einen Auslöser hinzu, indem Sie die folgenden Aktionen durchführen:
    • Klicken Sie auf + Add a task/trigger (Aufgabe/Auslöser hinzufügen).
    • Wählen Sie Triggers > API Triggers (Auslöser > API-Auslöser) aus.
    • Platzieren Sie den Auslöser auf dem Designer, indem Sie an eine geeignete Stelle klicken.
      Die Auslöser-ID wird automatisch abhängig vom Namen der Integration generiert. Mit dem API-Auslöser können Integrationsautoren eine Integration durch einen API-Aufruf testen. Dieser Auslöser ist nützlich, wenn Sie die Integration von Ihrem Anwendungscode aus testen wollen.
      Apigee – Auslöser hinzufügen
  8. Fügen Sie dem Designer im Integration Editor ein Data Mapping (Datenzuordnung) hinzu, indem Sie die folgenden Aktionen durchführen:
    • Klicken Sie auf + Add a task/trigger (Aufgabe/Auslöser hinzufügen).
    • Wählen Sie Tasks > Data Mapping (Aufgaben > Datenzuordnung) aus.
    • Platzieren Sie die Datenzuordnung auf dem Designer, indem Sie an eine geeignete Stelle klicken.
  9. Klicken Sie im Designer auf das Element Data Mapping, um den Konfigurationsbereich Data Mapping zu öffnen.
  10. Klicken Sie auf Open Data Mapping Editor (Datenzuordnungseditor öffnen).
    Mit dem Data Mapping Editor können Sie Variablenzuweisungen in Ihrer Integration vornehmen. Bei den Variablen kann es sich um Integrations- oder Aufgabenvariablen handeln. Mit der Aufgabe Data Mapping (Datenzuordnung) können Integrationsautoren Daten transformieren und Variablen zwischen Aufgaben in einer Integration zuweisen. Variablen werden mit der Option „VAR“ in der Palette erstellt.
    Apigee – Data Mapping Editor
  11. Erstellen Sie Eingabe- und Ausgabevariablen auf Grundlage der folgenden Liste. Eingabevariablen sind Variablen, die an Integrationsausführer übergeben werden. Geben Sie einen Literalwert an oder wählen Sie eine Referenzvariable aus. Um der Datenzuordnung eine Eingabevariable hinzuzufügen, klicken Sie auf eine Variable aus der Liste der verfügbaren Variablen und ziehen sie in die benachbarte Spalte Variables (Variablen). Klicken Sie auf Add + (Hinzufügen +), um eine neue Variable zu konfigurieren.
    In diesem Beispiel erstellen Sie sieben Eingabevariablen vom Datentyp „Zeichenfolge“ als Eingaben für die Integration:
    • input-ControlRoomUrl
    • input-Username
    • input-ApiKey
    • input-BotId
    • input-RunAsUserId
    • input-PoolId
    • input-BotInputVariables
    Erstellen Sie eine Ausgangsvariable als Ausgabe der Integration:
    • output-deploymentId
    Einige lokale Variablen, die nur im Rahmen dieser Integration existieren, sind: accessToken, authAPIUrl, deployBotAPIUrl, authRequestBody und deployRequestBody. Darüber hinaus generiert Apigee automatisch einige lokale Variablen zum Parken von Daten und für Transformationszwecke.

    Nachdem die Variablen erstellt wurden, schließen Sie den Data Mapping Editor.

  12. Fügen Sie im Integrationsdesigner ein Element hinzu, das die Authentifizierungs-API für den Automation 360-Control Room aufruft. Gehen Sie dazu wie folgt vor:
    • Klicken Sie auf + Add a task/trigger (Aufgabe/Auslöser hinzufügen).
    • Wählen Sie Tasks > Call REST Endpoint (Aufgaben > REST-Endpunkt aufrufen) aus.
    • Platzieren Sie die Datenzuordnung auf dem Designer, indem Sie auf eine geeignete Stelle klicken, um den Aufgaben-Konfigurationsbereich Call REST Endpoint (REST-Endpunkt aufrufen) anzuzeigen.
    • Ordnen Sie die folgenden Felder den im vorherigen Schritt definierten Variablen zu.
      • Ordnen Sie das Feld Endpoint base URL (Endpunkt-Basis-URL) der Variablen authAPIUrl zu.
      • Ordnen Sie das Feld Request body (Anforderungstext) der Variablen authRequestBody zu.
        Apigee – Zuordnung des Felds zur Variablen
  13. Fügen Sie dem Designer eine Datenzuordnungsaufgabe hinzu, um das Token aus dem vorherigen Schritt zu extrahieren. Führen Sie JSON wie gezeigt für Zeichenfolgeoperationen durch und speichern Sie sie in einer Variablen.
    Apigee – Token extrahieren
  14. Rufen Sie die Bot-Bereitstellungs-API für den Automation 360-Control Room auf.
    Fügen Sie dem Designer eine neue Aufgabe vom Typ Call REST Endpoint (REST-Endpunkt aufrufen) hinzu und konfigurieren Sie die Endpunkt-URL und die http-POST-Methode im Bereich auf der rechten Seite. Aktualisieren Sie auch den Anforderungstext mit den richtigen Zugangsdaten.
    Apigee – Bereitstellungsendpunkt aufrufen
  15. Fügen Sie eine Datenzuordnungsaufgabe hinzu, um die bot-Bereitstellungs-ID aus dem vorherigen Schritt zu extrahieren. Extrahieren Sie die Bereitstellungs-ID und speichern Sie sie in einer Variablen.
    Eine abgeschlossene Integration sieht wie folgt aus:
    Apigee – Bereitstellungs-ID extrahieren