グループの検索

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

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

オプション

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

Result Set(結果セット)

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

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

  • [最初の一致レコード]:一致する最初のレコードが返されます。

  • [最初に一致する200レコード]:最初に一致する200レコードが返されます。

  • [一致レコードのストリーミング]:一致するすべてのレコードが親フローからヘルパーフローに渡されます。

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

ドロップダウン

Search By(検索条件)

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

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

ドロップダウン

入力

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

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

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

検索

Search Criteria(検索条件)

Record Limit(レコード制限)

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

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

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

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

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

  • 有効な範囲は010000000です。

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

数値

Streaming(ストリーミング)

Flow(フロー)

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

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

フロー

出力

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

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

フィールド 定義 タイプ

Result(結果)

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

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

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

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

数値

関連項目

ServiceNowコネクター

Workflows要素

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

ServiceNowリファレンス