Konfigurieren Sie den GitHub Repository-Web-Auslöser, um eine Aktion auszulösen, sobald ein Ereignis in einem Repository auftritt. Dieses Beispiel zeigt, wie man mit einem Task Bot und einem GitHub-Repository-Web-Auslöser den Inhalt eines Pull-Anfrage in einem Nachrichtenfenster anzeigt.

Wenn der in den Einstellungen angegebene Nutzer eine Pull-Anfrage in diesem Repository 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 Repository-Web-Auslöser hinzuzufügen und zu konfigurieren.
    1. Klicken Sie auf Auslöser > GitHub und doppelklicken Sie anschließend auf Repository-Web-Auslöser, um den Web-Auslöser hinzuzufügen.
    2. Wählen Sie Pull-Anfrage aus der Dropdown-Liste Auf Ereignis achten aus.
    3. Geben Sie den Repository-Namen im Feld Repository-Name ein.
      Der Auslöser überwacht dieses Repository auf das Ereignis.
    4. Geben Sie den GitHub-Profilnamen in das Feld Nutzerprofil ein.
      Der Auslöser aktiviert die nachfolgende Aktion nur, wenn der Nutzer mit dem in diesem Feld angegebenen Profilnamen eine Pull-Anfrage erstellt oder erneut öffnet.
    5. Wählen Sie Personal Access Token > Anmeldeinformation aus und klicken Sie auf Auswählen.
    6. 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.
    7. 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 > Meldungsfeld und doppelklicken Sie dann auf Nachrichtenfeld oder ziehen Sie es, um die Aktion hinzuzufügen.
    2. Geben Sie einen passenden Titel für das Nachrichtenfeld in Fenstertitel des Nachrichtenfelds eingeben ein.
    3. Geben Sie $TriggerData{pull_request.body}$ in Anzuzeigende Nachricht eingeben ein.
      Der $TriggerData{pull_request.body}$-Schlüssel aus den Auslöser-Antwortdaten enthält den Text der Pull-Anfrage 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 Pull-Anfrage-Ereignisse im angegebenen GitHub-Repository zu hören. Wenn der Nutzer mit dem angegebenen Profilnamen in diesem Repository eine Pull-Anfrage erstellt oder wieder öffnet, löst der Auslöser die Nachrichtenfeld-Aktion aus. Das Nachrichtenfeld zeigt den Inhalt der Pull-Anfrage an.