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

  • リリースバージョン: Zurich
  • 更新日 2025年08月19日
  • 所要時間：4分

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

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

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

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

    URL を変更することで、 サービスポータル や 従業員センター などのポータルでカタログアイテムを構成して、フォームに事前に入力することができます。
    注:
    ポータルには、[ URL の事前入力を無効にする] というウィジェットインスタンスオプションがあります。デフォルトでは、このチェックボックスはオフになっています。特定のポータルで URL の事前入力を無効にするには、このオプションを選択します。
    事前入力を設定するには、次のアクションを実行します。
    1. URL パラメーター sysparm_variable_values を使用して、キーと値のペアをビルドします。キーと値のペアでは、key は変数の名前で、value はその変数の値です。
      注:
      参照変数の値はsys_idである必要があります。
    2. sysparam_variable_values の URL パラメーターとして値を指定します。たとえば、[ 部門 ] を「営業」に設定し、[ ビジネスの根拠 ] を「従業員のオンボーディング」に設定する場合は、次の URL を使用します。

      /sp?id=sc_cat_item&sys_id=e56a7ffe41011300964ff05369414ebd&sysparm_variable_values={"business_justification":"employee onboarding", "department":"221db0edc611228401760aec06c9d929"}

    3. URL をテストするには、ブラウザーのアドレスバーに URL を追加して開きます。

      ロード時に [部門 ] フィールドには「営業」という値が事前に入力され、[ ビジネスの根拠 ] フィールドには「従業員のオンボーディング」という値が事前に入力されていることがわかります。

      次の変数は事前入力ではサポートされていません。
      • 添付ファイル
      • カスタム
      • ラベル付きカスタム
      • ラベル、コンテナなどの非入力型変数タイプ
      • マスク済み
      • UI ページ
      • 複数行の変数セット (MRVS)

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

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

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

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

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

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

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

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

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

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

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