Search Groups(グループの検索)

ServiceNowのユーザーグループを検索します。

[First Matching Record(最初の一致レコード)]または[First 200 Matching Records(最初に一致する200レコード)]オプションが選択されている場合、入力および出力フィールドはServiceNowインスタンスに基づいて動的に生成されます。入出力フィールドには、ServiceNowが提供するデフォルトフィールド([アクティブ]、[コストセンター]、[グループメール]など)のほか、ユーザーグループテーブルに追加したすべてのカスタムフィールドが含まれます。

オプション

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

Result Set(結果セット)

レスポンスで返されるメールの数を指定します。

検索結果をフィルタリングする方式を選択します。

  • First Matching Record:一致する最初のレコードを返します。

  • First 200 Matching Records:最初に一致する200レコードを返します。

  • Stream Matching Records:一致するすべてのレコードを親フローからヘルパーフローに渡します。

    このオプションを選択すると、ストリーミング用のヘルパーフローを選択したりカスタム拡張可能フィールドを追加したりできる[Streaming(ストリーミング)]入力セクションがカードに追加されます。

ドロップダウン

TRUE

Search By(検索条件)

入力テキスト値の比較方法を指定します。すべてのテキストフィールドを検索します。検索に使用する演算子を選択します。

  • [Like(曖昧)]:検索が入力されたテキストまたは数字の値に完全に一致する場合にメールを返します。例:「Important(重要)」を含む件名をすべて検索します。
  • [Equals(等しい)]:検索が入力されたテキストまたは数字の値に部分的に一致する場合にメールを返します。例:[Sender(送信者)]フィールドで「Smith」を含むレコードを検索します。
  • [Starts With(指定の値で始まる)]:検索結果が入力したテキスト/数値から始まる場合にメールを返します。

ドロップダウン

TRUE

入力

複数の検索条件を指定すると、それを組み合わせてクエリが作成されます。結果出力は、すべての条件に一致するグループとなります。

ただし、検索条件を指定しない場合、カードは利用可能なレコードのすべてのフィールドを返します。

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

検索

Search Criteria(検索条件)

Record Limit(レコード制限)

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

  • [Limit]フィールドを0に設定すると、レコードは返されません。

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

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

  • デフォルト値は10000000(1,000万)です。

  • 有効な範囲は010000000です。

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

数値

FALSE

ストリーミング

Flow(フロー)

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

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

フロー

TRUE

出力

表示する出力フィールドを選択します。

更新した入力フィールドに対応する出力フィールドを表示する必要はありません。

フィールド 定義 タイプ

Result(結果)

[Result Set(結果セット)]オプションから[First Matching Records(最初の一致レコード)]または[200 Matching Records(一致する200レコード)]が選択されていて、他に特に指定がない場合に表示されます。

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

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

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

数値

関連項目

ServiceNowコネクター

Workflows要素

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

ServiceNow APIリファレンス