XDP ベースのアダプティブフォームにおける XFA のサポート

はじめに

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

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

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

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

アダプティブフォームでサポートされる XFA 要素およびそれらのマッピング

フィールド

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

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

プロパティ

次の表は、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 プロパティにマッピング済み。

スクリプト

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

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

検証

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

XFA 検証	アダプティブフォームにおける対応する検証
検証パターン（formatTest）	validatePictureClause
検証パターンのメッセージ（formatTestMessage）	validatePictureMessage
必須（nullTest）	mandatory
メッセージを空にする（nullTestMessage）	mandatoryMessage
スクリプトを検証（scriptTest）	validateExp
検証スクリプトのメッセージ（scriptTestMessage）	validateMessage