オブジェクトでフォームを使用する¶
Liferay DXP 7.4以降で利用可能
Liferay Objectはフォームアプリケーションと統合されているため、ユーザー入力を受け取ってオブジェクトエントリーを作成するためのフォームを設計できます。 これを行うには、最初に新しいフォームを追加し、オブジェクトストレージタイプを使用するように構成します。 次に、目的のオブジェクトを選択し、フォームをデザインして、そのフィールドを選択したオブジェクトのフィールドにマップします。
注釈
ルールや検証を含むすべてのフォーム機能がオブジェクトでサポートされています。 ただし、ユーザーはオブジェクトリレーションをフォーム項目にマップすることはできません。 オブジェクトリレーションを含むカスタムレイアウトを作成する方法については、オブジェクトレイアウトの設計を参照してください。
オブジェクト用のフォームを追加する¶
次の手順に従って、オブジェクトエントリーを作成するためのフォームを追加します。
目的のサイトに移動し、 サイトメニュー（
）を開いて、 ［Content & Data］ → ［Forms］ に移動します。追加 ボタン（
）をクリックします。新しいフォームの ［設定］ ボタン（
）をクリックします。オブジェクト ストレージタイプと、フォームに接続する特定のオブジェクトの両方を選択します。
これにより、選択したオブジェクトのデータを保存するようにフォームが構成されます。
注釈
公開されたアクティブなオブジェクトのみが表示されます。 また、フォームは一度に1つのオブジェクトにのみ接続できますが、オブジェクトは複数のフォームに接続できます。
［完了］ をクリックします。
目的のオブジェクトにリンクしたら、フィールド要素をフォームに追加して、オブジェクトのフィールドにマップできます。
フォーム項目をオブジェクトフィールドにマップする¶
次の手順に従って、フォーム項目をオブジェクトフィールドにマップします。
フォームにフィールド要素を追加します。
［詳細設定］ タブをクリックします。
目的の オブジェクトフィールド を選択します。
必要なすべてのオブジェクトフィールドがフォーム項目にマップされるまで、上記のプロセスを繰り返します。
注釈
オブジェクトフィールドは、1つのフォーム項目にのみマップできます。
フォームレイアウトをデザインします。 フォームのデザインの詳細については、フォームのドキュメントを参照してください。
フォームのデザインが完了したら、 ［公開］ をクリックしてフォームの作成を終了します。
重要
オブジェクトフォームを公開する前に、すべての マッピング要件 を満たす必要があります。
公開後、フォームを使用して、選択したオブジェクトのオブジェクトエントリーを作成できます。
マッピング要件¶
オブジェクトストレージタイプのすべてのフォームには、次の要件があります。
データの損失を防ぐために、すべてのフォーム項目はオブジェクトフィールドにマップする必要があります。
必要なすべてのオブジェクトフィールドは、フォーム項目にマップする必要があります。
無効なマッピングを使用してフォームを公開しようとすると、何が問題であるかを示すエラーメッセージが表示されます。
フィールド互換性リファレンス¶
Liferay 7.4 U20以降の場合
オブジェクト項目タイプ |
互換性のあるフォーム項目 |
|---|---|
添付ファイル |
❌ |
ブール値 |
ブール値(チェックボックス) |
日付 |
日付 |
小数（以前はDouble) |
数値 → 小数 |
整数 |
数値 → 整数 |
長い整数 (以前はLong) |
数値 → 整数 |
長いテキスト（以前はClob) |
テキスト |
選択リスト |
リストから選択、１つだけ選択 |
小数の精度 (以前はBigDecimal) |
数値 → 小数 |
リレーション |
❌ |
リッチテキスト |
リッチテキスト |
Text (以前はString) |
テキスト、複数選択、グリッド、色 |