Erste Schritte mit Apigee Integration und Cloud Pub/Sub-Trigger

Erfahren Sie, wie Sie eine Beispielintegration mit Apigee Integration und dem Cloud Pub/Sub-Trigger erstellen. In den folgenden Schritten wird beschrieben, wie Sie den Trigger, Aufgaben, Variablen und Datenabgleiche konfigurieren, die für die Ausführung einer vollständigen Integration erforderlich sind.

Überblick

In dieser Kurzanleitung erstellen Sie eine Integration mit einem Cloud Pub/Sub-Trigger, um ein vorhandenes Pub/Sub-Thema zu beobachten, das die Temperaturwerte in Grad Kelvin von einem IOT-Gerät empfängt. Anschließend können Sie die Aufgabe Datenabgleich verwenden, um die Pub/Sub-Nachricht in Celsius zu transformieren und den Wert in einer E-Mail zu senden.

Hinweise

Führen Sie die folgenden Aufgaben aus, bevor Sie mit der Kurzanleitung beginnen.

    • Weisen Sie dem Apigee-Integrations-Dienst-Agent (service-PROJECT_NUMBER@gcp-sa-apigee.iam.gserviceaccount.com) in Ihrem Google Cloud-Projekt die folgenden IAM-Rollen zu.
      • Pub/Sub-Bearbeiter
      • Aufrufer von Apigee-Integrationen

        Weitere Informationen zum Zuweisen von IAM-Rollen finden Sie unter IAM-Rollen und -Berechtigungen.

    Umgebung einrichten

    Erstellen Sie ein neues Cloud Pub/Sub-Thema

    In dieser Kurzanleitung wird davon ausgegangen, dass Sie ein Pub/Sub-Thema haben, das Temperaturwerte in Grad Kelvin von einem IOT-Gerät empfängt. Es ist nicht erforderlich, das Thema mit einem Gerät zu verbinden. In dieser Kurzanleitung wird getestet, ob die Integration das Thema überwachen und Aufgaben ausführen kann, wenn der Trigger ausgelöst wird.

    So erstellen Sie ein Beispielthema für diese Kurzanleitung:

    1. Rufen Sie in der Cloud Console die Seite "Pub/Sub-Themen" auf.

      Zur Seite „Pub/Sub-Themen“

    2. Klicken Sie auf Thema erstellen.
    3. Geben Sie im Feld Themen-ID einen eindeutigen Themennamen ein. z. B. temperaturesensor.
    4. Klicken Sie auf Speichern.

    Neue Integration erstellen

    So erstellen Sie eine neue Integration:

    1. Wählen Sie in der Apigee-Benutzeroberfläche Ihre Apigee-Organisation aus.
    2. Klicken Sie auf Entwickeln > Integrationen.
    3. Klicken Sie auf Integration erstellen.
    4. Geben Sie im Dialogfeld Integration erstellen einen Namen und eine Beschreibung ein. Beispiel: my-test-integration.
    5. Wählen Sie eine Region für die Integration aus.
    6. Klicken Sie auf Erstellen, um den Integrationseditor zu öffnen.

    Cloud Pub/Sub-Trigger hinzufügen

    So fügen Sie der Integration einen Cloud Pub/Sub-Trigger hinzu:
    1. Wählen Sie im Integrationseditor Trigger aus, um eine Liste der verfügbaren Trigger aufzurufen.
    2. Klicken Sie auf das Element Cloud Pub/Sub-Trigger und platzieren Sie es im Designer.

    Cloud Pub/Sub-Trigger konfigurieren

    Klicken Sie im Integrationseditor auf das Element Cloud Pub/Sub-Trigger, um den Trigger-Konfigurationsbereich aufzurufen.

    Geben Sie im Feld Pub/Sub-Thema das Thema, das der Trigger überwachen soll, in folgendem Format an:

    projects/PROJECT_ID/topics/TOPIC_ID
    Dabei gilt:
    • PROJECT_ID ist das Google Cloud-Projekt, in dem das Thema erstellt wurde.
    • TOPIC_ID ist die ID des Cloud Pub/Sub-Themas, das Sie unter Vorbereitung erstellt haben.

    Wenn Ihr Projekt beispielsweise den Namen my-project hat und Sie das Thema temperaturesensor benannt haben, geben Sie Folgendes ein:

    projects/my-project/topics/temperaturesensor

    Alle verfügbaren Themen in Ihrem Google Cloud-Projekt finden Sie in der Spalte Themenname unter Themen.

    Der Konfigurationsbereich Cloud Pub/Sub-Trigger befüllt das Feld Triggerausgabe automatisch mit einer Variablen, die die Pub/Sub-Nachricht enthält.

    Aufgabe „Datenabgleich“ hinzufügen und konfigurieren

    So konfigurieren Sie die Aufgabe Datenabgleich:

    1. Wählen Sie Aufgaben aus, um eine Liste der verfügbaren Aufgaben anzuzeigen.
    2. Klicken Sie auf das Element Datenabgleich und platzieren Sie es im Integrationseditor.
    3. Klicken Sie im Designer auf die Aufgabe Datenabgleich, um den Konfigurationsbereich der Aufgabe zu öffnen.
    4. Klicken Sie auf Datenabgleichs-Editor öffnen.

      Mit den Transformationsfunktionen im Datenabgleichs-Editor können Sie Eingabevariablen den gewünschten Ausgabevariablen zuordnen. Die Ausgabe ist dann als Variable für alle anderen Integrationsaufgaben oder Trigger verfügbar. Weitere Informationen zur Übergabe von Daten als Variablen finden Sie unter Variablen in Apigee Integration verwenden.

      Führen Sie für diese Kurzanleitung die folgenden Schritte aus, um eine Zuordnung mit CloudPubSubMessage als Eingabe zu erstellen:

      1. Maximieren Sie die JSON-Variable CloudPubSubMessage in der Liste der Variablen und ziehen Sie die Variable CloudPubSubMessage.data in die erste Eingabe-Zeile.
      2. Klicken Sie neben der Variable CloudPubSubMessage.data auf + (Funktion hinzufügen), um die Drop-down-Liste der verfügbaren Funktionen aufzurufen.
      3. Wählen Sie TO_DOUBLE() aus, um den Wert CloudPubSubMessage.data in den Datentyp double zu konvertieren.
      4. Klicken Sie noch einmal auf + (Funktion hinzufügen), um die Funktion SUBTRACT auszuwählen und zu verketten.
      5. Geben Sie 273.15 als Funktionswert SUBTRACT ein. Damit wird die Kelvin-Temperatur in Grad Celsius konvertiert.
      6. Klicken Sie auf das erste Feld in der Spalte Ausgabe, um eine neue Variable zu erstellen, die den Wert der transformierten Daten enthält. Füllen Sie die folgenden Felder aus:
        • Name: Geben Sie TempInCelsius ein.
        • Klicken Sie das Kästchen Als Ausgabe der Integration verwenden an.
        • Klicken Sie auf Erstellen, um die Variable zu erstellen, und schließen Sie den Bereich. Die neue Variable TempInCelsius wird in der Liste Variablen angezeigt.
      7. Ziehen Sie die Variable TempInCelsius aus der Liste Variablen in die zweite Zeile der Spalte Eingabe.
      8. Klicken Sie in der Variable TempInCelsius auf + Funktion hinzufügen, um die Drop-down-Liste der verfügbaren Funktionen aufzurufen.
      9. Klicken Sie auf TO_STRING(), um den Datentyp der Variable von double in string zu transformieren.
      10. Klicken Sie auf die zweite Reihe in der Spalte Ausgabe, um eine neue Variable zu erstellen, die den Wert der transformierten Daten enthält. Füllen Sie die folgenden Felder aus:
        • Name: Geben Sie TempInCelsiusString ein.
        • Leerer Standardwert bedeutet: Wählen Sie Leerer String aus.
        • Klicken Sie das Kästchen Als Ausgabe der Integration verwenden an.
        • Klicken Sie auf Erstellen, um die Variable zu erstellen, und schließen Sie den Bereich. Die neue Variable wird links im Datenabgleichseditor in der Liste Variablen angezeigt.
      11. Schließen Sie den Datenableichs-Editor, sobald die Zuordnung abgeschlossen ist. Alle Änderungen werden automatisch gespeichert.

    Aufgabe „E-Mail senden” hinzufügen und konfigurieren

    So konfigurieren Sie die Aufgabe E-Mail senden:

    1. Wählen Sie im Integrationseditor Aufgaben aus, um die Liste der verfügbaren Aufgaben aufzurufen.
    2. Klicken Sie auf das Element E-Mail senden und platzieren Sie es im Integrationseditor.
    3. Klicken Sie im Designer auf das Element E-Mail senden, um den Konfigurationsbereich der Aufgabe zu öffnen. Legen Sie die folgenden Attribute fest:
      • An Empfänger: Geben Sie Ihre E-Mail-Adresse ein. Mit dieser E-Mail bestätigen Sie den erfolgreichen Abschluss der Integration.
      • Betreff: Geben Sie Temperature in Celsius ein.
      • Text in Nur-Text: Wählen Sie die Variable TempInCelsiusString aus, die zuvor in der Aufgabe Datenabgleich erstellt wurde.
      • Die restlichen Optionen können in der Standardkonfiguration beibehalten werden.
      Ihre Änderungen an den Attributen werden automatisch gespeichert.

    Erforderliche Edge-Verbindungen hinzufügen

    Ein Edge ist eine Verbindung zwischen zwei Elementen in einer Integration. Die Verbindung gibt die Richtung des Steuerungsablaufs von einem Element(Aufgabe oder Trigger) zu einem anderen an. Weitere Informationen zu Kanten finden Sie unter Edges.

    1. Fügen Sie dem Element Datenabgleich eine Edge-Verbindung aus dem Element Cloud Pub/Sub-Trigger hinzu. Bewegen Sie dazu den Mauszeiger auf einen Steuerpunkt im Cloud Pub/Sub-Trigger. Klicken Sie dann auf eine Linie zu einem Steuerpunkt im Aufgabenelement Datenabgleich. Dieser Edge kennzeichnet den Kontrollfluss von der Aufgabe Cloud Pub/Sub-Trigger zur Aufgabe Datenabgleich.
    2. Fügen Sie eine Edge-Verbindung vom Element Datenabgleich zum Element E-Mail senden hinzu. Bewegen Sie dazu den Mauszeiger auf einen Steuerungspunkt des Elements Datenabgleich. Klicken Sie dann auf eine Linie und ziehen Sie sie an einen Steuerungspunkt im Aufgabenelement E-Mail senden. Dieser Edge kennzeichnet den Kontrollfluss von der Aufgabe Datenabgleich zur Aufgabe E-Mail senden.

    Die fertige Verbindung sollte der folgenden Abbildung entsprechen:

    Abbildung mit Kurzanleitung Abbildung mit Kurzanleitung

    Integration testen

    So testen Sie die neue Integration auf der Seite „Pub/Sub-Themen“:

    1. Rufen Sie in der Cloud Console die Seite "Pub/Sub-Themen" auf.

      Zur Seite "Pub/Sub-Themen"

    2. Suchen Sie nach dem von Ihnen erstellten Thema Temperatursensor und wählen Sie es aus.
    3. Klicken Sie auf der Detailseite des Themas auf + Nachricht veröffentlichen, um den Konfigurationsbereich Nachricht veröffentlichen zu öffnen.
    4. Geben Sie im Feld Nachrichtentext 307.15 ein.

      Die Erstellung dieser Nachricht simuliert die Veröffentlichung eines Temperaturmesswerts in Kelvin, der von Pub/Sub von einem IOT-Gerät empfangen wird.

    5. Klicken Sie auf Veröffentlichen, um die Nachricht im Thema zu veröffentlichen und die Integration auszulösen.

    Nach erfolgreichem Abschluss sendet die Integration eine E-Mail mit der Kelvin-Temperatur, die in Celsius konvertiert wird, an die in der Aufgabe E-Mail senden angegebene E-Mail-Adresse. Bestätigen Sie den Erhalt der E-Mail in Ihrem E-Mail-Client.

    Die von der Integration gesendete E-Mail sollte einen Nachrichtentext mit dem Wert 34 enthalten.

    Sie können den Inhalt der E-Mail nicht nur überprüfen, sondern auch in den Logs den Status und die Nutzlast einer bestimmten Integration einsehen. So können die Logs angezeigt werden:

    1. Klicken Sie im Integrationseditor auf Abbildung mit dem Symbol für AusführungslogsAusführungsprotokolle für diese Integration ansehen. Die Seite Ausführungslogs wird angezeigt. Weitere Informationen zu Ausführungslogs finden Sie unter Ausführungslogs der Integration ansehen.
    2. Auf der Seite Ausführungslogs können Sie Details zu jedem Versuch anzeigen, eine Integration auszuführen. Jeder Eintrag enthält Details für den Ausführungsversuch. Beispiele:
      • Name der Integration
      • Ausführungs-ID
      • Status
      • Beginn
      • Dauer
      • Integrationsversion
      • Trigger-ID
    3. Klicken Sie neben der ausgeführten Integration auf den Erweiterungspfeil (>), um eine erweiterte Liste von Aufgaben und Variablen in der Integration aufzurufen. Außerdem werden der Aufgabenstatus und die Nutzlasten von Variablen angezeigt.