Jira Cloud-Trigger

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

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:

  • Connector-Administrator (roles/connectors.admin)

    • Weitere Informationen zum Zuweisen 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:

  • Application Integration Invoker (roles/integrations.integrationInvoker)

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

Jira Cloud-Trigger hinzufügen

Führen Sie die folgenden Schritte aus, um Ihrer Integration einen Jira Cloud-Trigger hinzuzufügen:

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

    Zu „Application Integration“

  2. Klicken Sie im Navigationsmenü auf Integrationen.

    Die Seite Integrationsliste wird angezeigt und enthält alle Integrationen, die im Google Cloud-Projekt verfügbar sind.

  3. Wählen Sie eine vorhandene Integration aus oder klicken Sie auf Integration erstellen, um eine neue zu erstellen.

    Wenn Sie eine neue Integration erstellen, gehen Sie so vor:

    1. Geben Sie im Bereich Integration erstellen einen Namen und eine Beschreibung ein.
    2. Wählen Sie eine Region für die Integration aus.
    3. Wählen Sie ein Dienstkonto für die Integration aus. Sie können die Dienstkontodetails einer Integration jederzeit im Bereich Integrationsübersicht in der Symbolleiste der Integration ändern oder aktualisieren.
    4. Klicken Sie auf Erstellen.

    Die neu erstellte Integration wird im 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 Element Jira Cloud-Trigger und platzieren Sie es im Integrationseditor.

    6. Wenn Sie den Jira Cloud-Trigger konfigurieren möchten, können Sie entweder eine vorhandene Jira Cloud-Verbindung verwenden, die in Integration Connectors verfügbar ist, oder eine neue Jira Cloud-Verbindung mit der Inline-Option zum Erstellen von Verbindungen 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. Der Jira Cloud-Trigger ist ein Connector-Ereignistrigger. Daher können Sie nur eine Jira Cloud-Verbindung mit aktivierter Ereignisregistrierung verwenden, um den Trigger zu 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.

So konfigurieren Sie einen Jira Cloud-Trigger mit einer vorhandenen Jira Cloud-Verbindung:

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

      In der Anwendungsintegration werden nur Jira Cloud-Verbindungen angezeigt, die aktiv sind und für die ein Ereignisabo aktiviert ist.

    3. Typ des Ereignisabos:Wählen Sie den Typ des Ereignisabos aus, der 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

So konfigurieren Sie den Jira Cloud-Trigger mit einer neuen Jira Cloud-Verbindung:

  1. Klicken Sie im Integrationseditor auf das Element Jira Cloud-Trigger, um den Bereich für die 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 die folgenden Schritte im Bereich Verbindung erstellen 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 Weiter.
    2. Geben Sie im Schritt Verbindungsdetails Details zur neuen Jira Cloud-Verbindung an:
      1. Connector-Version:Wählen Sie eine verfügbare Version des Jira Cloud-Connectors aus der Drop-down-Liste aus.
      2. Verbindungsname:Geben Sie einen Namen für die Jira Cloud-Verbindung ein.
      3. (Optional) Beschreibung : Geben Sie eine Beschreibung für die Verbindung ein.
      4. Optional: Cloud Logging aktivieren: Aktivieren Sie dieses Kästchen, 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 der Verbindung einbeziehen.
      7. Optional: Maximieren Sie Erweiterte Einstellungen, um die Einstellungen für den Verbindungsknoten zu konfigurieren.

        Weitere Informationen zu den Einstellungen für den Verbindungs-Knoten für Jira Cloud finden Sie in der Dokumentation 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 Weiter.
    3. Geben Sie im Schritt Ziele die Details zum Jira Cloud-Konto 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 Weiter.
    4. Geben Sie im Schritt Authentifizierung die Authentifizierungsdetails für das Jira Cloud-Konto an:
      1. Nutzername:Geben Sie den Nutzernamen für den Zugriff auf die angegebene Zieladresse ein.
      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.

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

      4. Klicken Sie auf Weiter.
    5. Geben Sie im Schritt Details zum Ereignisabo 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:Geben Sie den Nutzernamen für den Zugriff auf die angegebene Registrierungs-URL ein.
      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 Weiter.
    6. Überprüfen: Überprüfen Sie die angegebenen Jira Cloud-Verbindungsdetails.
    7. Klicken Sie auf Erstellen, um die neue Jira Cloud-Verbindung zu erstellen.
  6. Typ des Ereignisabos:Wählen Sie den Typ des Ereignisabos aus, der 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

Es dauert einige Minuten, bis der Jira Cloud-Trigger die Konfiguration des Ereignisabos abgeschlossen hat. Den Status Ihres Ereignisabos können Sie im Bereich „Triggerkonfiguration“ unter Details zum Ereignisabo einsehen.

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 erfolgreich für ein Ereignisabo registriert wurde.
  • Error: Gibt an, dass ein Problem mit dem konfigurierten Ereignisabo vorliegt.

Neben dem Status des Ereignisabos werden im Bereich Details zum Ereignisabo auch andere Details wie Verbindungsregion, Verbindungsname und Name des Ereignisabos angezeigt.

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

Bild: Bereich für die Konfiguration von Jira Cloud-Triggern Bild: Bereich für die Konfiguration von Jira Cloud-Triggern

Variable „Trigger-Ausgabe“

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

Ereignisabos ansehen

So rufen Sie alle Ereignisabos auf, die mit einer Verbindung in Integration Connectors verknüpft sind, und verwalten sie:

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

    Zur Seite „Verbindungen“

  2. Klicken Sie auf die Verbindung, für die Sie die Abos aufrufen möchten.
  3. Klicken Sie auf den Tab Event-Abos.

    Hier werden alle Ereignisabos für die Verbindung angezeigt.

Jira Cloud-Trigger bearbeiten

Sie können einen Jira Cloud-Trigger bearbeiten, um die Verbindungs- und Ereignisabonnements zu ändern oder zu aktualisieren.

So bearbeiten Sie einen Jira Cloud-Trigger:

  1. Klicken Sie im Integrationseditor auf das Element Jira Cloud-Trigger, um den Bereich für die Triggerkonfiguration zu öffnen.
  2. Klicken Sie auf Jira Cloud-Trigger konfigurieren.
  3. Führen Sie auf der Seite Connector Event Trigger Editor (Editor für Connector-Ereignistrigger) die folgenden Schritte aus:
    1. Wenn Sie das zuvor konfigurierte Ereignis-Abo beibehalten möchten, klicken Sie auf Beibehalten. Andernfalls klicken Sie auf Löschen.
    2. Aktualisieren Sie die Verbindungskonfiguration und die Details zum Ereignis-Abo nach Bedarf.
    3. Klicken Sie auf Fertig.

    4. Die aktualisierten Details zur Verbindung und zum Ereignisabo finden Sie im Bereich für die Triggerkonfiguration unter Details zum Ereignisabo.

Unterstützte Arten von Ereignisabos

Sie können den Jira Cloud-Trigger verwenden, um eine Integration für die folgenden Arten von Ereignisabonnements aufzurufen:

Arten von Ereignisabos Beschreibung
attachment_created Für ein Jira-Ticket wird ein Anhang erstellt.
attachment_deleted Der Anhang, der mit einem Jira-Vorgang verknüpft ist, wird gelöscht.
board_created Ein neues Jira-Board wird erstellt.
board_deleted Ein Jira-Board wird gelöscht.
comment_created Dem Jira-Vorgang wird ein Kommentar hinzugefügt.
comment_deleted Ein Kommentar in einem Jira-Vorgang wird gelöscht.
comment_updated Ein vorhandener Kommentar in einem Jira-Vorgang 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 neuer Jira-Vorgang wird erstellt.
issue_deleted Ein Jira-Vorgang wird gelöscht.
issue_updated Ein vorhandener Jira-Vorgang wird aktualisiert.
issuelink_created Für eine Jira-Instanz wird ein neuer Vorgangslink erstellt.
issuelink_deleted Der Link zum Problem für eine Jira-Instanz wird gelöscht.
option_issuelinks_changed Eine vorhandene Vorgangsverknüpfung für eine Jira-Instanz wird geändert oder aktualisiert.
option_subtasks_changed Die untergeordneten Aufgaben für ein Problem werden aktualisiert oder geändert.
option_voting_changed Die Anzahl der Stimmen für ein Jira-Vorgang wurde geändert.
option_watching_changed Die Beobachter oder die Liste der Nutzer, die zum Beobachten eines Jira-Vorgangs hinzugefügt wurden, haben sich geändert.
project_created Ein neues Projekt wird erstellt.
project_deleted Ein Projekt wird gelöscht.
project_restored_deleted Ein gelöschtes Projekt wird wiederhergestellt.
project_soft_deleted Ein Projekt wird so gelöscht, dass es für keinen Nutzer sichtbar ist, auch nicht für Administratoren, die entweder die Produktoberfläche oder die API verwenden.
project_updated Die Projektdetails werden aktualisiert.
sprint_closed Der Sprint ist abgeschlossen.
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 Arbeitslog-Eintrag wird hinzugefügt.
worklog_deleted Ein Arbeitslog-Eintrag wird gelöscht.
worklog_updated Ein Arbeitslogeintrag wird geändert oder aktualisiert.

Kontingente und Limits

Weitere Informationen zu allen Kontingenten und Limits finden Sie unter Kontingente und Limits.

Nächste Schritte