フォーム項目タイプのリファレンス¶
Liferayフォームアプリケーションには、フォームに追加する多くの項目タイプと要素が含まれています。 利用可能な要素を発見するために
プロダクトメニュー(
)を開き、サイト管理メニューのコンパスアイコン(
)をクリックします。 フォームを作成するサイトを選択します。
<0コンテンツ> & データ → フォーム をクリックします。
追加 ボタン(
)をクリックします。 フォームビルダービューが表示されます。
追加 ボタン(
)をもう一度クリックして、 [要素を追加] サイドバーを表示します(まだ開いていない場合)。
フィールド設定の概要¶
フォームビルダーで新しいフィールドを追加したり、既存のフィールドをクリックすると、フィールド設定エディタのサイドバーが表示されます。 使用できる設定オプションは、項目タイプによって異なります。
すべてのフォームフィールドには、ベーシックとアドバンスの少なくとも2つの設定タイプがあります。 多くのフォームが 基本的な設定で作成可能です。フォームには、ラベルや、プレースホルダーテキスト、ヘルプテキストが含まれ、フィールドが必要か、どのようなメッセージが必要かを決められます。 さらにフィールド固有の設定もあります。
高度な設定には、 規定値の値、検索設定、フィールドが繰り返し可能かどうか、システム/プログラムのフィールド参照、フィールドの確認、フィールドが隠されているかどうかなどがあります。 さらにフィールド固有の設定もあります。
非表示のフィールド¶
時には、外部ソース( REST データプロバイダなど)からの情報を、 フォームルールをトリガするためにのみ使用されるフォームフィールドに渡すことが有用です。 この場合、フィールドの非表示設定(Liferay 7.4の新機能)を使用します。
フィールド確認¶
フィールド確認は、バージョン7.4以降のLiferayフォームでサポートされています。 確認フィールドは、フォームビルダーでフォーム本体に直接追加するフィールドではなく、1行のテキストまたは数値フィールドを [確認が必要] に設定した場合にのみフォームに表示されます(フィールドの詳細設定セクションを使用)。 このフィールドでは、重要なデータを持つフィールドが正しく入力されるようにします(例えば、メールアドレスのフィールドなど)。
確認フィールドを有効にすると、新しい設定オプションが表示されます。
方向: 垂直(デフォルト)または水平を選択して、確認フィールドを元のフィールドの下に表示するか、横に表示するかを決定します。
ラベル: 元のフィールドラベルのプレフィックスを選択します。 デフォルト値はConfirmなので、Email Addressというフィールドの確認フィールドのラベルは、 Confirm Email Address となります。
エラーメッセージ: 確認するフィールドに応じて、より具体的なエラーメッセージを提供することができます。
ユーザーが有効な形式で情報を入力できるようにするための情報は、 Validating Text and Numeric Field Entries を参照してください。
フィールド名、フィールドID、およびフィールドの参照¶
Liferay 7.3の最初のリリースでは、編集可能な構成のField Nameが削除され、読み取り専用のField IDが各フィールドのAdvancedタブに含まれるようになりました。 しかし、Liferay 7.3では、編集可能な代替品であるField Referenceが利用できるようになりました。 プログラムでフィールドを参照する場合は、7.2のフィールド名の値と7.3以降のフィールド参照を使用します。
フォームのフィールドと要素¶
パラグラフ¶
パラグラフフィールドは、フォーム作成者が入力した静的なテキストをフォーム上に表示します。 ユーザーは説明文フィールドにデータを入力しません。 これは、指示が長い場合に役立ちます。
パラグラフフィールドは単なるテキストではありません。 埋め込み式のコンテンツエディターを使って、リッチコンテンツを作成します。
テキスト項目¶
ユーザーはこれらのフィールドに自由形式のテキストを入力します。 たとえば、氏名フィールドはテキストフィールドです。 デフォルトでは、テキストフィールドはすべての入力を1行のテキストに保持します。 より長い応答に対応するには、この例のようにテキストフィールドを構成するときに複数行設定を選択します。 テキストフィールドの検証オプションを使用して、ユーザーが入力できるテキスト(1〜10の数字、電子メールアドレスなど)を制限できます。
プルダウン¶
ユーザーは、選択肢のリストから1つ(または許可されている場合は複数)のオプションを選択します。 選択肢は手動で入力するか、データプロバイダーによって自動的に入力されます。 たとえば、居住国フィールドは、Countries of the Worldデータプロバイダーによって入力されたリストフィールドから選択できます。
日付¶
ユーザーは日付ピッカーを使用して日付を選択します。
Liferay 7.4では、日付フィールドの詳細設定に入力値の検証が含まれています。
入力値の検証のオプションは以下の通りです。
受け入れられた日付: 選択された日付が、未来の日付、過去の日付、または指定された範囲であることを要求します。
開始日と終了日 未来の日付の場合は、デイトピッカーの開始日の日付を定義します。 過去の日付については、終了日を定義します。 日付ピッカーが応答日(ユーザーがフォームに入力する日付)を使用するか、この値のカスタム日付を使用するかを構成します。 日付範囲の検証には、開始日と終了日の両方が設定されている必要があります。
エラーメッセージ: エラーメッセージは、特定の検証ルールに合わせてカスタマイズできます。
グリッド¶
ユーザーは、ラジオボタンを使用して、行と列に配置されたオプションから選択します。 行ごとに1つの選択を行うことができます。 これは、複数の質問に同じ回答メトリックが必要な場合に役立ちます。
数値¶
ユーザーは数値データ(整数または小数)を数値フィールドに入力します。 数字以外の入力は受け付けません。
数値フィールドには、興味深い詳細なフィールド設定があります。
確認要求 ユーザがデータを正しく入る性を保証します。
**入力値の検証 ユーザーの入力を事前に設定された要件に制限します。
入力マスク では、ユーザーが数値データを入力する際に、正しいフォーマットを表示することができます。 整数フィールドと10進数フィールドでは、コンフィギュレーションの動作が異なります。
整数フィールドのマスク:フォーマットを設定します。 2番目のエントリである文字オプションは、フォーマットを定義するために使用される文字の動作に関する追加のガイダンスを提供する読み取り専用のフィールド設定です。
10進数フィールドのマスク:千値セパレーター、少数セパレーター、プレフィックスまたはサフィックスの設定を行います。 1000区切りセパレータースタイルは、
None
、1,000
、1.000
または1 000
に設定できます。 少数セパレーターのスタイルは、0.00
または0,00
に設定できます。 接頭辞または接尾辞。 接頭辞または接尾辞は通常、10進数の単位を定義するために使用されます。 例えば、ユーザーがドルを入力することを前提としたフィールドには、$
をプレフィックスとして使用します。
アップロード¶
アップロードフィールドを使用すると、ユーザーはローカルファイルシステムからファイルをアップロードできます。 ログインしているユーザーは、以前にアップロードしたファイルから選択するか、新しいファイルをアップロードできます。
注釈
7.2でログインすると、ユーザーはドキュメントとメディアライブラリから既存のファイルを選択するか、ローカルファイルシステムからファイルをアップロードすることを選択できます。
Liferay 7.3 (DXP FP1およびCE GA7 )以降、認証されていないゲストユーザーにファイルのアップロードを許可することができます。 フォームフィールドの設定でゲストのアップロードを有効にします。
アップロードされたドキュメントは、 ドキュメントとメディアリポジトリ非表示フォルダに保存されます。 [ドキュメントとメディア]アプリケーションで表示するには、 ポータルプロパティ を portal-ext.properties
ファイルに設定します。
dl.show.hidden.mount.folders=true
コントロールパネル:[システム設定]→ [フォーム(コンテンツとデータ)] → [フォーム]で、または、com.liferay.dynamic.data.mapping.form.web.internal.configuration.DDMFormWebConfiguration.config
という名前の設定ファイルを作成して、ゲストのアップロード動作を設定します。
ちなみに
インスタンススコープ../../../system-administration/configuring-liferay/understanding-configuration-scope.html#scope-definitions`__でフォームアプリケーションを設定するには、[Instance Settings]のフォームエントリーを使用します。
Guest Upload File Extensions(guestUploadFileExtensions
): 受け入れられるファイル拡張子のコンマ区切りリストを入力します。 デフォルトでは以下のリストがサポートされています:doc
、docx
、jpeg
、jpg
、pdf
、png
、ppt
、pptx
、tiff
、txt
、xls
、およびxlsx
。
Guest Upload Maximum file Size(guestUploadMaximumFileSize
): ゲストユーザがアップロードフィールドからアップロードできるファイルの最大サイズを設定します。 これは、ドキュメントとメディアアプリケーションの設定で、認証されたユーザーに対して設定され、システム全体の制限は、アップロードサーブレットリクエストシステム設定エントリーの[合計最大アップロードリクエストサイズ]というフィールドで定義されます。 デフォルトでは25MBに設定されています。
Maximum Repetitions for Upload Fields(maximumRepetitionsForUploadFields
): フィールドが繰り返し可能に設定されている場合、ユーザーがフィールドをフォームに追加できる最大回数を設定します (ゲスト ユーザーとログインしたユーザーに同じように適用されます)。 デフォルトでは5に設定されています。
Maximum Submissions for Guest Upload Fields(maximumSubmissionsForGuestUploadFields
): ゲストが使用可能なアップロード フィールドを含むフォームを、ゲスト ユーザーが送信できる最大回数を設定します。 ゲストユーザーのIPアドレスは、送信数の記録のために使用されます。 デフォルトでは5に設定されています。
Image¶
ユーザーは、Webコンテンツ画像、ドキュメントとメディアライブラリから画像ファイル(.gif
、.jpeg
、.jpg
、.png
)を選択したり、ローカルファイルシステムから画像ファイルをアップロードしたりすることができます。
重要
ゲストユーザーは、画像へのアクセスやアップロードができません。 認証されたユーザーのみがフォームにアクセスできる場合を除き、このフィールドは使用しないでください。
位置を検索¶
Liferay 7.4以降の[ロケーションの検索]フィールドを使用して、フォームユーザーから有効なアドレスを簡単に収集します。
詳細については、 検索場所フィールドを使う を参照してください。