Synchronisieren von adaptiven Formularen mit XFA-Formularvorlagen

Adobe empfiehlt die Verwendung der modernen und erweiterbaren Datenerfassung Kernkomponenten für Erstellen neuer adaptiver Forms oder Hinzufügen von Adaptive Forms zu AEM Sites-Seiten. Diese Komponenten stellen einen bedeutenden Fortschritt bei der Erstellung adaptiver Forms dar und sorgen für beeindruckende Benutzererlebnisse. In diesem Artikel wird der ältere Ansatz zum Erstellen von Adaptive Forms mithilfe von Foundation-Komponenten beschrieben.

Einführung

Sie können adaptive Formulare basierend auf einer XFA-Formularvorlage (*.XDP-Datei) erstellen. Durch diese Wiederverwendung können Sie Ihre Investition in vorhandene XFA-Formulare beibehalten. 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 eine Möglichkeit, die Felder der adaptiven Formulare mit allen Änderungen zu synchronisieren, 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.

Sie können Felder aus einem XFA-Formular in ein adaptives Formular ziehen.

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

Voraussetzungen

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

In diesem Artikel wird anhand eines Beispiels gezeigt, wie das adaptive Formular mit einer aktualisierten XFA-Formularvorlage synchronisiert wird. Die im Beispiel verwendeten Assets sind in einem Paket verfügbar, das aus dem Abschnitt Downloads in diesem Artikel heruntergeladen werden kann.

Nach dem Hochladen des Pakets 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:

  1. sample-form.xdp: Die als Beispiel verwendete XFA-Formularvorlage

  2. sample-xfa-af: Das adaptive Formular, das auf der Datei sample-form.xdp basiert. Dieses adaptive Formular enthält jedoch keine Felder. Im nächsten Schritt fügen wir diesem adaptiven Formular Inhalt hinzu.

Hinzufügen von Inhalt zu einem adaptiven Formular

  1. Navigieren Sie zu https://<server>:<port>/aem/forms.html. Geben Sie auf Anfrage Ihre Anmeldedaten ein.
  2. Öffnen Sie sample-af-xfa zur Bearbeitung im Autorenmodus.
  3. Wählen Sie im Inhaltsbrowser in der Seitenleiste die Registerkarte Datenmodellobjekte . Ziehen Sie NumericField1 und TextField1 auf das adaptive Formular.
  4. Ändern Sie den Titel von „NumericField1“ von Numerisches Feld zu Numerisches AF-Feld.
HINWEIS

In den vorangegangenen Schritten haben wir eine Eigenschaft eines Felds in der XDP-Datei überschrieben. Diese Eigenschaft wird daher nicht synchronisiert, wenn die entsprechende Eigenschaft in der XDP-Datei später geändert wird.

Erkennen von Änderungen in der XDP-Datei

Bei jeder Änderung in einer XDP-Datei oder einem Fragment 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:

  1. Navigieren Sie zu https://<server>:<port>/projects.html.. Geben Sie bei Aufforderung Ihre Anmeldedaten ein.

  2. Klicken Sie links auf die Registerkarte „Formulare“.

  3. Laden Sie die Datei sample-form.xdp auf Ihren lokalen Computer herunter. Die XDP-Datei wird als .zip-Datei heruntergeladen, die mit einem beliebigen Entpackprogramm extrahiert werden kann.

  4. Öffnen Sie die Datei sample-form.xdp und ändern Sie den Titel des Felds „TextField1“ von Textfeld zu Mein Textfeld.

  5. Laden Sie die Datei sample-form.xdp wieder in die AEM Forms-Benutzeroberfläche hoch.

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

Symbol, das angibt, dass das adaptive Formular nicht mehr mit der XDP-Datei synchron ist

Synchronisieren von adaptiven Formularen mit der neuesten XDP-Datei

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.

Meldung, die Sie auffordert, das adaptive Formular mit der XDP-Datei zu synchronisieren

Aktualisieren der Eigenschaften

Alle Eigenschaften, die aus der XDP-Datei in das adaptive Formular kopiert wurden, werden aktualisiert, mit Ausnahme der Eigenschaften, die explizit vom Autor im adaptiven Formular (aus dem Komponentendialogfeld) ü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.

update-property

HINWEIS

Die Beschriftung „AF Numeric Field“ wurde nicht geändert, da Sie diese Eigenschaft im Dialogfeld für die Komponenteneigenschaften überschrieben haben, wie in Hinzufügen von Inhalten zu adaptiven Formularen beschrieben.

Hinzufügen neuer Felder aus der XDP-Datei zum adaptiven Formular  

Alle Felder, die später zur ursprünglichen XDP-Datei hinzugefügt werden, werden auf der Registerkarte "Formularhierarchie"angezeigt und 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

Wenn ein Feld, das zuvor in ein adaptives Formular kopiert wurde, aus einer XDP-Datei gelöscht wird, wird im Authoring-Modus eine Fehlermeldung angezeigt, die besagt, dass das Feld nicht in der XDP-Datei 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:

  1. Aktualisieren Sie die Datei sample-form.xdp und löschen Sie „NumericField1“.

  2. Laden Sie die Datei sample-form.xdp in die AEM Forms-Benutzeroberfläche hoch.

  3. Öffnen Sie das adaptive Formular sample-xfa-af zum Authoring. Die folgende Fehlermeldung wird 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.)

  4. Klicken Sie auf den (mit „Click Here“ beschrifteten) Link in der Meldung. Eine Fehlermeldung wird angezeigt, die besagt, dass das Feld in der XDP-Datei nicht mehr vorhanden ist.

Fehler, der angezeigt wird, wenn Sie ein Element in der XDP-Datei löschen

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

Fehlersymbol in dem Feld

HINWEIS

Die Felder im adaptiven Formular, die eine inkorrekte Bindung aufweisen (einen ungültigen bindRef-Wert im Bearbeitungsdialogfeld) werden ebenfalls als gelöschte Felder betrachtet. Wenn der Autor diese Fehler nicht behebt und das adaptive Formular veröffentlicht, wird das Feld als normales ungebundenes adaptives Formularfeld behandelt und in den unbinded-Abschnitt der Ausgabe-XML-Datei aufgenommen.

Downloads

Inhaltspaket für das Beispiel in diesem Artikel

Datei laden

Auf dieser Seite