フローのサービスカタログ変数を作成する

特定の サービスカタログ フローにのみ利用可能な サービスカタログ 変数を作成します。フロー固有の変数は、フロー内のカタログタスクおよびアクションで使用できます。

始める前に

必要なロール：flow_designer または admin

このタスクについて

フローの サービスカタログ 変数は、[カタログタスクの作成] アクションと [カタログ変数の取得] アクションの [カタログ変数] フィールドに表示されます。これらは「フロー:変数名」という形式で表示され、定義されているフローでのみ使用できます。

サービスカタログ のアクションの詳細については、「「カタログ タスクの作成」アクション」と「「カタログ変数の取得」アクション」を参照してください。

手順

1. サービスカタログ トリガーを持つフローを開くか作成します。
2. をクリックし、[フロー カタログ変数を管理] を選択します。
   フロー カタログ変数テーブルが開きます。
3. [新規] をクリックして、フローで使用できる新しい変数を追加します。
4. フォームに入力します。

   表 : 1. 変数フォーム

   フィールド	説明
   アプリケーション	この変数を使用できるアプリケーションを示す読み取り専用フィールドです。
   フィールドにマップ	レコードプロデューサーのテーブルの特定のフィールドに変数をマップします。 このフィールドが表示されるのは、変数がレコードプロデューサーに属する場合です。
   タイプ	作成する変数タイプ。詳細については「サービスカタログ変数のタイプ」を参照してください。
   カタログアイテム	変数を使用したカタログアイテムです。
   順番	変数がカタログアイテムのページに配置される順番です。変数は、上から下へ最小順序値から最大順序値まで編成されます。たとえば、順序値が 1 の変数は、順序値がより大きいその他の変数の上に配置されます。
   アクティブ	変数を使用可能にするためのチェックボックスです。
   必須	変数を注文プロセスの一部として必須にするためのチェックボックスです。 注: この動作はページのロード時にのみ適用されて、クライアント API から変更できます。
   読み込み専用	変数を読み込み専用または編集可能にするオプション。
   非表示	変数を非表示にするオプション。
   一意	複数行の変数セット内でこの変数の値の重複を禁止するオプション。 注: このフィールドは、複数行の変数セットで作成された変数に対してのみ表示されます。 この動作は、ServiceNow AI Platform、サービスポータル、および エージェントワークスペース の変数エディターでのみ適用できます。
   最初のスロット入力を無効にする	カタログアイテムフォームに事前に入力する、発信者提供のキーと値のペアの使用を有効にするかどうかを決定するためのチェックボックスです。
   選択する必要があります	ユーザーにチェックボックス変数を選択するように要求するためのチェックボックスです。たとえば、このオプションを使用して、ユーザーに合意フォームの [I agree] (同意します) チェックボックスをオンにするように要求します。ユーザーがチェックボックスを選択せずに契約フォームを送信しようとすると、チェックボックスをオンにする必要があることをユーザーに伝える警告メッセージが表示されます。
   グローバル	これを選択した場合、デフォルトではサービスカタログワークフローまたは実行計画内のすべてのカタログタスクで変数を使用できます。この選択を解除した場合、変数を個々のカタログタスクに関連付ける必要があります。
   フィールド	変数がマップされるフィールドです。 このフィールドが表示されるのは、変数がレコードプロデューサーに属する場合です。
   レコードプロデューサーテーブル	レコードプロデューサーがレコードを作成するテーブルです。 このフィールドが表示されるのは、変数がレコードプロデューサーに属する場合です。
   質問
   質問	ユーザーにカタログアイテムの注文を尋ねる質問です。
   名前	質問を識別するための名前です。 注: このフィールドが空の場合、その値は、ブレーク、コンテナ分割、コンテナ終了を除くすべての変数タイプの [質問] フィールドに基づいて自動的に設定されます。
   ツールヒント	ユーザーが変数を指したときに表示されるツールチップのテキストです。簡潔なメモを入力して「質問」の目的を説明します。
   サンプルテキスト	ユーザーが値を入力する前に質問フィールドに表示されるヒントです。 次の変数に適用されます。 IP アドレス メール URL 1 行テキスト ワイドな 1 行テキスト 複数行テキスト 日付 日付/時刻
   リッチテキスト	カタログアイテムフォームに表示される書式設定されたラベル。 リッチテキストラベル変数に適用できます。
   注釈
   ヘルプ表示	選択すると、変数のヘルプテキストと指示が表示されます。 注: これは、ブレーク変数とチェックボックス変数では使用できません。 ヘルプテキストと指示は、変数セットには使用できません。
   常に展開	これを選択した場合、デフォルトではカタログアイテムページのロード時に [ヘルプテキスト] と [説明] フィールドの値が展開されます。 このチェックボックスが表示されるのは、[ヘルプ表示] チェックボックスをオンにした場合です。 注: また、このフィールドはサービスポータルにも適用されます。 このフィールドは、ワークスペースの変数エディターとカタログアイテム UIB コンポーネントでは適用できません。 カタログアイテムレベルで [すべての質問のヘルプを展開] チェックボックスがオンになっている場合、変数レベルの [常に展開] フィールド設定が上書きされます。 カタログアイテムレベルで [すべての質問のヘルプを展開] チェックボックスがオフの場合は、変数レベルで [常に展開] フィールド設定が適用されます。
   ヘルプタグ	[常に展開] チェックボックスをオフにした場合は、このフィールドで指定された値をクリックして、[ヘルプテキスト] と [説明] フィールドの値を表示します。 このフィールドは、ワークスペースの変数エディターとカタログアイテム UIB コンポーネントでは適用できません。
   ヘルプテキスト	サービスカタログ変数のヘルプ情報です。 このフィールドは、ServiceNow AI Platform、サービスポータル、およびワークスペースの変数エディターとカタログアイテム UIB コンポーネントで適用できます。 ただし、ワークスペースとカタログアイテム UIB コンポーネントでは、ヘルプテキストまたは指示のいずれかを表示できます。指示とヘルプテキストの両方が利用可能な場合は、指示のみを表示できます。 このフィールドは、ブレーク、チェックボックス、コンテナ終了、コンテナ分割、マクロ、および UI ページの変数には適用されません。ワークスペースとカタログアイテム UIB コンポーネントでは、このフィールドをマスク済み変数に追加で適用することはできません。
   説明	ヘルプ情報をサポートするためにリッチテキストの書式設定または画像の追加が必要な情報です。 このフィールドは、ServiceNow AI Platform、サービスポータル、およびワークスペースの変数エディターとカタログアイテム UIB コンポーネントで適用できます。 ただし、ワークスペースとカタログアイテム UIB コンポーネントでは、ヘルプテキストまたは指示のいずれかを表示できます。指示とヘルプテキストの両方が利用可能な場合は、指示のみを表示できます。 ワークスペースとカタログアイテム UIB コンポーネントでは、このフィールドをマスク済み変数に追加で適用することはできません。 注: HTML テーブルの場合、変数の幅以内のサイズを使用してください。
   タイプ仕様 (このセクションのフィールドは変数タイプごとに異なります)
   変数の幅	カタログアイテムページの変数の幅です。画面サイズの何パーセントに及ぶかを指定します。詳細については、「サービスカタログ変数のデフォルト幅を設定する」を参照してください。 このフィールドは、ブレーク、コンテナ終了、コンテナ開始、コンテナ分割、コンテナレイアウト、ラベル変数を除くすべての変数タイプに表示されます。
   [追加要求] の有効化	複数のユーザーに対してカタログアイテム要求を送信できるようにするオプション。このオプションを選択すると、[追加要求 (Also request for)]フィールドが要求元変数とともにカタログアイテムに表示されます。 この機能は サービスポータルでのみ適用できます。 このフィールドは、要求元変数にのみ適用できます。 委任された要求エクスペリエンスについては、「Delegated request experience」を参照してください。
   [追加要求] を使用するロール	複数のユーザーにカタログアイテム要求を送信できるロールを指定するオプション。 この機能は サービスポータルでのみ適用できます。 このフィールドは、要求元変数にのみ適用できます。 このフィールドは、[追加要求の有効化 (Enable also request for)] チェックボックスがオンになっている場合にのみ表示されます。 注: ロールが指定されていない場合は、カタログアイテムにアクセスできるすべてのユーザーが要求を送信できます。 委任された要求エクスペリエンスについては、「Delegated request experience」を参照してください。
   選択肢の表示方向	選択リストが配置される方向です。 [交差]：選択肢を水平に配置します。 [下]：選択肢を垂直に配置します。 このフィールドは、複数選択肢のルックアップの変数に表示されます。 注: 選択した方向は、サービスポータルにも適用されます。
   選択肢フィールド	変数のオプションを設定するためのテーブルフィールドです。フィールドに選択肢が定義されていない場合、変数によってテーブルからフィールド関連の個々の値がロードされます。 このフィールドは、選択ボックス変数に表示されます。
   選択肢テーブル	[選択肢フィールド] に値を設定するためのテーブルです。 このフィールドは、選択ボックス変数に表示されます。
   第一選択肢をデフォルト選択しない	カタログアイテム ページで変数のすべてのオプションをクリアするためのチェックボックスです。 このチェックボックスをオンにした場合、変数の第一選択肢がデフォルト選択されます。 このフィールドは、複数選択肢変数および数値スケール変数に表示されます。
   ダイナミック参照修飾子	ダイナミック修飾子です。参照フィールドに対してクエリを実行する動的フィルターを選択します。 このフィールドは、[参照修飾子を使用] が [ダイナミック] に設定されている場合の参照変数に表示されます。
   なしを含む	選択肢のリストに [なし] オプションを含めるためのチェックボックスです。 このフィールドは、複数選択肢のルックアップ、選択ボックスのルックアップ、複数選択肢、および選択ボックスの変数に表示されます。
   レイアウト	列が 1 つであるか、2 つであるかのコンテナのレイアウトです。 このフィールドは、コンテナ開始変数に表示されます。
   リストテーブル	リストコレクタの値を含む表です。このテーブルには表示列を指定する必要があります。 このフィールドは、リストコレクター変数に表示されます。
   ルックアップソース	ルックアップソース。[テーブル] または [選択肢] を選択します。デフォルトでは、[テーブル] が選択されています。
   テーブルからルックアップ	ユーザーが選択する値を取得するテーブルです。このテーブルの値は、[ルックアップ値フィールド] に入力されます。 このフィールドは、複数選択肢のルックアップの変数と選択ボックスのルックアップの変数、および テーブル ルックアップソースが選択されている場合に表示されます。
   ルックアップ値フィールド	変数のオプションを設定するルックアップテーブルのフィールドです。 このフィールドは、複数選択肢のルックアップの変数と選択ボックスのルックアップの変数、および テーブル ルックアップソースが選択されている場合に表示されます。
   ルックアップラベルフィールド	オプションの表示に値を使用するルックアップテーブルのフィールドのカンマ区切りリストです。 このフィールドは、複数選択肢のルックアップの変数と選択ボックスのルックアップの変数、および テーブル ルックアップソースが選択されている場合に表示されます。
   ルックアップ価格フィールド	注文されるアイテムの価格の変更に値を使用するルックアップテーブルのフィールドです。 このフィールドは、複数選択肢のルックアップの変数と選択ボックスのルックアップの変数、および テーブル ルックアップソースが選択されている場合に表示されます。
   定期的な価格のルックアップフィールド	注文されるアイテムの繰り返し発生料金の変更に値を使用するルックアップテーブルのフィールドです。 このフィールドは、複数選択肢のルックアップの変数と選択ボックスのルックアップの変数、および テーブル ルックアップソースが選択されている場合に表示されます。
   選択肢テーブル	このフィールドを使用して、目的の選択リストを含むテーブルを指定します。これは、[ルックアップソース] が [選択肢] に設定されている場合にのみアクティブになります。ここで選択したテーブルに関連付けられているすべての選択リストが、中央選択テーブル (sys_choice) に対してクエリーされます。
   選択肢フィールド	このフィールドを使用して、選択肢テーブルからオプションを表示する特定のフィールド (または「要素」) を選択します。たとえば、選択肢テーブルがインシデント [incident] の場合、[ 優先度]、[ ステータス]、または [カテゴリ ] フィールドを選択して、定義された選択肢を表示できます。
   選択肢の依存先：	同じカタログアイテムから別の変数を選択して、この変数の選択肢を依存させます。これにより、動的なフィルタリング効果が作成されます。現在の変数に表示されている選択肢は、ここで指定した変数でユーザーが選択した値に基づいてリアルタイムでフィルタリングされます。たとえば、このフィールドが「市区町村」の場合、ここで「国」変数を選択して、選択した国に基づいて関連する市区町村のみが表示されるようにすることができます。
   マクロ	カタログアイテムに挿入する UI マクロです。 このフィールドは、マクロ、ラベル付きマクロ、および UI ページの変数に表示されます。
   サマリーマクロ	これは、マクロ、およびラベル付きマクロタイプの変数にのみ適用されます。
   ウィジェット	これは、マクロ、およびラベル付きマクロタイプの変数にのみ適用されます。
   選択した場合、価格	アイテムの価格です。 このフィールドは、チェックボックス変数に表示されます。
   選択した場合、繰り返し発生する料金	ユーザーがアイテムについて複数の注文を要求した場合に、アイテムに対して増加する価格です。 このフィールドは、チェックボックス変数に表示されます。価格および繰り返し発生料金の詳細については、「価格セットアップの変数の使用」を参照してください。
   参照	変数の参照テーブル。このテーブルには表示列を指定する必要があります。 このフィールドは、参照変数に表示されます。
   参照修飾子	フィールドで使用可能なデータを制限する修飾子。 参照修飾子と高度な修飾子をサポートします。詳細については、「参照修飾子」を参照してください。 一致するすべての結果を返します (上限なし)。 注: セキュリティ上の理由から、[参照修飾子] フィールドでのスクリプトの使用は、[Allow javascript in Default Value] (デフォルト値で Javascript を許可) ビジネスルールによってシステムアドミニストレーターに制限されています。 このフィールドは、リストコレクター、複数選択肢をルックアップ、選択ボックスをルックアップ、参照、および 要求元変数に表示されます。 これは、[参照修飾子を使用] が [ダイナミック] に設定されている場合の参照変数に表示されます。
   参照修飾子の条件	条件をビルドするためのオプションです。 このフィールドは、[参照修飾子を使用] が [簡易] に設定されている場合の参照変数に表示されます。
   スケール最大値	変数に使用可能なオプションのスケールで最も大きい値です。 このフィールドは、数値スケール変数に表示されます。
   スケール最小値	変数に使用可能なオプションのスケールで最も小さい値です。 このフィールドは、数値スケール変数に表示されます。
   一意の値のみ	フィールドに一意の値を要求するためのチェックボックスです。このチェックボックスをオンにした場合、2 つのレコードでそのフィールドの値を同じにすることはできません。 このフィールドは、複数選択肢のルックアップ、選択ボックスのルックアップ、および選択ボックスの変数に表示されます。
   確認を使用	ユーザーにデータを再入力して各自のエントリを確認するように求めるためのチェックボックスです。 このフィールドは、マスクされた変数に表示されます。
   暗号化を使用	回答を暗号化形式でデータベースに保存するためのチェックボックスです。暗号化されない場合、回答はプレーンテキスト形式で保存されます。暗号化では、システム暗号化とともに Triple DES を使用します。 このフィールドは、マスクされた変数に表示されます。
   参照修飾子を使用	使用する修飾子のタイプです。 このフィールドは、参照変数に表示されます。
   検証用の正規表現	変数値を検証する正規表現です。このフィールドは、1 行テキストとワイドな 1 行テキストの変数タイプに対してのみ表示されます。 正規表現を定義するには、「Define a regular expression for a variable」を参照してください。 注: また、このフィールドはサービスポータルにも適用されます。 検証用の正規表現が設定されていても、max_length 属性値は有効です。 正規表現検証エラーのあるカタログアイテムをウィッシュリストに追加することはできません。
   変数の属性	変数の動作と制限を定義する属性。変数属性の詳細については、「サービスカタログ変数属性」を参照してください。
   トピックブロック	仮想エージェント会話で同じ動作を再現するには、カスタム変数またはカスタムラベル付き変数で使用される構成済みの UI マクロまたはウィジェットと同様のトピックブロックを指定します。 注: このフィールドは、「カスタム」および「ラベル付きカスタム」変数タイプでのみ使用できます。
   デフォルト値
   デフォルト値	変数のデフォルト値です。
   権限 このタブに読み込み、書き込み、または作成アクションのロールが指定されていない場合は、カタログ アイテムにアクセスできるすべてのユーザーが、ロールに関係なくこれらのアクションを実行できます。たとえば、[書き込みロール] フィールドにロールが指定されていない場合は、カタログ アイテムにアクセスできるすべてのユーザーが、変数エディタで変数値を編集できます。 次のロールのいずれにも一致しないロールを持つユーザーは、スクリプティングを使用しても変数値を設定できません。 これらのロールは、ラベル、ブレーク、コンテナ分割、コンテナ終了、マクロ、ラベル付きマクロ、および UI ページの変数では利用できません。
   読み込みロール	カタログアイテムまたはレコードプロデューサーの要求前後に変数を表示できるロールです。このフィールドで指定されたロールを持つユーザーのみが変数を表示できます。
   書き込みロール	カタログアイテムまたはレコードプロデューサーの要求後に変数エディターで変数を編集できるロールです。ユーザーがこのフィールドに指定されたロールを持っていない場合、変数は変数エディターで読み込み専用になります。
   作成ロール	カタログアイテムまたはレコードプロデューサーの要求前に変数の値を作成できるロールです。ユーザーが指定されたロールを持っていない場合、カタログアイテムまたはレコードプロデューサーの要求前の変数は読み取り専用です。
   可用性
   各所に表示	これを選択した場合、変数が、アイテムフォーム (アイテムを注文する前) 、VEditor (アイテムを注文した後)、およびアイテムの買い物かごビューに表示されます。
   バンドルに表示	これを選択した場合、アイテムをバンドルに追加したときに変数が表示されます。
   ガイドに表示	これを選択した場合、変数が注文ガイドに追加されたとき、または注文ガイドに含まれるカタログアイテムに追加されたときに表示されます。 注: 注文ガイドにあるアイテムおよび変数が多すぎる場合は、注文ガイドのロードパフォーマンスを改善するために、できるだけ多くのアイテムでこのチェックボックスをオフにすることを検討してください。
   サマリーに表示	これを選択した場合、カタログアイテムの任意の変数サマライザーに変数が表示されます。 サービスポータルでは、RITM チケットページと [承認] ページに変数が表示されます。 Now Mobile では、変数は RITM レコードと承認レコードに表示されます。
   対話型インターフェースから削除	カタログアイテムにアイテムを非会話型にする変数 (価格設定に関する変数など) がある場合は、チェックボックスをオンにしてカタログアイテムを会話型にします。 注: このオプションは、複数行の変数セット (MRVS) には適用されません。

5. [送信] をクリックします。

タスクの結果

フロー内の変数にアクセスするには、「カタログ タスクの作成」アクションまたは「カタログ変数の取得」アクションを追加します。