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

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：4分

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

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

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

    ポータルでのフォームへの事前入力

    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)

      これらの変数値が事前に入力される順序は、カタログアイテムフォームで変数が定義される順序です。

    ネクストエクスペリエンス UI でのフォームの事前入力

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

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

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

    仮想エージェントでのインラインカタログアイテムのフォームへの事前入力

    仮想エージェント で使用されるインラインカタログアイテムフォームの事前入力値を設定できます。

    インラインカタログアイテムの事前入力フォームを構成するには、次の手順を実行します。
    1. トピックを開きます (例:カタログアイテムの要求 (Inline-seismic)。
    2. variableValues プロパティで、キーと値のペアを文字列形式の JSON オブジェクトとして指定します。

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

    この例では、画像に示すように、[部門] と [ビジネス上の根拠] の 2 つの変数があります。両方の変数の値を true に設定します。「部門」を「営業」として、「ビジネス上の根拠」を「従業員オンボーディング」として指定できます。仮想エージェントでのインラインカタログアイテムの事前入力フォームの例

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