ガイドパネルへの項目の追加

エディターでガイド内のパネルに項目を追加します。パネルに項目を追加するには、項目をエディターにドラッグします。Data Model ビューから項目を追加するか、エディターでガイド固有の項目を追加できます。エディターで追加する項目は、他のガイドで再利用できません。また、データモデルの一部にすることもできません。これらの項目には、テキスト、ボタンおよびネストされたパネルなどがあります。

Data Model ビューからの項目の追加

Data Model ビューは、ガイドの基礎であるモデルの構造化された表示です。モデルは、Workbench の Data Model パースペクティブで作成されたデータモデル（FML）か、Designer で作成された XDP または PDF フォームです。

Data Model ビューで、エンティティまたはプロパティをガイド内のパネルに追加できます。Data Model ビューには、ガイドを作成したときに選択したルートエンティティに含まれているエンティティおよびプロパティが表示されます。

データオブジェクトやリストソースなど、パネルに追加できるその他の項目を作成することもできます。データオブジェクトやリストソースなど、Data Model ビューに追加した項目は、現在のガイドのみに適用され、元のモデルには保存されません。モデルを変更する必要がある場合は、モデルソースファイルを編集します。例えば、Data Model パースペクティブで FML ファイルを編集するか、Designer で XDP ファイルを編集します。

ガイドを作成するには、Data Model ビューからエディターまたは Guide Tree ビューに項目をドラッグします。

注意： ガイドが XDP または PDF フォームに基づく場合、ID プロパティまたは署名フィールドをガイドに追加しないでください。

  1. Guide Tree ビューで、項目を追加するパネルを選択します。

  2. Data Model ビューで、追加する項目をクリックします。

  3. エディターまたは Guide Tree ビューで、項目をパネルにドラッグします。

  4. 必要に応じて、Guide Properties ビューでプロパティを設定します

エディターでの項目の追加

エディターで、ガイド専用項目をガイド内のパネルに追加できます。これらの項目は、Data Model ビューには追加されず、他のガイドで再利用できません。次のガイド専用項目をパネルに追加できます。

テキスト
テキストをパネルに追加できます。例えば、パネルの説明を追加したり、フィールドにキャプションを追加したりできます。

ボタン
ボタンをパネルに追加できます。例えば、ボタンを使用して、表示ルールをガイドに追加したり、Data Model ビュー内の項目をバインドしたりします。Guide Properties ビューで、ボタンはフィールドと同じプロパティを持ちます。

ネストされたパネル
ネストされたパネルは、別のパネル内のパネルです。

テキストまたはボタンの追加

  1. Guide Tree ビューで、項目を追加するパネルを選択します。

  2. エディターの最上部で、Text または Button アイコンをパネルにドラッグします。Guide Properties ビューに、追加したテキストまたはボタンのプロパティが表示されます。

  3. Guide Properties ビューで、必要に応じてプロパティを指定します。

ネストされたパネルの追加

「ネストされたパネル」は、別のパネル内のパネルです。ネストされたパネルを使用すると、別のパネル内の個別のパネルとして定義されたパネルを表示および対話処理できます。

ネストされたパネルを使用する理由は、次のとおりです。

  • モジュール化された再利用可能な方法でパネルを定義し、他のパネル内で使用するため。例えば、ネストされたパネルを使用して、共通の情報パネルを各パネルの最上部に配置します。

  • パネル内で項目のグループを表示および非表示にするため。ネストされたパネルを使用して項目のグループを追加し、ネストされたパネルの表示ルールを設定して、必要に応じて表示または非表示にします。

  • 別のパネル内で別のパネルレイアウトのレイアウト機能を使用するため。例えば、ネストされたパネルを使用して、1 列のレイアウト内でグリッドまたはリピーターレイアウトを使用します。

  • リピーターレイアウトのヘッダー、繰り返しコンテンツおよびフッターとして、可変の列のレイアウトを使用するため。ネストされたパネルを使用しないと、ヘッダーおよびフッターでは 1 列に制限され、Repeater Tab または Repeater Accordion レイアウトでは 2 列に制限されます。

  • 繰り返しレイアウト内で別の繰り返しレイアウトをネストするため。

  • データモデル内のあるプロパティの値に基づいてネストされたパネルを表示するため。モデルプロパティをエディターにドラッグします。Guide Properties ビューで、Control Type／Display As／Nested Panel を選択します。ネストされたパネルに、モデルプロパティの値に対応したパネルが表示されます。例えば、モデルプロパティの値が「Panel 1」の場合、ネストされたパネルには「Panel 1」というタイトルのパネルが表示されます。ネストされたパネルをこの方法で使用するには、ガイド内の一連のパネルの名前を含むリストソースを作成します。ガイド入力者がリストから値を選択すると、選択した名前のパネルがリストの下に表示されます。

Guide Properties ビューで、ネストされたパネルはフィールドと同じプロパティを持ちます。

次の 2 つの方法のいずれかを選択して、ネストされたパネルをガイドに追加できます。

  • エディターのツールバーからネストされたパネルを追加し、ネストされたパネルとして使用するパネルを選択します。

  • フィールドをネストされたパネルとして表示します。Guide Properties ビューで、Control Type／Display As／Nested Panel を選択します。

エディターのツールバーからネストされたパネルを追加する場合、ネストされたパネルの Guide Tree ビューには次の 2 つの項目があります。

  • パネルレベルでは、Guide Properties ビューで Panel Title に対して指定する名前が項目に表示されます。

  • ネストされたパネルを含むパネルの下では、ネストされたパネルの Guide Properties ビューで Caption Text に対して指定する名前が項目に表示されます。

ネストされたパネルには、ネスト元のパネルを表示できません。ネストされたパネルにパネルを表示できない場合、パネルの代わりにパネル名が表示されます。

Guide Properties ビューで、パネルとネストされたパネルの両方に対して表示ルールを設定できます。ガイドナビゲーションパネルにパネルが表示されないようにするには、Display Rules で「Displayed」を選択解除します。ただし、ガイドをデバッグするときは、ナビゲーションパネルに元のパネルを表示すると役立つ場合があり、元のパネルをナビゲーターで個別に実行したり別のパネル内にネストして実行したりして確認すると役立つ場合があります。

ガイドには名前が一致した最初のパネルが表示されるので、ネストされたパネルの名前は一意である必要があります。

ネストされたパネルの追加

  1. Guide Tree ビューで、ネストされたパネルを追加するパネルを選択します。

  2. エディターで、Nested Panel ボタン をクリックし、パネルにドラッグします。Guide Properties ビューに、ネストされたパネルのプロパティが表示されます。

  3. Guide Properties ビューで、必要に応じて入力プロパティを設定します。

ガイド入力者がラジオボタンまたはチェックボックスを選択したときに表示される、ネストされたパネルを作成します。

Nested Panels レイアウトを使用して、ガイド入力者がラジオボタンまたはチェックボックスを選択したときに表示されるパネルを作成します。

Nested Panels レイアウトは、ガイド入力者がボタンまたはチェックボックスを選択したときに、選択されているパネルをラジオボタンまたはチェックボックスの下にネストします。ボタンまたはチェックボックスを選択解除すると、パネルは表示されなくなります。元のパネルの表示ルールに基づいてパネルを表示し、自動的にパネルをナビゲーションパネルから非表示にします。

  1. Guide Tree ビューで、ガイドにパネルを追加します。

  2. パネルの Guide Properties ビューで、「Layout」オプションから、「Nested Panels」を選択します。

  3. モデルで一連のブール値を定義します。ブール値は、Data Model パースペクティブ内の明示的な Boolean プロパティとして作成するか、ルールまたはリストソースとして作成します。

  4. Nested Panels レイアウトによって表示されているパネルの表示ルール上にブール値をドラッグします。

  5. パネル上にブール値をドラッグします。パネル上のブール値の位置によって、ネストされるパネルの表示位置が指定されます。チェックボックスまたはラジオボタンとして表示されます。ガイド入力者がチェックボックスまたはラジオボタンを選択すると、パネルがラジオボタンの下に表示されます。チェックボックスまたはラジオボタンを選択解除すると、パネルは非表示になります。

  6. この方法で複数のチェックボックスまたはラジオボタンをレイアウト上にドラッグできます。各チェックボックスまたはラジオボタンによって、1 つのパネルが制御されます。