Prise en charge de XFA dans les formulaires adaptatifs basés sur XDP xfa-support-in-xdp-based-adaptive-forms

Présentation introduction

Adobe recommande d’utiliser les composants principauxde capture de données modernes et extensibles pour créer de nouveaux formulaires adaptatifsou ajouter des formulaires adaptatifs à des pages AEM Sites. Ces composants représentent une avancée significative dans la création de formulaires adaptatifs, ce qui garantit des expériences utilisateur impressionnantes. Cet article décrit l’ancienne approche de la création de formulaires adaptatifs à l’aide de composants de base.

Les formulaires adaptatifs prennent en charge divers événements XFA, propriétés, scripts et validations définis dans un fichier XDP, notamment :

  • Exécution de scripts définis sur les événements dans le fichier XDP.
  • Capture des valeurs par défaut et des propriétés comportementales pour les champs du fichier XDP.
  • Exécution de scripts de validation définis dans le fichier XDP.

Lorsqu’un formulaire adaptatif est créé à partir d’un fichier XDP, les propriétés, les événements et les validations sont automatiquement renseignés dans l’interface utilisateur de création de formulaire. Toutefois, les concepteurs de formulaires peuvent remplacer certains de ces éléments pour créer une autre expérience.

Cet article répertorie les événements, propriétés et validations XFA pris en charge honorés dans les formulaires adaptatifs et explique comment les remplacer dans les formulaires adaptatifs.

Éléments XFA pris en charge et leur mappage dans les formulaires adaptatifs supported-xfa-elements-and-their-mapping-in-adaptive-forms-br

Champs fields

Lorsqu’un formulaire adaptatif est créé à l’aide d’un fichier XDP, vous pouvez faire glisser un champ XFA sur le formulaire adaptatif. Le tableau suivant répertorie la façon dont les champs XFA sont mappés aux champs de formulaire adaptatif.

Champ ou conteneur XFA
Composant de formulaire adaptatif correspondant
Bouton
Bouton
Case à cocher
Case à cocher
Zone de liste
Liste déroulante
Champ Date/Heure
Sélecteur de date
Signature tactile
Signature tactile
Champ numérique
Zone numérique
Champ décimal
Zone numérique
Champ de texte
Zone de texte
Champ Mot de passe
Champ de mot de passe
Image
Image
Texte
Texte
Sous-formulaire
Panneau
Zone (groupe)
Panneau
Jeu de sous-formulaires
Panneau

Propriétés properties

Le tableau suivant capture la manière dont divers scripts XFA définis dans les fichiers XDP se comportent dans les formulaires adaptatifs.

Propriétés du composant XFA
Comportement correspondant dans les formulaires adaptatifs
somExpression
Chemin d’accès à la propriété référence Bind (bindRef) dans les formulaires adaptatifs.
presence
Associé à la propriété visible dans le formulaire adaptatif. Vous pouvez le remplacer en utilisant l’expression Visibility
accès
Associé à la propriété activée dans le formulaire adaptatif. Vous pouvez le remplacer à l’aide de l’expression Access.
Accessibilité : role
Associé à la propriété « rôle » dans le formulaire adaptatif.
Accessibilité : speakPriority
Associé à la propriété speakPriority dans le formulaire adaptatif.
Accessibilité : speakText
Associé au texte Accessibility personnalisé dans le formulaire adaptatif.
Accessibilité : toolTip
Associé à la propriété « Brève description » dans le formulaire adaptatif.
caption  (tous les types de champ)
Associé à la propriété Titre dans le formulaire adaptatif.
displayFormat (tous les types de champ)
Associé à la propriété Display Pattern dans le formulaire adaptatif.
rawValue (tous les types de champ)
Associé à la propriété Value dans le formulaire adaptatif.
items  (zone de liste, case à cocher)
Associé à la propriété options dans le formulaire adaptatif. Vous pouvez le remplacer à l’aide de l’expression Options.
maxChar  (champ de texte)
Associé à la propriété Maximum characters allowed dans le formulaire adaptatif.
multiline (champ de texte)
Associé à la propriété Allow multiple lines dans le formulaire adaptatif.
fracDigit (champ numérique, champ décimal)
Associé à la propriété Frac digits dans le formulaire adaptatif.
leadDigit (champ numérique, champ décimal)
Associé à la propriété Lead digits dans le formulaire adaptatif.
multiSelect  (zone de liste)
Associé à la propriété Allows multiple selection dans le formulaire adaptatif.

Scripts scripts

Le tableau suivant capture la manière dont divers scripts XFA définis dans les fichiers XDP se comportent dans les formulaires adaptatifs.

Événements de script XFA
Comportement correspondant dans les formulaires adaptatifs
initialize
Ce script est exécuté lors de l’exécution et ne peut pas être remplacé dans les formulaires adaptatifs.
calculate
Associé à l’expression Calculate dans le formulaire adaptatif.
validate
Associé à l’expression Validation dans le formulaire adaptatif.
validationState
Ce script est exécuté lors de l’exécution et ne peut pas être remplacé dans les formulaires adaptatifs.
exit
Ce script est exécuté lors de l’exécution et ne peut pas être remplacé dans les formulaires adaptatifs.
click (champs de bouton)
Associé à l’expression Click du bouton.
Prise en charge de script côté serveur
Ce script est exécuté lors de l’exécution et ne peut pas être remplacé dans les formulaires adaptatifs.
Prise en charge des services Web
Ce script est exécuté lors de l’exécution et ne peut pas être remplacé dans les formulaires adaptatifs.
Modification (champ de saisie tactile, bouton radio, case à cocher)
Ce script est exécuté lors de l’exécution et ne peut pas être remplacé dans les formulaires adaptatifs.

Validations validations

Le tableau suivant capture la manière dont les validations XFA sont associées aux validations dans les formulaires adaptatifs.

Validation XFA
Validation correspondante dans les formulaires adaptatifs
Modèle de validation (formatTest)
validatePictureClause
Message du modèle de validation (formatTestMessage)
validatePictureMessage
Required (nullTest)
mandatory
Empty Message (nullTestMessage)
mandatoryMessage
Validate script (scriptTest)
validateExp
Message du script de validation (scriptTestMessage)
validateMessage
NOTE
Vous ne pouvez pas remplacer la propriété obligatoire pour les boutons radio de formulaire adaptatif et les groupes de cases à cocher liés aux boutons de contrôle XFA.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2