GitHubDéclencheur Web de l\'organisation

Les déclencheurs web de l\'organisation GitHub sont utilisés pour surveiller une organisation GitHub pour des événements. Une fois que l\'événement se produit dans l\'organisation, le déclencheur est activé et lance le flux de travail automatisé.

Mappez votre déclencheur à une organisation GitHub et configurez le déclencheur pour exécuter l\'automatisation lorsque des événements se produisent dans l\'organisation.

L\'activation web de l\'organisation GitHub prend en charge les événements suivants dans une organisation :
  • Créer
  • Dupliquer
  • Commentaire sur le problème
  • Problèmes
  • Étiquette
  • Demande de tirage
  • Examen de la demande de tirage
  • Pousser
  • Favori
  • Regarder

Par exemple, créez un déclencheur web d\'organisation GitHub pour surveiller une organisation GitHub afin de détecter des problèmes. Lorsqu\'un problème est créé dans l\'organisation surveillée, le déclencheur est activé et les actions suivantes dans l\'automatisation sont lancées.

Prérequis

  • Vous devez disposer d\'une licence Bot Creator ou Développeur citoyen.
  • Vous devez disposer de l\'autorisation Afficher mes robots.
  • Vous devez disposer de toutes les autorisations EVENT TRIGGERS pour le rôle.
  • Vous devez disposer des autorisations Archiver et Extraire sur les dossiers où se trouve l\'automatisation.
  • Vous devez être connecté à votre Control Room.
  • Les déclencheurs web GitHub utilisent le Jeton d\'accès personnel pour authentifier l\'identité de l\'utilisateur. Le déclencheur web GitHub prend en charge les jetons d\'accès classiques et à granularité fine. Assurez-vous de générer un jeton d\'accès personnel dans les paramètres GitHub utilisateur et de le stocker dans le Credential Vault. Pour plus d\'informations sur la création et la gestion du Personal Access Token, consultez la section Gestion de vos jetons d\'accès personnel.

Procédure

  1. Dans le volet de gauche, cliquez sur Automatisation.
  2. Cliquez Créer > Bot de tâche.
    L\'assistant Create Task Bot est affiché.
  3. Saisissez un nom approprié pour le robot dans le champ Nom.
    Tous les robots sont stockés dans le dossier \Bots par défaut.
  4. Facultatif : Vous pouvez ajouter une description pour le robot dans le champ Description.
  5. Facultatif : Vous pouvez utiliser le bouton Choisir pour enregistrer le robot dans un dossier différent.
  6. Cliquez sur Créer et modifier.
    Le robot est créé et le Edit Task Bot est affiché.
  7. Cliquez sur Déclencheurs > GitHub, puis double-cliquez ou faites glisser Déclencheur Web d\'organisation pour ajouter le déclencheur Web à la section Déclencheurs.
  8. Sélectionnez un ou plusieurs événements à écouter dans la liste déroulante Écouter l\'événement.
    Les événements suivants sont pris en charge :
    • Créer
    • Dupliquer
    • Commentaire sur le problème
    • Problèmes
    • Étiquette
    • Demande de tirage
    • Examen de la demande de tirage
    • Pousser
    • Favori
    • Regarder
  9. Saisissez le nom de l\'organisation GitHub dans le champ Nom de l\'organisation.
  10. Sélectionnez l\'une des options suivantes dans la section Sélectionnez le type d\'authentification.
    Le Jeton d\'accès personnel est sélectionné comme type d\'authentification dans Sélectionner le type d\'authentification par défaut.
    • Informations d\'identification : Cliquez sur Choisir pour sélectionner Jeton d\'accès personnel déjà configuré dans le Credential Vault.
    • Chaîne non sécurisée : Copiez et collez la chaîne du jeton d\'accès personnel générée dans GitHub les paramètres du développeur.
      Remarque : Assurez-vous que le jeton d\'accès personnel n\'a pas expiré.
  11. Facultatif : Ajoutez des variables au déclencheur dans l\'option Réponse. Pour plus d\'informations sur les variables, consultez la rubrique Aperçu des variables.
    Remarque : Si vous utilisez une variable existante pour la réponse, assurez-vous que la case à cocher Utiliser comme entrée est activée pour la variable.
  12. Facultatif : Ajoutez d\'autres déclencheurs selon les besoins dans la section Déclencheurs.
  13. Double-cliquez ou faites glisser une action appropriée de la palette Actions vers la section Action.
    Pour plus d\'informations sur les actions, consultez Actions permettant de créer des automatisations.
  14. Cliquez sur Enregistrer pour enregistrer le robot.
Lorsque vous exécutez le robot en utilisant Exécuter avec déclencheurs, le déclencheur web est activé et écoute les événements Fork, Issues, et Label. Lorsqu\'un des événements se produit dans l\'organisation, le déclencheur initie l\'action Zone de message suivante.