Konfigurieren Sie GitHub-Organisation-Web-Auslöser, um eine Aktion auszulösen, wann immer ein Ereignis in der Organisation auftritt. Dieses Beispiel zeigt, wie man einen Task Bot mit GitHub Organisation-Web-Auslöser erstellt, um den Text eines Vorgangs in einem Nachrichtenfeld anzuzeigen.

Wenn der Eigentümer des im Einstellungen angegebenen Personal Access Token einen Vorfall in einem beliebigen Repository innerhalb der angegebenen GitHub-Organisation erstellt, löst der Auslöser die konfigurierte Nachrichtenfeld-Aktion aus.

Vorbereitungen

Sie müssen die folgenden Anforderungen erfüllen:
  • Lizenz und Berechtigungen, die in GitHub Web-Auslöser aufgeführt sind.
  • Ein aktives GitHub Personal Access Token, das als Anmeldeinformation in Ihrem Credential Vault gespeichert ist.
  • 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 Task Bot bearbeiten wird angezeigt.
  2. Führen Sie die folgenden Schritte aus, um den GitHub-Organisations-Auslöser hinzuzufügen und zu konfigurieren.
    1. Wählen Sie Auslöser > GitHub aus und doppelklicken Sie anschließend auf Organisations-Web-Auslöser, um den Web-Auslöser hinzuzufügen.
    2. Wählen Sie Vorfälle aus der Dropdown-Liste Auf Ereignis achten aus.
    3. Geben Sie den Organisationsnamen im Feld Name der Organisation ein.
      Der Auslöser überwacht diese Organisation auf das Ereignis.
    4. Wählen Sie Personal Access Token > Anmeldeinformation aus und klicken Sie auf Auswählen.
      Der Auslöser aktiviert die nachfolgende Aktion nur, wenn der Nutzer, dem dieses Personal Access Token gehört, den Vorfall erstellt.
    5. Folgen Sie den Anweisungen im Anmeldeinformation auswählen-Modalfenster und wählen Sie das Personal Access Token aus, das in dem Credential Vault gespeichert ist.
    6. Wählen Sie TriggerData im Dropdown-Menü Antwort aus.
      Diese Datensatzvariable erfasst die Auslöser-Antwortdaten zum Ereignis, bei dem die Änderung aufgetreten ist, im Format von Schlüssel-Wert-Paaren.
  3. Führen Sie die folgenden Schritte aus, um die Nachrichtenfeld-Aktion hinzuzufügen und zu konfigurieren.
    1. Klicken Sie auf Aktionen > Nachrichtenfeld, und fügen Sie die Nachrichtenfeld-Aktion hinzu.
    2. Geben Sie einen passenden Titel für das Nachrichtenfeld in Fenstertitel des Nachrichtenfelds eingeben ein.
    3. Geben Sie $TriggerData{issue.body}$ in Anzuzeigende Nachricht eingeben ein.
      Der issue.body-Schlüssel aus den Auslöser-Antwortdaten enthält den Text des erstellten Tickets als entsprechenden Wert.
  4. Klicken Sie auf Speichern, um die Konfiguration 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 Vorfall-Ereignisse in der angegebenen GitHub-Organisation zu hören. Wenn ein Nutzer ein Problem in einem beliebigen Repository innerhalb der Organisation erstellt, löst der Auslöser die Aktion Nachrichtenfeld aus. Das Nachrichtenfeld zeigt den Haupttext des erstellten Vorgangs an.