ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。

フォームフラグメントを使用したフォームの作成

フォームフラグメントを使用して、コンテンツページまたはページテンプレート上のフォームを作成および管理します。フォームフラグメントを使用すると、フィールドをオブジェクトにマッピングしたり、レイアウトを整理したり、フォームの設定を構成したりできます。オブジェクト間の関係性を処理したり、関連データを管理したり、サイトの要件に合わせてフォーム要素をカスタマイズしたりすることもできます。

フォームの作成

開始する前に、カスタムオブジェクトが作成されていることを確認してください。
コンテンツページまたはページテンプレートの編集を開始します。
（オプション）フラグメントを使用してレイアウトを設計します。詳細については、フラグメントを使用したレスポンシブレイアウトの構築を参照してください。
フォームコンテナ フラグメントをページに追加し、それをオブジェクトにマッピングします。

コンテナは、すべてのオブジェクトフィールドに対して送信ボタンとフラグメントを自動的に生成します。これらはアルファベット順に表示されます。必須項目にはその旨が明記されています。

Liferay DXP 2024.Q3+/Portal GA125+ ポップアップで、フォームに表示するフィールドと関連フィールドを選択します。フォームフラグメント内の関連フィールドの管理の詳細については、フォームコンテナフラグメント内のオブジェクト関係の処理を参照してください。
フォームに不要な、必須項目ではないフィールドを削除してください。

Liferay DXP 2024.Q3+/Portal GA125+ 利用可能なフィールドと関連フィールドを管理するには、 フォームコンテナ フラグメントを選択し、右側の [一般] タブの [コンテンツタイプ] の下の [フォームフィールドの管理 をクリックします。
フォームの断片をドラッグ＆ドロップして、並べ替えます。デフォルトでは、フォーム要素はアルファベット順に並べられます。
（オプション）フォームコンテナに基本的なフラグメントを追加します。基本的な構成要素（グリッド、区切り線、段落、画像など）を使用して、フォームコンテナに構造とスタイルを与えることができます。
フラグメントを設定します。フォームの断片には、標準のと固有の設定オプションの両方が含まれます。

注

フォームフラグメントをオブジェクトフィールドにマッピングすると、フォームフラグメントの設定オプションが利用可能になります。
ベータ機能 (オプション) オブジェクトでドラフトモードが有効になっている場合は、フォームの送信ボタンの送信済みエントリステータスを設定します: 承認済み または ドラフト。

重要

表示ページのエントリを更新するためにフォームフラグメントを使用する場合、エントリのステータスを承認済みから下書きに変更することはできません。
完了したら、公開をクリックしてください。

フォームコンテナフラグメント内のオブジェクト間の関係の処理

Liferay DXP 2024.Q3+/Portal GA125+

オブジェクト間のリレーションシップを管理し、コンテンツページや表示ページテンプレート内のフォームコンテナフラグメントから関連データを直接扱うことができます。

注

Liferay DXP 2025.Q3 では、子オブジェクトのフォームコンテナフラグメントを使用して関連オブジェクトフォームに親オブジェクトのエントリを作成する機能は非推奨となり、今後のリリースで削除される予定です。今後は、親から子への作成のみがサポートされます。まず親オブジェクトのエントリを作成し、次に親オブジェクトのフォームから関連する子エントリを作成する必要があります。

フォームフラグメント内のオブジェクト関係を管理するには、

コンテンツページまたは表示ページテンプレートを作成します。
フォームコンテナフラグメントをページに追加します。
フォームコンテナフラグメント内でオブジェクトを選択すると、関連フィールドを含む利用可能なフィールドが選択可能なオプションとして表示されるウィンドウが開きます。 1つまたは複数のフィールドを選択し、 をクリックして保存 をクリックすると、フォームにデータが入力されます。

この例では、従業員プロファイルオブジェクトと車両オブジェクトは一対多の関係にあり、各従業員は複数の車両に関連付けられる可能性があります。フォームを生成する際、両方のオブジェクトからフィールドを選択して組み合わせることで、必要な情報をすべて取得できます。

ヒント

また、従業員詳細の入力、車の割り当て、入力内容の確認など、ユーザーがさまざまなステップをナビゲートできるマルチステップアプリケーションを作成することもできます。
フィールドを選択した後、 フォームコンテナ フラグメントをクリックし、右側の「一般」タブの「コンテンツタイプ」の下にある「フォームフィールドの管理」ボタンを使用して、フィールドを管理します。
または、テキストフィールドまたは選択リストフィールドを選択し、右側の「ソース」と「フィールド」オプションを設定して、これらのフィールドを手動で管理することもできます。