ALM からのインスタント・メッセージの送信

このタスクでは、特定の ALM エンティティに関連付けられているユーザに Microsoft Teams メッセージを送信する方法について説明します。たとえば、同じ不具合、テスト、要件を扱っているユーザなどです。

前提条件

Teams チャットを送信する前に、次の設定タスクを完了します。

Microsoft Azure App Service で

Microsoft Azure App Service で次のタスクを実行します。

  1. Microsoft Azure App Service でアプリケーションを作成します。

  2. アプリケーションを開きます。［Authentication］タブの［Mobile and desktop applications］セクションで、次のリダイレクト URI を追加します。

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

  3. ［API permissions］タブで、Microsoft Graph API の次の権限を追加します。

    • Channel.ReadBasic.All

    • ChannelMessage.Send

    • ChatMessage.Send

    • offline_access

    • Presence.Read

    • Presence.Read.All

    • Team.ReadBasic.All

    • User.Read

    • User.ReadBasic.All

  4. ［Grant admin consent for <テナント名>］ボタンをクリックします。

アプリケーションの作成と設定の詳細については、Microsoft Azure App Service のドキュメントを参照してください。
ALM サイト管理で

ALM サイト管理で、次のタスクを完了します。

  • 次のサイト・パラメータを設定します。

    • ENABLE_TEAMS_INTEGRATION を Y に設定します。

    • TEAMS_APP_CLIENT_ID を、使用するアプリケーションのアプリケーション（クライアント）ID に設定します。

    • TEAMS_APP_TENANT_ID を、使用するアプリケーションのディレクトリ（テナント）ID に設定します。

    アプリケーションのクライアント ID およびテナント ID については、Microsoft Azure App Service でアプリケーションの［Overview］タブにアクセスしてください。

    サイト・パラメータの設定の詳細については、「設定パラメータの指定」を参照してください。

  • ユーザの電子メール・アドレスが、ALM で定義されている必要があります。ユーザのセット・アップの詳細については、「プロジェクトでのユーザの管理」を参照してください。
ファイアウォールへの URL の追加

組織がファイアウォールまたはプロキシ・サーバで保護されている場合は、次の URL を許可リストに追加して、ALM クライアントが Microsoft Teams リソースにアクセスできるようにします。

  • https://aadcdn.msftauth.net

  • https://login.microsoftonline.com/

  • https://graph.microsoft.com/

先頭に戻る

エンティティ・フォームからの Teams チャットの開始

エンティティ・フォームから Microsoft Teams チャットを開始するには、次の手順を実行します。

  1. エンティティ・フォームを開きます。

  2. チャットする相手のユーザが定義されているユーザ・フィールドを見つけます。

  3. ユーザの名前の左側にある Microsoft Teams プレゼンス・インジケータをクリックします。

    インジケータは灰色です。ALM アカウントの電子メール・アドレスを使用して Microsoft Teams にサイン・インするまでは、ユーザのリアルタイムの Teams ステータスは反映されません。Teams のステータスは 10 秒ごとに同期されます。

    インジケータを現在の ALM セッション中に初めてクリックすると、Microsoft ログイン・ウィンドウが開き、Microsoft にログインするように求められます。

  4. ユーザとの Teams チャット・ウィンドウが開き、自動メッセージの送信が待機状態になります。

    このメッセージには、エンティティのリンクと、名前、ID、要約などの一般情報が含まれます。

    既知の問題：Microsoft Teams の API が変更されたため、エンティティのリンクがプレーン・テキストで表示されます。ALM でエンティティを開くには、次のいずれかを実行します。

    • エンティティのアドレス（括弧で囲まれています）をコピーして、ブラウザに貼り付けます。

    • メッセージの末尾にある閉じ括弧 ")" を削除し、手動で閉じ括弧を追加します。プレーン・テキストがクリック可能なリンクになります。

    新規エンティティの作成時に Teams チャットを開始する場合、自動メッセージは表示されません。

  5. ［送信］ボタンをクリックします。メッセージは、チャットの参加者が ALM 内のエンティティを開けるようにするリンクになります。

  6. ユーザに別のメッセージを送信します。

先頭に戻る

参照情報：