ユーザーデータからフォーム送信メタデータへの情報の追加 adding-information-from-user-data-to-form-submission-metadata

CAUTION
AEM 6.4 の拡張サポートは終了し、このドキュメントは更新されなくなりました。 詳細は、 技術サポート期間. サポートされているバージョンを見つける ここ.

フォームの要素に入力された値を使用して、ドラフトまたはフォーム送信のメタデータフィールドを計算できます。 メタデータを使用すると、ユーザーデータに基づいてコンテンツをフィルタリングできます。 例えば、ユーザーがフォームの名前フィールドに John Doe と入力したとします。 この情報を使用してメタデータを計算することにより、この送信をイニシャル JD の下に分類できます。

ユーザーが入力した値でメタデータフィールドを計算するには、メタデータにフォームの要素を追加します。 この要素にユーザーが値を入力すると、スクリプトはその値を使用して情報を計算します。この情報はメタデータに追加されます。 要素をメタデータフィールドとして追加する場合、そのキーを指定します。 キーがメタデータのフィールドとして追加され、計算された情報がそのキーに対してログに記録されます。

例えば、健康保険会社がフォームを公開するとします。このフォームのフィールドで、エンドユーザーの年齢を取得します。この会社では、多数のユーザーからフォームが送信された後、特定の年齢範囲に当てはまる送信をすべて確認したいと考えています。しかしそのままでは相応の手間がかかります。なぜならフォームの数が増加するほどデータは複雑化するからです。メタデータを追加すると、手間を軽減することができます。検索が最も簡単になるように、エンドユーザーが入力したプロパティやデータを最上位レベルに保存するように、フォーム作成者が設定できます。 追加メタデータはユーザーによって入力される情報であり、作成者の設定に基づいてメタデータノードの最上位レベルに保存されます。

電子メール ID と電話番号を取り込むフォームの別の例を考えてみましょう。 ユーザーがフォームに匿名でアクセスしてからフォームを破棄した場合、メール ID と電話番号が自動保存されるようにフォームを設定できます。このフォームは自動保存され、電話番号と電子メール ID はドラフトのメタデータノードに保存されます。 この設定の使用例は、リード管理ダッシュボードです。

メタデータへのフォーム要素の追加 adding-form-elements-to-metadata

フォーム要素をメタデータに追加するには、次の手順を実行します。

  1. アダプティブフォームを編集モードで開きます。

    フォームを編集モードで開くには、Forms Manager でフォームを選択して、「開く」をタップします。

  2. 編集モードで、コンポーネントを選択し、 フィールドレベル アダプティブフォームコンテナ ​をタップしてから、 cmppr をタップします。

  3. サイドバーで、 メタデータ.

  4. 「メタデータ」セクションで、 追加.

  5. スクリプトを追加するには、「メタデータ」タブの「値」フィールドを使用します。 追加したスクリプトは、フォーム上の要素からデータを収集し、メタデータに入力される値を計算します。

    例えば、入力された年齢が 21 才以上の場合はメタデータに true  を記録し、21 才未満の場合は  false  を記録します。「メタデータ」タブで次のスクリプトを入力します。

    (agebox.value >= 21) ? true : false

    メタデータスクリプト
    図: 「メタデータ」タブで入力したスクリプト

  6. OK」をクリックします。

メタデータフィールドとして選択された要素にユーザーがデータを入力すると、計算された情報がメタデータに記録されます。 メタデータは、メタデータを保存するように設定したリポジトリーで表示できます。

フォーム送信メタデータの表示: seeing-updated-form-nbsp-submission-metadata

上記の例では、メタデータは CRX リポジトリーに保存されます。メタデータは次のようになります。

metadata-entry

メタデータにチェックボックス要素を追加すると、選択された値がコンマで区切られた文字列として保存されます。例えば、フォームにチェックボックスコンポーネントを追加し、その名前を checkbox1 として指定します。チェックボックスコンポーネントのプロパティで、値 0、1、および 2 に対して、運転免許、社会保障番号、パスポートの各項目を追加します。

チェックボックスに入力された複数の値の保存

アダプティブフォームコンテナを選択し、フォームのプロパティで cb1 を保存するメタデータキー checkbox1.value を追加して、フォームを発行します。ユーザーがフォームに入力すると、チェックボックスの [ パスポートと社会保障番号 ] オプションが選択されます。 値 1 と 2 が送信メタデータの cb1 フィールドに「1, 2」として保存されます。

チェックボックスフィールドで選択された複数の値のメタデータへの入力

NOTE
上記の例は学習目的のみで紹介しています。メタデータの検索は、AEM Forms実装で設定した正しい場所でおこなってください。
recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da