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

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

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

フォームの作成

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

コンテナーは、すべてのオブジェクトフィールドの [送信] ボタンとフラグメントを自動的に生成します。アルファベット順に表示されます。必須フィールドにはそれに応じたマークが付けられます。

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

Liferay DXP 2024.Q3+/Portal GA125+ 利用可能な関連フィールドを管理するには、 フォームコンテナ フラグメントを選択し、コンテンツタイプの右側の[全般]タブで フォームフィールドの管理 をクリックします。
フォームフラグメントをドラッグアンドドロップして再編成します。デフォルトでは、フォーム要素はアルファベット順に整理されます。
(オプション) フォームコンテナーに基本フラグメントを追加します。基本コンポーネント (グリッド、セパレーター、段落、画像など) を使用して、フォームコンテナーに構造とスタイルを提供できます。
フラグメントを構成します。フォームフラグメントには、標準のと固有の構成オプションの両方が含まれます。

注

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

重要

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

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

Liferay DXP 2024.Q3+/ポータル GA125+

オブジェクト間の関係を管理し、コンテンツページまたは表示ページテンプレート内のフォームコンテナーフラグメントから関連データを直接処理します。

注

フォームコンテナフラグメント内のオブジェクト1:1関係のサポートは、Liferay DXP 2025.Q3で廃止され、将来のリリースで削除される予定です。

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

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

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

ヒント

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