Utiliser Azure Boards dans Microsoft Teams

  • Article

Azure DevOps Services

Cet article explique comment utiliser les applications Azure Boards et Azure DevOps pour Microsoft Teams afin de créer et surveiller des éléments de travail Azure Boards à partir de vos canaux Teams.

Remarque

Cette fonctionnalité est disponible uniquement sur Azure DevOps Services. En règle générale, les nouvelles fonctionnalités sont introduites dans le service cloud en premier, puis mises à disposition localement dans la prochaine version principale ou mise à jour d’Azure DevOps Server. Pour plus d’informations, consultez Chronologie des fonctionnalités Azure DevOps.

À l’aide de l’application Azure Boards pour Microsoft Teams, vous pouvez :

  • Configurer et gérer les abonnements pour créer et gérer des éléments de travail et des événements d’élément de travail dans vos canaux Teams.
  • Créer des éléments de travail à partir de conversations dans un canal.
  • Rechercher et partager des éléments de travail avec d’autres canaux à l’aide de l’extension de messagerie.
  • Afficher des préversions des éléments de travail à partir d’URL.

Remarque

Les notifications Azure Boards ne sont pas prises en charge dans les conversations instantanées ou les messages directs Teams.

Dans cet article, vous apprendrez comment :

  • Ajouter l’application Azure Boards à votre équipe dans Microsoft Teams.
  • Lier votre projet Azure Boards à l’application Azure Boards.
  • Configurer des abonnements pour des événements d’élément de travail dans votre canal Teams.
  • Créer des éléments de travail à partir de votre canal Teams.
  • Surveiller l’activité des éléments de travail dans votre canal Teams.

Remarque

L’application Azure Boards pour Microsoft Teams n’est pas prise en charge pour les clients O365 Government Community Cloud (GCC) qui utilisent un abonnement Azure commercial en conjonction avec un locataire GCC.

Prérequis

  • Accès à une équipe et à un canal dans Microsoft Teams où vous pouvez installer une application.
  • Rôle d’administrateur du projet ou d’administrateur de l’équipe dans un projet Azure DevOps.
  • Accès aux applications tierces via OAuth activé dans les paramètres de l’organisation Azure DevOps.

Pour plus d’informations, consultez les ressources suivantes :

Ajouter l’application Azure Boards à Teams

Vous pouvez ajouter l’application Azure Boards à vos canaux Teams.

  1. Dans Microsoft Teams, sélectionnez Applications, recherchez Azure Boards, puis sélectionnez Azure Boards.

    Capture d’écran de la sélection d’« Applications », puis d’« Azure Boards ».

  2. Sélectionnez la flèche déroulante située en regard du bouton Ouvrir, puis sélectionnez Ajouter à une équipe.

    Capture d’écran de la sélection du bouton Ouvrir, puis de l’option Ajouter à une équipe.

  3. Sélectionnez ou entrez le nom de votre équipe, puis sélectionnez Configurer un bot.

    Capture d’écran de la sélection du bouton « Configurer un bot ».

Une fois l’application installée, un message de bienvenue s’affiche dans le volet de conversation Teams.

Capture d’écran du message de bienvenue dans le volet de conversation.

Commandes de l’application Azure Pipelines

Vous pouvez utiliser les commandes @azure boards suivantes pour interagir avec l’application Azure Boards dans votre canal Teams.

Commande Fonctionnalités
@azure boards sign in Se connecter à votre organisation Azure Boards.
@azure boards sign out Se déconnecter de votre organisation Azure Boards.
@azure boards link <url du projet> Lier un projet à ce canal pour créer des éléments de travail et recevoir des notifications.
@azure boards unlink Dissocier un projet de ce canal.
@azure boards subscriptions Ajouter ou supprimer des abonnements pour ce canal.
@azure boards addAreapath <chemin de zone> Ajouter un chemin de zone de votre projet à ce canal.
@azure boards feedback Signaler un problème ou suggérer une fonctionnalité.
@azure boards help Obtenir de l’aide sur les commandes.

Pour utiliser l’application, connectez-vous à Azure Boards et liez votre projet Azure Boards à votre canal Teams.

  1. Dans le volet de conversation Teams, entrez @azure boards signin.

  2. Sélectionnez Connexion et terminez l’authentification auprès d’Azure Boards. Sélectionnez Se connecter avec une autre adresse e-mail si vos clients Microsoft Teams et Azure Boards se trouvent dans différents locataires.

  3. Utilisez la commande @azure boards link pour créer un lien vers votre URL de projet Azure DevOps. Par exemple :

    @azure boards link https://dev.azure.com/myorg/myproject/

  4. Sélectionnez le bouton Ajouter un abonnement dans la notification de projet lié pour commencer à surveiller votre projet.

    Capture d’écran de la notification de projet lié avec le bouton Ajouter un abonnement.

Définir des abonnements

Une fois votre projet lié, commencez à surveiller les éléments de travail du projet en sélectionnant le bouton Ajouter un abonnement. Vous pouvez ajouter des abonnements supplémentaires à tout moment à l’aide de la commande @azure boards subscriptions.

  1. Sous Choisir un événement, sélectionnez l’événement auquel vous souhaitez vous abonner, puis cliquez sur Suivant.

    Capture d’écran illustrant la sélection de l’événement à surveiller.

  2. Sous Choisir des filtres, sélectionnez le chemin de zone, le type d’élément de travail et spécifiez éventuellement des balises ou une chaîne spécifique à laquelle appliquer un filtre, puis cliquez sur Confirmer.

    Capture d’écran de la configuration de l’abonnement.

Ajouter des chemins de zone

Les chemins de zone associés à des abonnements dans le canal, les chemins de zone récemment consultés et les chemins de zone que vous ajoutez à l’aide de la commande @azure boards addAreapath apparaissent dans le menu déroulant Chemin de zone lorsque vous créez un abonnement. Si le chemin de zone sur lequel votre équipe travaille ne figure pas dans le menu déroulant, vous pouvez l’ajouter manuellement afin qu’il soit toujours disponible pour la création d’éléments de travail et d’abonnements. Cette fonctionnalité est particulièrement utile pour les équipes avec plus de 100 chemins de zone dans leur projet.

Utilisez la commande @azure boards addAreapath pour ajouter des chemins de zone de votre projet au canal Teams. Par exemple :

@azure boards addAreapath 'VMdemo\Area4'

Vous recevez un message de confirmation.

Capture d’écran de l’ajout d’un chemin de zone et du message de confirmation.

Si vous choisissez le nom du projet comme chemin de zone, vous recevez des notifications pour tous les chemins de zone dans le projet.

Créer des éléments de travail

Depuis l’application Azure Boards, vous pouvez créer des éléments de travail directement à partir de votre canal à l’aide d’une action de message.

  1. Dans n’importe quel message du canal, sélectionnez les trois points Autres actions dans le volet des actions, puis sélectionnez Créer un élément de travail.

    Capture d’écran de la sélection d’un élément de travail dans le menu des actions supplémentaires.

  2. Sélectionnez le type d’événement de travail que vous souhaitez créer, puis sélectionnez Suivant.

  3. Saisissez un titre et sélectionnez un chemin de zone pour l’élément de travail.

  4. Le texte du message est utilisé comme description ou Étapes de reproduction de l’événement de travail selon le type d’élément de travail. Vous avez également la possibilité de modifier ce texte. Sélectionnez Créer.

    Capture d’écran de la configuration de l’élément de travail.

Le nouvel élément de travail apparaît dans Azure Boards et contient un lien vers l’élément Teams qui a généré l’élément de travail.

Capture d’écran du nouvel élément de travail dans Azure Boards.

Gérer les abonnements Azure Boards

Pour afficher, ajouter et supprimer des abonnements pour un canal, utilisez la commande @azure boards subscriptions. Cette commande répertorie tous les abonnements actuels pour le canal. Vous pouvez ajouter de nouveaux abonnements et supprimer des abonnements existants. Lorsque vous ajoutez un abonnement, vous pouvez personnaliser les notifications en appliquant des filtres.

Capture d’écran de la liste des abonnements.

Remarque

Les administrateurs d’équipe ne peuvent pas supprimer ou modifier les abonnements créés par les administrateurs de projet.

Utiliser l’extension compose

Pour vous aider à rechercher et à partager des éléments de travail, l’application Azure Boards pour Microsoft Teams prend en charge l’extension compose. Vous pouvez rechercher des éléments de travail par ID d’élément de travail, titre ou commande fonctionnelle prise en charge. Pour obtenir la liste des commandes prises en charge, consultez Recherche d’éléments de travail fonctionnels.

Pour utiliser l’extension compose, vous devez être connecté au projet Azure Boards dans le canal Teams. Sélectionnez le symbole + dans le champ de message, sélectionnez Azure Boards, puis recherchez un élément de travail. Vous pouvez également sélectionner Créer un élément de travail pour créer un élément de travail.

Capture d’écran montrant l’extension compose.

Afficher un aperçu des éléments de travail

Pour prendre en charge la collaboration sur des éléments de travail que vous avez abordés dans un canal, l’application Azure Boards affiche un aperçu des éléments de travail référencés. Lorsque vous collez l’URL d’un élément de travail ou sélectionnez un élément de travail à partir de l’extension compose, l’application affiche un aperçu similaire à l’image suivante. Cette fonctionnalité de déploiement d’URL fonctionne pour tous les canaux de l’équipe.

Capture d’écran montrant le déploiement de l’URL de l’élément de travail.

Un canal Teams ne peut lier qu’un seul projet Azure Boards à la fois. Pour créer un lien vers un autre projet, vous devez d’abord dissocier le projet actuel à l’aide de la commande @azure boards unlink.

La dissociation d’un projet supprime tous les abonnements du projet ainsi que les chemins de zone ajoutés du canal. Si le canal n’a pas d’abonnements, tout utilisateur peut dissocier un projet. Si le canal possède des abonnements, seuls les administrateurs de projet peuvent dissocier le projet.

Développer et réduire des fils de discussion

Dans un canal Teams, les publications d’un fil de discussion sont automatiquement réduites pour les regrouper de manière logique, réduisant ainsi l’encombrement visuel dans le canal. Toutes les réponses à une publication sont regroupées.

Pour développer le fil de discussion, cliquez sur le lien du fil réduit.

Capture d’écran montrant la vue réduite du fil.

Pour revenir au canal et réduire le fil de discussion, sélectionnez Accéder au canal.

Capture d’écran montrant la vue développée du fil.

Configurer des onglets Azure DevOps

Pour ajouter votre tableau de bord de projet ou votre tableau Kanban dans Teams, vous pouvez installer l’application Azure DevOps dans un onglet de votre canal Teams. L’application Azure DevOps vous permet d’insérer du contenu à partir de l’application dans des messages et de recevoir des notifications dans vos canaux.

  1. Dans Teams, sélectionnez le symbole + dans la navigation supérieure de votre canal ou sélectionnez Applications dans le menu de gauche.

  2. Recherchez l’application si nécessaire, puis sélectionnez Azure DevOps.

    Capture d’écran pour ajouter un nouvel onglet au canal Équipes.

  3. Sélectionnez votre organisation Azure DevOps Services, puis connectez-vous.

  4. Dans l’écran Azure DevOps , sélectionnez un projet et indiquez si vous souhaitez ajouter un tableau de bord ou un tableau Kanban à l’onglet. Sélectionnez d’autres configurations en fonction de votre choix, puis indiquez si vous souhaitez publier sur le canal pour signaler l’ajout de l’onglet.

    Capture d’écran montrant l’ajout d’un tableau de bord pour Azure DevOps dans Teams.

  5. Cliquez sur Enregistrer. Le nouvel onglet contenant le tableau de bord s’affiche dans votre canal.

Connecter différents locataires

Si vous utilisez différentes adresses e-mail ou différents locataire pour Microsoft Teams et Azure DevOps, procédez comme suit pour vous connecter en fonction de vos paramètres.

Microsoft Teams Azure DevOps Action de connexion
email1@abc.com (tenant1) email1@abc.com (tenant1) Sélectionnez Se connecter.
email1@abc.com (tenant1) email2@abc.com (tenant2) 1. Connectez-vous à Azure DevOps.
2. Dans le même navigateur, démarrez un nouvel onglet et accédez à https://teams.microsoft.com/.
3. Exécutez la sign in commande et sélectionnez Se connecter.
email1@abc.com (tenant1) email2@pqr.com (tenant2) 1. Sélectionnez Se connecter avec une autre adresse e-mail.
2. Dans le sélecteur d’ID d’e-mail, utilisez l’adresse e-mail2 pour vous connecter.
email1@abc.com (tenant1) email2@pqr.com (nondefault tenant3) Non pris en charge.

Résoudre les erreurs d’authentification

Si vous recevez l’erreur Échec de la configuration. Vérifiez que l’organisation ’{nom de l’organisation}’ existe et que vous disposez des autorisations nécessaires. Suivez les étapes décrites ci-dessous pour résoudre l’erreur.

  1. Dans le même navigateur, ouvrez un nouvel onglet et connectez-vous à https://teams.microsoft.com/.

  2. Dans cet onglet, accédez au canal où l’application Azure Boards pour Microsoft Teams est installée et exécutez la commande @azure boards signout, puis la commande @azure boards signin.

  3. Sélectionnez le bouton Se connecter, puis terminez le processus de connexion. Vérifiez que le répertoire affiché est identique à celui que vous avez choisi à l’étape précédente.

Si ces étapes ne résolvent pas votre problème d’authentification, contactez la Communauté des développeurs.