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

はじめに introduction

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

アダプティブフォームは、XDP ファイルで定義された様々な XFA イベント、プロパティ、スクリプト、検証をサポートします。以下が含まれます。

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

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

この記事では、アダプティブフォームでサポートされる XFA イベント、プロパティ、検証機能を一覧表示し、アダプティブフォームでそれらを上書きする方法について説明します。

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

フィールド fields

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

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

プロパティ properties

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

XFA コンポーネントのプロパティ
アダプティブフォームにおける対応する動作
somExpression
アダプティブフォームのバインド参照(bindRef)プロパティにマッピング済み。
presence
アダプティブフォームの Visible プロパティにマッピング済みです。表示式を使用して上書きできます。
access
アダプティブフォームの Enabled プロパティにマッピング済みです。アクセス式を使用して上書きできます。
Accessibility: role
アダプティブフォームの Role プロパティにマッピング済みです。
Accessibility: speakPriority
アダプティブフォームの speakPriority プロパティにマッピング済み。
Accessibility: speakText
アダプティブフォームのカスタム Accessibility テキストにマッピング済み。
Accessibility: toolTip
アダプティブフォームの Short Description プロパティにマッピング済みです。
caption (すべてのフィールドの種類)
アダプティブフォームの Title プロパティにマッピング済みです。
displayFormat (すべてのフィールドの種類)
アダプティブフォームの表示パターンにマッピング済み。
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
アダプティブフォームの計算式にマッピングされている。
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