---
sourceDocument: オーストラリア ServiceNow AI Platform の機能
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/servicenow-platform

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア ServiceNow AI Platform の機能

ft:clusterId :

    - platcap

bundleId :

    - platcap

workflow :

    - Platform


---

# ポータル UI および ネクストエクスペリエンス UI のカタログアイテムフォームに変数値を事前入力する

# ポータル UI および ネクストエクスペリエンス UI のカタログアイテムフォームに変数値を事前入力する {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：4分

カタログアイテムの要求者がポータル ネクストエクスペリエンス または UI でアイテムを注文する場合は、変数の値が事前に入力されるキーと値のペアを使用するようにカタログアイテムを設定できます。要求者はフォームをより迅速に完成させることができます。

このメソッドで設定された値は、ユーザーが指定した値であるかのように適用されます。つまり、これらの値に対して動的な動作 (カタログ UI ポリシー、カタログクライアントスクリプトなど) が機能します。

この機能はデフォルトで有効になっています。この機能をオフにするには、 glide.sc.enable_url_prefill プロパティを false に設定します。

## ポータルでのフォームへの事前入力 {#prefill-variable-values-catalog-item-form__section_y3v_rgg_jgc}

URL を変更することで、 サービスポータル や 従業員センター などのポータルでカタログアイテムを設定してフォームに事前入力することができます。  
注:  
ポータルには、\[ URL 事前入力の無効化 (Disable URL prefill)\] というウィジェットインスタンスオプションがあります。このチェックボックスはデフォルトでオフになっています。その特定のポータルで URL 事前入力を無効にするには、このオプションを選択します。  
事前入力を設定するには、次のアクションを実行します。

1. URL パラメーター sysparm_variable_values を使用して、キーと値のペアをビルドします。キーと値のペアでは、「キー」は変数の名前で、値はその変数の値です。  
   注:  
   参照変数の値はsys_idである必要があります。
2. sysparm_variable_values の URL パラメーターとして値を指定します。たとえば、 部門 を「営業」として、 ビジネス上の根拠 を「従業員オンボーディング」として設定する場合は、次の URL を使用します。

   /sp?id=sc_cat_item\&sys_id=e56a7ffe41011300964ff05369414ebd\&sysparm_variable_values={"business_justification":"employee onboarding", "department":"221db0edc611228401760aec06c9d929"}
3. URL をテストするには、ブラウザのアドレスバーに URL を追加して開きます。ロード時に、\[ 部門 \] フィールドに「Sales」という値が事前入力され、\[ Business Justification (ビジネスの根拠)\] フィールドに「Employee Onboarding」という値が事前入力されていることがわかります。

   次の変数は事前入力ではサポートされていません。
   * 添付ファイル
   * カスタム
   * ラベル付きカスタム
   * ラベル、コンテナなどの変数タイプを取る非入力
   * マスク済み
   * UI ページ
   * 複数行の変数セット (MRVS)
   {#prefill-variable-values-catalog-item-form__ul_kvx_qhg_jgc}

   これらの変数値が事前に入力される順序は、カタログアイテムフォームで変数が定義される順序です。
{#prefill-variable-values-catalog-item-form__ol_jjc_chg_jgc}

## ネクストエクスペリエンス UI でのフォームの事前入力 {#prefill-variable-values-catalog-item-form__section_iks_n3g_jgc}

キーと値のペアを構成して、 ネクストエクスペリエンス UI でカタログアイテム要求フォームを事前に入力します。ネクストエクスペリエンス UI の場合、キーと値のペアは入力プロパティとしてコンポーネントに直接送信されます。

ユーザーがアイテムを選択した後にカタログアイテムまたはフォームがレンダリングされると、これらのキーと値のペアがオブジェクトとしてコンポーネントに渡されます。次に、コンポーネントはオブジェクトを解析し、それに応じてフォームに事前入力します。  
キーと値のペアを構成するには、次の手順を実行します。

1. 移動先 すべてNow Experience フレームワークエクスペリエンス.
2. 事前入力値を設定する UX アプリケーションを選択します。
3. \[UI ビルダーで開く (Open in UI Builder)\] を選択します。
4. 事前入力値を設定するカタログアイテムのページを開きます。
5. カタログアイテム macroponent で、variableValues プロパティを使用します。
6. 次の画像に示すように、プロパティを編集してキーと値のペアを追加します。
7. キーと値のペアを指定したら、アイテムを保存して選択します プレビューURL パスを開く.
{#prefill-variable-values-catalog-item-form__ol_ljk_s3g_jgc}

## 仮想エージェントでのインラインカタログアイテムのフォームへの事前入力 {#prefill-variable-values-catalog-item-form__section_avs_y3g_jgc}

仮想エージェント で使用されるインラインカタログアイテムフォームの事前入力値を設定できます。  
インラインカタログアイテムの事前入力フォームを構成するには、次の手順を実行します。

1. トピックを開きます (例:カタログアイテムの要求 (Inline-seismic)。
2. variableValues プロパティで、キーと値のペアを文字列形式の JSON オブジェクトとして指定します。
{#prefill-variable-values-catalog-item-form__ol_vlt_bjg_jgc}

この機能を構成するには 2 つの方法があります。文字列の JSON オブジェクトを指定することも、スクリプトを記述することもできます。

この例では、画像に示すように、\[部門\] と \[ビジネス上の根拠\] の 2 つの変数があります。両方の変数の値を true に設定します。「部門」を「営業」として、「ビジネス上の根拠」を「従業員オンボーディング」として指定できます。

これを設定すると、要求者がアイテムを要求すると、事前に入力されたフォームが表示されます。