Envoyer des messages instantanés depuis ALM

Cette tâche décrit comment envoyer des messages Microsoft Teams aux utilisateurs associés à une entité ALM spécifique. Par exemple, des utilisateurs travaillant sur la même anomalie, le même test ou sur une exigence.

Conditions préalables

Avant de démarrer une conversation Teams, effectuez les tâches de configuration suivantes.

Dans Microsoft Azure App Service

Effectuez les tâches suivantes dans Microsoft Azure App Service :

  1. Créez votre application dans Microsoft Azure App Service.

  2. Vous ouvrez l’application. Dans l’onglet Authentification, section Applications mobiles et de bureau, ajoutez l’URL de redirection suivante :

    https://login.microsoftonline.com/common/oauth2/nativeclient

  3. Dans l’onglet API permissions, ajoutez les autorisations suivantes de l’API Microsoft Graph :

    • Channel.ReadBasic.All

    • ChannelMessage.Send

    • ChatMessage.Send

    • offline_access

    • Presence.Read

    • Presence.Read.All

    • Team.ReadBasic.All

    • User.Read

    • User.ReadBasic.All

  4. Cliquez sur le bouton Grant admin consent for <your tenant name>.

Pour plus de détails sur la création et la configuration des applications, consultez la documentation de Microsoft Azure App Service.
Dans ALM Site Administration

Effectuez les tâches suivantes dans ALM Site Administration :

  • Définissez les paramètres de site suivants :

    • Réglez ENABLE_TEAMS_INTEGRATION sur Y.

    • Réglez TEAMS_APP_CLIENT_ID sur l’ID d’application (client) de votre application.

    • Réglez TEAMS_APP_TENANT_ID sur l’ID de répertoire (locataire) de votre application.

    Pour obtenir des informations sur l’ID client et l’ID locataire de votre application, cliquez sur l’onglet Présentation de votre application dans Microsoft Azure App Service.

    Pour plus d’informations sur la définition des paramètres du site, voir Définir les paramètres de configuration.

  • Les utilisateurs doivent avoir défini leurs adresses e-mail dans ALM. Pour plus d’informations sur la configuration des utilisateurs, voir Gérer les utilisateurs d’un projet.
Ajouter des URL dans votre pare-feu

Si votre organisation est sécurisée par un pare-feu ou un serveur proxy, ajouter les URL suivantes à la liste d’autorisation pour vous assurer que le client ALM peut accéder aux ressources Microsoft Teams :

  • https://aadcdn.msftauth.net

  • https://login.microsoftonline.com/

  • https://graph.microsoft.com/

Retour en haut

Démarrer une conversation Teams à partir d’un formulaire d’entité

Pour démarrer une conversation Microsoft Teams à partir d’un formulaire d’entité :

  1. Ouvrez le formulaire de l’entité.

  2. Localisez le champ utilisateur dans lequel l’utilisateur avec lequel vous voulez converser, est défini.

  3. Cliquez sur l’indicateur de présence Microsoft Teams à gauche du nom de l’utilisateur.

    L’indicateur est grisé et ne reflète pas le statut Teams en temps réel de l’utilisateur jusqu’à ce que vous vous connectiez à Microsoft Teams avec l’adresse e-mail de votre compte ALM. Le statut Teams est synchronisé toutes les 10 secondes.

    Si c’est la première fois que vous cliquez sur l’indicateur dans la session ALM actuelle, la fenêtre de connexion Microsoft s’ouvre et vous invite à vous connecter à Microsoft.

  4. La fenêtre de conversation Teams avec l’utilisateur s’ouvre, avec un message automatique en attente d’être envoyé.

    Le message comprend le lien de l’entité et des informations générales, telles que le nom, l’ID et la synthèse.

    Problème connu : En raison des modifications apportées à l’API de Microsoft Teams, le lien de l’entité est affiché en texte brut. Pour ouvrir l’entité dans ALM, effectuer l’une des opérations suivantes :

    • Copier l’adresse de l’entité (entre parenthèses) et la coller dans votre navigateur.

    • Supprimer la parenthèse de fin « ) » à la fin du message et ajouter manuellement une parenthèse de fin. Le texte brut devient un lien cliquable.

    Si vous démarrez la conversation Teams lors de la création d’une nouvelle entité, ce message automatique ne s’affiche pas.

  5. Cliquez sur le bouton Envoyer. Le message devient un lien qui permet aux participants au chat d’ouvrir l’entité dans ALM.

  6. Envoyer d’autres messages à l’utilisateur.

Retour en haut

Voir aussi :