Informationen zu den unterstützten Connectors für Application Integration.

Jira Cloud-Trigger

Der Jira Cloud-Trigger ist ein Trigger für Connector-Ereignisse, mit dem Sie eine Integration basierend auf den Jira Cloud-Ereignissen aufrufen können, die Sie in Ihrer Jira Cloud-Verbindung abonniert haben.

Wichtig:Integration Connectors ist eine kostenpflichtige Komponente von Google Cloud. Informationen zu den Kosten und Gebühren für die Verwendung von Integration Connectors finden Sie unter Preise für Integration Connectors.

Hinweise

Wenn Sie eine neue Verbindung für den Jira Cloud-Trigger erstellen oder konfigurieren möchten, benötigen Sie die folgende IAM-Rolle für das Projekt:

• Connectors-Administrator (roles/connectors.admin)

Informationen zum Gewähren von Rollen finden Sie unter Zugriff verwalten.

Weisen Sie dem Dienstkonto, das Sie für den Jira Cloud-Trigger verwenden möchten, die folgenden IAM-Rollen zu:

• Aufrufer von Application Integration (roles/integrations.integrationInvoker)

Informationen zum Zuweisen von Rollen zu einem Dienstkonto finden Sie unter Zugriff auf Dienstkonten verwalten.

Jira Cloud-Trigger hinzufügen

Führe die folgenden Schritte aus, um deiner Integration einen Jira Cloud-Trigger hinzuzufügen:

1. Rufen Sie in der Google Cloud Console die Seite Application Integration auf.

   Zur Seite „Application Integration“

2. Klicken Sie im Navigationsmenü auf Integrationen.

   Die Seite Integrationsliste mit allen im Google Cloud-Projekt verfügbaren Integrationen wird angezeigt.

3. Wähle eine vorhandene Integration aus oder klicke auf Verknüpfung erstellen, um eine neue zu erstellen.

   Wenn Sie eine neue Integration erstellen:

   1. Geben Sie im Bereich Create Integration (Integration erstellen) einen Namen und eine Beschreibung ein.
   2. Wählen Sie eine Region für die Integration aus.
      Hinweis: Im Drop-down-Menü Regionen werden nur die in Ihrem Google Cloud-Projekt bereitgestellten Regionen aufgeführt. Klicken Sie zum Bereitstellen einer neuen Region auf Region aktivieren. Weitere Informationen finden Sie unter Neue Region aktivieren.
   3. Wählen Sie ein Dienstkonto für die Integration aus. Sie können die Dienstkontodetails einer Integration jederzeit in der Integrationsübersicht in der Integrationssymbolleiste ändern oder aktualisieren.
      Hinweis:Die Option zur Auswahl eines Dienstkontos wird nur angezeigt, wenn Sie die Integration Governance für die ausgewählte Region aktiviert haben.
   4. Klicken Sie auf Erstellen.

   Dadurch wird die Integration auf der Seite Integrationseditor geöffnet.

4. Klicken Sie in der Navigationsleiste des Integrationseditors auf Trigger, um die Liste der verfügbaren Trigger aufzurufen.
5. Klicken Sie auf das Jira Cloud-Trigger-Element und platzieren Sie es im Integrationseditor.

Zum Konfigurieren des Jira Cloud-Triggers können Sie entweder eine vorhandene Jira Cloud-Verbindung verwenden, die in Integration Connectors verfügbar ist, oder mit der Option zur Inline-Verbindungserstellung eine neue Jira Cloud-Verbindung erstellen.

Jira Cloud-Trigger mit einer vorhandenen Verbindung konfigurieren

Sie können den Jira Cloud-Trigger mit einer vorhandenen Jira Cloud-Verbindung in Integration Connectors konfigurieren. Hinweis: Der Jira Cloud-Trigger ist ein Trigger für Connector-Ereignisse. Sie können den Trigger daher nur über eine Jira Cloud-Verbindung mit aktiviertem Ereignisabo konfigurieren.

Informationen zum Konfigurieren eines Jira Cloud-Triggers mit einer neuen Jira Cloud-Verbindung finden Sie unter Jira Cloud-Trigger mit einer neuen Verbindung konfigurieren.

Führen Sie die folgenden Schritte aus, um einen Jira Cloud-Trigger mit einer vorhandenen Jira Cloud-Verbindung zu konfigurieren:

1. Klicken Sie im Integrationseditor auf das Element Jira Cloud-Trigger, um den Bereich zur Triggerkonfiguration zu öffnen.
2. Klicken Sie auf Trigger konfigurieren.
3. Geben Sie auf der Seite Editor für Connector-Ereignistrigger die folgenden Konfigurationsdetails an:
   1. Region: Wählen Sie die Region Ihrer Jira Cloud-Verbindung aus.
   2. Connection (Verbindung): Wählen Sie die Jira Cloud-Verbindung aus, die Sie verwenden möchten.

      Application Integration zeigt nur die Jira Cloud-Verbindungen an, die aktiv und für die ein Ereignisabo aktiviert ist.

   3. Ereignisabotyp:Wählen Sie den Typ des Ereignisabos aus, das die Integration auslöst. Informationen zu den unterstützten Ereignisabotypen für diesen Trigger finden Sie unter Unterstützte Ereignisabotypen.
   4. Dienstkonto: Wählen Sie ein Dienstkonto mit den erforderlichen IAM-Rollen für den Jira Cloud-Trigger aus.
4. Klicken Sie auf Fertig, um die Triggerkonfiguration abzuschließen und die Seite zu schließen.

Jira Cloud-Trigger mit einer neuen Verbindung konfigurieren

Führen Sie die folgenden Schritte aus, um den Jira Cloud-Trigger mit einer neuen Jira Cloud-Verbindung zu konfigurieren:

1. Klicken Sie im Integrationseditor auf das Element Jira Cloud-Trigger, um den Bereich zur Triggerkonfiguration zu öffnen.
2. Klicken Sie auf Trigger konfigurieren.
3. Überspringen Sie das Feld Region.
4. Klicken Sie auf Verbindung und wählen Sie im Drop-down-Menü die Option Verbindung erstellen aus.
5. Führen Sie im Bereich Create Connection (Verbindung erstellen) die folgenden Schritte aus:
   1. Wählen Sie im Schritt Standort den Standort für die neue Jira Cloud-Verbindung aus:
      1. Region:Wählen Sie eine Region aus der Drop-down-Liste aus.
      2. Klicken Sie auf Next (Weiter).
   2. Geben Sie im Schritt Verbindungsdetails Details zur neuen Jira Cloud-Verbindung an:
      1. Connector-Version:Wählen Sie in der Drop-down-Liste eine verfügbare Version des Jira Cloud-Connectors aus.
      2. Connection Name (Verbindungsname): Geben Sie einen Namen für die Jira Cloud-Verbindung ein.
         Hinweis: Verbindungsnamen müssen die folgenden Kriterien erfüllen:

         • Verbindungsnamen können Buchstaben, Ziffern oder Bindestriche enthalten.
         • Buchstaben müssen Kleinbuchstaben sein.
         • Verbindungsnamen müssen mit einem Buchstaben beginnen und mit einem Buchstaben oder einer Ziffer enden.
         • Verbindungsnamen dürfen maximal 63 Zeichen haben.
      3. Optional: Beschreibung : Geben Sie eine Beschreibung für die Verbindung ein.
      4. (Optional) Cloud Logging aktivieren: Klicken Sie dieses Kästchen an, um alle Logdaten der Verbindung zu speichern.
      5. Dienstkonto: Wählen Sie ein Dienstkonto mit den erforderlichen IAM-Rollen für die Jira Cloud-Verbindung aus.
      6. Ereignisabo aktivieren:Wählen Sie diese Option aus, um ein neues Ereignisabo für die Jira Cloud-Verbindung zu erstellen und zu aktivieren. Sie können entweder nur Ereignisabos aktivieren oder auch Entitäten, Vorgänge und Aktionen für die Verbindung einschließen.
         Hinweis: Die folgenden zusätzlichen Schritte zur Konfiguration der Verbindung sind erforderlich, wenn Sie Entitäten, Vorgänge und Aktionen für die Verbindung aktivieren:

         • Ziele
         • Authentifizierung
      7. Optional: Maximieren Sie Erweiterte Einstellungen, um die Einstellungen für Verbindungsknoten zu konfigurieren.

         Weitere Informationen zu den Einstellungen für Verbindungsknoten für Jira Cloud finden Sie in der Dokumentation zur Jira Cloud-Verbindung.

      8. Optional: Klicken Sie auf + Label hinzufügen, um der Verbindung ein Label in Form eines Schlüssel/Wert-Paars hinzuzufügen.
      9. Klicken Sie auf Next (Weiter).
   3. Geben Sie im Schritt Ziele die Jira Cloud-Kontodetails an:
      1. Zieltyp:Wählen Sie Hostadresse aus.
      2. Host:Geben Sie den Hostnamen oder die IP-Adresse Ihres Jira Cloud-Kontos ein.
      3. Klicken Sie auf Next (Weiter).
   4. Geben Sie im Schritt Authentifizierung die Authentifizierungsdetails für das Jira Cloud-Konto an:
      1. Nutzername: Geben Sie den Nutzernamen ein, um auf die angegebene Zieladresse zuzugreifen.
      2. API-Token:Wählen Sie das Secret Manager-Secret mit dem API-Token aus, das dem Jira Cloud-Nutzernamen zugeordnet ist.
      3. Secret-Version:Wählen Sie eine Secret-Version aus.

      Weitere Informationen zum Konfigurieren der Authentifizierung finden Sie unter Authentifizierung konfigurieren.

      4. Klicken Sie auf Next (Weiter).
   5. Geben Sie im Schritt Ereignisabodetails Details zum Jira Cloud-Konto an, in dem die Ereignisabos erstellt werden.
      1. Zieltyp:Wählen Sie Hostadresse aus.
      2. Host:Geben Sie die Registrierungs-URL Ihres Jira Cloud-Kontos ein. Für diese URL werden Ereignisabos erstellt.
      3. Nutzername:Gib den Nutzernamen ein, um auf die angegebene Registrierungs-URL zuzugreifen.
      4. API-Token:Wählen Sie das Secret Manager-Secret mit dem API-Token aus, das dem Nutzernamen zugeordnet ist.
      5. Secret-Version:Wählen Sie eine Secret-Version aus.
      6. Klicken Sie auf Next (Weiter).
   6. Überprüfung: Sehen Sie sich die bereitgestellten Jira Cloud-Verbindungsdetails an.
   7. Klicken Sie auf Create (Erstellen), um das Erstellen einer neuen Jira Cloud-Verbindung abzuschließen.
6. Ereignisabotyp:Wählen Sie den Typ des Ereignisabos aus, das die Integration auslöst. Informationen zu den unterstützten Ereignisabotypen für diesen Trigger finden Sie unter Unterstützte Ereignisabotypen.
7. Klicken Sie auf Fertig und schließen Sie die Seite.

Trigger-Ausgabe

Der Jira Cloud-Trigger dauert einige Minuten, um die Konfiguration des Ereignisabos abzuschließen. Sie können den Status Ihres Ereignisabos im Bereich für die Triggerkonfiguration unter Ereignisabodetails ansehen.

Der Jira Cloud-Trigger gibt den Status eines Ereignisabos mit den folgenden Status an:

• Creating: Gibt an, dass der Trigger das Ereignisabo abonniert.
• Active: Gibt an, dass der Trigger ein Ereignisabo abonniert hat.
• Error: Gibt an, dass ein Problem mit dem konfigurierten Ereignisabo vorliegt.

Neben dem Abostatus des Ereignisses werden im Abschnitt Ereignisabodetails auch weitere Details wie Verbindungsregion, Verbindungsname, Name des Ereignisabos und mehr angezeigt.

Die folgende Abbildung zeigt ein Beispiellayout des Konfigurationsbereichs für Jira Cloud-Trigger:

Trigger-Ausgabevariable

Der Jira Cloud-Trigger generiert für jedes Ereignis eine ConnectorEventPayload-Ausgabevariable, die Sie in nachgelagerten Aufgaben verwenden können. Die Ausgabevariable hat das JSON-Format, das das Ausgabeschema von Jira Cloud enthält.

Ereignisabos ansehen

So können Sie alle Ereignisabos aufrufen und verwalten, die mit einer Verbindung in Integration Connectors verknüpft sind:

1. Rufen Sie die Seite Integration Connectors > Verbindungen auf.

   Zur Seite „Verbindungen“

2. Klicken Sie auf die Verbindung, deren Abos Sie sich ansehen möchten.
3. Klicken Sie auf den Tab Ereignisabos.

   Dadurch werden alle Ereignisabos für die Verbindung angezeigt.

Jira Cloud-Trigger bearbeiten

Sie können einen Jira Cloud-Trigger bearbeiten, um die Verbindungskonfiguration und die Details des Ereignisabos zu ändern oder zu aktualisieren.

Wichtig:Wenn Sie einen Jira Cloud-Trigger bearbeiten oder ändern, können Sie entweder das zuvor konfigurierte Ereignisabo beibehalten, das mit dem Trigger verknüpft ist, oder es löschen. Wenn Sie ein Ereignisabo löschen, wirkt sich das auf alle veröffentlichten Integrationen aus, für die dieses Ereignisabo verwendet wird.

Führen Sie die folgenden Schritte aus, um einen Jira Cloud-Trigger zu bearbeiten:

1. Klicken Sie im Integrationseditor auf das Element Jira Cloud-Trigger, um den Bereich zur Triggerkonfiguration zu öffnen.
2. Klicken Sie auf Jira Cloud-Trigger konfigurieren.
3. Gehen Sie auf der Seite Editor für Connector-Ereignistrigger so vor:
   1. Wenn Sie das zuvor konfigurierte Ereignisabo beibehalten möchten, klicken Sie auf Beibehalten oder auf Löschen.
      Warnung:Wenn Sie ein Ereignisabo löschen, wirkt sich das auf alle veröffentlichten Integrationen aus, für die das Ereignisabo verwendet wird. Diese Aufgabe kann nicht rückgängig gemacht werden.
   2. Aktualisieren Sie die Verbindungskonfiguration und die Details zum Ereignisabo nach Bedarf.
   3. Klicken Sie auf Fertig.

Die aktualisierten Details zu Verbindung und Ereignisabo finden Sie im Triggerkonfigurationsbereich unter Ereignisabodetails.

Unterstützte Ereignisabotypen

Mit dem Jira Cloud-Trigger können Sie eine Integration für die folgenden Ereignisabotypen aufrufen:

Abotypen für Ereignisse	Beschreibung
attachment_created	Für ein Jira-Ticket wird ein Anhang erstellt.
attachment_deleted	Der mit einem Jira-Ticket verknüpfte Anhang wird gelöscht.
board_created	Ein neues Jira-Board wird erstellt.
board_deleted	Ein Jira-Board wird gelöscht.
comment_created	Dem Jira-Ticket wird ein Kommentar hinzugefügt.
comment_deleted	Ein Kommentar in einem Jira-Ticket wird gelöscht.
comment_updated	Ein vorhandener Kommentar in einem Jira-Ticket wird aktualisiert.
filter_created	Ein neuer Jira-Filter wird erstellt.
filter_deleted	Ein Jira-Filter wird gelöscht.
filter_updated	Ein vorhandener Jira-Filter wird aktualisiert.
issue_created	Ein neues Jira-Problem wird erstellt.
issue_deleted	Ein Jira-Problem wurde gelöscht.
issue_updated	Ein vorhandenes Jira-Problem wird aktualisiert.
issuelink_created	Für eine Jira-Instanz wird ein neuer Problemlink erstellt.
issuelink_deleted	Der Problemlink für eine Jira-Instanz wird gelöscht.
option_issuelinks_changed	Ein vorhandener Problemlink für eine Jira-Instanz wird geändert oder aktualisiert.
option_subtasks_changed	Die Unteraufgaben für ein Problem werden aktualisiert oder geändert.
option_voting_changed	Die Anzahl der Stimmen für ein Jira-Problem wurde geändert.
option_watching_changed	Die Watchers oder die Liste der Nutzer, die zum Beobachten eines Jira-Problems hinzugefügt wurden, haben sich geändert.
project_created	Ein neues Projekt wird erstellt.
project_deleted	Ein Projekt wurde gelöscht.
project_restored_deleted	Ein gelöschtes Projekt wird wiederhergestellt.
project_soft_deleted	Ein Projekt wird gelöscht, sodass es für keine Nutzer sichtbar ist, auch nicht für Administratoren, die die Produktoberfläche oder die API verwenden.
project_updated	Die Projektdetails werden aktualisiert.
sprint_closed	Der Sprint ist beendet.
sprint_created	Ein Sprint wird erstellt.
sprint_deleted	Ein Sprint wird gelöscht.
sprint_updated	Die Details eines Sprints werden geändert oder aktualisiert.
user_created	Ein Nutzer wird erstellt.
user_updated	Die Details eines Nutzers werden geändert oder aktualisiert.
worklog_created	Ein Arbeitslogeintrag wird hinzugefügt.
worklog_deleted	Ein Arbeitslogeintrag wird gelöscht.
worklog_updated	Ein Arbeitsprotokolleintrag wird geändert oder aktualisiert.