Note
Cette fonctionnalité est en accès anticipé et est uniquement disponible pour certains clients.
L'intégration de contrôle de version de Command connecte vos dépôts GitHub à Command by Asana, ce qui permet de synchroniser l'activité des pull requests avec vos tickets. Une fois que vous avez associé un dépôt et votre compte GitHub personnel, les statuts des tickets peuvent être mis à jour en fonction des événements liés aux demandes d'extraction (pull requests), les examinateurs peuvent recevoir des notifications dans leur boîte de réception et les commentaires peuvent être synchronisés entre GitHub et Command.
Configuration de l'intégration GitHub pour votre domaine
Un administrateur de domaine active les intégrations d'agents de codage pour l'ensemble de l'organisation.
- Passez en mode Command.
- Dans le panneau latéral, sélectionnez Administrateur. Cette option n'apparaît que pour les administrateurs de domaine.
- Cliquez sur Connecter à côté de GitHub.
- GitHub s'ouvre dans une fenêtre séparée. Sélectionnez l'organisation ou les dépôts dans lesquels vous installer l'application, puis cliquez sur Installer et autorisez la connexion.
- Retourner sur Asana. Une fois l'intégration du dépôt connectée, le bouton devient Déconnecter et les paramètres d'automatisation deviennent disponibles.
Configuration des comptes GitHub d'utilisateurs individuels
- Accédez aux paramètres de votre profil
- Passez à la section Applications
- Cliquez sur Connecter à côté de Compte GitHub personnel pour associer votre compte GitHub. Cette connexion associe les commentaires de GitHub à votre utilisateur du domaine Asana.
Configurer les règles d'automatisation
Après avoir connecté GitHub, configurez des règles d'automatisation qui mettent à jour les statuts des tickets en fonction des événements de demande d'extraction (pull request). Dans les paramètres de l'espace d'équipe, accédez à la section Intégrations, puis utilisez les menus déroulants Sélectionner pour choisir le statut du ticket pour chaque événement :
- Lorsqu'un brouillon de pull request est ouvert, mettez à jour le statut en le faisant passer à...
- Lorsqu'une pull request est ouverte, mettez à jour le statut en le faisant passer à...
- Lorsqu'une pull request fait l'objet d'une demande de révision ou d'une activité, mettre à jour le statut en le faisant passer à...
- Lorsqu'une pull request est prête à être fusionnée, mettez à jour le statut en le faisant passer à…
- Lorsqu'une demande d'extraction est fusionnée, mettez à jour le statut en le faisant passer à…
Par exemple, vous pouvez configurer une demande d'extraction ouverte pour faire passer un ticket au statut En cours de révision. Après la survenue d'un événement lié à une demande d'extraction, attendez quelques secondes pour que le statut du ticket et les informations relatives à la demande d'extraction associée soient mis à jour.
Lien entre les demandes d'extraction (pull requests) et les tickets
Il existe deux façons d'associer une demande d'extraction (pull request) à un ticket Command :
- Ajoutez l'identifiant du ticket au titre de la demande d'extraction (pull request). Incluez l'ID du ticket Command directement dans le titre, par exemple [CODE-620] Correction du bug de connexion.
- Utilisez un mot magique dans la description de la demande d'extraction. Ajoutez un mot-clé pris en charge suivi d'une ou de plusieurs URL ou ID de ticket. Les mots-clés pris en charge sont les suivants :
tâches, tâche, tickets, ticket, ref, refs, références, part of, related to, contributes to, toward et towards. Vous pouvez inclure plusieurs URL ou identifiants de tickets après un mot-clé pour associer la demande d'extraction à plusieurs tickets.
Après avoir créé la demande d'extraction, l'intégration l'associe au ticket et applique l'automatisation du statut configurée. Les réviseurs peuvent recevoir des notifications dans leur boîte de réception sur Asana, et les commentaires sont synchronisés entre GitHub et le ticket associé.
Affichage des demandes d'extraction (pull requests) associées
Les demandes d'extraction (pull requests) associées s'affichent dans la section Contrôle de version d'un ticket. Vous pouvez cliquer sur n'importe quelle demande d'extraction pour voir les détails du réviseur, le temps passé sur la révision, le statut actuel de la révision et les liens vers la demande d'extraction. Les statuts peuvent inclure Modifications demandées ou En attente.
Vous pouvez associer plusieurs requêtes de tirage à un ticket afin que votre équipe puisse suivre les modifications de code associées au même endroit.
Protection du statut en mode « uniquement vers l'avant »
L'intégration utilise une protection à progression uniquement pour les mises à jour de statut des tickets. Un événement GitHub peut faire avancer un ticket dans son processus, mais il ne peut pas le faire reculer une fois qu'un statut ultérieur a été atteint.
Par exemple, si un ticket est déjà en statut Révision en cours et que vous associez un brouillon de requête de tirage configuré pour faire passer les tickets au statut Non commencé, le ticket reste en statut Révision en cours. Le brouillon de demande d'extraction est toujours lié, mais le statut ne recule pas.
Les commentaires des demandes d'extraction (pull requests) associées apparaissent sur le ticket Command correspondant. Lorsque vous connectez votre compte GitHub personnel, vos commentaires GitHub sont attribués à votre utilisateur de domaine Asana.
Les commentaires synchronisés comprennent le texte du commentaire, le titre de la demande d'extraction (pull request) et les liens vers le commentaire et la demande d'extraction. Les commentaires de plusieurs demandes d'extraction (pull requests) associées peuvent apparaître sur le même ticket.
Agentic Work Management
Asana Service Management
Asana Client Management
Command by Asana
StackAI by Asana
