ルート パラメーターを使用したナビゲーション ガイド

    アプリケーションの状態を管理する方法のひとつとして、App Builder の特別な種類の変数 (ルート パラメーターなど) を使用すると、アプリケーション内のナビゲーションが容易になります。

    ルート パラメーターについて

    ルート パラメーターは変数として機能し、ユーザーによる作成、値の保存と割り当て、アプリケーション内の他のプロパティへのバインド、が可能です。ただし、ルート パラメーターには、ユーザーがアプリ内でナビゲーションを構築できるようにするという特定の用途があります (ナビゲーションを参照)。ナビゲーション ルートにパラメーター バインドが必要な場合、ユーザーはルート パラメーターをバインドしてこのプロセスを容易にすることができます。

    アプリ変数とルート パラメーターの主な違いは次のとおりです。

    • ルート パラメーターは子ビューでのみ作成でき、子ビューは特定のナビゲーション ルートのランディング ページとして機能します。
    • ルート パラメーターには、string (文字列)、numeric (数値)、または boolean (ブール型) のみを使用できます。他のタイプのサポートは将来のバージョンで導入される予定です。
    • ルート パラメーターは初期値をサポートしますが、boolean ルート パラメーターは FALSE 初期値のみをサポートします。
    • ルート パラメーターは、変数の設定アクションのターゲット変数ではありません。

    変数の概要

    ルート パラメーターの作成

    ユーザーは次の 2 つの方法でルート パラメーターを作成できます。

    1. [変数] セクションの [新しい変数] > [ルート パラメーター] フローを使用します。
    2. [プロパティ] パネルの一部である [ルート パラメーター] セクションの [+ 追加] ボタンを使用します。

    パラメーター名は、変数と同じ検証を受けます。

    ルート パラメーターの作成

    ルート パラメーターの使用法

    • 子ビューにルート パラメーターが 1 つだけある場合、それはアプリケーション ルーティングのパス パラメーターとして扱われます。これにより、pathParameter に特定の値を渡しながら、/child-view/pathParameter へのナビゲーションが可能になります。

    • ビューに対して複数のルート パラメーターが作成されると、これらのパラメーターはナビゲーションでクエリ パラメーターとして扱われます: /child-view/pathParameter=value1&pathParameter2=value2。ビュー内の唯一のルート パラメーターが boolean 型である場合、それはクエリ パラメーターのように扱われます。

    オプションおよび必須のルート パラメーター

    ルート パラメーターに初期値がある場合、それはナビゲーションのオプションのパラメーターとして扱われます。オプションのルート パラメーターを作成すると、アプリケーションに 2 つの有効なルートが存在することになります。

    1. /app/customerDetails/customerID
    2. app/customerDetails

    オプション 2 では、customerID パラメーターの値が設定されていない場合、customerID プロパティの処理はターゲット フレームワークによって異なる場合があります。Angular フレームワークと WebComponents フレームワークは、デフォルトで undefined (未定義) の値を割り当てますが、この値は、App Builder のプロパティに設定された初期値によってオーバーライドされます。

    ルート パラメーターを使用して子ページに移動する

    1. デザイン画面にコンポーネント (ボタンなど) を追加し、ドロップダウンから子ビューを選択して、それに [次へ移動] インタラクションをアタッチします。

    2. 選択した子ビューにルート パラメーターがある場合、ユーザーには追加のダイアログを開くオプションが表示され、そのダイアログで、ルート パラメーターに値を指定したり、変数をバインドしたりすることができます。

    エンドポイントからのデータの初期化

    その他のリソース