Wenn ein Formular ausgefüllt oder übermittelt wird, können Sie das Formular drucken oder als Dokument speichern. Dies wird als Datensatzdokument (DoR) bezeichnet. Es handelt sich dabei um eine druckoptimierte Kopie des gesendeten Formulars. Auch können Sie im Datensatzdokument mittels Verweis Informationen erfassen, die Kunden zu einem späteren Zeitpunkt eingegeben haben, oder mithilfe des Datensatzdokuments Formulare und zugehörige Inhalte gemeinsam im PDF-Format archivieren.
Um ein Datensatzdokument zu erstellen, wird eine XFA- oder AcroForm-basierte Vorlage mit Daten zusammengeführt, die über ein adaptives Formular erfasst wurden. Sie können ein Datensatzdokument entweder automatisch oder auf Anfrage generieren.
Mit der On-Demand-Option können Sie eine benutzerdefinierte XFA- oder AcroForm-basierte Vorlage angeben, um Ihrem Datensatzdokument ein benutzerdefiniertes Erscheinungsbild zu verleihen.
Sie haben folgende Möglichkeiten:
Bevor Sie beginnen, lernen Sie die für ein Datensatzdokument erforderlichen Assets kennen und bereiten Sie sie vor:
Basisvorlage: Eine XFA-Vorlage (XDP-Datei), die in Forms Designer oder einem Acrobat-Formular (AcroForm) erstellt wurde. Über die Basisvorlage werden Stil- und Branding-Informationen für ein Datensatzdokument festgelegt. Laden Sie vorher Ihre XFA-Vorlage (XDP-Datei) in Ihre AEM Forms-Instanz hoch.
Adaptives Formular: Ein adaptives Formular, für das das Datensatzdokument generiert werden soll.
Laden Sie Ihre XFA-Vorlage (XDP-Datei) in Ihre AEM Forms-Instanz hoch. Führen Sie die folgenden Schritte aus, um ein adaptives Formular zu konfigurieren und die XFA-Vorlage (XDP-Datei) als Vorlage für das Datensatzdokument zu verwenden:
Ihr adaptives Formular ist jetzt so konfiguriert, dass eine XDP-Datei als Vorlage für das Datensatzdokument verwendet wird. Die nächsten Schritte bestehen darin, die Komponenten des adaptiven Formulars an die entsprechenden Vorlagenfelder zu binden.
Laden Sie Ihr Adobe Acrobat-PDF (AcroForm) in Ihre AEM Forms-Instanz hoch. Führen Sie die folgenden Schritte aus, um ein adaptives Formular zur Verwendung von Adobe Acrobat-PDF (AcroForm) als Vorlage für das Datensatzdokument zu konfigurieren:
Ihr adaptives Formular ist jetzt so konfiguriert, dass ein AcroForm als Vorlage für das Datensatzdokument verwendet wird. Die nächsten Schritte bestehen darin, die Komponenten des adaptiven Formulars an die entsprechenden Vorlagenfelder zu binden.
Wenn ein adaptives Formular so konfiguriert ist, dass automatisch ein Datensatzdokument generiert wird, wird dieses direkt aktualisiert, sobald das Formular geändert wird. Wenn beispielsweise ein Feld aus einem vorhandenen adaptiven Formular entfernt wird, wird das entsprechende Feld ebenfalls entfernt und ist nicht im Datensatzdokument sichtbar. Die automatische Generierung von Datensatzdokumenten bietet jedoch noch zahlreiche weitere Vorteile :
Führen Sie die folgenden Schritte aus, um ein adaptives Formular so zu konfigurieren, dass automatisch ein Datensatzdokument erzeugt wird:
Binden Sie Felder adaptiver Formulare mit Vorlagenfeldern, um die erfassten Formulardaten im entsprechenden Datensatzdokument-Feld anzuzeigen. Gehen Sie wie folgt vor, um die Komponenten des adaptiven Formulars an die entsprechenden Felder der Datensatzdokument-Vorlage zu binden:
Öffnen Sie das adaptive Formular, das für die Verwendung einer benutzerdefinierten Formularvorlage konfiguriert wurde, um es zu bearbeiten.
Wählen Sie eine Komponente des adaptiven Formulars aus und klicken Sie auf das Symbol . Dadurch wird der Eigenschaften-Browser geöffnet.
Wählen Sie im Eigenschaften-Browser ein Feld aus.
Klicken Sie auf Speichern.
Sie können die Sende-Aktion „E-Mail senden, Experience Manager-Workflow“ in Verbindung mit dem Schritt Datensatzdokument und andere Sende-Aktionen verwenden, um ein Datensatzdokument zu erhalten.
Adaptive Formulare und entsprechende Vorlagen für Datensatzdokumente können sich im Laufe der Zeit weiterentwickeln. So können Sie etwa Felder zu einem adaptiven Formular oder einer Datensatzdokument-Vorlage hinzufügen, entfernen oder ändern.
Wenn Sie Änderungen an einer Datensatzdokument-Vorlage vornehmen und die geänderte Vorlage in AEM Forms hochladen, erkennt der Editor für adaptive Formulare automatisch die geänderten Bindungen und informiert Sie über die Komponenten des adaptiven Formulars, für die neue Bindungen erforderlich sind. Dies ermöglicht es Ihnen, eine Datensatzdokument-Vorlage sukzessive zu aktualisieren.
Zum Beispiel: Beim Unternehmen We.Retail wird eine AcroForm-basierte Datensatzdokumentvorlage namens we-retail-bill.pdf verwendet. Die Vorlage sieht wie folgt aus:
Nachdem das Unternehmen die Vorlage einige Zeit verwendet hat, entscheidet es sich, das Feld invoice-number
in bill-number
umzubenennen und die E-Mail-Adresse der Käufer zu erfassen. Ein Entwickler aktualisiert den Namen des Felds invoice-number
und fügt der Vorlage ein Feld zur Eingabe der E-Mail-Adresse hinzu. Außerdem erstellt er eine neue Version der Vorlage namens we-retail-bill-v2.pdf.
Der Entwickler lädt die aktualisierte Vorlage hoch und wendet sie auf das adaptive Formular an. Das adaptive Formular erkennt automatisch die Liste der Felder, in denen sich die Bindung geändert hat, und zeigt diese an.
Der Formularentwickler bindet die Felder des adaptiven Formulars an die entsprechende Datensatzdokument-Vorlage.
Beim Versenden des adaptiven Formulars wird nun fortan ein aktualisiertes Datensatzdokument erstellt.
Beachten Sie beim Arbeiten an einem Datensatzdokument für adaptive Formulare die folgenden Hinweise und Einschränkungen.
Im Folgenden sind die Komponenten des adaptiven Formulars sowie die ihnen zugehörigen XFA-Komponenten aufgeführt. Ebenfalls ist aus der Tabelle abzulesen, ob Letztere im Datensatzdokument aufgenommen werden.
Komponente eines adaptiven Formulars | Zugehörige XFA-Komponente | Standardmäßig in 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. Nur über Anhänge in Datensatzdokument-Vorlage verfügbar. |
Komponente eines adaptiven Formulars | Zugehörige XFA-Komponente | Anmerkungen |
---|---|---|
Bereich |
Teilformular |
Wiederholbare Bedienfelder werden wiederholbaren Teilformularen zugeordnet. |
Komponente eines adaptiven Formulars | Zugehörige XFA-Komponente | Anmerkungen |
---|---|---|
Bild | Bild | Die Komponenten „TextDraw“ und „Image“ (unabhängig davon, ob gebunden oder nicht) werden in dem Datensatzdokument für ein XSD-basiertes adaptives Formular immer angezeigt, es sei denn, sie werden per Einstellungen des Datensatzdokuments ausgeschlossen. |
Text | Text |
Die Tabellenkomponenten adaptiver Formulare (wie Kopf- und Fußzeile sowie Zeilen) sind den entsprechenden XFA-Komponenten zugeordnet. Sie können Tabellen im Datensatzdokument wiederholbare Bereiche zuordnen.
Die Basisvorlage liefert Informationen zu Stil und Erscheinungsbild des Datensatzdokuments. Das bietet Ihnen die Möglichkeit, das Standarderscheinungsbild des automatisch generierten Datensatzdokuments anzupassen. So können Sie über die Basisvorlage etwa festlegen, dass das Datensatzdokument in der Kopfzeile das Logo Ihres Unternehmens und in der Fußzeile Ihre Copyright-Informationen trägt.
Die Musterseite aus der Basisvorlage wird als Musterseite für die Datensatzdokument-Vorlage verwendet. Die Musterseite kann Informationen wie Kopfzeile, Fußzeile und Seitenzahl enthalten, die Sie auf das Datensatzdokument anwenden können. Sie können diese Informationen mithilfe der Basisvorlage auf das Datensatzdokument anwenden, damit das Datensatzdokument automatisch generiert wird. Die Verwendung der Basisvorlage ermöglicht es Ihnen, die Standardeinstellungen von Feldern zu ändern.
Halten Sie sich bei der Entwicklung Ihrer Basisvorlage stets an die 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 Musterseite in der Basisvorlage wird kopiert und dient als Musterseite für das Datensatzdokument. Sie enthält Kopfzeile, Fußzeile, Seitenzahl oder andere Informationen, die auf allen Seiten im Datensatzdokument angezeigt werden sollen. Wenn Sie eine Basisvorlage verwenden, die den Konventionen für Basisvorlagen nicht entspricht, wird die erste Musterseite aus der Basisvorlage dennoch in der Datensatzdokument-Vorlage verwendet. Es wird dringend empfohlen, dass Sie Ihre Basisvorlage gemäß den Konventionen gestalten und sie für die automatische Generierung von Datensatzdokumenten verwenden.
Konventionen für Masterseiten
Benennen Sie in der Basisvorlage das Stamm-Unterformular mit AF_METATEMPLATE
und die Musterseite mit AF_MASTERPAGE
.
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 Felder in dem Unterformular AF_FIELDSSUBFORM
unter dem Stamm-Unterformular AF_METATEMPLATE
bereit.
Die Eigenschaften dieser Felder werden auf die Felder in dem 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 Forms Designer zu erstellen:
Klicken Sie auf Datei > Neu.
Wählen Sie die Option Auf Basis einer Vorlage aus.
Wählen Sie die Kategorie Formulare – Aufzuzeichnendes Dokument.
Auswählen DoR-Basisvorlage.
Klicken Sie auf Weiter und geben Sie die erforderlichen Informationen ein.
(Optional) Ändern Sie den Stil und das Erscheinungsbild von Feldern, die Sie auf die Felder im Datensatzdokument anwenden möchten.
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
Halten Sie sich bei der Entwicklung einer Basisvorlage genau die oben genannten Konventionen und Anweisungen.
Beim Generieren eines Datensatzdokuments können Sie auf der Registerkarte „Datensatzdokument“ die 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.
Achten Sie darauf, dass für Ihren Browser das richtige Gebietsschema festgelegt ist. Dadurch wird sichergestellt, dass die von Ihnen auf der Registerkarte für das Datensatzdokument eingegebenen Branding-Informationen lokalisiert werden. Gehen Sie wie folgt vor, um die Branding-Informationen des Datensatzdokuments anzupassen:
Wählen Sie einen Bereich (Stammbereich) im Datensatzdokument aus und tippen Sie dann auf .
Tippen Sie auf . Die Registerkarte „Datensatzdokument“ wird angezeigt.
Wählen Sie entweder die Standardvorlage oder eine benutzerdefinierte Vorlage für die Darstellung des Datensatzdokuments aus. Wenn Sie die Standardvorlage auswählen, wird eine Miniaturvorschau des Datensatzdokuments unterhalb der Dropdown-Liste „Vorlage“ angezeigt.
Abhängig davon, ob Sie eine standardmäßige oder eine benutzerdefinierte Vorlage wählen, werden einige oder alle der folgenden Eigenschaften auf der Registerkarte „Datensatzdokument“ angezeigt. Geben Sie die folgenden Eigenschaften an, um das Erscheinungsbild des Datensatzdokuments zu definieren:
Allgemeine Eigenschaften:
Formularfeldeigenschaften:
Eigenschaften der primären Seite:
Wenn Sie eine Vorlage für ein adaptives Formular mit einer Designer-Version vor 6.3 verwenden, müssen Sie sicherstellen, dass im Stamm-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>
Tippen Sie auf Fertig, um die Branding-Änderungen zu speichern.
Sie können die Datensatzdokument-Vorlage direkt über den Editor für adaptive Formulare oder den Vorlagen-Editor für adaptive Formulare konfigurieren.
Führen Sie die folgenden Schritte über die Autoreninstanz des Editors für adaptive Formulare aus:
Wählen Sie die Komponente Adaptiver Formularcontainer (Stamm) aus.
Klicken Sie auf das Symbol , um die Eigenschaften des adaptiven Formular-Containers zu öffnen.
Öffnen Sie die Registerkarte Datensatzdokument-Vorlage und wählen Sie aus den folgenden Optionen aus:
Keine: Wenn diese Option ausgewählt ist, wird keine Datensatzdokument-Vorlage für Ihr adaptives Formular erstellt.
Formularvorlage als Dokument aus Datensatzvorlage zuordnen: Wenn diese Option ausgewählt ist, wird das XFA-Formular als Vorlage für das Datensatzdokument verwendet.
Generieren von Dokument aus Datensatz: Wenn diese Option ausgewählt ist, wird die Datensatzdokument-Vorlage automatisch für Ihr adaptives Formular generiert.
Tippen Sie auf , um die Eigenschaften zu speichern.
Wenn die Datensatzdokument-Vorlage mit einem Vorlagen-Editor für adaptive Formulare erstellt wird, sind nur zwei Optionen auf der Registerkarte Datensatzdokument-Vorlage verfügbar: Keine und Generieren von Datensatzdokument.
Ihr adaptives Formular ist möglicherweise sehr lang und enthält mehrere Formularfelder. Sie möchten vielleicht nicht, dass ein Datensatzdokument als eine exakte Kopie des adaptiven Formulars gespeichert wird. Jetzt können Sie zum Speichern eines oder mehrerer Bereiche des adaptiven Formulars in der Datensatzdokument-PDF ein Tabellen- oder Spalten-Layout auswählen.
Wählen Sie vor dem Generieren eines Datensatzdokuments in den Einstellungen eines Bereichs als „Layout für das Datensatzdokument“ entweder „Tabelle“ oder „Spalte“ für diesen Bereich aus. Die Felder in dem Bereich werden in dem Datensatzdokument entsprechend angeordnet.
Felder in einem Bereich, die im Datensatzdokument im Tabellen-Layout dargestellt werden
Felder in einem Bereich, die im Datensatzdokument im Spalten-Layout dargestellt werden
In den Datensatzdokument-Einstellungen können Sie Optionen auswählen, die in dem Datensatzdokument enthalten sein sollen. Beispielsweise akzeptiert eine Bank in einem Formular Name, Alter, Sozialversicherungsnummer und Telefonnummer. Das Formular generiert eine Bankkontonummer und Details zur Zweigstelle. Sie können festlegen, dass nur Name, Sozialversicherungsnummer, Bankkonto und Filialendetails im Datensatzdokument angezeigt werden sollen.
Die Einstellung der Komponente „Datensatzdokument“ ist in den Eigenschaften verfügbar. Um auf die Eigenschaften einer Komponente zuzugreifen, wählen Sie die Komponente aus und klicken Sie auf in der Überlagerung. Die Eigenschaften werden in der Seitenleiste mit den folgenden Einstellungen angezeigt.
Einstellungen auf Feldebene
Aus Datensatzdokument ausschließen: Wenn aktiviert, ist das Feld im Datensatzdokument nicht enthalten. 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: Wenn aktiviert, wird der Bereich im Datensatzdokument als Tabelle angezeigt, wenn der Bereich weniger als 6 Felder enthält. Gilt nur für den Bereich.
Titel aus Datensatzdokument ausschließen: Wenn aktiviert, ist der Titel des Bereichs bzw. der Tabelle im Datensatzdokument nicht enthalten. Gilt nur für Bereiche und Tabellen.
Beschreibung aus Datensatzdokument ausschließen: Wenn aktiviert, ist die Beschreibung des Bereichs bzw. der Tabelle im Datensatzdokument nicht enthalten. Gilt nur für Bereiche und Tabellen.
Einstellungen auf Formularebene
Mit einer XCI-Datei können Sie verschiedene Eigenschaften eines Dokuments festlegen. Forms as a Cloud Service verfügt über eine primäre XCI-Datei. Sie können eine benutzerdefinierte XCI-Datei verwenden, um eine oder mehrere Standardeigenschaften zu überschreiben, die in der primären XCI-Datei angegeben sind. Sie können beispielsweise eine Schriftart in ein Dokument einbetten oder eine getaggte Eigenschaft für alle Dokumente aktivieren. Die folgende Tabelle gibt die XCI-Optionen an:
XCI-Option | Beschreibung |
---|---|
config/present/pdf/creator | Identifiziert den Ersteller des Dokuments mithilfe des Eintrags „Ersteller“ im Wörterbuch zu Dokumentinformationen. Weitere Informationen zu diesem Wörterbuch finden Sie im Handbuch zu PDF-Referenzen. |
config/present/pdf/producer | Identifiziert den Produzenten des Dokuments mithilfe des Eintrags „Produzent“ im Wörterbuch zu Dokumentinformationen. Weitere Informationen zu diesem Wörterbuch finden Sie im Handbuch zu PDF-Referenzen. |
config/present/layout | Steuert, ob es sich bei der Ausgabe um einen einzelnen Bereich handelt oder ob sie paginiert wird. |
config/present/pdf/compression/level | Gibt den Komprimierungsgrad an, der beim Generieren eines PDF-Dokuments verwendet werden soll. |
config/present/pdf/fontInfo/embed | Steuert die Einbettung von Schriftarten in das Ausgabedokument. |
config/present/pdf/scriptModel | Steuert, ob XFA-spezifische Informationen im PDF-Ausgabedokument enthalten sind. |
config/present/common/data/adjustData | Steuert, ob die XFA-Anwendung die Daten nach dem Zusammenführen anpasst. |
config/present/pdf/renderPolicy | Steuert, ob die Erstellung des Seiteninhalts auf dem Server erfolgt oder zum Client ausgelagert wird. |
config/present/common/locale | Gibt das im Ausgabedokument verwendete Standardgebietsschema an. |
config/present/destination | Gibt das Ausgabeformat an, wenn es in einem vorhandenen Element enthalten ist. Gibt die Aktion an, die beim Öffnen des Dokuments in einem interaktiven Client ausgeführt werden soll, wenn sie in einem openAction-Element enthalten ist. |
config/present/output/type | Gibt entweder die Art der Komprimierung an, die auf eine Datei angewendet werden soll, oder den Typ der zu erzeugenden Ausgabe. |
config/present/common/temp/uri | Gibt den Formular-URI an. |
config/present/common/template/base | Liefert einen Basisspeicherort für URIs im Formular-Design. Wenn dieses Element fehlt oder leer ist, wird der Speicherort des Formular-Designs als Basis verwendet. |
config/present/common/log/to | Steuert den Speicherort, an den Protokolldaten oder Ausgabedaten geschrieben werden. |
config/present/output/to | Steuert den Speicherort, an den Protokolldaten oder Ausgabedaten geschrieben werden. |
config/present/script/currentPage | Gibt die Anfangsseite an, auf der das Dokument geöffnet wird. |
config/present/script/exclude | Informiert Forms as a Cloud Service, welche Ereignisse ignoriert werden sollen. |
config/present/pdf/linearized | Steuert, ob das ausgegebene PDF-Dokument linearisiert ist. |
config/present/script/runScripts | Steuert, welcher Satz von Skripten von Forms as a Cloud Service ausgeführt wird. |
config/present/pdf/tagged | Steuert die Einbeziehung von Tags in das PDF-Ausgabedokument. Tags sind im Kontext von PDF zusätzliche Informationen, die in einem Dokument enthalten sind, um die logische Struktur des Dokuments anzuzeigen. Tags unterstützen Barrierefreiheitshilfen und die Neuformatierung. Beispielsweise kann eine Seitenzahl als Artefakt getaggt werden, sodass eine Bildschirmlesehilfe sie nicht in der Mitte des Textes anzeigt. Obwohl Tags ein Dokument nützlicher machen, erhöhen sie auch die Größe des Dokuments und die Verarbeitungszeit bei der Erstellung. |
config/present/pdf/fontInfo/alwaysEmbed | Gibt eine Schriftart an, die in das Ausgabedokument eingebettet ist. |
config/present/pdf/fontInfo/neverEmbed | Gibt eine Schrift an, die niemals in das Ausgabedokument eingebettet werden darf. |
config/present/pdf/pdfa/part | Gibt die Versionsnummer der PDF/A-Spezifikation an, der das Dokument entspricht. |
config/present/pdf/pdfa/amd | Gibt die Änderungsebene der PDF/A-Spezifikation an. |
config/present/pdf/pdfa/conformance | Gibt die Konformitätsstufe mit der PDF/A-Spezifikation an. |
config/present/pdf/version | Gibt die Version des zu erzeugenden PDF-Dokuments an |
config/present/pdf/version/map | Gibt die Fallback-Schriften für das Dokument an |
Fügen Sie die benutzerdefinierte XCI-Datei zu Ihrem Entwicklungsprojekt hinzu.
Geben Sie die folgende Inline-Eigenschaft an:
{
"xciFilePath": "[path of XCI file]"
}
Beispiel:
{
"xciFilePath": "/content/dam/formsanddocuments/customMinionProBoldAndTagged.xci"
}
Stellen Sie das Projekt in Ihrer Cloud Service-Umgebung bereit.