Utiliser l’application Azure Boards dans Microsoft Teams

  • Article

Azure DevOps Services

Si vous utilisez Microsoft Teams, vous pouvez créer des éléments de travail et surveiller l’activité des éléments de travail dans votre projet Azure Boards à partir de votre canal Teams. Pour ce faire, ajoutez l’application Azure Boards pour Microsoft Teams à votre canal Teams.

L’application Azure Boards pour Microsoft Teams permet aux utilisateurs d’effectuer les tâches suivantes :

  • Configurer et gérer des abonnements pour créer et mettre à jour des éléments de travail
  • Gérer d’autres événements d’élément de travail
  • Recevoir et gérer des notifications pour des événements d’élément de travail dans leur canal Teams
  • Créer des éléments de travail à partir de conversations dans le canal
  • Rechercher et partager des éléments de travail avec d’autres membres du canal à l’aide de l’extension de messagerie
  • Affichez des préversions des éléments de travail à partir de leurs URL pour démarrer des discussions et garder des conversations contextuelles.

Image : Notification

Lisez cet article pour découvrir comment :

  • Ajouter l’application Azure Boards à votre équipe dans Microsoft Teams
  • Lier et dissocier votre projet Azure Boards pour l’application Azure Boards
  • Configurer des abonnements pour des événements liés aux éléments 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

Notes

L’intégration Azure Boards et Microsoft Teams n’est prise en charge que pour Azure DevOps Services.

De plus, l’intégration Azure Boards et Microsoft Teams n’est pas prise en charge si vous êtes un client O365 Government Community Cloud (GCC) qui utilise un abonnement Azure commercial en conjonction avec votre locataire GCC.

Prérequis

Notes

  • Vous pouvez uniquement lier l’application Azure Boards pour Microsoft Teams à un projet hébergé sur Azure DevOps Services pour le moment.
  • Les notifications ne sont actuellement pas prises en charge dans les messages directs.
  • Seuls les canaux publics sont pris en charge.

Ajouter l’application Azure Boards à Microsoft Teams

Vous ajoutez l’application à votre canal Teams dans Microsoft Teams.

  1. Visitez la boutique d’applications dans Microsoft Teams et recherchez l’application Azure Boards. Lors de l’installation, un message de bienvenue de l’application s’affiche comme illustré dans l’image suivante.

    Image : Message de bienvenue

  2. Utilisez le descripteur @azure boards pour interagir avec l’application. Pour obtenir la liste des commandes, consultez la Référence sur les commandes fournie plus loin dans cet article.

Pour utiliser l’application, vous devez d’abord lier votre projet Azure Boards à votre canal Teams.

  1. Une fois l’application installée dans votre équipe, connectez-vous et authentifiez-vous auprès d’Azure Boards. Si vos clients Microsoft Teams et Azure Boards se trouvent dans différents locataires, sélectionnez Se connecter avec un e-mail différent.

    Connectez-vous et vous authentifiez-vous auprès d’Azure Boards.

    Connectez-vous et vous authentifiez-vous auprès d’Azure Boards, étape 2.

  2. Après vous être connecté, utilisez la commande suivante à l’intérieur d’un canal Teams pour établir un lien vers le projet Azure Boards que vous spécifiez avec l’URL :

     @azure boards link [project url]

    Par exemple :

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

Une fois le projet lié, vous pouvez créer des éléments de travail à l’aide d’une commande @azure boards create ou d’actions de message.

Définir des abonnements

Vous pouvez créer des abonnements pour surveiller les éléments de travail à tout moment à l’aide de la commande @azure boards subscriptions.

  1. Sélectionnez le chemin de zone souhaité et l’événement qui vous intéresse. Utilisez les filtres associés pour personnaliser ce sur quoi vous recevez des notifications dans votre canal Teams. Pour vous aider à configurer facilement des abonnements, les chemins de zone récemment consultés sont affichés dans la liste déroulante du chemin de zone.

    Configurez des abonnements.

Si le chemin de zone souhaité n’apparaît pas dans le menu déroulant Chemin de zone, suivez les instructions mentionnées dans la section suivante, Ajouter des chemins de zone. Les chemins de zone ajoutés à l’aide de la commande @azure boards addAreapath et les chemins de zone pour lesquels des abonnements sont créés dans le canal apparaissent toujours dans la liste déroulante Chemin de zone, ainsi que les chemins de zone récemment consultés.

Ajouter des chemins de zone

Vous pouvez ajouter au canal des zones sur lesquelles votre équipe travaille afin qu’elles soient toujours disponibles pour la création d’éléments de travail et d’abonnements. Cette fonctionnalité est utile pour les équipes avec plus de 100 chemins de zone dans leur projet.

  • Utilisez la commande suivante pour ajouter des chemins de zone de votre projet au canal Teams.

      @azure boards addAreapath [area path]

    Par exemple :

      @azure boards addAreapath myproject\fabrikam

    Ajouter un message de réussite de chemin de zone

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

Créer un élément de travail avec une commande

Avec l’application Azure Boards, vous pouvez créer des éléments de travail à partir de votre canal. L’application prend également en charge les éléments de travail personnalisés.

  • Pour créer un élément de travail, utilisez @azure boards create.

    Créer un élément de travail à l’aide de la commande

Créer un élément de travail à partir d’actions de message

Souvent, les discussions dans un canal nécessitent la création d’éléments de travail. Vous pouvez utiliser des actions de message pour créer un élément de travail. Le message sélectionné est prérempli dans la section Description de l’élément de travail. La section Discussion de l’élément de travail nouvellement ajouté stocke un lien vers la conversation dans le canal.

  • Pour créer des éléments de travail à l’aide d’actions de message

    Créer un élément de travail à l’aide de l’action de message

    Créez un élément de travail à l’aide de l’action de message, étape 2.

Gérer les abonnements Azure Boards

  1. Pour afficher, ajouter et supprimer des abonnements pour un canal, utilisez la commande @azure boards subscriptions :

     @azure boards subscriptions

Cette commande répertorie tous les abonnements actuels pour le canal et vous permet d’ajouter de nouveaux abonnements et de supprimer ceux existants. Dans le cadre de l’ajout d’abonnements, vous pouvez également personnaliser ce sur quoi vous recevez des notifications à l’aide de différents filtres.

Voir les abonnements

Notes

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

Rechercher et partager des éléments de travail à l’aide de l’extension compose

Pour aider les utilisateurs à 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, consultez Recherche d’éléments de travail fonctionnels. Pour utiliser l’extension compose, les utilisateurs doivent se connecter à l’application Azure Boards en exécutant la commande @azure boards signin ou en se connectant directement à l’extension compose.

Connexion à l’extension compose.

Aperçu d’URL d’élément de travail

Pour prendre en charge la collaboration sur des éléments de travail abordés dans un canal, le canal affiche un aperçu des éléments de travail référencés. Lorsqu’un utilisateur colle l’URL de l’élément de travail, un aperçu s’affiche, comme l’image suivante. Cet aperçu permet de maintenir la pertinence et l’exactitude des conversations liées aux éléments de travail.

URL d’élément de travail déployée.

Pour que cette fonctionnalité fonctionne, les utilisateurs doivent être connectés. Une fois que vous êtes connecté, cette fonctionnalité fonctionne pour tous les canaux d’une équipe dans Microsoft Teams.

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 ainsi que les chemins de zone ajoutés du canal. Si le canal n’a pas d’abonnements, tout utilisateur peut dissocier un projet. Toutefois, si un canal a des abonnements, seuls les administrateurs de projet peuvent dissocier un projet d’un canal.

Le canal Teams crée un thread des notifications afin de lier et de réduire logiquement les notifications associées dans le canal. Toutes les notifications liées à un élément de travail particulier sont liées.

Vue compacte des notifications en thread

Thread compact

Vue développée des notifications en thread

Thread développé

Référence de commande Azure Boards

Le tableau suivant répertorie toutes les commandes @azure boards que vous pouvez utiliser dans votre canal Microsoft Teams.

Commande Fonctionnalités
@azure boards link [url projet] Lier un projet à ce canal pour créer des éléments de travail et recevoir des notifications
@azure boards subscriptions Ajouter ou supprimer des abonnements pour ce canal
@azure boards create Créer un élément de travail
@azure boards addAreapath [chemin de zone] Ajouter un chemin de zone de votre projet à ce canal
@azure boards sign in Connectez-vous à votre organisation Azure Boards
@azure boards sign out Déconnectez-vous de votre organisation Azure Boards
@azure boards unlink Dissocier un projet de ce canal
@azure boards feedback Signaler un problème ou suggérer une fonctionnalité

Configurer les onglets Azure DevOps Services dans Microsoft Teams

  1. Pour intégrer votre tableau Kanban ou tableau de bord dans Microsoft Teams, sélectionnez le bouton « + » (« Ajouter un nouvel onglet ») en haut de la navigation de votre canal d’équipe.

    La boîte de dialogue Ajouter un onglet s’affiche. Les icônes sont généralement organisées en fonction de l’accès le plus récent. Vous pouvez sélectionner A-Z pour une liste alphabétique.

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

  2. Choisissez l’icône Azure DevOps et authentifiez votre identité. Si vous le souhaitez, vous pouvez choisir l’icône Site web et ajouter l’URL de votre tableau de bord Kanban au canal.

  3. Choisissez l’organisation dont vous souhaitez ajouter le tableau ou tableau de bord.

  4. Remplissez le formulaire présenté. Par exemple, nous ajoutons ici un tableau de bord pour l’équipe Azure DevOps pour le projet TechnicalContent.

    Boîte de dialogue pour ajouter un tableau de bord d’équipe à un canal Teams.

  5. Le tableau Kanban ou le tableau de bord que vous avez sélectionné s’affiche.

Assistance multi-locataire

Dans votre organisation, si vous utilisez un autre e-mail ou locataire pour Microsoft Teams et Azure DevOps, procédez comme suit pour vous connecter en fonction de votre cas d’usage.

Case

ID e-mail et locataire dans Microsoft Teams

ID e-mail et locataire dans Azure DevOps

Étapes à suivre

1

email1@abc.com
(locataire 1)

email1@abc.com
(locataire 1)

Connectez-vous à l’aide du bouton Se connecter.

2

email1@abc.com
(locataire 1)

email1@abc.com
(locataire 2)

  • Se connecter au compte Azure DevOps
  • Dans le même navigateur, ouvrez un nouvel onglet, accédez à https://teams.microsoft.com
  • Exécutez la commande signin et choisissez le bouton Se connecter.

3

email1@abc.com
(locataire 1)

email2@pqr.com
(locataire 2)

Sélectionnez Se connecter avec une autre adresse e-mail, puis dans le sélecteur d’ID de messagerie, utilisez l’adresse e-mail2 pour vous connecter à Azure DevOps.

4

email1@abc.com
(locataire 1)

email2@pqr.com
(locataire non par défaut 3)

Ce scénario n’est pas encore pris en charge

Résoudre les erreurs

Si vous rencontrez les erreurs suivantes lors de l’utilisation de l’application Azure Boards pour Microsoft Teams, suivez les procédures décrites dans cette section.

Désolé, une erreur s’est produite. Recommencez.

L’application Azure Boards utilise le protocole d’authentification OAuth et nécessite l’accès aux applications tierces via OAuth pour que l’organisation soit activée. Pour activer ce paramètre, accédez à Paramètres de l'organisation>Sécurité>Stratégies, puis définissez le paramètre Accès aux applications tierces via OAuth pour l’organisation sur Activé.

Activer l’accès à l’application tierce via OAuth pour le paramètre de l’organisation

La configuration a échoué. Vérifiez que l’organisation « {nom organisation} » existe et que vous disposez des autorisations suffisantes.

Déconnectez-vous d’Azure DevOps en accédant à https://aka.ms/VsSignout à l'aide de votre navigateur.

Ouvrez une fenêtre de navigateur In private ou Incognito et accédez à https://aex.dev.azure.com/me, puis connectez-vous. Dans la liste déroulante sous l’icône de profil à gauche, sélectionnez le répertoire qui contient l’organisation contenant le projet que vous souhaitez lier.

Sélectionnez le répertoire qui contient l’organisation qui contient le projet

Dans le même navigateur, ouvrez un nouvel onglet, accédez à https://teams.microsoft.com/. Exécutez la commande @azure boards signout, puis @azure boards signin dans le canal où l’application Azure Boards pour Microsoft Teams est installée.

Sélectionnez le bouton Sign in et vous serez redirigé vers une page de consentement comme celle de l’exemple suivant. Vérifiez que le répertoire affiché à côté de l’e-mail est identique à ce qui a été choisi à l’étape précédente. Acceptez et terminez le processus de connexion.

Consentement aux autorisations d’application demandées

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