クイックスタート - チーム、チャンネル、メッセージを取得する

概要

このガイドの目的は、さまざまな Microsoft Teams アクティビティ ([チームを取得]、[ チャンネルを取得]、[ メッセージを取得]、[アクティビティを取得] など) を使用した、実用的なサンプルを作成できるようになることです。

この実用的なサンプルにより、 登録済みの Microsoft Teams アプリケーションへの接続をすばやく確認したり、アクティビティの入力/出力データ型に習熟したりすることができます。

このページの手順を完了すると、以下のアクションを実行するオートメーション シーケンスが使用できるようになります。

1. 登録済みの Microsoft Teams アプリケーションへの接続を確立します ([Microsoft Teams スコープ])。
2. チームの検索クエリに一致するチームを検索して返します ([チームを取得])。
3. 指定したチームからチャンネル検索クエリに一致するチャンネルを検索し、返します ([チャンネルを取得])。
4. 指定したチャンネルからすべてのメッセージを取得します ([メッセージを取得])。

5. メッセージ本文の内容を出力し、メッセージ返信を返すことで、メッセージが取得されたことを確認します ([繰 り返し (コレクションの各要素)] と [1 行を書き込み]、[ メッセージ返信を取得]

   
   

   

   
   

前提条件

はじめる前に

1. Microsoft Teams の セットアップ 手順を完了します。

2. 既存のチームとチャネルを作成するか使用し、少なくとも 1 つのメッセージを送信して、そのメッセージに返信します。

   • このガイドと同じ値を使用するには、以下を作成して送信します。

     • チーム名: Quickstart_Test1
     • チャネル: QS4_Channel
     • メッセージ 1: UiPath からのこんにちは。
     • 返信 1: ねえ、 ねえ、ねえ
     • 2に返信: ここに来てうれしいです!
     • メッセージ 2: 会議は何時ですか。
     • 返信 1: 11am

手順

プロジェクトを構築する

1. プロジェクトに [Microsoft Teams スコープ] アクティビティを追加します。

2. 登録済み アプリケーションの [アプリケーション ID] を 入力します。

   • 詳細については、「セットアップ」ガイドの「 アプリケーションを登録する 」のセクションをご覧ください。

3. [ 認証の種類 ] ドロップダウン リストから、該当する認証フローを選択します (例: InteractiveToken)。

   • 詳細については、[Microsoft Teams スコープ] アクティビティの「 無人オートメーションと有人オートメーション 」をご覧ください。
4. [Microsoft Teams スコープ] アクティビティの後に [ チームを取得 ] アクティビティを追加します。
5. [リストの種類] ドロップダウン リストから、取得するチームの 種類 を選択します (例: MyJoinedTeams)

6. [クエリ オプション] を 入力して、チームのリストから特定のチームを見つけます (例: {New QueryOption("filter", "displayName eq 'Team Name'")})。

   • 詳細については、[チームを取得] アクティビティのページの「 クエリ オプション」 セクションをご覧ください。
7. チーム の値に Team[] 変数を作成して入力します (例: myTeams)。
   • 変数を作成する場合、変数の型として [Microsoft.Graph.Team ] を選択します。
8. [ チームを取得] アクティビティの後に [チャンネルを 取得 ] アクティビティを追加します。

9. [ クエリ オプション] を 入力して、指定したチームから特定のチャネルを見つけます (例: {New QueryOption("filter", "displayName eq 'Channel Name")})。

   • 詳細については、[チャンネルを取得] アクティビティのページの「 クエリ オプション」 セクションをご覧ください。
10. [ チーム ID ] プロパティに、[チームを 取得 ] アクティビティに対して作成した Team[] 変数を入力します。 String 値を入力するには、配列内の項目を指定して追加します 。 変数の末尾の ID (例: myTeams(0)ID) にアクセスします。
11. [チャンネル ] の値に Channel[] 変数を作成して入力します (例: myChannels)。
    • 変数を作成する場合、変数型として Microsoft.Graph.Channel を選択します。
12. [チャンネルを取得] アクティビティの後に [ メッセージ を 取得] アクティビティを追加します。
13. [ チャネル ID] プロパティに、[ チャンネルを取得 ] アクティビティに対して作成した Channel[] 変数を入力します。 String 値を入力するには、配列内の項目を指定して追加します 。 変数の末尾の ID (例: myChannels(0)。ID) にアクセスします。
14. [ チーム ID ] プロパティに、[チームを 取得 ] アクティビティに対して作成した Team[] 変数を入力します。 String 値を入力するには、配列内の項目を指定して追加します 。 変数の末尾の ID (例: myTeams(0)ID) にアクセスします。
15. 出力するメッセージの数を制限するには、[ 制限 ] プロパティに低い数値を入力します (例: 5)。
16. [メッセージ ] の値に ChatMessage[] 変数を作成して入力します (例: myMessages)。

    • 変数を作成する場合、その型には Microsoft.Graph.ChatMessage を選択します。

      
      

      

      
      

プロジェクトをテストする

1. アクティビティがチーム、チャネル、メッセージを取得したことをテストするには、[メッセージを 取得 ] アクティビティの後に [繰り返し (コレクションの各 要素)] アクティビティを追加します。

   1. [ TypeArgument ] プロパティで、[ Microsoft.Graph.ChatMessage] を選択します。
   2. [ 値 ] プロパティに、[ メッセージを取得 ] アクティビティに対して作成した ChatMessage[] 変数を入力します (例: myMessages)。

2. [繰り返し (コレクションの各 要素)] アクティビティに [1 行を書き込み ] アクティビティを追加します。

   1. [ テキスト] プロパティに 、「"Message: "+ item」と入力します。Body.Content

3. [1 行を書き込み ] アクティビティの後に、[メッセージ返信を取得 ] アクティビティを追加します。

   1. [ チャネル ID] プロパティに、[ チャンネルを取得 ] アクティビティに対して作成した Channel[] 変数を入力します。 String 値を入力するには、配列内の項目を指定して追加します 。 変数の末尾の ID (例: myChannels(0)。ID) にアクセスします。
4. 出力するメッセージの数を制限するには、[ 制限 ] プロパティに低い数値を入力します (例: 2)。
5. [ メッセージ ID ] プロパティに、 Item.Id を入力して、取得した各メッセージの返信を取得します。
6. [ チーム ID ] プロパティに、[チームを 取得 ] アクティビティに対して作成した Team[] 変数を入力します。 String 値を入力するには、配列内の項目を指定して追加します 。 変数の末尾の ID (例: myTeams(0)ID) にアクセスします。
7. [メッセージReplies ] の値に対し、 ChatMessage[] 変数を作成して入力します (例: myReplies)。
   • 変数を作成する場合、変数型として _Microsoft.Graph.ChatMessage_を選択します。

8. [ メッセージ返信を取得 ] アクティビティの後に、[繰り返し ( コレクションの各 要素)] アクティビティを追加します。

   1. [ TypeArgument ] プロパティで、[ Microsoft.Graph.ChatMessage] を選択します。
   2. [ 値 ] プロパティに、[ メッセージの返信を取得 ] アクティビティに対して作成した ChatMessage[] 変数を入力します (例: myReplies)。

9. [繰り返し (コレクションの各 要素)] アクティビティに [1 行を書き込み ] アクティビティを追加します。

   1. [ テキスト] プロパティに 、「"Reply: "+ item」と入力します。Body.Content

10. [ 実行 ] をクリックして、[ 出力 ] ウィンドウに、ユーザーのメッセージと関連する返信が含まれるかどうかを確認します。

    
    

    

    
    

完了です!

準備ができたら、他の 「クイックスタート 」ガイドにも挑戦し、さまざまな Microsoft Teams アクティビティにさらに習熟してください。

Microsoft Teams アクティビティの詳細 (プロパティの入力/出力の例を含む) については、以下のアクティビティのページをご覧ください。すべてのアクティビティが記載されたリストと、アクティビティの詳細な説明ページへのリンクが記載されています。

• Channels
• Chats
• Messages
• Teams