Power Automateからチームメンバー全員にメンションする方法！！

Power Automateのホーム画面はこちらです。

▲①左側メニューの作成をクリックして、②「インスタントクラウドフロー」を選択してフローを作成します。

▲①フロー名に任意の名前を入力＞②「手動でフローをトリガーします」＞③作成をクリックします。

じょじお

今回はメンションのテストなので、ボタンからメッセージを送信できるようにします。ボタンを押した時にTeamsに送信するメッセージ本文を入力できるようにします。

▲「＋入力の追加」をクリックします。

▲ユーザー入力の種類の選択に「テキスト」を選択します。

▲入力欄のラベルテキストを入力します。任意のわかりやすいメッセージを入力してください。ここでは「メッセージのタイトル」と入力しました。

▲もうひとつテキスト入力を受け付けるボックスを用意します。こちらは「メッセージの本文」というラベルをつけます（図の赤枠）。

▲「新しいステップ」をクリックします。

▲「Group」というキーワードで検索して、「Office365 Groups」コネクタを探してクリックします。

▲ 「Office365 Groups」コネクタ の中の「グループメンバーの一覧表示」アクションを追加します。

▲メンションを送信するチームを選択します。

▲「変数」コネクタの中の「変数を初期化する」アクションを追加します。

• 名前：任意の変数の名前を入力します。ここでは「arr」としました。
• 種類：アレイを選択します。
• 値：（空白）

▲「コントロール」コネクタの中の「Apply to each」アクションを追加します。入力値として、「グループメンバーの一覧表示」アクションの動的コンテンツ（動的な値）である「value」を選択します。

▲Apply to eachループの中に「Teams」コネクタの中の「ユーザーの@mentionトークンを取得する」アクションを追加します。

ユーザー： 「グループメンバーの一覧表示」アクションの動的コンテンツ（動的な値）である 「ユーザープリンシパル名」を入力します。

▲「データ操作」コネクタの中の「作成」アクションを追加します。

入力：@{decodeUriComponent(outputs(‘ユーザーの@mentionトークンを取得する’)?[‘body/atMention’])}

じょじお

ここでは「ユーザーの@mentionトークンを取得する」アクションの戻り値（動的コンテンツ）をdecodeUriComponent関数でデコードしています。詳しくは次のColumnを見てね。

Column

decodeUriComponent関数でデコードが必要だよ！

「ユーザーの@mentionトークンを取得する」アクションで作成したメンショントークンはURIエンコードされた状態で戻ってきます。通常の組織内ユーザのみのチーム（グループ）であれば恐らく問題ないのですが、組織外の方をゲストユーザとして招待している場合、下記のように「#（シャープ）」が入ったUPN（ユーザープリンシパルネーム）になります。

組織外のゲストユーザのUPNの例 jojio_contoso.onmicrosoft.com#EXT#@tejilabo.onmicrosoft.com

「#（シャープ）」は、URIには使えない文字列なのでエンコード対象となります。試しに上の例のUPNを 「ユーザーの@mentionトークンを取得する」アクション に渡してみると下記のようにエンコードされたメンショントークンが戻ってきました。

<at>jojio_contoso.onmicrosoft.com%23EXT%23@tejilabo.onmicrosoft.com</at>

じょじお

「#」が「%23」にエンコードされていますね。

ぽこがみさま

このままTeamsのアクションに渡してもメンションとして機能しないにゃ・・

じょじお

そうだね。そこで使うのが 「decodeUriComponent関数」 なんだよ！

Power Automateの「decodeUriComponent関数」とは？

じょじお

decodeUriComponent関数は、URIエンコードされた文字列をエンコード前の文字列に戻してくれます（デコード）。

エスケープ文字をデコード バージョンに置き換えた文字列を返します。

式関数のリファレンスガイド – decodeUriComponent関数

使い方の例
decodeUriComponent(<at>jojio_contoso.onmicrosoft.com%23EXT%23@tejilabo.onmicrosoft.com</at>)

結果
<at>jojio_contoso.onmicrosoft.com#EXT#@tejilabo.onmicrosoft.com</at>

▲「変数」コネクタの中の「配列変数に追加」アクションを追加します。

• 名前：STEP5で作成した変数を選択します。
• 値：STEP8の「作成」アクションの動的コンテンツである「出力」を入力します。

▲（Apply to eachループの外側に）「データ操作」コネクタの中の「参加（結合）」アクションを追加します。

じょじお

配列のままだと、Teamsアクションの中で使えないので、一つの文字列にするために結合アクションを使います。山田さんのようにさんを付けて結合しています。

▲パラメータを入力します。

**チームメンバ 各位**

# **@{triggerBody()['text']}** @{triggerBody()['text_1']}


@{body('結合')}さん

▲結合アクションだと最後のメンバだけさんが付かないので、最後のメンバ用に@{body('結合')}のあとにさんを付けています。

▲テスト実行してTeamsのメッセージを確認しましょう！

じょじお

文頭に「メンバー全員宛て」であることを書いたほうが実用的かと思います！