Search Chats(チャットの検索)

Microsoft Teams内のチャットを検索します。

オプション

フィールド 定義 タイプ 必須
Result Set(結果セット) 検索結果を表示するために次のオプションのいずれかを選択します。
  • [First 50 Matching Records]:最初に一致する50チャットを返します。
  • [Stream Matching Records]:一致するすべてのレコードが親フローからヘルパーフローに渡されます。カードに[ストリーミング]入力セクションが追加され、カスタム拡張可能フィールドのストリーミングと追加のためのヘルパーフローを選択できます。

ドロップダウン

TRUE

Search By(検索条件) 検索の[Exact Match]に該当するチームを返すか、検索式の[Starts With]に該当するチームを返すかを選択します。

ドロップダウン

TRUE

入力

フィールド 定義 タイプ 必須

検索

Topic(トピック) チャットのタイトル。チャットタイトルを指定できるのは、チャットタイプがグループの場合のみです。

[Search By(検索条件)]オプションで[Exact Match]または[Starts With] を選択した場合に表示されます。

テキスト

FALSE

Chat Type(チャットタイプ) チャットのタイプを指定します。取り得る値は次のとおりです。
  • oneOnOne:1:1チャットであることを示します。
  • group:グループチャットであることを示します。

[Search By(検索条件)]オプションで[Exact Match]を選択した場合に表示されます。

ドロップダウン

TRUE

Search Criteria(検索条件)

このフィールドは、[Result Set(結果セット)]オプションで[Stream Matching Records)]を選択した場合に表示されます。

Record Limit(レコード制限)

ストリーミングするレコードの数を指定します。

  • [Record Limit(レコード制限)]フィールドを0に設定すると、400 Bad Requestエラーが返されます。

  • [Record Limit(レコード制限)]フィールドに0より大きい値を設定すると、指定した最大レコード数までのレコードが返されます。

  • [Record Limit(レコード制限)]フィールドが空、null、または未選択の場合、すべてのレコードが返されます。

  • デフォルト値は120000です。

  • 有効な値は1120000です。

数値

TRUE

Streaming(ストリーミング)

このフィールドは、[Result Set(結果セット)]オプションで[Stream Matching Records(一致レコードのストリーミング)]を選択した場合に表示されます。

Flow(フロー)

[Choose Flow(フローの選択)]をクリックして検索結果をストリーミングするヘルパーフローを参照および選択し、[Choose(選択)]をクリックして確定します。

オプションとして、[Click or drop here to create(クリックまたはここにドロップして作成)]の下の空のフィールドをクリックし、データをヘルパーフローに渡すカスタム拡張可能フィールドを追加します。これらのフィールドは、ヘルパーフロー内の[State(状態)]出力オブジェクトの下にキー/値ペアとして追加されます。

フロー

TRUE

出力

フィールド 定義 タイプ

チャット

Id(ID) チャットの一意識別子。

テキスト

Chat Type(チャットタイプ) チャットのタイプを指定します。

テキスト

Members(メンバー) チーム、チャンネル、またはチャット内のユーザーを表します。「会話メンバー」を参照してください。

オブジェクトのリスト

Topic(トピック) チャットのタイトル。チャットタイトルを指定できるのは、チャットタイプがグループの場合のみです。

テキスト

Created Date Time(作成日時) チャットが作成された日時。

日時

Last Updated Date Time(最終更新日時) チャット名が変更された、またはメンバーリストが最後に変更された日時。

日時

Records Streamed(ストリーミングしたレコード)

ストリーミングフロー内でストリーミングされたレコードの数。

このフィールドは、[Result Set(結果セット)]オプションで[Stream Matching Records]を選択した場合に表示されます。

数値

追加情報

[Result Set(結果セット)][First 50 Matching Records(最初に一致する50レコード)]オプションを選択した場合、想定されるすべてのレコードでAPIが応答しない可能性があります。すべてのレコードを確実に検索するには、[Stream Matching Records(一致レコードのストリーミング)]オプションを使用します。

関連項目

Microsoft Teamsコネクター

Workflows要素

Microsoft Teamsコネクターに関するガイダンス

Microsoft Teams APIの概要