オブジェクトでフォームを使用する
Liferay DXP 7.4+
Liferayオブジェクトはフォームアプリケーションと統合されており、大量のデータ収集のための効率的なインターフェースを提供します。 この統合機能は、フォームビルダーのネイティブなルールと検証ツールを使用しながら、新しいオブジェクトのエントリを取得するように最適化されています。
データの整合性とパフォーマンスを確保するために、フォームとオブジェクトの統合の重要な側面には以下が含まれます。
-
エントリの作成: フォームは、新しいデータの入力ポイントとしてのみ設計されています。 既存のオブジェクトエントリを管理、更新、または削除するには、オブジェクトの管理インターフェースまたはヘッドレスAPIを使用します。
-
データ管理: オブジェクトストレージタイプを使用する場合、データライフサイクル管理はオブジェクトアプリケーション内で直接処理されます。 ただし、フォーム入力データのエクスポートはサポートされていません。
-
通知サポート: デフォルトのストレージタイプを使用するオブジェクトにマッピングされたフォームに対して、メール通知が利用可能です。 プロキシを使用するカスタムオブジェクト（外部システム内のデータを管理するオブジェクト）については、カスタム通知ロジックのためにオブジェクトアクションまたは外部ミドルウェアを使用してください。
- フォームアプリケーションのデータプロバイダをオブジェクトで使用することはできません。
- オブジェクト間の関係をフォームフィールドにマッピングすることはできません。 関係を表示または管理するには、 オブジェクトレイアウトの設計 を参照してください。
オブジェクト用のフォームを追加する
オブジェクトエントリを作成するためのフォームを追加するには、以下の手順に従ってください。
-
目的のサイトに移動し、 サイトメニュー (
) を開き、 コンテンツ & データ → フォーム に移動します。 -
追加 (
) をクリックします。 -
新しいフォームを開くには、 設定 (
) をクリックしてください。 -
オブジェクト ストレージ タイプと、フォームで使用するオブジェクトを選択してください。
これにより、選択したオブジェクトのデータを保存するようにフォームが設定されます。
注公開済みでアクティブなオブジェクトのみが表示されます。 フォームは一度に1つのオブジェクトにしか接続できませんが、オブジェクトは複数のフォームに接続できます。
-
［完了］ をクリックします。
目的のオブジェクトにリンクされると、フォームにフィールド要素を追加し、それらをオブジェクトのフィールドにマッピングできます。
フォーム項目をオブジェクトフィールドにマップする
フォームフィールドをオブジェクトフィールドにマッピングするには、以下の手順に従ってください。
-
目的のオブジェクトフィールドと互換性のあるフォームフィールドを追加します。
どのフォームフィールドが各タイプのオブジェクトフィールドと互換性があるかについては、 フィールド互換性リファレンス を参照してください。
-
詳細 タブをクリックします。
-
目的のオブジェクトフィールド を選択します。
警告必須オブジェクトフィールドにマッピングされると、フォームフィールドは自動的に必須項目としてマークされます。 フォームルールを使って 条件付きで必須フィールドを非表示にする場合、そのフィールドに適切なデータが含まれていることを確認しなければなりません。 定義済みの値 を 自動入力ルール と組み合わせて使用すると、必須の非表示フィールドが正しく入力されることが保証されます。
-
目的のオブジェクトフィールドがすべてフォームフィールドにマッピングされるまで、上記の手順を繰り返してください。
注オブジェクトフィールドは、1つのフォームフィールドにしかマッピングできません。
-
フォームレイアウト を設計します。
-
フォームの入力が完了したら、 公開 をクリックします。
重要オブジェクトフォームを公開する前に、すべての マッピング要件 を満たす必要があります。
公開後、このフォームを使用して選択したオブジェクトのオブジェクトエントリを作成できます。
マッピング要件
オブジェクトストレージタイプを持つすべてのフォームには、以下の要件があります。
-
データ損失を防ぐため、すべてのフォームフィールドはオブジェクトフィールドにマッピングされる必要があります。
-
必須のオブジェクトフィールドはすべて、フォームフィールドにマッピングする必要があります。
無効なマッピングを使用してフォームを公開しようとすると、エラーメッセージが表示されます。
フィールド互換性リファレンス
| オブジェクト項目タイプ | 互換性のあるフォーム項目 |
|---|---|
| 添付ファイル | ❌ |
| ブール値 | ブール値(チェックボックス) |
| 日付 | 日付 |
| 小数 (以前は Double) | 数値 → 小数 |
| 整数 | 数値 → 整数 |
| Long Integer (以前は Long) | 数値 → 整数 |
| 長文テキスト（以前は Clob） | テキスト |
| 選択リスト | リストから選択（手動リストのみ） 単一選択 |
| 小数の精度 (以前はBigDecimal) | 数値 → 小数 |
| リレーション | ❌ |
| リッチテキスト | リッチテキスト |
| テキスト (以前は文字列) | テキスト、複数選択、グリッド、色 |