List.[Table] データタイプ

特定のテーブルに関連付けられたレコードシステム ID のリストを格納します。この変数は、デフォルトレコードや参照修飾子などの ServiceNow AI Platform リストフィールドオプションをサポートします。

基本オプション

オプション	説明
ラベル	ワークフロースタジオ インターフェイスでデータ変数を識別するために使用されるラベルを表示します。ラベルは任意のテキストで構成できます。
名前	スクリプトコールでデータ変数を識別するために使用される名前を表示します。名前には、英数字とアンダースコアのみを使用できます。特殊文字を削除または置換することにより、ラベルが有効な名前に自動的に変換されます。
タイプ	データ変数によって格納されるデータのタイプを示します。
必須	アクションで設定するときにデータ変数に値を含める必要があるかどうかを示します。

リスト変数の詳細オプション

オプション	説明
ヒント	データの構成方法についてフローデザイナーまたはアクションデザイナーにガイダンスを提供します。
デフォルト値	フローデザイナーまたはアクションデザイナーが値を指定しない場合に使用される値を指定します。
[レコードラベル] の追加	リストのデフォルト値として含めるレコードを 1 つ以上選択します。参照修飾子を使用してリストをフィルタリングすると、参照修飾子の条件に一致するレコードのみを選択できます。
参照修飾子の条件	レコードリストに適用するフィルター条件を選択します。フローデザイナーは、参照修飾子の条件に一致するレコードのみを選択できます。

一般的なガイドライン

リストレコードをフィルターするための参照修飾子を追加する

参照修飾子を追加し、リスト変数を有効なオプションとして表示するレコードをフィルターします。参照修飾子は必須のリストフィルターとして機能し、これにより参照修飾子の条件に一致するレコードのみがリスト変数に表示されます。たとえば、アクティブなインシデントレコードのみを表示するには、参照修飾子の条件として [アクティブ][次の値に等しい][true] を追加します。

ServiceNow Store の対象アクションのデフォルトレコードを選択しない

すべてのインスタンスが選択したレコードにアクセスできることがわかっている場合を除き、リストのデフォルトレコードを選択しないでください。スポーク開発者は通常、カスタムアクションをインストールする顧客のデータにアクセスできません。ServiceNow Store でカスタムアクションを公開する場合は、デフォルトレコードをデモデータとして提供する必要がある場合があります。

For Each フローロジックでリスト変数を使用する

リスト変数を使用して、For Each フローロジック内で処理するレコードを指定できます。For Each フローロジックは、データに存在するすべての non-record sys_id を無視します。たとえば、リスト変数にメールアドレスが含まれている場合、フローロジックはそれを無視します。