Google Pub Sub Nachricht veröffentlichen Aktivität
Einführung
Eine Google Pub Sub Nachricht veröffentlichen Aktivität, die ihre Google Pub Sub Verbindung verwendet, veröffentlicht Nachrichten an ein Thema in Google Pub/Sub und ist dazu gedacht, als Ziel zum Konsumieren von Daten in einem Vorgang verwendet zu werden.
Erstellen einer Google Pub Sub Nachricht veröffentlichen Aktivität
Eine Instanz einer Google Pub Sub Nachricht veröffentlichen Aktivität wird aus einer Google Pub Sub Verbindung unter Verwendung des Aktivitätstyps Nachricht veröffentlichen erstellt.
Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Entwurfsfläche oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Entwurfsfläche ein. Für Details siehe Erstellen einer Aktivitäts- oder Toolinstanz in Komponentenwiederverwendung.
Eine vorhandene Google Pub Sub Nachricht veröffentlichen Aktivität kann von diesen Orten aus bearbeitet werden:
- Die Entwurfsfläche (siehe Komponentenaktionsmenü in Entwurfsfläche).
- Der Komponenten-Tab im Projektbereich (siehe Komponentenaktionsmenü in Projektbereich Komponenten-Tab).
Konfigurieren einer Google Pub Sub Nachricht veröffentlichen Aktivität
Befolgen Sie diese Schritte, um eine Google Pub Sub Nachricht veröffentlichen Aktivität zu konfigurieren:
-
Schritt 1: Geben Sie einen Namen ein und wählen Sie ein Thema aus
Geben Sie einen Namen für die Aktivität ein und wählen Sie ein Thema aus. -
Schritt 2: Überprüfen Sie die Datenschemas
Alle Anforderungs- oder Antwortschemas, die von dem Endpunkt generiert wurden, werden angezeigt.
Schritt 1: Geben Sie einen Namen ein und wählen Sie ein Thema aus
In diesem Schritt geben Sie einen Namen für die Aktivität an und spezifizieren ein Abonnement. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.
Die Benutzeroberfläche, die in diesem Schritt der Konfiguration einer Google Pub Sub Nachricht veröffentlichen-Aktivität verwendet wird, hängt von der ausgewählten Abonnement auswählen-Option ab:
-
Thema manuell angeben: Bei dieser Option geben Sie manuell das Thema ein, in dem die Nachrichten veröffentlicht werden sollen.
-
Vorhandenes Thema auswählen: Diese Option füllt eine Liste vorhandener Themen zur Auswahl aus. Um diese Option zu verwenden, müssen Sie das
pubsub.topics.list
-Recht dem in der Google Pub Sub Verbindung angegebenen Dienstkonto zuweisen.
Thema manuell angeben
Wenn Thema manuell angeben für Thema auswählen ausgewählt ist, wird diese Benutzeroberfläche angezeigt:
-
Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede Google Pub Sub Publish Message-Aktivität einzigartig sein und darf keine Schrägstriche
/
oder Doppelpunkte:
enthalten. -
Choose Subscription: Wählen Sie die Methode zur Bereitstellung des Themas, das in der Anfrage verwendet werden soll:
-
Inform Topic Manually: Wählen Sie diese Option, um das Thema manuell einzugeben, in dem die Nachrichten veröffentlicht werden sollen.
-
Select Existent Topic: Wählen Sie diese Option, um ein vorhandenes Thema aus einer gefüllten Liste auszuwählen. Um diese Option zu nutzen, muss das
pubsub.topics.list
-Recht dem Dienstkonto zugewiesen sein, das in der Google Pub Sub connection angegeben ist.
-
-
Topic: Geben Sie den Namen des Themas ein, in dem die Nachrichten veröffentlicht werden sollen.
-
Continue on Error: Wählen Sie diese Option, um die Ausführung der Aktivität fortzusetzen, wenn ein Fehler für einen Datensatz in einer Batch-Anfrage auftritt. Wenn Fehler auftreten, werden diese im operation log protokolliert.
-
Save & Exit: Wenn aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.
-
Next: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie die Schaltfläche Fertig im letzten Schritt klicken.
-
Discard Changes: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.
Select existent topic
Wenn Select Existent Topic für Choose Topic ausgewählt ist, wird diese Schnittstelle angezeigt:
-
Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede Google Pub Sub Publish Message-Aktivität eindeutig sein und darf keine Schrägstriche
/
oder Doppelpunkte:
enthalten. -
Choose Subscription: Wählen Sie die Methode zur Bereitstellung des Themas, das in der Anfrage verwendet werden soll:
-
Inform Topic Manually: Wählen Sie, um das Thema manuell einzugeben, in dem die Nachrichten veröffentlicht werden sollen.
-
Select Existent Topic: Wählen Sie, um ein vorhandenes Thema aus einer gefüllten Liste auszuwählen. Um diese Option zu verwenden, müssen Sie die Berechtigung
pubsub.topics.list
dem Dienstkonto zugewiesen haben, das in der Google Pub Sub Verbindung angegeben ist.
-
-
Select a Topic: Dieser Abschnitt zeigt die in der Google Pub Sub-Endpunkt verfügbaren Themen an.
- Selected Topic: Nachdem ein Thema ausgewählt wurde, wird es hier aufgelistet.
-
Search: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Themen zu filtern. Die Suche ist nicht groß-/kleinschreibungsempfindlich. Wenn Themen bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse in Echtzeit mit jedem Tastendruck gefiltert. Um Themen beim Suchen vom Endpunkt neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann, wie unten beschrieben.
-
Refresh: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Themen vom Google Pub Sub-Endpunkt neu zu laden. Dies kann nützlich sein, wenn Themen zu Google Pub/Sub hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der in der Konfiguration angezeigten Themenliste verwendet werden.
-
Thema auswählen: Klicken Sie innerhalb der Tabelle auf eine Zeile, um ein Thema auszuwählen. Es kann nur ein Thema ausgewählt werden. Die Informationen zu jedem Thema werden von dem Google Pub Sub-Endpunkt abgerufen:
-
Name: Der Name des Themas.
-
Beschreibung: Die Beschreibung des Themas.
Hinweis
Wenn die Tabelle nicht mit verfügbaren Themen gefüllt wird, könnte die Google Pub Sub-Verbindung nicht erfolgreich sein. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldeinformationen erneut testen.
-
-
Bei Fehler fortfahren: Wählen Sie diese Option, um die Ausführung der Aktivität fortzusetzen, wenn ein Fehler für einen Datensatz in einer Batch-Anfrage auftritt. Wenn Fehler auftreten, werden diese im Betriebsprotokoll aufgezeichnet.
-
Speichern & Beenden: Wenn aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.
-
Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie die Schaltfläche Fertig im letzten Schritt klicken.
-
Änderungen verwerfen: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.
Schritt 2: Überprüfen der Datenschemas
Alle Anforderungs- oder Antwortschemas, die vom Endpunkt generiert werden, werden angezeigt. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.
-
Datenschemas: Diese Datenschemas werden von angrenzenden Transformationen übernommen und während der Transformationszuordnung erneut angezeigt.
Der Google Pub Sub-Connector verwendet die Google Pub/Sub API. Weitere Informationen zu den Schema-Knoten und -Feldern finden Sie in der API-Dokumentation.
Hinweis
Das Antwortschema für die Publish Message-Aktivität variiert je nach Konfiguration des in Schritt 1: Geben Sie einen Namen ein und wählen Sie ein Thema aus ausgewählten Themas. Wenn das ausgewählte Thema ein konfiguriertes Schema hat, enthält das Anforderungsschema einen
body
-Knoten mit der gleichen Struktur wie das konfigurierte Schema in Google Pub/Sub. Wenn das ausgewählte Thema kein konfiguriertes Schema hat, enthält das Anforderungsschema einbody
-Feld, das Zeichenfolgendaten akzeptiert (siehe oben). -
Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Schemas vom Google Pub Sub-Endpunkt neu zu generieren. Diese Aktion regeneriert auch ein Schema an anderen Stellen im Projekt, an denen dasselbe Schema referenziert wird, wie z. B. in einer angrenzenden Transformation.
-
Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.
-
Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.
-
Änderungen verwerfen: Nach Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.
Nächste Schritte
Nachdem Sie eine Google Pub Sub Nachricht veröffentlichen-Aktivität konfiguriert haben, vervollständigen Sie die Konfiguration des Vorgangs, indem Sie andere Aktivitäten oder Werkzeuge als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Betriebseinstellungen konfigurieren, die die Möglichkeit umfassen, Vorgänge zusammenzuführen, die sich in denselben oder unterschiedlichen Workflows befinden.
Menüaktionen für eine Aktivität sind im Projektbereich und auf der Entwurfsgrafik zugänglich. Für Details siehe Aktivitätsaktionsmenü in Connector-Grundlagen.
Google Pub Sub Nachricht veröffentlichen-Aktivitäten können als Ziel mit diesen Vorgangsmustern verwendet werden:
- Transformationsmuster
- Zwei-Transformationsmuster (als erstes oder zweites Ziel)
Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Ort und verwenden Sie dann diesen temporären Ort in der Skriptfunktion.
Wenn Sie bereit sind, bereitstellen und ausführen Sie den Vorgang und validieren Sie das Verhalten, indem Sie die Vorgangsprotokolle überprüfen.