XFA-Unterstützung in XDP-basierten adaptiven Formularen
Erstellt für:
- Benutzende
- Entwickler
Einführung
Adobe empfiehlt, die modernen und erweiterbaren Kernkomponentenzur Datenerfassung zu verwenden, um neue adaptive Formulare zu erstellenoder adaptive Formulare zu AEM Sites-Seiten hinzuzufügen. Diese Komponenten stellen einen bedeutenden Fortschritt bei der Erstellung adaptiver Formulare dar und sorgen für beeindruckende Anwendererlebnisse. In diesem Artikel wird der ältere Ansatz zum Erstellen adaptiver Formulare mithilfe von Foundation-Komponenten beschrieben.
Adaptive Formulare bieten Unterstützung für verschiedene XFA-Ereignisse, Eigenschaften, Skripte und Validierungen, die in einer XDP-Datei definiert sind, darunter:
- Ausführung von Skripten, die für Ereignisse in der XDP-Datei definiert wurden.
- Erfassen von Standardwerten und Verhaltenseigenschaften für Felder in der XDP-Datei.
- Ausführung von Validierungsskripten, die in der XDP-Datei definiert wurden.
Wenn ein adaptives Formular anhand einer XDP-Datei erstellt wurde, werden die Eigenschaften, Ereignisse und Validierungen in der Benutzeroberfläche zur Erstellung adaptiver Formulare automatisch ausgefüllt. Allerdings können Formularautoren einige dieser Elemente überschreiben, um ein anderes Erlebnis bereitzustellen.
Dieser Artikel erläutert die unterstützten XFA-Ereignisse, Eigenschaften und Validierungen, die in adaptiven Formularen berücksichtigt werden, und beschreibt, wie sie dort überschrieben werden können.
Unterstützte XFA-Elemente und deren Zuordnung in adaptiven Formularen
Felder
Wenn ein adaptives Formular anhand einer XDP-Datei erstellt wird, können Sie ein XFA-Textfeld per Drag-and-Drop auf das adaptive Formular ziehen. Die folgende Tabelle listet auf, wie den Feldern in adaptiven Formularen XFA-Felder zugeordnet werden.
XFA-Feld oder Container | Entsprechende Komponente des adaptiven Formulars |
Schaltfläche | Schaltfläche |
Kontrollkästchen | Kontrollkästchen |
Listenfeld | Dropdownliste |
Datum-/Uhrzeitfeld | Datumsauswahl |
Unterschrift freihändig | Freihändige Unterschrift |
Numerisches Feld | Numerisches Feld |
Dezimalfeld | Numerisches Feld |
Textfeld | Textfeld |
Kennwortfeld | Kennwortfeld |
Bild | Bild |
Text | Text |
Teilformular | Bereich |
Bereich (Gruppe) | Bereich |
Teilformularsatz | Bereich |
Eigenschaften
Die folgende Tabelle erfasst, wie verschiedene XFA-Skripte, die in den XDP-Dateien definiert sind, sich in adaptiven Formularen verhalten.
XFA-Komponenteneigenschaften | Entsprechendes Verhalten in adaptiven Formularen |
somExpression | Der Eigenschaft der Verbindungsreferenz (bindRef) im adaptiven Formular zugeordnet. |
presence | Der visible-Eigenschaft im adaptiven Formular zugeordnet. Sie können sie mit dem Sichtbarkeitsausdruck überschreiben. |
access | Der enabled-Eigenschaft im adaptiven Formular zugeordnet. Sie können sie mit dem Zugriffsausdruck überschreiben. |
Barrierefreiheit: role | Der role-Eigenschaft im adaptiven Formular zugeordnet. |
Barrierefreiheit: speakPriority | Der speakPriority-Eigenschaft im adaptiven Formular zugeordnet. |
Barrierefreiheit: speakText | Dem benutzerdefinierten barrierefreien Text im adaptiven Formular zugeordnet. |
Barrierefreiheit: QuickInfo | Der short-description-Eigenschaft im adaptiven Formular zugeordnet. |
caption (alle Feldtypen) | Der Title-Eigenschaft im adaptiven Formular zugeordnet. |
displayFormat (alle Feldtypen) | Dem Anzeigemuster im adaptiven Formular zugeordnet. |
rawValue (alle Feldtypen) | Der value-Eigenschaft im adaptiven Formular zugeordnet. |
items (Listenfeld, Kontrollkästchen) | Der options-Eigenschaft im adaptiven Formular zugeordnet. Mit dem Optionsausdruck überschreibbar. |
maxChar (Textfeld) | Der Eigenschaft „Maximum characters allowed“ im adaptiven Formular zugeordnet. |
multiline (Textfeld) | Der Eigenschaft „Allow multiple lines“ im adaptiven Formular zugeordnet. |
fracDigit (numerisches Feld, Dezimalfeld) | Der Eigenschaft „Frac digits“ im adaptiven Formular zugeordnet. |
leadDigit (numerisches Feld, Dezimalfeld) | Der Eigenschaft „Lead digits“ im adaptiven Formular zugeordnet. |
multiSelect (Listenfeld) | Der Eigenschaft „Allows multiple selection“ im adaptiven Formular zugeordnet. |
Skripte
Die folgende Tabelle erfasst, wie verschiedene XFA-Skripten, die in der XDP-Datei definiert sind, sich in adaptiven Formularen verhalten.
XFA-Skriptereignisse | Entsprechendes Verhalten in adaptiven Formularen |
initialize | Dieses Skript wird zur Laufzeit ausgeführt und kann im adaptiven Formular nicht außer Kraft gesetzt werden. |
calculate | Dem Berechnungsausdruck im adaptiven Formular zugeordnet. |
validate | Dem Überprüfungsausdruck im adaptiven Formular zugeordnet. |
ValidationState | Dieses Skript wird zur Laufzeit ausgeführt und kann im adaptiven Formular nicht außer Kraft gesetzt werden. |
exit | Dieses Skript wird zur Laufzeit ausgeführt und kann im adaptiven Formular nicht außer Kraft gesetzt werden. |
click (Schaltflächen) | Dem Klickereignis-Ausdruck der Schaltfläche zugeordnet. |
Unterstützung für Server-seitiges Skript | Dieses Skript wird zur Laufzeit ausgeführt und kann im adaptiven Formular nicht außer Kraft gesetzt werden. |
Unterstützung für Web-Dienste | Dieses Skript wird zur Laufzeit ausgeführt und kann im adaptiven Formular nicht außer Kraft gesetzt werden. |
Change (Scribble-Feld, Optionsschalter, Kontrollkästchen) | Dieses Skript wird zur Laufzeit ausgeführt und kann im adaptiven Formular nicht außer Kraft gesetzt werden. |
Validierungen
Die folgende Tabelle erfasst, wie XFA-Überprüfungen den Überprüfungen in adaptiven Formularen zugeordnet sind.
XFA-Validierung | Entsprechende Überprüfungen im adaptiven Formular |
Validierungsmuster (formatTest) | validatePictureClause |
Validierungsmuster-Meldung (formatTestMessage) | validatePictureMessage |
Erforderlich (nullTest) | mandatory |
Meldung bei leerem Feld (nullTestMessage) | mandatoryMessage |
Skript validieren (scriptTest) | validateExp |
Überprüfungsskript-Meldung (scriptTestMessage) | validateMessage |