Vous utilisez notre intégration GitHub pour synchroniser le travail entre GitHub et ClickUp ? Ajoutez des Automations GitHub pour créer un flux de travail efficace. Les équipes de développement peuvent réduire les changements de contexte grâce aux Automations pour tout garder à jour.

Les intégrations d'Automation sont disponibles à partir des plans Business et supérieurs.

L'administrateur ou le propriétaire de l'Environnement de travail doit activer le ClickApp Automation.

Vous devez disposer des droits d'administrateur sur le dépôt GitHub pour configurer des Automations.

Les Invités et les membres limités ne peuvent pas utiliser l'intégration GitHub.

Créer une Automation GitHub dans ClickUp

Pour configurer une Automation GitHub, depuis une Liste, un sous-dossier, un Dossier ou un Espace :

1. En haut à droite, cliquez sur l'icône robot.
2. Cliquez sur Créer une Automation :
   • Sélectionnez un déclencheur ou une action GitHub.
   • Ou, depuis la barre latérale gauche, cliquez sur GitHub et sélectionnez un modèle d'Automation.
3. Configurez votre déclencheur, vos conditions et vos actions.
   • Sélectionnez ou connectez votre compte GitHub.
   • Saisissez votre nom d'utilisateur GitHub, cliquez sur Connecter le compte et autorisez ClickUp.
   • Ou cliquez sur Créer un compte pour créer un nouveau compte sur GitHub.com.
   • Pour mettre à jour un compte GitHub précédemment autorisé, vous devez le retirer et le rajouter.
   • Retirer un compte n'affecte pas les Automations existantes qui utilisent ce compte. Vous devrez le rajouter pour créer des Automations GitHub par la suite.
   • Indiquez qui peut utiliser votre compte GitHub pour créer des Automations.
   • Chaque Automation GitHub vous permet de choisir un dépôt spécifique (repo).
4. Cliquez sur Créer.

Automations GitHub

Les Automations GitHub utilisent la même structure que les Automations dans ClickUp.

Chaque Automation se compose d'un déclencheur et d'une action. Les utilisateurs disposant d'un plan Business et supérieurs peuvent également utiliser des conditions.

Déclencheurs GitHub

Lorsque les événements suivants se produisent dans le dépôt GitHub spécifié et que les conditions sont remplies, l'Automation s'exécute et effectue une action.

• Pull Request fusionnée
• Branche fusionnée
• Au commit
• Révision de Pull Request créée
• Révision de Pull Request mise à jour
• Statut CI/CD modifié
• Pull Request liée
• Branche liée
• Commit lié

Conditions GitHub

Les Automations GitHub liées aux pull requests prennent en charge une ou plusieurs conditions.

Par exemple, vous pouvez mettre à jour le statut de la tâche lorsqu'une pull request vers la branche main est liée. Ou définir la priorité de la tâche comme urgente et ajouter un commentaire lorsqu'une pull request portant le libellé hotfix est fusionnée dans la branche QA.

Les conditions peuvent être définies pour plusieurs combinaisons de libellés de pull request, de valeurs de base ref et de head ref.

Logique des conditions

Vous pouvez utiliser la logique de condition suivante :

• est l'un des : La pull request inclut au moins l'un des libellés ou branches spécifiés.
• est tous les : La pull request inclut tous les libellés ou branches spécifiés.
• n'est aucun des : La pull request n'inclut aucun des libellés ou branches spécifiés.
• n'est pas tous les : La pull request n'inclut pas tous les libellés ou branches spécifiés.

Pour les libellés, vous pouvez utiliser la logique ci-dessus ainsi que :

• est défini : Au moins un libellé a été appliqué à la pull request.
• n'est pas défini : Aucun libellé n'a été appliqué à la pull request.

Ajouter une condition

Pour ajouter une condition à votre Automation GitHub :

1. Depuis une Automation, sous la section Déclencheur, cliquez sur Ajouter une condition.
2. Sélectionnez à quoi la condition doit s'appliquer :
   • Condition de libellé GitHub : libellés appliqués à la pull request.
   • Head ref : la branche source contenant vos modifications proposées.
   • Base ref : la branche cible sur laquelle vos modifications seront appliquées.
3. Sélectionnez la logique de condition.
4. Choisissez la valeur de libellé ou de branche à utiliser avec cette condition. Les conditions sont sensibles à la casse et doivent correspondre exactement au nom du libellé ou de la branche, sans quoi les critères ne seront pas remplis et l'Automation ne se déclenchera pas.
5. Cliquez sur Ajouter un autre pour inclure une valeur de libellé ou de branche supplémentaire.
6. Cliquez sur Ajouter une condition pour ajouter plusieurs conditions.

Actions ClickUp

Toutes les actions d'Automation, à l'exception de l'action Webhook, sont disponibles pour mettre à jour des tâches via des déclencheurs GitHub.

Pour que des actions d'Automation s'appliquent à des tâches existantes, la tâche doit déjà être liée au dépôt GitHub par l'association d'un commit, d'une branche ou d'une pull request. L'action Créer une tâche est la seule exception, car les nouvelles tâches ne peuvent pas être liées à l'avance.

Actions dans GitHub

Vous pouvez utiliser des Automations avec l'action Créer un ticket, qui crée un nouveau ticket dans GitHub.

Par exemple, lorsqu'un formulaire de signalement de bug est soumis et crée une tâche dans une Liste spécifique, une Automation peut créer un ticket dans GitHub.