Utiliser Azure Boards avec Slack

Azure DevOps Services

Si vous utilisez Slack, vous pouvez utiliser l'application Azure Boards pour Slack afin de créer des éléments de travail et de surveiller l'activité des éléments de travail dans votre projet Azure Boards à partir de votre canal Slack.

L'application Azure Boards pour Slack permet aux utilisateurs de configurer et de gérer des abonnements dans leur canal Slack. Ils peuvent gérer les abonnements pour les événements de création, de mise à jour et d'autres événements d'élément de travail. Les utilisateurs peuvent également recevoir des notifications pour ces événements dans leur canal Slack. Les conversations dans le canal Slack peuvent être utilisées pour créer des éléments de travail. Les aperçus des URL d'élément de travail aident les utilisateurs à démarrer des discussions autour du travail.

Prerequisites

Ajoutez l’application Azure Boards à votre espace de travail Slack

1. Pour installer l’application Azure Boards dans votre espace de travail Slack, ouvrez un navigateur Web, connectez-vous à Slack, puis ouvrez l’application Azure Boards.

2. Une fois ajoutée, un message de bienvenue s’affiche dans l’application, comme illustré dans l’image suivante.

   

3. Utilisez le /azboards handle Slack pour interagir avec l’application. Une liste de commandes est fournie plus loin dans cet article, dans la section Référence des commandes.

Lier votre projet Azure Boards à l’application Azure Boards

Pour utiliser l’application, vous devez d’abord lier votre projet Azure Boards à votre chaîne Slack.

1. Une fois l’application installée dans votre espace de travail Slack, connectez-vous et authentifiez-vous auprès d’Azure Boards.

   

2. Une fois connecté, utilisez la commande slash suivante dans une chaîne Slack pour vous connecter au projet Azure Boards que vous spécifiez avec l’URL :

   /azboards link [project url]
   

   Par exemple :

   /azboards 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 /azboards create ou d’actions de message.

Configurer des abonnements pour surveiller les éléments de travail

Vous pouvez créer des abonnements pour surveiller les éléments de travail à tout moment à l’aide de la commande /azboards subscriptions. Vous avez la possibilité de configurer des abonnements juste après avoir connecté un projet.

1. Sélectionnez le chemin d’accès à la zone souhaité, l’événement qui vous intéresse et utilisez les filtres associés pour personnaliser votre chaîne Slack. Pour faciliter la configuration des abonnements, les chemins d’accès récemment utilisés s’affichent dans la liste déroulante des chemins d’accès.

   

   Si le chemin d’accès de votre équipe n’apparaît pas dans le menu déroulant Chemin d’accès, suivez les instructions de la section suivante, Ajouter des chemins d’accès. Les chemins d’accès ajoutés à l’aide de la commande /azboards addAreapath et les chemins d’accès pour lesquels des abonnements ont été créés dans la chaîne Slack apparaissent toujours dans la liste déroulante Chemin d’accès, avec les chemins d’accès récemment utilisé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 action est importante surtout pour les équipes qui ont plus de 100 chemins de zone.

• Utilisez la commande suivante pour ajouter des chemins d’accès de votre projet à la chaîne Slack.

  /azboards addAreapath [area path]
  

  Par exemple :

  /azboards addAreapath myproject\fabrikam
  

  

• Si vous choisissez le nom du projet comme chemin d’accès, vous recevrez des notifications pour tous les chemins d’accès du projet. Cette action est logiquement équivalente à la sélection de 'N'importe quel' chemin de zone.

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

1. 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 /azboards create.

  

2. Vous pouvez créer des éléments de travail directement à partir d’une commande en passant le type et le titre de l’élément de travail en tant que paramètres. Les éléments de travail ne sont créés que s’ils ne comportent aucun champ obligatoire.

   /azboards create [work item type] [work item title]
   

   Par exemple :

   /azboards create 'user story' Push cloud monitoring alerts to mobile devices
   

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

Souvent, les discussions dans une chaîne 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. Un lien vers la conversation dans la chaîne est stocké dans la section Discussion du nouvel élément de travail, ce qui permet aux utilisateurs d’accéder à la discussion qui a conduit à la création de l’élément de travail.

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

  

Gérer les abonnements Azure Boards

1. Pour afficher, ajouter et supprimer des abonnements pour un canal, utilisez la commande /azboards subscriptions :

   /azboards 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.

Préversions des URL des éléments de travail

Pour faciliter la collaboration autour des éléments de travail discutés dans une chaîne, une préversion des éléments de travail référencés dans la chaîne s’affiche. Lorsqu’un utilisateur colle l’URL de l’élément de travail, un aperçu s’affiche, comme l’image suivante. Cette préversion permet de garantir la pertinence et l’exactitude des conversations relatives aux éléments de travail.

Pour que cette fonctionnalité fonctionne, les utilisateurs doivent être connectés. Une fois connectés, cette fonctionnalité fonctionne pour toutes les chaînes d’un espace de travail.

Dissocier un projet d’un canal

Une chaîne Slack ne peut être liée 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 /azboards 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.

Informations de référence sur les commandes

Le tableau suivant répertorie toutes les commandes /azboards que vous pouvez utiliser dans votre chaîne Slack.

Gérer le travail dans les chaînes privé

L’application Azure Boards pour Slack peut également vous aider à créer des éléments de travail et à surveiller l’activité des éléments de travail dans vos chaînes privées. Pour inviter le bot dans votre chaîne privée, entrez /invite @azboards. Une fois que vous avez publié cela, vous pouvez créer des éléments de travail et gérer vos notifications de la même manière que pour une chaîne publique.

Résoudre les erreurs

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

La configuration a échoué. Assurez-vous que l’organisation « {nom de l’organisation} » existe et que vous disposez d’autorisations suffisantes.

Pour résoudre ce problème d’authentification, procédez comme suit :

1. Déconnectez-vous d’Azure DevOps en accédant à https://aka.ms/VsSignout dans votre navigateur.

2. Ouvrez une fenêtre de navigateur InPrivate (Microsoft Edge) ou Incognito (Chrome).

3. Accédez à https://aex.dev.azure.com/me et connectez-vous avec vos informations d’identification.

4. Sélectionnez le répertoire approprié dans le menu déroulant sous l’icône de votre profil. Choisissez le répertoire qui contient l’organisation avec le projet que vous souhaitez lier.

   

5. Dans le même navigateur, ouvrez un nouvel onglet, accédez à https://slack.com et connectez-vous à votre espace de travail (utilisez le client Web). Exécutez la commande /azboards signout suivie de la commande /azboards signin.

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

Contenu connexe

• Définir les chemins de zone et les assigner à une équipe
• Utiliser Azure Pipelines avec Slack
• Utiliser Azure Repos avec Slack
• Créer un hook de service pour Azure DevOps avec Slack