Synchronisieren von adaptiven Formularen mit XFA-Formularvorlagen synchronizing-adaptive-forms-with-xfa-form-templates

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.

Einführung introduction

Sie können adaptive Formulare basierend auf einer XFA-Formularvorlage (*.XDP-Datei) erstellen. Diese Wiederverwendung ermöglicht es Ihnen, das, was Sie in bestehende XFA-Formulare investiert haben, zu erhalten. Informationen dazu, wie Sie eine XFA-Formularvorlage zum Erstellen eines adaptiven Formulars verwenden, finden Sie unter Erstellen eines adaptiven Formulars basierend auf einer Vorlage.

Sie können Felder aus der XDP-Datei in Ihrem adaptiven Formular wiederverwenden. Diese Felder werden als gebundene Felder bezeichnet. Die Eigenschaften der gebundenen Felder (wie Skripte, Beschriftungen und Anzeigeformat) werden aus der XDP-Datei kopiert. Sie können sich auch dafür entscheiden, die Werte einiger dieser Eigenschaften zu überschreiben.

AEM Forms bietet die Möglichkeit, die Felder der adaptiven Formulare mit allen Änderungen synchronisiert zu halten, die später an den entsprechenden Feldern in der XDP-Datei vorgenommen werden. In diesem Artikel wird beschrieben, wie Sie diese Synchronisierung aktivieren können.

In der Authoring-Umgebung von AEM Forms können Sie Felder aus einem XFA-Formular (links) in ein adaptives Formular (rechts) ziehen.

Voraussetzungen prerequisites

Um die Informationen in diesem Artikel nutzen zu können, sollten Sie mit den folgenden Themen vertraut sein:

Um die Assets für das Beispiel im Artikel zu verwenden, laden Sie das Beispielpaket wie im nächsten Abschnitt (Beispielpaket) beschrieben herunter.

Beispielpaket sample-package

Der Artikel verwendet ein Beispiel, um zu veranschaulichen, wie Sie das adaptive Formular mit einer aktualisierten XFA-Formularvorlage synchronisieren. Die im Beispiel verwendeten Assets sind in einem Paket verfügbar, das aus dem Abschnitt Downloads in diesem Artikel heruntergeladen werden kann.

Nachdem Sie das Paket hochgeladen haben, können Sie diese Assets in der Benutzeroberfläche von AEM Forms anzeigen.

Installieren Sie das Paket mit dem Package Manager: https://<server>:<port>/crx/packmgr/index.jsp

Das Paket enthält die folgenden Assets:

Hinzufügen von Inhalt zu einem adaptiven Formular add-content-to-adaptive-form-br

Erkennen von Änderungen in der XDP-Datei detecting-changes-in-xdp-file

Sobald es Änderungen in einer XDP-Datei oder einem Fragment gibt, kennzeichnet die AEM Forms-Benutzeroberfläche alle adaptiven Formulare, die auf der XDP-Datei oder dem Fragment basieren.

Nachdem Sie eine XDP-Datei aktualisiert haben, müssen Sie sie erneut in die AEM Forms-Benutzeroberfläche hochladen, damit die Änderungen gekennzeichnet werden.

Als Beispiel aktualisieren wir die Datei sample-form.xdp mithilfe der folgenden Schritte:

Wenn eine XDP-Datei aktualisiert wird, wird ein Symbol im Editor angezeigt, wenn Sie die adaptiven Formulare, die auf der XDP-Datei basieren, bearbeiten. Dieses Symbol zeigt an, dass das adaptive Formular nicht mehr mit der XDP-Datei synchron ist. In der folgenden Abbildung sehen Sie das Symbol links in der Randleiste angezeigt.

Synchronisieren von adaptiven Formularen mit der neuesten XDP-Datei synchronizing-adaptive-forms-with-the-latest-xdp-file

Wenn ein adaptives Formular, das nicht mehr mit der XDP-Datei synchron ist, zum nächsten Mal für das Authoring geöffnet wird, wird die folgende Meldung angezeigt: Schema/Form Template for the Adaptive Form has been updated. Click Here to rebase it with the new version. (Schema/Formularvorlage für das adaptive Formular wurde geändert. Klicken Sie hier, um ein Rebase mit der neuen Version auszuführen.)

Durch Klicken auf die Meldung werden die Felder im adaptiven Formular mit den entsprechenden Feldern in der XDP-Datei synchronisiert.

Öffnen Sie für das in diesem Artikel verwendete Beispiel sample-xfa-af im Autorenmodus. Die Meldung wird am unteren Rand des adaptiven Formulars angezeigt.

Aktualisieren der Eigenschaften updating-the-properties

Alle Eigenschaften, die aus der XDP-Datei in das adaptive Formular kopiert wurden, werden aktualisiert, mit Ausnahme der Eigenschaften, die explizit im adaptiven Formular (aus dem Komponentendialogfeld) von der Autorin oder dem Autor überschrieben wurden. Die Liste der Eigenschaften, die aktualisiert wurden, ist in den Serverprotokollen verfügbar.

Um die Eigenschaften im adaptiven Formular des Beispiels zu aktualisieren, klicken Sie auf den Link (mit "Click Here" gekennzeichnet) in der Nachricht. Der Titel von „TextField1“ ändert sich von Textfeld zu Mein Textfeld.

Hinzufügen neuer Felder aus einer XDP-Datei in ein adaptives Formular adding-new-fields-from-xdp-file-to-adaptive-form-nbsp

Felder, die später zur Original-XDP-Datei hinzugefügt werden, werden in der Registerkarte „Formularhierarchie“ angezeigt. Sie können diese neuen Felder in das adaptive Formular ziehen.

Sie müssen nicht auf den Link in der Fehlermeldung klicken, um die Felder in der Registerkarte „Formularhierarchie“ zu aktualisieren.

Gelöschte Felder in der XDP-Datei deleted-fields-in-xdp-file

Wenn ein zuvor in ein adaptives Formular kopiertes Feld in einer XDP-Datei gelöscht wird, wird eine Fehlermeldung im Autorenmodus angezeigt, die angibt, dass das Feld in der XDP-Datei nicht vorhanden ist. In diesem Fall müssen Sie das Feld manuell aus dem adaptiven Formular löschen oder die Eigenschaft bindRef im Komponentendialogfeld löschen.

Die folgenden Schritte veranschaulichen diesen Vorgang für die Assets, die in dem Beispiel in diesem Artikel verwendet wurden:

Das gelöschte Feld wird außerdem mit einem Symbol gekennzeichnet, um einen Fehler im Feld anzuzeigen.

Downloads downloads

Inhaltspaket für das Beispiel in diesem Artikel

Datei laden