Utiliser l’application Azure Boards avec Slack pour gérer les éléments de travail

  • Article

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 des abonnements pour des é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 du canal Slack peuvent être utilisées pour créer des éléments de travail. Les préversions des URL d’élément de travail aident les utilisateurs à démarrer des discussions autour du travail.

Image : Notification

Lisez cet article pour découvrir comment :

  • Ajouter l’application Azure Boards à votre espace de travail Slack
  • Lier et dissocier votre projet Azure Boards pour l’application Azure Boards
  • Configurer des abonnements pour les événements liés aux éléments de travail dans votre canal Slack
  • Créer des éléments de travail à partir de votre canal Slack
  • Surveiller l’activité des éléments de travail dans votre canal Slack
  • Obtenir des notifications dans les canaux Slack privés

Notes

  • l’intégration Azure Boards et Slack n’est prise en charge que pour Azure DevOps Services.
  • Les notifications ne sont actuellement pas prises en charge dans les messages directs.

Prérequis

Ajouter 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é, un message de bienvenue de l’application s’affiche, comme illustré dans l’image suivante.

    Image : Message de bienvenue

  3. Utilisez le /azboards handle Slack pour interagir avec l’application. Une liste de commandes est fournie plus loin dans cet article, Informations de référence sur les commandes.

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

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

    capture d’écran de la connexion

  2. Après vous être connecté, utilisez la commande de barre oblique suivante dans un canal Slack pour créer un lien vers le 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 la liaison d’un projet.

  1. Sélectionnez le chemin de zone souhaité, l’événement qui vous intéresse et utilisez les filtres associés pour personnaliser votre canal Slack. Pour configurer facilement des abonnements, les chemins de zone récemment consultés sont affichés dans la liste déroulante des chemins d’accès de la zone.

    Configurez des abonnements.

    Si le chemin de zone de votre équipe n’apparaît pas dans le menu déroulant Chemin d’accès à la zone, suivez les instructions mentionnées dans la section suivante, Ajouter des chemins de zone. Les chemins d’accès aux zones ajoutés à l’aide des /azboards addAreapath chemins de commande et de zone pour lesquels les abonnements sont créés dans le canal Slack apparaissent toujours dans la liste déroulante Chemin d’accès à la 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. Cela est important principalement pour les équipes avec plus de 100 chemins de zone.

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

      /azboards addAreapath [area path]

    Par exemple :

      /azboards 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. Cela équivaut logiquement à choisir le chemin de zone « Any ».

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.

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

  1. Vous pouvez créer des éléments de travail directement à partir d’une commande en passant le type d’élément de travail et le titre en tant que paramètres. Les éléments de travail sont créés uniquement s’ils n’ont pas de champs à remplir obligatoirement.

     /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 un canal demandent 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 le canal est stocké dans la section Discussion de l’élément de travail nouvellement créé, 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

    Créer un élément de travail à l’aide de l’action 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.

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

Image : Afficher les abonnements

Aperçus des URL d’élément de travail

Pour prendre en charge la collaboration autour des éléments de travail abordés dans un canal, un aperçu des éléments de travail référencés dans le canal 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 maintenir la pertinence et l’exactitude des conversations liées aux éléments de travail.

Image : Déploiement de l’URL

Pour que cette fonctionnalité fonctionne, les utilisateurs doivent être connectés. Une fois qu’ils sont connectés, cette fonctionnalité fonctionne pour tous les canaux d’un espace de travail.

Un canal Slack ne peut être lié qu’à un seul Azure Boards projet à 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 /azboards commandes que vous pouvez utiliser dans votre canal Slack.

Commande barre oblique Fonctionnalités
/azboards link [url du projet] Lier un projet à ce canal pour créer des éléments de travail et recevoir des notifications
Abonnements /azboards Ajouter ou supprimer des abonnements pour ce canal
/azboards create ou /azboards create [type d’élément de travail] [title] Créer un élément de travail
/azboards addAreapath [chemin d’accès à la zone] Ajouter un chemin de zone de votre projet à ce canal
/azboards signin Connectez-vous à votre organisation Azure Boards
/azboards signout Déconnectez-vous de votre organisation Azure Boards
/azboards dissocier Dissocier un projet de ce canal
Commentaires /azboards Signaler un problème ou suggérer une fonctionnalité

Gérer le travail dans les canaux privés

L’application Azure Boards pour Slack peut vous aider à créer des éléments de travail et à surveiller l’activité des éléments de travail dans vos canaux privés. Pour inviter le bot à votre canal privé, entrez /invite @azboards. Une fois que vous avez posté, vous pouvez créer des éléments de travail et gérer vos notifications de la même façon que pour un canal public.

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.

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’organisationStratégiesde sécurité>, puis définissez l’accès aux applications tierces via OAuth pour le paramètre organizationsur 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 à l’aide de https://aka.ms/VsSignout votre navigateur.

Ouvrez une fenêtre de navigateur In private ou incognito et accédez à https://aex.dev.azure.com/me et 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, démarrez un nouvel onglet, accédez à https://slack.com, puis connectez-vous à votre espace de travail (utilisez le client web). Exécutez la commande /azboards signout suivie de la commande /azboards signin.

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.