Synchronisieren von adaptiven Formularen mit XFA-Formularvorlagen

Einführung

You can create an adaptive form based on an XFA form template ( *.XDP file). Diese Wiederverwendung ermöglicht es Ihnen, Ihre Investition in vorhandene XFA-Formulare beizubehalten. For information on how to use an XFA form template for creating an adaptive form, Create an Adaptive Form based on a template.

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

AEM Forms bietet die 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 Authoring-Umgebung von AEM Forms können Sie Felder aus einem XFA-Formular (links) in ein adaptives Formular (rechts) ziehen.

Voraussetzungen

Um die Informationen in diesem Artikel zu verwenden, sollten Sie mit den folgenden Themen vertraut sein:

To use the assets provides for the example in the article, download the sample package as explained in the next section, Sample package.

Beispielpaket

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 AEM Forms-UI anzeigen.

Install the package using the 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 Ihre Anmeldeinformationen ein, wenn Sie danach gefragt werden.
  2. Öffnen Sie sample-af-xfa zur Bearbeitung im Authoring-Modus.
  3. Wählen Sie im Inhalt-Browser in der Seitenleiste die Registerkarte „Datenmodellobjekte“. Ziehen Sie NumericField1 und TextField1 auf das adaptive Formular.
  4. Change the Title of the NumericField1 from Numeric Field to AF Numeric Field.
Hinweis

In den vorangegangenen Schritten haben wir eine Eigenschaft eines Feldes 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

Sobald es Änderungen in einer XDP-Datei oder einem Fragment gibt, kennzeichnet die AEM Forms-UI 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 anhand der folgenden Schritte:

  1. Navigieren Sie bei Aufforderung zur https://<server>:<port>/projects.html. Eingabe Ihrer Anmeldedaten.

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

  3. Laden Sie die Datei sample-form.xdp auf Ihren lokalen Computer herunter. The XDP file is downloaded as a .zip file, which can be extracted using any file decompression utility.

  4. Öffnen Sie die Datei sample-form.xdp und ändern Sie den Titel des Feldes „TextField1“ von Textfeld in 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, die auf der XDP-Datei basieren, bearbeiten. Dieses Symbol gibt an, dass das adaptive Formular nicht mehr mit der XDP-Datei synchron ist. Im folgenden Bild finden Sie das Symbol daneben in der Randleiste.

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, um es mit der neuen Version neu zu erstellen.

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 Authoring-Modus. 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 im adaptiven Formular (aus dem Komponentendialogfeld) vom Autor überschrieben wurden. Die Liste der Eigenschaften, die aktualisiert wurden, ist in den Serverprotokollen verfügbar.

To update the properties in the example adaptive form, click the link (labeled "Click Here") in the message. Der Titel von TextField1 ändert sich von Textfeld in Mein Textfeld.

update-property

Hinweis

The label AF Numeric Field did not get changed because you had overridden this property from the component properties dialog, as described in Add content to adaptive forms.

Hinzufügen neuer Felder aus einer XDP-Datei in ein adaptives Formular  

Felder, die später zur Original-XDP-Datei hinzugefügt werden, werden in der Registerkarte „Form Hierarchy“ (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 „Form Hierarchy“ (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 eine Fehlermeldung im Authoring-Modus angezeigt, die angibt, 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 Gebrauchsfluss für die Assets in dem in diesem Artikel verwendeten Beispiel:

  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-/Formularvorlage für das adaptive Formular wurde aktualisiert. Click Here , um es mit der neuen Version neu zu erstellen.

  4. Click the link (labeled " Click Here") in the message. Eine Fehlermeldung wird angezeigt, dass das Feld nicht mehr in der XDP-Datei vorhanden ist.

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

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

Fehlersymbol im 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