例：フォームルールでの非表示フィールドの使用

［詳細設定］タブで［フォーム］フィールドを非表示に設定します。

このフォームには非表示のフィールドがあります。 データプロバイダーに入力値として渡すことができるように、サイトのID番号を保持しています。

この例に従うためには、まず［データプロバイダーシステム設定］エントリでローカルネットワークアクセスを有効にする必要があります。 詳細については、「 ローカル ネットワーク上のデータへのアクセスの有効化 」を参照してください。

この例では、2つのデータプロバイダーと、4つのフィールドと3つのフォームルールを持つフォームを作成する必要があります。 以下の表は、その要素の概要を示したものです。

Liferayフォーム要素	要素ラベル	説明
データ提供者	グループユーザーの取得	サイト/グループのユーザーを取得し、その電子メールアドレスのリストを提供する。
データ提供者	ユーザーにメールで知らせる	選択された電子メールアドレスでユーザーを取得し、姓名を入力します。
フォームフィールド	非表示グループID	非表示の数値フィールドを使用して、現在のサイトのグループIDを保持します。
フォームフィールド	Who are you?	データプロバイダーから返されたEメールアドレスを表示する［リストから選択］フィールドを使用します。
フォームフィールド	名	ユーザーの名前には、テキストフィールドを使用します。
フォームフィールド	姓	ユーザーの姓にはテキストフィールドを使用します。
フォームルール	適切ではない	非表示グループIDフィールドが空でない場合は、［リストから選択］フィールドにサイトのユーザーのメールアドレスを自動入力します。
フォームルール	適切ではない	もし あなたは誰ですか? フィールドが空でない場合、データ プロバイダーから取得した姓名フィールドが自動入力されます。
フォームルール	適切ではない	もし あなたは誰ですか? フィールドが空の場合は、名前フィールドを有効にして、ユーザーが手動でデータを入力できるようにします。 条件が満たされておらず、姓と名のフィールドがデータプロバイダーによって自動入力されている場合、これらのフィールドはフォーム上では無効になります。

この例を構成するには、

1. これらの設定でデータプロバイダーを構成します。

   • 名前: グループユーザーを取得

   • URL: http://localhost:8080/api/jsonws/user/get-group-users/group-id/

     groupId は、データプロバイダーの入力パラメーターとして渡されます。 この例では、グループIDを入力するために非表示フォームフィールドを使用します。

   • ユーザー名 ：[e-mail] (または管理者の電子メールアドレス)

   • パスワード： ［ユーザーのパスワードを入力］

   • 入力：

     • ラベル: グループID
     • パラメータ: グループID
     • タイプ: 数値

   • 出力：

     • ラベル: メールアドレス
     • パス: $..emailAddress
     • タイプ: リスト

   データプロバイダーを保存します。

2. この設定で別のデータプロバイダーを設定します。

   • 名前: メールでユーザーを取得

   • URL: http://localhost:8080/api/jsonws/user/get-user-by-email-address/company-id/20099/email-address/

     Liferay InstanceのID（例：20099）を取得する必要があります。 コントロールパネル → 仮想インスタンスに表示されるインスタンス ID です。

   • ユーザー名 ：[e-mail] (または管理者の電子メールアドレス)

   • パスワード： ［ユーザーのパスワードを入力］

   • 入力：

     • ラベル: メールアドレス
     • パラメータ: emailAddress
     • タイプ: テキスト

   • 出力：

     • ラベル: 名
     • パス: $.firstName
     • タイプ: テキスト

   プラス記号をクリックして、別の出力を追加します。

   • 出力：
     • ラベル: 姓
     • パス: $.lastName
     • タイプ: テキスト

   データプロバイダーを保存します。

3. 新しいフォームを作成し、これらのフィールドを追加します。

   • 数値フィールド: 非表示グループID

     • 初期値： ［サイトID (例：20123)］

       サイト設定→サイト構成でサイトIDを見つけます。

   • リストから選択： Who are you?
     • リストを作成: 自動入力から
   • テキストフィールド: 名
   • テキストフィールド: 姓

   フォームにタイトルをつけて保存します。

   

4. フォームの「ルール」タブに移動し、「 あなたは誰ですか?」を自動入力するルールを作成します。 フィールドのオプションのリスト:

   • CONDITION：
     • 非表示グループID が空でない場合
   • ACTION:
     • 実行 自動入力 データプロバイダーから グループユーザーを取得
       • データプロバイダーの入力: groupId → 非表示グループID
       • データプロバイダーの出力: メールアドレス → あなたは誰ですか?

   ルールの保存

   

5. フォームの「ルール」タブに移動し、「 あなたは誰ですか?」を自動入力するルールを作成します。 フィールドのオプションのリスト:

   • CONDITION：
     • もし あなたは誰ですか? 空ではありません
   • ACTION:
     • 実行 自動入力 データプロバイダーから メールでユーザーを取得
       • データプロバイダーの入力: emailAddress → Who are You?
       • データプロバイダーの出力: 名 → 名
       • データプロバイダーの出力: 姓 → 姓

   ルールの保存

   

6. フォームの［ルール］タブに移動し、メールアドレスが選択されていない場合に名前フィールドのみを有効にするルールを作成します。

   • CONDITION：
     • もし あなたは誰ですか? 空です
   • ACTION:
     • 実行 有効 名
     • 実行 有効 姓

   ルールの保存

   

7. フォームを保存して公開します。 ルールを保存してもフォームは保存されなかったため、［フォーム］タブに戻り、 ［保存］をクリックし、フォームがまだ公開されていない場合は 公開します。

フォームをテストするには、専用のURLにアクセスし、メールアドレスを選択します。 以下の動作に注意してください。

• あなたは誰ですか?を使用してください 現在のサイトに属するユーザーのリストから自分のメールアドレスを選択するフィールドです。 このリストは、データプロバイダーがJSONウェブサービス get-group-usersを呼び出すことで入力されます。
• セレクタでメールアドレスを選択すると、［名］と［姓］の欄が自動入力され、これらの欄は編集できないようになっています。
• を離れる あなたは誰ですか？ フィールドが空白の場合（例： オプションを選択 が表示される）、両方の名前フィールドが有効になり、ユーザーはデータを直接入力できます。

関連する内容

• フォームの公開
• データプロバイダー
• 自動入力ルールの使用
• フォーム項目タイプのリファレンス