XDP ベースのアダプティブフォームにおける XFA のサポート xfa-support-in-xdp-based-adaptive-forms

はじめに introduction

アダプティブフォームの新規作成または AEM Sites ページへのアダプティブフォームの追加には、最新の拡張可能なデータキャプチャコアコンポーネントを使用することをお勧めします。これらのコンポーネントは、アダプティブフォームの作成における大幅な進歩を表し、ユーザーエクスペリエンスの向上を実現します。この記事では、基盤コンポーネントを使用してアダプティブフォームを作成する古い方法について説明します。

アダプティブフォームでは、XDP ファイルで定義される各種 XDP イベント、プロパティ、スクリプト、検証をサポートします。サポートには次のものが含まれます。

  • XDP ファイルのイベントで定義されたスクリプトの実行
  • XDP ファイル内の各フィールドのデフォルトの値および動作プロパティの取得
  • XDP ファイルで定義された検証スクリプトの実行

XDP ファイルに基づいてアダプティブフォームが作成されると、各種プロパティ、イベント、および検証がフォーム作成 UI に自動入力されます。ただし、フォーム作成者は、これらの要素の一部を上書きして代替エクスペリエンスを作成できます。

この記事では、アダプティブフォームでサポートされる XFA イベント、プロパティ、スクリプト、検証を一覧表示し、アダプティブフォームでこれらをオーバーライドする方法を説明します。

アダプティブフォームでサポートされる XFA 要素およびそれらのマッピング supported-xfa-elements-and-their-mapping-in-adaptive-forms-br

フィールド fields

XDP ファイルを使用してアダプティブフォームを作成すると、XFA フィールドをアダプティブフォームにドラッグ&ドロップできます。次の表は、XFA フィールドがアダプティブフォームのフィールドにマッピングされる方法を一覧表示したものです。

XFA フィールドまたはコンテナ
対応するアダプティブフォームのコンポーネント
ボタン
ボタン
チェックボックス
チェックボックス
リストボックス
ドロップダウンリスト
日付/時間フィールド
日付選択
手書き署名
手書き署名
数値フィールド
数値ボックス
十進数フィールド
数値ボックス
テキストフィールド
テキストボックス
パスワードフィールド
パスワードボックス
画像
画像
テキスト
テキスト
サブフォーム
パネル
領域(グループ)
パネル
サブフォームセット
パネル

プロパティ properties

次の表は、XDF ファイルで定義された各種 XFA スクリプトがどのようにアダプティブフォームで動作するか示したものです。

XFA コンポーネントのプロパティ
アダプティブフォームにおける対応する動作
somExpression
アダプティブフォームのバインド参照(bindRef)プロパティにマッピング済み。
presence
アダプティブフォームの Visible プロパティにマッピング済みです。表示式を使用して上書きできます。
access
アダプティブフォームの Enabled プロパティにマッピング済みです。アクセス式を使用して上書きできます。
Accessibility: role
アダプティブフォームの Role プロパティにマッピング済みです。
Accessibility: speakPriority
アダプティブフォームの speakPriority プロパティにマッピング済み。
Accessibility: speakText
アダプティブフォームのカスタム Accessibility テキストにマッピング済み。
Accessibility: toolTip
アダプティブフォームの Short Description プロパティにマッピング済みです。
caption (すべてのフィールドの種類)
アダプティブフォームの Title プロパティにマッピング済みです。
displayFormat (すべてのフィールドの種類)
アダプティブフォームの Display Pattern にマッピング済み。
rawValue (すべてのフィールドの種類)
アダプティブフォームの value プロパティにマッピング済み。
items (リストボックス、チェックボックス)
アダプティブフォームの options プロパティにマッピング済み。オプション式を使用して上書きできます。
maxChar (テキストフィールド)
アダプティブフォームの Maximum characters allowed プロパティにマッピング済み。
multiline (テキストフィールド)
アダプティブフォームの Allow multiple lines プロパティにマッピング済み。
fracDigit (数値フィールド、十進数フィールド)
アダプティブフォームの Frac digits プロパティにマッピング済み。
leadDigit (数値フィールド、十進数フィールド)
アダプティブフォームの Lead digits プロパティにマッピング済み。
multiSelect (リストボックス)
アダプティブフォームの Allows multiple selection プロパティにマッピング済み。

スクリプト scripts

次の表は、XDF ファイルで定義された各種 XFA スクリプトがどのようにアダプティブフォームで動作するか示したものです。

XFA スクリプトイベント
アダプティブフォームにおける対応する動作
initialize
このスクリプトは、実行時に実行され、アダプティブフォームではオーバーライドできません。
calculate
アダプティブフォームの Calculate 数式にマッピング済み。
validate
アダプティブフォームの Validation 数式にマッピング済み。
validationState
このスクリプトは、実行時に実行され、アダプティブフォームではオーバーライドできません。
exit
このスクリプトは、実行時に実行され、アダプティブフォームではオーバーライドできません。
click(ボタンフィールド)
ボタンのクリック式にマッピングされる。
Support for server-side script
このスクリプトは、実行時に実行され、アダプティブフォームではオーバーライドできません。
Support for web services
このスクリプトは、実行時に実行され、アダプティブフォームではオーバーライドできません。
Change(手書きフィールド、ラジオボタン、チェックボックス)
このスクリプトは、実行時に実行され、アダプティブフォームではオーバーライドできません。

検証 validations

次の表は、アダプティブフォームで XFA 検証が検証にどのようにマッピングするかを示したものです。

XFA 検証
アダプティブフォームにおける対応する検証
検証パターン(formatTest)
validatePictureClause
検証パターンのメッセージ(formatTestMessage)
validatePictureMessage
必須(nullTest)
mandatory
メッセージを空にする(nullTestMessage)
mandatoryMessage
スクリプトを検証(scriptTest)
validateExp
検証スクリプトのメッセージ(scriptTestMessage)
validateMessage
NOTE
XFA チェックボタンに連結されたアダプティブフォームのラジオボタンおよびチェックボックスの必須プロパティをオーバーライドすることはできません。
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2