Konfigurieren Sie einen Jira-Web-Auslöser, um eine Aktion auszulösen, wann immer ein Ereignis im Jira-Projekt auftritt. Dieses Beispiel zeigt, wie Sie einen Task Bot mit einem Jira-Web-Auslöser erstellen, um eine E-Mail an ein Microsoft 365 Outlook-Postfach zu senden, wenn der angegebene Nutzer ein Ticket im angegebenen Jira-Projekt erstellt.

Der Jira-Web-Auslöser überwacht ein Jira-Projekt mit dem Namen ABC auf neue Vorgänge (Vorgang erstellt-Ereignis), die ein Nutzer namens XYZ erstellt. Wenn der Nutzer ein Problem erstellt, löst der Auslöser die nachfolgenden Microsoft 365 Outlook-Aktionen aus, die eine E-Mail an das Postfach Microsoft 365 Outlook senden. Diese E-Mail enthält die Jira-Zusammenfassung und Beschreibung mit der Jira-Problem-ID als Betreff.

Vorbereitungen

Vergewissern Sie sich, dass Sie die folgenden Voraussetzungen erfüllen:
  • Voraussetzungen, die in Jira-Web-Auslöser-Voraussetzung erwähnt werden.
  • Jira Client-Geheimnis und Microsoft 365-Nutzername sind im Credential Vault gespeichert.
  • Eine OAuth-Verbindung für die Jira-Instanz, in der das Projekt verfügbar ist, und das Microsoft 365 Outlook-Konto.
  • Eine Datensatzvariable mit dem Namen TriggerData.

Prozedur

  1. Führen Sie die folgenden Schritte aus, um einen Task Bot zu erstellen:
    1. Klicken Sie im linken Fensterbereich auf Automatisierung.
    2. Klicken Sie auf Erstellen > Task Bot.
      Der Assistent Task Bot erstellen wird angezeigt.
    3. Geben Sie einen geeigneten Namen für den Bot in das Feld Name ein.
      Alle Bots werden standardmäßig im Ordner <\Bots> gespeichert.
    4. Optional: Fügen Sie eine Beschreibung für den Bot im Feld Beschreibung hinzu.
    5. Optional: Klicken Sie auf Auswählen und folgen Sie den Anweisungen, um den Bot in einem anderen Ordner zu speichern.
    6. Klicken Sie auf Erstellen und bearbeiten.
      Der Bot ist erstellt und die Seite Bot-Editor wird angezeigt.
  2. Führen Sie die folgenden Schritte aus, um den Jira-Web-Auslöser hinzuzufügen und zu konfigurieren.
    1. Klicken Sie auf Auslöser > Jira und doppelklicken Sie dann auf Web-Auslöser oder ziehen Sie ihn, um den Web-Auslöser zum Abschnitt Auslöser hinzuzufügen.
    2. Wählen Sie Vorfall erstellt aus der Dropdown-Liste Auf Ereignis achten aus.
    3. Konfigurieren Sie die Ereignisfilterkriterien in Filterkriterien mit einer der folgenden Optionen:
      • Abfrage: Geben Sie die folgende JQL-Abfrage ein project= "ABC" AND reporter= "XYZ".
      • Bedingung: Führen Sie die folgenden Schritte aus, um mit dem Bedingungseditor eine Filterbedingung zu erstellen.
        1. Wählen Sie UND > Bedingung hinzufügen.
        2. Konfigurieren Sie die erste Bedingung mit ID als Bedingungstyp, Gleich als Operation auswählen und ABC als Wert.
        3. Klicken Sie auf Hinzufügen, um die Bedingung hinzuzufügen.
        4. Klicken Sie auf Bedingung hinzufügen.
        5. Konfigurieren Sie die zweite Bedingung mit Reporter als Bedingungstyp, Gleich als Operation auswählen und XYZ als Wert.
        6. Klicken Sie auf Hinzufügen, um die zweite Bedingung hinzuzufügen.
      Siehe den Abschnitt Filterkriterien (optional) in Jira-Web-Auslöser, um mehr darüber zu erfahren, wie Filterkriterien erstellt werden.
    4. Klicken Sie auf Auswählen, um die vorkonfigurierte OAuth-Verbindung aus dem Modalfenster OAuth-Verbindung auswählen auszuwählen.
    5. Wählen Sie Clientgeheimnis zur Überprüfung des empfangenen Ereignisses > Anmeldeinformationen > Auswählen und folgen Sie den Anweisungen im Modal Anmeldeinformation auswählen, um das Jira Clientgeheimnis auszuwählen, das im Credential Vault verfügbar ist.
    6. Wählen Sie die Option TriggerData in der Dropdown-Liste Antwort (optional) aus.
      Diese Datensatzvariable erfasst die Auslöser-Antwortdaten. Die Auslöser-Antwortdaten enthalten alle Informationen über das Ereignis, bei dem die Änderung aufgetreten ist, im Format von Schlüssel-Wert-Paaren.
  3. Führen Sie die folgenden Schritte aus, um die Microsoft 365 Outlook Connect-Aktion hinzuzufügen und zu konfigurieren.
    1. Klicken Sie auf Aktionen > Microsoft 365 Outlook und doppelklicken Sie dann auf die Aktion Verbinden oder ziehen Sie sie, um sie zum Abschnitt Aktionen hinzuzufügen.
    2. Azure Cloud: Wählen Sie Azure Global.
      Wenn Sie eine Microsoft 365 Outlook Government-Version haben, wählen Sie Azure US GCC High.
    3. Wählen Sie Control Room verwaltet aus der Dropdown-Liste OAuth2-Authentifizierungsmodus aus.
    4. Klicken Sie auf Auswählen in Verbindung und folgen Sie den Anweisungen im OAuth-Verbindung auswählen-Modal, um die OAuth-Verbindung für das Microsoft 365 Outlook-Konto auszuwählen.
    5. Klicken Sie auf Anmeldeinformation > Auswählen in Nutzername und folgen Sie den Anweisungen im Modal Anmeldeinformation auswählen, um den Microsoft 365-Nutzernamen auszuwählen.
    6. Optional: Geben Sie einen passenden Sitzungsnamen in Microsoft 365 Outlook-Sitzung erstellen ein.
      Das System legt Microsoft365OutlookSession standardmäßig als Sitzungsnamen fest.
  4. Führen Sie die folgenden Schritte aus, um die Microsoft 365 Outlook Senden-Aktion hinzuzufügen und zu konfigurieren.
    1. Klicken Sie auf Aktionen > Microsoft 365 Outlook und doppelklicken Sie dann auf die Aktion Senden oder ziehen Sie sie, um sie zum Abschnitt Aktionen hinzuzufügen.
    2. Geben Sie den Sitzungsnamen ein, den Sie bei der Konfiguration der Aktion Verbinden eingegeben haben.
      Wenn der Standardname beibehalten wird, trägt das System Microsoft365OutlookSession als Microsoft 365 Outlook session ein.
    3. Geben Sie die E-Mail-ID ein, an die das System die Jira-Details in Empfänger weiterleiten soll.
    4. Geben Sie $TriggerData{"issue.key"}$ in Betreff ein.
      Der Jira-Vorgangsschlüssel ist als Betreff der E-Mail festgelegt.
    5. Wählen Sie HTML-Code aus und geben Sie Summary - $TriggerData{"issue.fields.summary"}$ Beschreibung: $TriggerData{"issue.fields.description"}$ in E-Mail-Body-Typ.
      Die Jira-Zusammenfassung und Beschreibung wird als Inhalt der E-Mail festgelegt.
  5. Klicken Sie auf Speichern, um die Automatisierung zu speichern.
Wenn Sie auf Ausführen > Mit Auslösern ausführen klicken, aktiviert das System den Auslöser und der Auslöser beginnt, auf das Ereignis Vorgang erstellt im überwachten Jira-Projekt zu hören. Wenn der Nutzer XYZ ein neues Problem im Jira-Projekt ABC erstellt, startet der Auslöser die konfigurierten Aktionen. Das Microsoft 365 Outlook-Postfach erhält eine E-Mail mit der Jira-Zusammenfassung und Beschreibung, wobei Jira die Vorgangs-ID als Betreff ist.