メッセージを取得

概要

[メッセージを取得] アクティビティは、Microsoft Graph の GetChannelMessage または GetChatMessage API を呼び出して、チャット ([チャット ID]) またはチャネル ([チャネル ID]) とチーム ([チーム ID]) から指定したメッセージ ([メッセージ ID]) を取得します。

検索の実行後、アクティビティはプロパティをChatMessage オブジェクト ([メッセージ]) に出力します。このオブジェクトは、後続のアクティビティ (例: [メッセージの返信を取得]、[メッセージに返信] など) で入力変数として使用できますChatMessage.Id。

このアクティビティと [メッセージを取得 ] アクティビティの違いは、特定のメッセージ ([メッセージ ID]) を入力する必要があることです。MessageId を入力すると、[メッセージを取得] アクティビティで返されるオブジェクトの配列ではなく、特定の ChatMessage オブジェクトを取得できます。

動作のしくみ

以下の手順とメッセージ シーケンス ダイアグラムは、設計時 (つまり、アクティビティの依存関係と入/出力プロパティ) から実行時に至るまでの、アクティビティの動作のしくみの例を示したものです。

1. 「セットアップ」の手順を完了します。
2. プロジェクトに [ Microsoft Teams スコープ ] アクティビティを追加します。
3. 次の 2 つのオプション (A または B) のいずれかを完了します。

A。 アクティビティを追加するか、 Chat.Id 値を出力する外部プロセスを実行します (例: [チャットを取得])。

B。Team.Id値を出力するアクティビティを追加するか、外部プロセスを実行する ([チームを取得] など)、Channel.Id値を出力するアクティビティまたは外部プロセス ([チャネルを取得] など) を追加します。

1. [Microsoft Teams スコープ] アクティビティ内に [メッセージを取得] アクティビティを追加します。
2. [チャネルまたはチャット] プロパティと [入力] プロパティに値を入力します。
3. [出力] セクションのプロパティのために ChatMessage 型変数を作成し、入力します。
4. アクティビティを実行します。

   • 入力したプロパティ値は、 GetChannelMessage または GetChatMessage API に渡されます。

   • API は、[出力] セクションのプロパティ変数に ChatMessage の値を返します。

     

プロパティ

以下のプロパティの値は、このアクティビティを UiPath Studio でプロジェクトに追加するときに指定します。

共通

表示名

アクティビティの表示名です。

属性	詳細
入力	String
Required	はい
既定値	メッセージを取得
許容値	String または String 型変数を入力します。
備考	N/A

Channel

TeamId

メッセージの取得に使用するチャネルを含む Team オブジェクトの ID です。

属性	詳細
入力	String
Required	はい ( ChatId が空の場合)
既定値	空
許容値	String または String 型変数を入力します。
備考	Team.Id値を取得するには、出力に Team.Id 値を含む外部プロセスまたはアクティビティ (例: [チームを取得] や外部 API 呼び出し) を使用します。 (ChatId) または (TeamId と ChannelId) のいずれかが必要です。

ChannelId

メッセージの取得に使用する Channel オブジェクトの ID です。

属性	詳細
入力	String
Required	はい ( TeamId に値がある場合)
既定値	空
許容値	String または String 型変数を入力します。
備考	Channel.Id値を取得するには、出力に Channel.Id 値を含む外部プロセスまたはアクティビティ (例: [チャネルを取得] や [外部 API 呼び出し]) を使用します。 (ChatId) または (TeamId と ChannelId) のいずれかが必要です。

チャット

ChatId

メッセージの送信先 Chat オブジェクトの ID です。

属性	詳細
入力	String
Required	はい ( TeamId と ChannelId が空の場合)
既定値	空
許容値	String または String 型変数を入力します。
備考	Chat.Id値を取得するには、出力に Chat.Id 値を含む外部プロセスまたはアクティビティ ([チャットを取得] や外部 API 呼び出しなど) を使用します。 (ChatId) または (TeamId と ChannelId) のいずれかが必要です。

入力

メッセージ ID

取得するメッセージの ID です。

属性	詳細
入力	String
Required	はい
既定値	空
許容値	String または String 型変数を入力します。
備考	Message.Id値を取得するには、出力にMessage.Id値を含む外部プロセスまたはアクティビティを使用します (例: [メッセージを取得] や外部 API 呼び出し)。

その他

プライベート (Private)

選択すると、変数と引数の値が Verbose レベルでログ記録されなくなります。

属性	詳細
入力	チェックボックス
Required	いいえ
既定値	非選択
許容値	選択または非選択
備考	N/A

出力

メッセージ

[メッセージ ID] プロパティに指定したメッセージを表すChatMessage オブジェクトです。

属性	詳細
入力	ChatMessage
Required	いいえ (後続のアクティビティで出力データを使用する予定がある場合は必須)
既定値	空
許容値	ChatMessage 型変数を入力します。
備考	このプロパティ用に作成した変数は、後続のアクティビティ (例: [メッセージの返信を取得 ]、[ メッセージに返信 ]) で入力変数として使用できます。 ChatMessage オブジェクトには、他のアクティビティで使用できる複数のプロパティが含まれます。下の画像の例に、返すことができるプロパティの一部を示します。 注 - デザイナーに表示されているプロパティの中には、 ChatMessage オブジェクトに適用できないものがあります (例: ODatatType )。該当する Team プロパティのリストについては、上記のリンクをご覧ください。

例

次の画像は、アクティビティの依存関係と入力/出力プロパティの値の例です。

ステップバイステップの手順および例は、「クイックスタート」ページをご覧ください。