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
メモ

XFA チェックボタンに連結されたアダプティブフォームのラジオボタンおよびチェックボックスの必須プロパティをオーバーライドすることはできません。

このページ