Die Web-Auslöser der GitHub-Organisation werden verwendet, um eine GitHub-Organisation auf Ereignisse zu überwachen. Sobald das Ereignis in der Organisation eintritt, wird der Auslöser aktiviert und startet den Automatisierungs-Workflow.

Ordnen Sie Ihren Auslöser einer GitHub-Organisation zu und konfigurieren Sie den Auslöser so, dass die Automatisierung ausgeführt wird, wenn Ereignisse in der Organisation auftreten.

Die Web-Auslöser der GitHub-Organisation unterstützen die folgenden Ereignisse in einer Organisation:
  • Erstellen
  • Fork
  • Kommentar zum Problem
  • Probleme
  • Bezeichnung
  • Pull-Anfrage
  • Überprüfung von Pull-Anfragen
  • Push
  • Star
  • Ansehen

Zum Beispiel können Sie einen GitHub-Organisations-Web-Auslöser erstellen, um eine GitHub-Organisation auf Probleme zu überwachen. Wenn ein Problem in der überwachten Organisation entsteht, wird der Auslöser aktiviert und die nächsten Aktionen in der Automatisierung werden eingeleitet.

Vorbereitungen

  • Sie müssen über eine Bot Creator- oder Citizen Developer-Lizenz verfügen.
  • Sie müssen die Berechtigung Meine Bots anzeigen haben.
  • Sie müssen über alle EVENT TRIGGERS-Berechtigungen für die Rolle verfügen.
  • Sie müssen die Berechtigung Einchecken und Auschecken für die Ordner haben, in denen sich die Automatisierung befindet.
  • Sie müssen in Ihrem Control Room angemeldet sein.
  • Die GitHub-Web-Auslöser verwenden Personal Access Token, um die Identität des Nutzers zu authentifizieren. Der GitHub-Web-Auslöser unterstützt klassische und feinabgestimmte Zugriffstoken. Sie müssen ein Personal Access Token in den GitHub-Benutzereinstellungen generieren und es im Credential Vault speichern. Weitere Informationen zum Erstellen und Verwalten des Personal Access Token finden Sie im Abschnitt Personal Access Token verwalten.

Prozedur

  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: Sie können eine Beschreibung für den Bot im Feld Beschreibung hinzufügen.
  5. Optional: Sie können die Auswählen-Schaltfläche verwenden, um den Bot in einem anderen Ordner zu speichern.
  6. Klicken Sie auf Erstellen und bearbeiten.
    Der Bot ist erstellt und der Task Bot bearbeiten wird angezeigt.
  7. Klicken Sie auf Auslöser > GitHub und doppelklicken Sie dann auf Organisations-Web-Auslöser oder ziehen Sie ihn, um den Web-Auslöser zum Abschnitt Auslöser hinzuzufügen.
  8. Wählen Sie aus der Dropdown-Liste Auf Ereignis achten das oder die Ereignisse, auf die Sie achten möchten.
    Die folgenden Ereignisse werden unterstützt:
    • Erstellen
    • Fork
    • Kommentar zum Problem
    • Probleme
    • Bezeichnung
    • Pull-Anfrage
    • Überprüfung von Pull-Anfragen
    • Push
    • Star
    • Ansehen
  9. Geben Sie den GitHub-Organisationsnamen in das Feld Name der Organisation ein.
  10. Wählen Sie im Abschnitt Authentifizierungstyp auswählen eine der folgenden Optionen.
    Der Persönliche Zugriffstoken ist standardmäßig als Authentifizierungstyp unter Authentifizierungstyp wählen ausgewählt.
    • Anmeldedaten: Klicken Sie auf Auswählen, um den persönlichen Zugriffstoken auszuwählen, der bereits im Credential Vault konfiguriert ist.
    • Unsichere Zeichenfolge: Kopieren Sie die Zeichenfolge des persönlichen Zugriffstokens, die in den GitHub-Entwicklereinstellungen generiert wird, und fügen Sie sie ein.
      Anmerkung: Stellen Sie sicher, dass das persönliche Zugriffstoken nicht abgelaufen ist.
  11. Optional: Fügen Sie dem Auslöser in der Option Antwort Variablen hinzu. Weitere Informationen zu den Variablen finden Sie unter Übersicht über die Variablen.
    Anmerkung: Wenn Sie eine vorhandene Variable für die Antwort verwenden, achten SIe bitte darauf, dass das Kontrollkästchen Als Eingabe verwenden für die Variable aktiviert ist.
  12. Optional: Fügen Sie bei Bedarf weitere Auslöser im Abschnitt Auslöser hinzu.
  13. Doppelklicken Sie auf eine geeignete Aktion in der Palette Aktionen oder ziehen Sie sie in den Abschnitt Aktion.
    Weitere Informationen zu Aktionen finden Sie unter Aktionen zum Erstellen von Automatisierungen.
  14. Klicken Sie auf Speichern, um den Bot zu speichern.
Wenn Sie den Bot mit Mit Auslösern ausführen ausführen, wird der Web-Auslöser aktiviert und hört auf Fork-, Issues- und Label-Ereignisse. Wenn eines der Ereignisse in der Organisation eintritt, löst der Auslöser die nachfolgende Nachrichtenfeld-Aktion aus.