オブジェクトレイアウトの設計
Liferay 7.4 U31+/GA31+ の場合
レイアウトは、エントリーを作成または編集するときにフィールドと関連がどのように表示されるかを定義します。 各レイアウトには、エントリー作成時または作成後に表示されるさまざまな要素を含む複数のタブを含めることができます。 レイアウトをデザインする際、2種類のタブがあります。
フィールドタブ は、オブジェクト定義で直接作成されたフィールドや、1対多の関連から継承されたフィールドを表示することができます。
関連タブ は、一対多または多対多の関連からの関連テーブルのみを表示することができます。
レイアウトを設計する際には、まずフィールドタブを追加する必要があります。その後、他のタブを追加できます。 オブジェクトエントリーの作成中は、最初のタブのみが表示されます。 オブジェクトエントリーの編集時には、他のタブが表示されます。 レイアウトのデザインが完了したら、 デフォルト としてマークし、使用します。
最初のタブはフィールドタブにしてください。 このタブには、すべての必須オブジェクトフィールドを含める必要があります。 また、レイアウトにフィールドタブがある後場合にのみ、関連タブを追加できます。 関連タブは、オブジェクトレイアウトの最初のタブにすることはできません。
レイアウトを追加する
[グローバルメニュー](
)を開き、 [コントロールパネル] タブに移動して、 [オブジェクト] をクリックします。
目的のオブジェクト定義の編集を開始します。
noteシステムオブジェクトは、カスタムレイアウトに対応していません。 詳しくは、システムオブジェクトの拡張を参照してください。
[レイアウト] タブを開き、 追加(
)をクリックします。
名前 を入力し、 [Save] をクリックします。
これにより、 フィールド と 関連 のタブを追加できる空白のレイアウトが作成されます。
フィールドタブの追加
[Layout] タブを開き、 [Add Tab] をクリックします。
ラベル を入力し、 フィールド タイプを選択し、 [Save] をクリックします。
このラベルによって、Liferay UIでのタブの表示名が決定します。
[Add Block] をクリックし、 ラベル を入力して、 [保存] をクリックします。
これにより、フィールドを追加するためのサブセクションが作成されます。 ラベルは、Liferay UIでのセクションの表示名を決定します。
同じタブに複数のブロックを追加する場合は、この手順を繰り返してください。
目的のブロックの [Add Field] をクリックし、オブジェクト フィールド を選択し、フィールドの サイズ(すなわち、1列、2列、または3列)を決定し、 [Save] をクリックします。
このステップを繰り返して、ブロックにフィールドを追加していきます。
トグルスイッチでブロックを折りたたみ可能にします。
必要なタブを追加した後、レイアウトの変更を保存します。
フィールドタブを追加した後、エンドユーザーがオブジェクトエントリにタグやカテゴリを適用できるように、カテゴリー設定ツールを追加できます。 詳細は、 フィールドタブへのカテゴリー設定の追加 を参照してください。
関連タブの追加
目的のレイアウトを編集し、 [Layout] タブを表示し、 [Add Tab] をクリックします。
ラベル を入力し、 [Relationships] タイプを選択し、タブに表示したい 関連テーブル を選択します。
このラベルによって、Liferay UIでのタブの表示名が決定します。
[Save] をクリックします。
必要なタブを追加した後、レイアウトの変更を保存します。
オブジェクトが自身と多対多の関係を持っている場合、そのレイアウトに2つのリレーションシップタブを追加することができます。 各タブは、関係の片側に対応しています。 例えば、複数のチケットを互いに関連付けるチケットオブジェクトを考えてみましょう。 チケットとその依存関係を追跡するために、2つのリレーションシップタブを定義することができます。 1 つのタブは、現在のチケットが依存しているすべてのチケットをリストアップし、もう 1 つのタブは、現在のチケットに依存しているすべてのチケットをリストアップします。 詳しくは、オブジェクト関係の定義をご覧ください。
デフォルトのレイアウトの選択
レイアウトを設計したら、それをオブジェクトのデフォルトレイアウトとして設定することができます。 これにより、オブジェクトのエントリーの作成と編集に確実に使用されるようになります。 そうでない場合は、オブジェクトは自動生成されたレイアウトを使用します。
次の手順を実行します:
目的の レイアウト を選択します。
[Basic Details]タブで、 [Mark as Default] をオンにします。
[Save] をクリックします。
オブジェクトのエントリーを作成および編集するときに、レイアウトが使用されるようになりました。