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

はじめに

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

アダプティブフォームでは、次のような XDP ファイルで定義された各種 XFA イベント、プロパティ、スクリプト、検証をサポートしています。

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

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

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

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

フィールド

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

XFA フィールドまたはコンテナ

対応するアダプティブフォームのコンポーネント

ボタン

ボタン

チェックボックス

チェックボックス

リストボックス

ドロップダウンリスト

日付／時間フィールド

日付選択

手書き署名

手書き署名

数値フィールド

数値ボックス

十進数フィールド

数値ボックス

テキストフィールド

テキストボックス

パスワードフィールド

パスワードボックス

画像

画像

テキスト

テキスト

サブフォーム

パネル

領域（グループ）

パネル

サブフォームセット

パネル

プロパティ

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

スクリプト

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

XFA スクリプトイベント

アダプティブフォームにおける対応する動作

initialize

このスクリプトは、実行時に実行され、アダプティブフォームではオーバーライドできません。

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 チェックボタンにバインドされているアダプティブフォームのラジオボタンとチェックボックスグループの必須プロパティを上書きすることはできません。

このページ