Generierung eines Datensatzdokuments für adaptive Formulare

Überblick

Nachdem Ihre Kunden ein Formular gesendet haben, möchten sie im Allgemeinen einen Beleg (in gedruckter Form oder im Dokumentformat) über die eingegebenen Informationen behalten, um später darauf Bezug nehmen zu können. Dies wird als Datensatzdokument bezeichnet.

Sie erfahren in diesem Artikel, wie Sie ein Datensatzdokument für adaptive Formulare erstellen können.

HINWEIS

Die automatische Generierung von Datensatzdokumenten wird für XFA-basierte adaptive Formulare nicht unterstützt. Sie können jedoch XDP verwenden, um das adaptive Formular als Datensatzdokument zu erstellen.

Typen adaptiver Formulare und ihre Datensatzdokumente

Beim Erstellen eines adaptiven Formulars können Sie ein Formularmodell auswählen. Ihre Optionen sind:

  • Formularvorlagen

    Hier können Sie eine XFA-Vorlage für Ihr adaptives Formular auswählen. Wenn Sie eine XFA-Vorlage auswählen, können Sie die dazugehörige XDP-Datei als Datensatzdokument verwenden (siehe oben).

  • XML-Schema

    Ermöglicht die Auswahl einer XML-Schemadefinition für das adaptive Formular. Wenn Sie ein XML-Schema für Ihr adaptives Formular auswählen, können Sie Folgendes tun:

    • XFA-Vorlage für Datensatzdokument verknüpfen. Vergewissern Sie sich, dass die verknüpfte XFA-Vorlage dasselbe XML-Schema verwendet wie Ihr adaptives Formular.
    • Datensatzdokument automatisch generieren
  • Ohne

    Ermöglicht die Erstellung eines adaptiven Formulars ohne Formularmodell. Das Datensatzdokument für Ihr adaptives Formular wird automatisch generiert.

Wenn Sie ein Formularmodell auswählen, konfigurieren Sie das Datensatzdokument mithilfe der Optionen, die unter „Konfiguration von Dokument aus Datensatzvorlage“ verfügbar sind. Weitere Informationen dazu finden Sie unter Konfiguration der Datensatzdokument-Vorlage.

Automatisch generiertes Datensatzdokument

Dank Datensatzdokument erhalten Ihre Kunden eine Kopie des übermittelten Formulars zum Ausdrucken. Wenn Sie automatisch ein Datensatzdokument generieren, wird jedes Mal das Datensatzdokument sofort aktualisiert, wenn Sie das Formular ändern. Beispiel: Sie entfernen für Kunden, die als ihr Land die USA angeben, das Feld „Alter“. Wenn diese Kunden ein Datensatzdokument erstellen, ist das Altersfeld im Datensatzdokument nicht sichtbar.

Ein automatisch generiertes Datensatzdokument bietet folgende Vorteile:

  • Es kümmert sich um die Datenbindung.
  • Dadurch werden automatisch Felder ausgeblendet, die im Datensatzdokument zum Zeitpunkt des Sendens entsprechend markiert sind. Zusätzlicher Aufwand ist nicht erforderlich.
  • Dies spart Zeit für die Entwicklung der Datensatzdokument-Vorlage.
  • Außerdem können Sie auch verschiedene Formatierungsstile und Erscheinungsbilder ausprobieren, indem Sie unterschiedliche Basisvorlagen verwenden und dann das beste Design für Ihr Datensatzdokument auswählen. Stil und Erscheinungsbild sind optional. Wenn Sie sich auf keinen Stil festlegen, werden Systemstile als Standard festgelegt.
  • Es stellt sicher, dass eine Änderung im Formular sofort im Datensatzdokument umgesetzt wird.

Komponenten für die automatische Generierung eines Datensatzdokuments

Sie benötigen die folgenden Komponenten, um ein Datensatzdokument für adaptive Formulare zu generieren:

Adaptives Formular Das adaptive Formular, für das Sie ein Datensatzdokument generieren möchten.

Basisvorlage (empfohlen) Das ist eine in AEM Designer erstellte XFA-Vorlage (XDP-Datei). Eine Basisvorlage wird verwendet, um die Stile und Branding-Informationen für die Datensatzdokument-Vorlage festzulegen.

Siehe Basisvorlage eines Datensatzdokuments

HINWEIS

Die Basisvorlage eines Datensatzdokuments wird auch als Metavorlage des Datensatzdokuments bezeichnet.

Datensatzdokument-Vorlage Eine aus einem adaptiven Formular generierte XFA-Vorlage (XDP-Datei).

Weitere Informationen dazu finden Sie unter Konfiguration der Datensatzdokument-Vorlage.

Formulardaten Informationen, die von einem Benutzer in das adaptive Formular eingetragen werden. Sie werden mit der Datensatzdokument-Vorlage zusammengeführt, um das Datensatzdokument zu generieren.

Zuordnen von adaptiven Formularelementen

Die folgenden Abschnitte beschreiben, wie adaptive Formularelemente im Datensatzdokument angezeigt werden.

Felder

Komponente des adaptiven Formulars Zugehörige XFA-Komponente Standardmäßig in der Datensatzdokument-Vorlage enthalten? Anmerkungen
Schaltfläche Schaltfläche Nein
Kontrollkästchen Kontrollkästchen Ja
Datumsauswahl Datum-/Uhrzeitfeld Ja
Dropdown-Liste Dropdown-Liste Ja
Freihändige Unterschrift Freihändige Unterschrift Ja
Numerisches Feld Numerisches Feld Ja
Kennwortfeld Kennwortfeld Nein
Optionsfeld Optionsfeld Ja
Textfeld Textfeld Ja
Schaltfläche „Zurücksetzen“ Schaltfläche „Zurücksetzen“ Nein
Schaltfläche „Senden“

Schaltfläche „E-Mail senden“

Schaltfläche „HTTP senden“

Nein
Allgemeine Geschäftsbedingungen Ja
Dateianhang Nein In Datensatzdokument-Vorlage nicht verfügbar. In Datensatzdokument-Vorlage nur über Anlagen verfügbar.

Container

Komponente des adaptiven Formulars Zugehörige XFA-Komponente Anmerkungen
Bereich
Teilformular
Wiederholbare Bereichs-Maps, zugeordnet zu wiederholbarem Teilformular.

Statische Komponenten

Komponente des adaptiven Formulars Zugehörige XFA-Komponente Anmerkungen
Bild Bild Die Komponenten TextDraw und Image (egal ob gebunden oder nicht) werden immer im Datensatzdokument eines XSD-basierten adaptiven Formulars angezeigt, es sei denn, sie werden mithilfe der Datensatzdokument-Einstellungen ausgeschlossen.
Text Text
HINWEIS

In der klassischen Benutzeroberfläche sind verschiedene Registerkarten zum Bearbeiten der Feldeigenschaften vorhanden.

Tabellen

Die Tabellenkomponenten adaptiver Formulare, wie Kopf- und Fußzeile sowie Zeilen sind den entsprechenden XFA-Komponenten zugeordnet. Sie können wiederholbare Bereiche Tabellen im Datensatzdokument zuordnen.

Basisvorlage eines Datensatzdokuments

Die Basisvorlage beinhaltet Informationen zu Stil und Erscheinungsbild des Datensatzdokuments. Es bietet Ihnen die Möglichkeit, das Standarderscheinungsbild des automatisch generierten Datensatzdokuments anzupassen. Beispiel: Sie möchten das Logo Ihres Unternehmens in der Kopfzeile und die Copyright-Informationen in der Fußzeile des Datensatzdokuments einfügen. Die Masterseite der Basisvorlage wird als Masterseite für die Datensatzdokument-Vorlage verwendet. Die Masterseite kann Informationen wie Kopfzeile, Fußzeile und Seitenzahl enthalten, die Sie auf das Datensatzdokument anwenden können. Sie können solche Informationen mithilfe der Basisvorlage für die automatische Erstellung des Datensatzdokuments auf das Datensatzdokument anwenden. Die Verwendung der Basisvorlage ermöglicht es Ihnen, die Standardeinstellungen von Feldern zu ändern.

Bitte folgen Sie bei der Entwicklung Ihrer Basisvorlage den Konventionen für Basisvorlagen.

Konventionen für Basisvorlagen

Eine Basisvorlage wird verwendet, um Kopf- und Fußzeile, Stil und Erscheinungsbild eines Datensatzdokuments zu definieren. Die Kopf- und die Fußzeile können Informationen wie Firmenlogo und Copyright-Vermerk enthalten. Die erste Masterseite in der Basisvorlage wird als Masterseite für das Datensatzdokument kopiert und verwendet. Sie enthält Kopfzeile, Fußzeile und Seitenanzahl oder auch andere Informationen, die im Datensatzdokument auf allen Seiten angezeigt werden sollen. Wenn Sie eine Basisvorlage verwenden, die nicht den Konventionen für Basisvorlagen entspricht, wird die erste Masterseite aus der Basisvorlage dennoch in der Datensatzdokument-Vorlage verwendet. Es wird dringend empfohlen, dass Sie Ihre Basisvorlage gemäß den Konventionen entwerfen und sie für die automatische Erstellung von Datensatzdokumenten verwenden.

Konventionen für Musterseiten

  • In der Basisvorlage sollten Sie das Stamm-Unterformular mit AF_METATEMPLATE und die Musterseite mit AF_MASTERPAGE benennen.

  • Die Musterseite mit dem Namen AF_MASTERPAGE, die sich unterhalb des Stamm-Unterformulars AF_METATEMPLATE befindet, hat beim Extrahieren von Kopfzeilen-, Fußzeilen- und Stilinformationen Vorrang.

  • Wenn AF_MASTERPAGE fehlt, wird die erste Musterseite in der Basisvorlage verwendet.

Stilkonventionen für Felder

  • Wenn Sie einen Stil auf die Felder im Datensatzdokument anwenden, stellt die Basisvorlage die Felder im Teilformular AF_FIELDSSUBFORM bereit, das sich unter dem Stammteilformular AF_METATEMPLATE befindet.

  • Die Eigenschaften dieser Felder werden auf die Felder im Datensatzdokument angewendet. Benennungen für diese Felder sollten der Form AF_<name of field in all caps>_XFO folgen. So sollte beispielsweise der Feldname für ein Kontrollkästchen AF_CHECKBOX_XFO lauten.

Gehen Sie wie folgt vor, um eine Basisvorlage in AEM Designer zu erstellen:

  1. Klicken Sie auf Datei > Neu.

  2. Wählen Sie die Option Auf Basis einer Vorlage aus.

  3. Wählen Sie die Kategorie Formulare – Aufzuzeichnendes Dokument.

  4. Wählen Sie „DoR-Basisvorlage“.

  5. Klicken Sie auf Weiter und geben Sie die erforderlichen Informationen ein.

  6. (Optional) Ändern Sie den Stil und das Erscheinungsbild von Feldern, die Sie auf die Felder im Datensatzdokument anwenden möchten.

  7. Speichern Sie das Formular.

Sie können das gespeicherte Formular jetzt als Basisvorlage für das Datensatzdokument verwenden.
Ändern oder entfernen Sie keine Skripte, die in der Basisvorlage vorhanden sind.

Ändern der Basisvorlage

  • Wenn Sie auf Felder in der Basisvorlage keinen Stil anwenden, wird empfohlen, diese Felder aus der Basisvorlage zu entfernen, damit alle Aktualisierungen der Basisvorlage automatisch übernommen werden.
  • Während des Änderns der Basisvorlage dürfen Sie keine Skripte entfernen, hinzufügen oder ändern.
HINWEIS

Entwickeln Sie die Basisvorlage gemäß den Konventionen und folgen Sie dabei genau den oben beschriebenen Schritten.

Konfiguration von Vorlagen für Datensatzdokumente

Konfigurieren Sie die Datensatzdokument-Vorlage Ihres Formulars, damit Ihre Kunden eine benutzerfreundliche Kopie des gesendeten Formulars zum Drucken herunterladen können. Als Datensatzdokument-Vorlage dient eine XDP-Datei. Das vom Kunden heruntergeladene Datensatzdokument ist entsprechend dem Layout formatiert, das in der XDP-Datei festgelegt ist.

Führen Sie die folgenden Schritte aus, um ein Datensatzdokument für adaptive Formulare zu konfigurieren:

  1. Klicken Sie in der AEM-Autor-Instanz auf Formulare > Formulare und Dokumente.

  2. Wählen Sie ein Formular aus und klicken Sie auf Eigenschaften anzeigen.

  3. Klicken Sie im Fenster „Eigenschaften“ auf Formularmodell.

    Sie können ein Formularmodell auch bei der Erstellung eines Formulars auswählen.

    HINWEIS

    Achten Sie auf der Registerkarte „Formularmodell“ darauf, dass Sie Schema oder Ohne aus dem Dropdown-Menü Auswählen auswählen. Das Datensatzdokument wird nicht für XFA-basierte oder adaptive Formulare mit einer Formularvorlage als Formularmodell unterstützt.

  4. Wählen Sie auf der Registerkarte „Formularmodell“ im Abschnitt „Konfiguration der Datensatzdokument-Vorlage“ eine der folgenden Optionen aus.

    Keine Wählen Sie diese Option aus, wenn Sie kein Datensatzdokument für das Formular konfigurieren möchten.

    Formularvorlage als Dokument einer Datensatzvorlage verknüpfen Wählen Sie diese Option, wenn Sie eine XDP-Datei haben, die Sie als Vorlage für das Datensatzdokument verwenden möchten. Wenn Sie diese Option wählen, werden alle im AEM Forms-Repository verfügbaren XDP-Dateien angezeigt. Wählen Sie die entsprechende Datei aus.

    Die ausgewählte XDP-Datei wird mit dem adaptiven Formular verknüpft.

    Datensatzdokument generieren Wählen Sie diese Option aus, um eine XDP-Datei als Basisvorlage zum Definieren von Stil und Erscheinungsbild des Datensatzdokuments zu verwenden. Wenn Sie diese Option wählen, werden alle im AEM Forms-Repository verfügbaren XDP-Dateien angezeigt. Wählen Sie die entsprechende Datei aus.

    Wählen Sie diese Option, um eine XDP-Datei als Basisvorlage zum Definieren von Stil und Erscheinungsbild des Datensatzdokuments zu verwenden. Wenn Sie diese Option wählen, werden alle im AEM Forms-Repository verfügbaren XDP-Dateien angezeigt. Wählen Sie die entsprechende Datei aus.

    Forms-Vorlage als Basisvorlage auswählen, um Datensatzdokument zu generieren Wählen Sie diese Option aus, um eine XDP-Datei als Basisvorlage zum Definieren von Stil und Erscheinungsbild des Datensatzdokuments zu verwenden. Wenn Sie diese Option wählen, werden alle im AEM Forms-Repository verfügbaren XDP-Dateien angezeigt. Wählen Sie die entsprechende Datei aus.

    HINWEIS

    Stellen Sie in folgenden Fällen sicher, dass das Schema, das für die Erstellung von adaptivem Formular und Schema (Datenschema) des XFA-Formulars verwendet wird, gleich sind:

    • Ihr adaptives Formular ist Schema-basiert
    • Sie verwenden die Datensatzdokument-Option „Formularvorlage als Dokument aus Datensatzvorlage zuordnen“.
  5. Klicken Sie auf Fertig.

Anpassen der Branding-Informationen im Datensatzdokument

Beim Generieren eines Datensatzdokuments können Sie auf der Registerkarte „Datensatzdokument“ Branding-Informationen für das Datensatzdokument ändern. Die Registerkarte „Datensatzdokument“ enthält Optionen für Logos, Aussehen, Layout, Kopf- und Fußzeile, zum Anpassen des Haftungsausschlusses sowie eine Optionen zum Entscheiden, ob Sie deaktivierte Kontrollkästchen und Optionsfeldern berücksichtigen möchten.

Für die Lokalisierung der Branding-Informationen, die Sie auf der Registerkarte für das Datensatzdokument eingeben, müssen Sie sicherstellen, dass das Gebietsschema des Browsers richtig eingestellt ist. Um die Branding-Informationen im Datensatzdokument anzupassen, gehen Sie wie folgt vor:

  1. Wählen Sie einen Bereich (Stammbereich) im Datensatzdokument aus und tippen Sie dann auf Konfigurieren.

  2. Tippen Sie auf dortab. Die Registerkarte „Datensatzdokument“ wird angezeigt.

  3. Wählen Sie entweder die Standardvorlage oder eine benutzerdefinierte Vorlage für das Rendern von Datensatzdokumenten aus. Wenn Sie die Standardvorlage auswählen, wird eine Miniaturvorschau des Datensatzdokuments in der Dropdown-Liste für Vorlagen angezeigt.

    brandingtemplate

    Wenn Sie eine benutzerdefinierte Vorlage auswählen, navigieren zu einer XDP auf Ihrem AEM Forms-Server und wählen sie aus. Wenn Sie eine Vorlage verwenden möchten, die sich noch nicht auf Ihrem AEM Forms-Server befindet, müssen Sie die XDP zuerst auf Ihren AEM-Server hochladen.

  4. Abhängig davon, ob Sie eine Standard- oder eine benutzerdefinierte Vorlage wählen, werden einige oder alle der folgenden Eigenschaften auf der Registerkarte „Datensatzdokument“ angezeigt. Legen Sie die folgenden entsprechend fest:

    • Logo-Bild: Sie können entweder das Logo-Bild des adaptiven Formulars verwenden, eines in DAM auswählen oder eines von Ihrem Computer hochladen.
    • Formulartitel
    • Kopfzeilentext
    • Haftungsausschluss-Bezeichnung
    • Haftungsausschluss
    • Text des Haftungsausschlusses
    • Akzentfarbe: Die Farbe, in der Kopfzeilentext und Trennlinien im PDF des aufzuzeichnenden Dokuments dargestellt werden.
    • Schriftfamilie: Schriftfamilie des Textes im Datensatzdokument-PDF.
    • Für Kontrollkästchen und Optionsschaltflächenkomponenten nur ausgewählte Werte einblenden
    • Trennzeichen für mehrere ausgewählte Werte
    • Formularobjekte, die nicht mit dem Datenmodell verbunden sind, einschließen
    • Ausgeblendete Felder vom Datensatzdokument ausschließen
    • Beschreibung von Bereichen ausblenden
    HINWEIS

    Wenn Sie eine Vorlage für ein adaptives Formular mit einem Designer-Version vor 6.3 verwenden, müssen Sie sicherstellen, dass im Root-Unterformular der Vorlage für das adaptive Formular folgendes vorhanden ist, damit Akzentfarbe und Schriftfamilie funktionieren:

    <proto>
    <font typeface="Arial"/>
    <fill>
    <color value="4,166,203"/>
    </fill>
    <edge>
    <color value="4,166,203"/>
    </edge>
    </proto>
    
  5. Tippen Sie auf „Fertig“, um die Branding-Änderungen zu speichern.

Tabellen- und Spalten-Layouts für Bereiche im Datensatzdokument

Ihr adaptives Formular ist möglicherweise sehr lange und umfasst mehrere Formularfelder. Sie möchten eventuell das Datensatzdokument nicht als exakte Kopie des adaptiven Formulars speichern. Im Editor für adaptive Formulare können Sie jetzt das Tabellen- oder Spaltenlayout zum Speichern eines oder mehrerer Bereiche des adaptiven Formulars im Datensatzdokument auswählen.

Bevor Sie ein Datensatzdokument generieren, wählen Sie in den Einstellungen für den betreffenden Bereich unter „Layout für Dokument aus Datensatz“ entweder „Tabelle“ oder „Spalte“ aus. Die Felder im Bereich werden im Datensatzdokument entsprechend angeordnet.

Felder in einem Bedienfeld, im Datensatzdokument im Tabellenlayout angeordnet

Felder in einem Bedienfeld, im Datensatzdokument im Tabellenlayout angeordnet

Felder in einem Bedienfeld, im Datensatzdokument im Spaltenlayout angeordnet

Felder in einem Bedienfeld, im Datensatzdokument im Spaltenlayout angeordnet

Einstellungen für Datensatzdokumente

Über die Datensatzdokument-Einstellungen können Sie Optionen festlegen, die Sie in das Datensatzdokument aufnehmen möchten. Beispiel: Eine Bank akzeptiert in einem Formular Name, Alter, Sozialversicherungsnummer und Telefonnummer. Das Formular generiert eine Bankkontonummer und Details zur Filiale. Sie können festlegen, dass nur Name, Sozialversicherungsnummer, Bankkonto und Filialendetails im Datensatzdokument angezeigt werden.

Die Datensatzdokument-Einstellungen einer Komponente sind unter den Eigenschaften verfügbar. Um auf die Eigenschaften einer Komponente zuzugreifen, wählen Sie die Komponente aus und klicken Sie auf cmppr in der Überlagerung. Die Eigenschaften werden in der Seitenleiste mit den folgenden Einstellungen angezeigt.

Einstellungen auf Feldebene

  • Aus Datensatzdokument ausschließen: Wird diese Eigenschaft aktiviert, erscheint das Feld im Datensatzdokument nicht. Dies ist eine skriptfähige Eigenschaft namens excludeFromDoR. Ihr Verhalten ist von der auf Formularebene befindlichen Eigenschaft Felder aus DoR ausschließen, wenn sie ausgeblendet sind abhängig.

  • Bereich als Tabelle anzeigen: Durch die Aktivierung dieser Eigenschaft wird der Bereich im Datensatzdokument als Tabelle angezeigt, wenn er weniger als 6 Felder enthält. Gilt nur für den Bereich.

  • Titel aus Datensatzdokument ausschließen: Wird diese Eigenschaft aktiviert, erscheint der Titel des Bereichs bzw. der Tabelle im Datensatzdokument nicht. Gilt nur für Bereiche und Tabellen.

  • Beschreibung aus Datensatzdokument ausschließen: Wird diese Eigenschaft aktiviert, erscheint die Beschreibung des Bereichs bzw. der Tabelle im Datensatzdokument nicht. Gilt nur für Bereiche und Tabellen.

Einstellungen auf Formularebene

  • Ungebundene Felder in DoR einbeziehen: Durch Festlegen dieser Eigenschaft werden ungebundenen Felder aus dem Schema-basierten adaptiven Formular im Datensatzdokument berücksichtigt. Diese Option ist standardmäßig aktiviert.
  • Felder aus Datensatzdokument ausschließen, wenn sie ausgeblendet sind: Wenn aktiviert, wird das Verhalten der auf Feldebene befindlichen Eigenschaft „Aus Datensatzdokument ausschließen“ überschrieben, wenn sie nicht den Wert „true“ hat. Wenn Felder zum Zeitpunkt der Formularübermittlung ausgeblendet sind, werden sie vom Datensatzdokument ausgeschlossen, wenn die Eigenschaft den Wert „true“ hat, vorausgesetzt, die Eigenschaft „Aus Datensatzdokument ausschließen“ ist nicht festgelegt.

Wichtige Aspekte beim Arbeiten mit einem Datensatzdokument

Beachten Sie die folgenden Hinweise und Einschränkungen beim Arbeiten mit einem Datensatzdokument für adaptive Formulare.

  • Datensatzdokument-Vorlagen unterstützen keinen Rich-Text. Rich-Text im statischen adaptiven Formular oder bei den vom Endbenutzer ausgefüllten Informationen wird daher im Datensatzdokument als Nur-Text angezeigt.
  • Dokumentfragmente in einem adaptiven Formular werden im Datensatzdokument nicht angezeigt. Adaptive Formularfragmente werden jedoch nicht unterstützt.
  • Das Datensatzdokument wird nur zum Drucken verwendet.
  • Die Inhaltsbindung in Datensatzdokumenten, die für XML-Schema-Basierte adaptive Formulare generiert werden, wird nicht unterstützt.
  • Die Inhaltsbindung in Datensatzdokumenten, die für XML-Schema-Basierte adaptive Formulare generiert werden, wird nicht unterstützt.
  • Lokalisierte Versionen des DoR werden nach Wunsch für ein Gebietsschema erstellt, wenn der Benutzer das Rendern des DoR anfordert. Die Lokalisierung von DoR tritt zusammen mit der Lokalisierung des adaptiven Formulars auf. Siehe Verwenden von AEM-Übersetzungs-Arbeitsablauf zum Lokalisieren von adaptiven Formularen und Datensatzdokumenten.

Auf dieser Seite