フラグメント変数のコンテナへの自動作成およびワイヤリング

入力パラメータとして有効になっているフラグメント変数または定数をマークして、フラグメントを使用するコンテナに自動的に作成できます。このようにして、ページがフラグメントから作成されるか、フラグメントが既存のページまたはコンテナにドロップされると、Visual Builderはページに変数(または定数)を作成し、それをフラグメント変数(または定数の)値にワイヤリングします。

このオプションは、フラグメントが機能するために入力パラメータをページから渡す必要がある場合に特に役立ちます。必要な入力パラメータを自動的にワイヤリングすることで、フラグメントが追加されたときにこれらの変数をページで作成および構成する必要はありませんが、値を割り当てる必要があります。さらに、自動適用変数に「プロパティ・ペインに拡張UIを表示するカスタマイズ」が含まれている場合、それらのカスタマイズもコンテナに引き継がれます。

ノート:

pageContent (デフォルト)またはpageとして「使用対象設定」 (プロパティ・ペインまたは設定エディタのいずれか)にタグ付けされたフラグメントのみをコンテナで自動調整できます。

親コンテナに作成する変数または定数を含むフラグメントを開きます。
変数タブで、変数または定数を選択してプロパティ・ペインを表示します。変数または定数が入力パラメータとして有効になっている場合(入力パラメータで有効または必須が選択されている場合)、「コンテナ・オプション」セクションにさらにプロパティが表示されます:

図fragmentvar-autowire-container.pngの説明
コンテナにこの変数を作成またはコンテナにこの定数を作成を選択します:

図fragmentvar-autowire-container-options.pngの説明
このオプションを選択すると、@dt.createOptionsメタデータがフラグメントのJSON定義に追加されます。次に例を示します:
```
  "variables": { 
    "days": {
      "type": "number",     
      "input": "fromCaller",
      "defaultValue": "5",
      "@dt": {       
        "createOptions": {}
      }  
    },
```
オプショナル: デフォルトでは、定数は定数および変数としてコンテナ(作成方法の下の自動)に変数として作成されます。ほとんどの場合、この設定を維持できますが、一部のシナリオでは、フラグメントがページ・レベルのプロパティを入力パラメータとして受け入れる場合、その値はページのスコープ内で評価される式です。一方を他方に切り替えることもできます: 変数の定数、または定数の変数。
たとえば、フラグメントがtitleを変数として定義し、その値が次のような式に基づいてページから渡されるとします:
```
  "title": {
     "defaultValue": "[[ 'Edit Employee: ' + $variables.data.firstName + ' ' + $variables.data.lastName ]]",
   },
```
このようなシナリオでは、firstNameおよびlastName値は、ページがロードされるときにフラグメントによって内部的にフェッチされたデータから取得され、$variables.data変数の一部としてページで使用できるようになるため、フラグメントはページ上の式を実際に解決できます。ページ・レベルのtitleがまったく変更されない場合は、titleを(変数ではなく)定数としてページ上で自動作成するように選択できます。このようにして、titleはフラグメント内に変数を保持し(ページ上の$variables.dataの変更がフラグメントに反映されるようにします)、ページ上で定数として自動作成できます。
オプショナル: コンテナ内の変数または定数をコンテナの入力パラメータにする場合:
- 「入力パラメータ」で、「有効」を選択してコンテナ変数または定数をオプションの入力パラメータにするか、「必須」を選択してコンテナ変数または定数を必須の入力パラメータにします。
- この入力パラメータをURLの一部としてコンテナに渡す場合は、「URLに渡す」を選択します。
オプショナル: bindingメタデータをコンテナ内の変数または定数に追加して、フラグメントから入力パラメータのデータ定義を取得し、ページに表示する場合は、ページへのバインドをOnに設定します。この設定を有効にすると、変数または定数は、フラグメントの場合と同様に、カスタマイズされた入力値をページに表示します。したがって、フラグメントの定数に対して列挙リストを定義した場合、それらの同じ値がフラグメントのプロパティの一部としてページに表示されます。

ページまたはコンテナにフラグメントを追加すると、ページまたはコンテナの変数エディタに、指定した設定で作成した変数または定数が表示されます。

ページのコードを確認すると、HTMLでワイヤリングされたパラメータが表示されます。次に例を示します:

  <oj-vb-fragment bridge="[[vbBridge]]" name="welcome" class="oj-flex-item oj-sm-12 oj-md-12">
    <oj-vb-fragment-param name="avatar" value="[[ $variables.avatars ]]"></oj-vb-fragment-param>
    <oj-vb-fragment-param name="days" value="[[ $variables.days ]]"></oj-vb-fragment-param>
    <oj-vb-fragment-param name="title" value="[[ $variables.title ]]"></oj-vb-fragment-param>
  </oj-vb-fragment>