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

フォーム項目タイプのリファレンス

Liferayフォームアプリケーションには、フォームに追加する多くの項目タイプと要素が含まれています。利用可能な要素を見つけるには、

製品メニュー () を開き、サイト管理メニューのコンパスアイコン () をクリックします。フォームを作成するサイトを選択します。
コンテンツ & データ → フォームをクリックします。
追加ボタン () をクリックします。フォームビルダービューが表示されます。
追加ボタン () をもう一度クリックして、 要素の追加 サイドバーを表示します (まだ開いていないとき)。

多くの便利なフォーム要素があります。

注

フォームフィールドのグループ化と繰り返し: フォームフィールドは、フォーム全体で使用するためグループ化できます ( 要素セットを使用)。または、フォーム内でフィールドグループにすることもできます。フィールドを他のフィールドの上にドロップして、フィールドグループを作成します。さらに、各フィールドは設定で 繰り返し可能 としてマークすることができ、これによりフォームのエンドユーザーはフォーム内でフィールドを複製できるようになります。

フィールド設定の概要

フォームビルダーで新しいフィールドを追加したり、既存のフィールドをクリックすると、フィールド設定エディタのサイドバーが表示されます。使用できる設定オプションは、項目タイプによって異なります。

すべてのフォームフィールドには、ベーシックとアドバンスの少なくとも2つの設定タイプがあります。多くのフォームは、次のような基本的な設定だけで作成できます。

ラベル
プレースホルダーテキスト
必須（および必須メッセージの内容）
ヘルプテキスト

さらにフィールド固有の基本設定もあります。

［プルダウン］フィールドには、いくつかの基本設定があります。

詳細設定は以下の通りです。

初期値
検索設定
そのフィールドが繰り返し可能かどうか
システム／プログラムフィールドリファレンス
フィールド確認
フィールドが非表示かどうか

さらにフィールド固有の詳細設定もあります。

テキストフィールドにはいくつかの詳細設定があります。

非表示のフィールド

場合によっては、外部ソース ( REST データプロバイダーなど) からの情報を、フォームルールをトリガーするためだけに使われるフォームフィールドに渡すことが便利なことがあります。この場合、フィールドの非表示設定（Liferay 7.4の新機能）を使用します。

フィールド確認

フィールド確認は、バージョン7.4以降のLiferayフォームでサポートされています。確認フィールドは、フォームビルダーでフォーム本体に直接追加するフィールドではなく、1行のテキストまたは数値フィールドを ［確認が必要］ に設定した場合にのみフォームに表示されます（フィールドの詳細設定セクションを使用）。このフィールドでは、重要なデータを持つフィールドが正しく入力されるようにします（例えば、メールアドレスのフィールドなど）。

確認フィールドは、ユーザーが正しい情報を入力していることを確認するのに役立ちます。

確認フィールドを有効にすると、新しい設定オプションが表示されます。

方向： 垂直（デフォルト）または水平を選択して、確認フィールドを元のフィールドの下に表示するか、横に表示するかを決定します。

ラベル: 元のフィールドラベルのプレフィックスを選択します。デフォルト値はConfirmなので、Email Addressというフィールドの確認フィールドのラベルは、 Confirm Email Addressとなります。

エラーメッセージ： 確認するフィールドに応じて、より具体的なエラーメッセージを提供することができます。

確認フィールドは構成可能です。

ユーザーが有効な形式で情報を入力していることを確認する方法については、「テキストおよび数値フィールドの入力の検証」を参照してください。

フィールド名、フィールドID、およびフィールドの参照

Liferay 7.3の最初のリリースでは、編集可能な構成のフィールド名が削除され、読み取り専用のフィールド IDが各フィールドの［詳細設定］タブに含まれるようになりました。しかし、Liferay 7.3では、編集可能な代替品であるフィールド参照が利用できるようになりました。プログラムでフィールドを参照する場合は、7.2のフィールド名の値と7.3以降のフィールド参照を使用します。

フィールド参照の設定では、フォームビルダーがフィールドの人間が読めるシステム名を設定することができます。

フォームのフィールドと要素

パラグラフ

パラグラフフィールドは、フォーム作成者が入力した静的なテキストをフォーム上に表示します。ユーザーは説明文フィールドにデータを入力しません。これは、指示が長い場合に役立ちます。

段落フィールドを使用して、フォーマットされたテキストのより長いブロックを提供できます。

説明文フィールドは単なるプレーンテキストではありません。埋め込み式のコンテンツエディターを使って、リッチコンテンツを作成します。

コンテンツエディタを使用して、段落フィールドにリッチコンテンツを作成します。

テキスト項目

ユーザーはこれらのフィールドに自由形式のテキストを入力します。たとえば、氏名フィールドはテキストフィールドです。デフォルトでは、テキストフィールドはすべての入力を1行のテキストに保持します。より長い応答に対応するには、この例のようにテキストフィールドを構成するときに複数行設定を選択します。テキストフィールドの検証オプションを使用して、ユーザーが入力できるテキスト (1 ～ 10 の数字、電子メールアドレスなど) に制限を設定できます。

複数行のテキストフィールドでは、ユーザーが複数の行を入力することができます。

プルダウン

ユーザーは、選択肢のリストから1つ（または許可されている場合は複数）のオプションを選択します。選択肢は手動で入力するか、データプロバイダーによって自動的に入力されます。たとえば、居住国フィールドは、Countries of the Worldデータプロバイダーによって入力されたリストフィールドから選択できます。

フォームの選択リストフィールドには、選択するオプションのドロップダウンリストがユーザーに表示されます。

ラジオボタン

ユーザーは、ラジオボタンを使用して、フォームに表示されたオプションのリストから1つのオプションを選択します。

ラジオボタンフィールドでは、ユーザーに複数の選択肢を表示し、その中から1つだけを選択できるようになっています。

ブール値

ユーザーは、チェックボックスやスイッチを有効にしたり無効にしたりして、表示されたテキストに対する true または false の応答を記録します。

ブール値フィールドはユーザーに単一のオプションを表示し、ユーザーが応答でtrueまたはfalseを選択できるようにします。

日付

ユーザーは日付ピッカーを使用して日付を選択します。

日付ピッカーは、日付を選択するための便利な方法を提供します。

Liferay 7.4では、日付フィールドの詳細設定に入力値の検証が含まれています。フィールドの詳細設定の検証オプションを使用して、ユーザーが入力できる日付 (1 ～ 10 の数字、電子メールアドレスなど) に制限を設定できます。

日時

Liferay 7.4で追加された、ユーザーが日付と時刻の両方を1つのフィールドに入力する機能です。

日時フィールドは、有効な日付と時間帯を組み合わせたものです。

日時フィールドは、 DD/MM/YYYY HH:MM [AM/PM]のフォーマットで入力します。例えば、 01/06/1981 12:15 PM は1981年1月6日、午後12時15分です。日時のピッカーを使用するか、ユーザーがフィールドに直接日付を入力することができます。

複数選択

ユーザーは、チェックボックス（または設定されている場合はトグル）から1つ以上のオプションを選択します。

複数選択フィールドでは、ユーザーが表示された選択肢の中から複数選択することができます。

グリッド

ユーザーは、ラジオボタンを使用して、行と列に配置されたオプションから選択します。行ごとに1つの選択を行うことができます。これは、複数の質問に同じ回答メトリックが必要な場合に役立ちます。

グリッドフィールドでは、ユーザーが同じ回答オプションのリストから複数の問い合わせに回答できます。

数値

ユーザーは数値データ（整数または小数）を数値フィールドに入力します。数字以外の入力は受け付けません。

数値フィールドは、ユーザーの入力を数字（整数または小数）に限定します。

数値フィールドには、興味深い詳細なフィールド設定があります。

確認が必要 により、ユーザーがデータを正しく入力したことを確認します。
検証は、ユーザー入力を事前に構成された要件に制限します。
入力マスク を使用すると、ユーザーが数値データを入力したときに正しい形式を表示できます。

アップロード

アップロードフィールドを使用すると、ユーザーはローカルファイルシステムからファイルをアップロードできます。ログインしているユーザーは、以前にアップロードしたファイルから選択するか、新しいファイルをアップロードできます。

注

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という名前の設定ファイルを作成して、ゲストのアップロード動作を設定します。

ヒント

インスタンススコープで Forms アプリケーションを構成するには、インスタンス設定の Forms エントリを使用します。

ゲストがアップロード可能なファイル拡張子（guestUploadFileExtensions）： 許可済ファイル拡張子のコンマ区切りリストを入力します。デフォルトでは、次のリストがサポートされています: doc、 docx、 jpeg、 jpg、 pdf、 png、 ppt、 pptx、 tiff、 txt、 xls、および xlsx。

ゲストがアップロード可能な最大ファイルサイズ（guestUploadMaximumFileSize）：ゲストユーザーがアップロードフィールドからアップロードできるファイルの最大サイズを設定します。これは、ドキュメントとメディアアプリケーションの設定で、認証されたユーザーに対して設定され、システム全体の制限は、アップロードサーブレットリクエストシステム設定エントリーの［合計最大アップロードリクエストサイズ］というフィールドで定義されます。デフォルトでは25MBに設定されています。

アップロードフィールドの最大繰り返し回数（maximumRepetitionsForUploadFields）：フィールドが繰り返し可能に設定されている場合、ユーザーがフィールドをフォームに追加できる最大回数を設定します (ゲストユーザーとログインしたユーザーに同じように適用されます)。デフォルトでは5に設定されています。

ゲストアップロードフィールドの最大送信数（maximumSubmissionsForGuestUploadFields）：ゲストが使用可能なアップロードフィールドを含むフォームをゲストユーザーが送信できる最大回数を設定します。ゲストユーザーのIPアドレスは、送信数の記録のために使用されます。デフォルトでは5に設定されています。

画像

ユーザーは、［Web Content Images］、［Documents and Media］ライブラリから画像ファイル（.gif、.jpeg、.jpg、.png）を選択したり、ローカルファイルシステムから画像ファイルをアップロードしたりすることができます。

画像フィールドでは、ユーザーが画像をアップロードしたり、ドキュメントとメディア内にある画像やWebコンテンツ画像から選択することができます。

重要

ゲストユーザーは、画像へのアクセスやアップロードができません。認証されたユーザーのみがフォームにアクセスできる場合を除き、このフィールドは使用しないでください。

画像を追加した後、ユーザーは画像の追加フィールドである説明を記入することができます。画像フィールドがオプションの場合、使い方は簡単で、画像もその説明も必要ありません。ただし、他のフォームフィールドと同様に、画像フィールドは必須とマークすることができます。画像フィールドが必須である場合、フォームビルダーは説明を必須とするか任意とするかを選択することができます。

必須画像フィールドの説明フィールドは、必須または任意とすることができます。