Beispiel: Erstellen von Layouts und Fragment-Layouts

Ein Layout bestimmt den grafischen Aufbau eines Briefs. Das Layout kann typische Formularfelder wie „Adresse“ und „Referenz“ enthalten. Es enthält auch leere Unterformulare, die Zielbereiche darstellen.

Erstellen Sie das Layout im Formulardesigner. Danach lädt es der Anwendungsspezialist in die Correspondence Management Solution hoch. Von dort können Sie das Layout bei der Erstellung einer Briefvorlage auswählen. Anwendungsspezialisten ordnen Inhalte wie Text und Bilder in den Zielbereichen zu und verknüpfen Formularfelder mit Datenquellen.

Mit einem einzigen Layout können Anwendungsspezialisten viele verschiedene Briefvorlagen erstellen. Beispielsweise enthält das unten gezeigte Layout „ClaimSubrogations“ mehrere Zielbereiche, von denen einige in anderen Briefvorlagen wiederverwendet werden können:

Grafik in Originalgröße anzeigen
Layout „ClaimSubrogations“

Übersicht über die Implementierung

Führen Sie die folgenden Schritte durch, um Layouts für die Correspondence Management Solution zu erstellen:

  1. Analysieren Sie das Layout, und bestimmen Sie den Inhalt, der über alle Seiten wiederholt wird. Normalerweise fallen Seitenkopf- und -fußzeilen in diese Kategorie. Dieser Inhalt wird auf Mustervorlagenseiten des Layouts platziert. Der restliche Inhalt wird in den Hauptteilseiten des Layouts platziert. In einer Richtlinienhülle kann das Logo und die Unternehmensadresse zu den Kopf- und Fußzeilen der Mustervorlagenseite hinzugefügt werden. (Vgl. Analysieren der vorhandenen Korrespondenz.) Beispiel: In der Lösungsvorlage verwenden der Hinweis zur Forderungsabtretung und die Kündigungsmitteilung beide dasselbe Layout. (Vgl. Correspondence Management Solution – schrittweise Erklärung.)

  2. Wenn Sie die Hauptteilseiten entwickeln, teilen Sie den Seiteninhalt in Abschnitte. Jeder Abschnitt wird als Unterformular entwickelt, das im Layout selbst oder als Fragment-Layout eingebettet wird. Verwenden Sie die folgenden Richtlinien, um die richtige Vorgehensweise auszuwählen:
    • Wenn der Abschnitt eine Tabelle enthält, modellieren Sie ihn als Fragment-Layout.

  3. Ein Layout kann folgendermaßen entwickelt werden:
    • Machen Sie jeden Bereich zu einem separaten Unterformular mit allen Elementen des Abschnitts.

    • Machen Sie jeden Abschnitt zu einem untergeordneten Unterformular des gleichen übergeordneten Unterformulars. Das Layout des übergeordneten Unterformulars ist auf Fluss eingestellt, um den Abschnitten das Wechseln zu ermöglichen, wenn große Datenmengen in vorherigen Abschnitten zusammengeführt werden.

    • Der primäre Standortabschnitt kann auch in anderen Layouts wiederverwendet werden. Erstellen Sie ihn als Fragment-Layout.

    • Die Details des zusätzlichen Abschnitts enthalten nur zwei Elemente, die untereinander platziert sind, können große Datenmengen enthalten und werden als Fluss entwickelt.

    • Andere Abschnitte enthalten Elemente an bestimmten Positionen, sodass sie als positioniertes Layout entwickelt werden.

    • Teilen Sie einen Abschnitt in Unterformulare, wenn der Abschnitt Elemente an bestimmten Positionen enthält und wenn diese Elemente große Datenmengen enthalten. Ordnen Sie dann die Unterformulare an, um das gewünschte Verhalten zu erzielen.

    • Fügen Sie für den primären Standortabschnitt einen Platzhalter-Zielbereich hinzu. Der Platzhalter ist an den primären Fragmentstandort gebunden, wenn der Brief entwickelt wird.

  4. Laden Sie das Layout und das Fragment-Layout mit der Benutzeroberfläche „Elemente verwalten“ hoch.

Verwendete Werkzeuge

  • LiveCycle Designer zum Erstellen von Layouts und Layout-Fragmenten.

  • Die Benutzeroberfläche „Elemente verwalten“ zum Hochladen des Layouts und der Layout-Fragmente in das Correspondence Management-System.

Teammitglieder

Die in diesem Benutzerszenario beschriebenen Aufgaben werden vom Formularentwickler durchgeführt. Der Formularentwickler verfügt über detaillierte Kenntnisse von LiveCycle Designer.

Layout für Correspondence Management erstellen

Zielversion

Verwenden Sie LiveCycle Designer zur Erstellung von Layouts, die XFA 2.8 oder höher als Zielversion haben müssen. So stellen Sie sicher, dass das Layout die korrekte Zielversion verwendet:

  1. Klicken Sie in LiveCycle Designer auf „Datei“ > „Formulareigenschaften“ > „Standard“ und legen Sie die Zielversion auf „Acrobat/Reader 9.0“ fest.

  2. Wechseln Sie zur Ansicht „XML-Quelle“ und vergewissern Sie sich, dass die Vorlageversion 2.8 ist. Beispiel:

    <template xmlns="http://www.xfa.org/schema/xfa-template/2.8/">

  3. Suchen Sie im Vorlagenknoten nach dem Knoten originalXFA und falls er vorhanden ist, löschen Sie ihn. Beispiel:

    <?originalXFAVersion http://www.xfa.org/schema/xfa-template/2.6/?>

  4. Wenden Sie alle Änderungen auf die XML-Quelle an, indem Sie zu einer anderen Ansicht wechseln.

Unterformulare als Zielbereiche erstellen

Standardmäßig werden alle Unterformulare, die keinen Inhalt umfassen, als Zielbereiche betrachtet. Wenn Ihr Layout ein leeres Unterformular enthält, das nicht als Zielbereich betrachtet wird, fügen Sie dem Namen dieses Unterformulars das Suffix „_int“ (intern) hinzu. Beispiel: subformWithScript_int. Verwenden Sie ein leeres Unterformular als Fragment, das nur eine Reihe von Skriptobjekten enthält, die in verschiedenen Formularen verwendet werden. In diesem Fall erscheint das Unterformular zwar leer, aber es wird nicht als Zielbereich betrachtet. Folgende Knoten werden als Inhalt betrachtet: area, draw, exclGroup, exObject, field, subform und subformSet.

Ein Unterformular als Zielbereich muss Folgendes enthalten:

  • Einen Namen

  • Eine Breite (nicht erweiterbar)

  • Eine Position (x, y)

  • Es muss fließend sein.

Folgendes darf auf ein Unterformular als Zielbereich nicht zutreffen:

  • Es wurde ein Bindungstyp festgelegt („binding“ muss auf „none“ eingestellt sein).

  • Es umfasst Inhalte (untergeordnete Knoten folgender Art: area, draw, exclGroup, exObject, field, subform oder subformSet).

  • An den Namen ist das Suffix „_int“ angehängt.

  • Es befindet sich auf einer Masterseite.

Schema verwenden

Sie können ein Schema in einem Layout oder Fragment-Layout verwenden, was aber nicht erforderlich ist. Wenn Sie ein Schema verwenden, stellen Sie Folgendes sicher:
  • Das Layout und alle Fragment-Layouts, die in einem Brief verwendet werden, verwenden Sie das gleiche Schema wie der Brief.

  • Alle Felder, die mit Daten gefüllt werden müssen, sind an das Schema gebunden.

Verknüpfungsfähige Felder erstellen

Standardmäßig werden alle Felder als verknüpfungsfähig mit vielen anderen Datenquellen betrachtet. Wenn das Layout Felder enthält, die nicht mit einer Datenquelle verknüpfungsfähig sind, fügen Sie den Namen dieser Felder das Suffix „_int“ (intern) hinzu. Beispiel: pageCount_int.

Ein verknüpfungsfähiges Feld muss folgende Voraussetzungen erfüllen:

  • Es muss ein XFA <field> oder <exclGroup> sein.

  • Es muss einen XFA-Bindungsverweis haben.

  • Wenn es sich um <exclGroup> handelt, muss es über mindestens ein untergeordnetes Feld für ein Optionsfeld verfügen, andernfalls kann die Art des Wertes nicht ermittelt werden.

Ein verknüpfungsfähiges Feld muss folgende Voraussetzungen erfüllen:

  • Es muss einen Namen haben.

Auf ein verknüpfungsfähiges Feld darf Folgendes NICHT zutreffen:

  • An den Namen ist das Suffix „_int“ angehängt.

  • Das Feld „binding“ ist auf „none“ eingestellt.

  • Es ist ein untergeordnetes Element eines <exclGroup>-Elements.

Solange ein verknüpfungsfähiges Feld die oben genannten Kriterien erfüllt, kann es sich im Layout an jeder beliebigen Position und in jeder Verschachtelungstiefe befinden. Verknüpfungsfähige Felder lassen sich auf Masterseiten verwenden.

Felder sind in Bezug auf ihre Layoutkonfiguration flexibler als Unterformulare, die als Zielfelder verwendet werden, allerdings sind Felder an eine einzige Wertart gebunden. Sie können ein Feld in die Breite ziehen oder es mit einer festen Breite oder Höhe einrichten usw. Das aufgelöste Modul- oder Regelergebnis wird in das Feld übernommen.

Entscheidungshilfe: Wann sollten Unterformulare, wann Felder verwendet werden?

Verwenden Sie ein Unterformular für Inhalte aus mehreren Modulen in einem von oben nach unten angeordneten Layout mit vertikalem Fluss (mehrere Absätze oder Bilder). Die Höhe eines Unterformulars nimmt zu, damit es den vorgesehenen Inhalt fassen kann: Achten Sie darauf, dass Ihr Layout diesen Umstand bewältigen kann. Wenn Sie nicht sicher sein können, dass der mit dem Unterformular/dem Zielbereich verknüpfte Inhalt niemals mehr Raum einnimmt als für das Unterformular vorgesehen ist, richten Sie das Unterformular als untergeordnetes Element eines fließenden Unterformular-Containers ein. Damit stellen Sie sicher, dass Layout-Objekte unterhalb des Unterformulars nach unten rücken, wenn die Höhe des Unterformulars zunimmt.

Verwenden Sie ein Feld, wenn Sie Moduldaten oder Daten aus einem Datenwörterbuchelement in das Schema Ihres Layouts aufnehmen möchten (da Felder mit Daten verknüpft sind) oder wenn Modulinhalte auf einer Masterseite angezeigt werden sollen. Beachten Sie, dass sich die Position von Inhalten auf einer Masterseite nicht an die Inhalte einer Hauptteilseite anpasst; stellen Sie also sicher, dass ein Bildfeld als Kopfzeilenlogo verwendet wird. Das gilt beispielsweise, wenn der Bildinhalt auf seinen Inhaltsbereich beschränkt bleiben und nicht in Originalgröße angezeigt werden soll. Andernfalls würde das Bild ab einer bestimmten Größe von den Inhalten der Hauptteilseite überlagert.

Die folgende Tabelle enthält weitere Kriterien für die Entscheidung, wann ein Unterformular und wann ein Feld im Layout verwendet werden sollte.

Voraussetzungen zur Verwendung eines Unterformulars

Voraussetzungen zur Verwendung eines Textfeldes

Es enthält eine Kombination einzelner Elemente, z. B. Vorname und Nachname.

Es enthält ein einzelnes Element, z. B. eine Policennummer.

Es enthält mehrere Absätze.

Text wird umgebrochen und ausgerichtet.

Sich wiederholende, optionale und bedingte Datengruppen sind mit Unterformularen verknüpft, um das Risiko von Designfehlern zu verringern, wie sie auftreten könnten, wenn Sie zur Erzielung desselben Ergebnisses Skripte verwenden würden.

Elemente wie das Logo und die Adresse Ihres Unternehmens werden auf allen Seiten eines Briefes angezeigt. Erstellen Sie in einem solchen Fall Formularfelder für die betreffenden Elemente und ordnen Sie die Felder auf der Masterseite an. Wenn Sie das Feld „binding“ auf „Keine Datenbindung“ einstellen, wird im Briefeditor keines der Felder als verknüpfungsfähiges Feld angezeigt. Wenn Sie mit diesen Feldern jedoch bestimmte Inhaltstypen verknüpfen möchten, muss der Bindungstyp im Feld „binding“ entsprechend eingerichtet werden.

Wenn die Firmenadresse mehr als eine Datenzeile umfasst, verwenden Sie das Textfeld mit der Option „Mehrere Zeilen zulassen“, um die Adresse im Layout darzustellen.

Wenn der Datentyp eines Textfeldes auf Normaltext eingestellt ist, wird die Normaltextversion der Modulausgabe an Stelle der Rich-Text-Version verwendet (d. h. alle Formatierungen gehen verloren). Wenn die Formatierung erhalten bleiben soll, stellen Sie den Datentyp des Textfeldes auf Rich-Text ein.

Text wird fortlaufend eingefügt (Textfluss).

Textfelder und Bildfelder werden auf Masterseiten verwendet. Auf Masterseiten können Unterformulare nicht als Zielbereiche verwendet werden.

Objekte werden gruppiert und organisiert, ohne das Unterformular mit einem Datenelement zu verknüpfen.

 

Innerhalb des Unterformulars ist ein Textfeld vorhanden. Das Unterformular kann an Größe zunehmen, ohne darunter angeordnete Layout-Objekte zu überschreiben.

Sie benötigen einen einfachen Zugriff auf die Daten in der Nachbearbeitung.

Sich wiederholende Elemente einrichten

Wenn Elemente wie das Logo und die Adresse Ihres Unternehmens auf allen Seiten eines Briefes angezeigt werden sollen, erstellen Sie für diese Elemente Formularfelder und ordnen Sie sie auf der Masterseite an. Nehmen Sie die Bindung für diese Felder über den Feldnamen vor.

Server-Renderformat festlegen

Verwenden Sie das dynamische XML-Formular als Server-Renderformat des Layouts; andernfalls können Briefe, die auf dem betreffenden Layout beruhen, nicht korrekt gerendert werden. Das Server-Renderformat ist in LiveCycle Designer standardmäßig auf das dynamische XML-Formular eingestellt. So stellen Sie sicher, dass Sie das richtige Format verwenden:

 Klicken Sie in LiveCycle Designer auf Datei > Formulareigenschaften > Standard, und vergewissern Sie sich, dass „PDF-Wiedergabeformat“ auf „Dynamisches XML-Formular“ eingestellt ist.

Richtlinien/Tipps und Tricks

Standardbindung für Unterformulare einrichten

Bei der Erstellung von Zielbereichen in LiveCycle Designer ist es hilfreich, die Standardbindung für alle neuen Unterformulare auf „Ohne“ einzustellen. So legen Sie die Standardbindung fest:

  1. Klicken Sie in LiveCycle Designer auf Extras > Optionen > Datenbindungen > Unterformularbindung.

  2. Wählen Sie in der Liste „Standardbindung für neue Unterformulare“ die Option Keine Datenbindung aus.

    Dadurch stellen Sie sicher, dass für Unterformulare, die Sie mit dem Befehl Einfügen > Unterformular oder per Drag & Drop aus der Objektpalette einfügen, die Bindungsmethode standardmäßig auf „Ohne“ eingestellt ist. Dadurch ist ein neues Unterformular standardmäßig ein Zielbereich, außer Sie fügen Inhalte hinzu, ändern die Bindungseinstellung oder fügen das Suffix „_int“ an den Namen des Unterformulars an.

Konformität mit Abschnitt 508

Wenn ein auf der Benutzeroberfläche „Korrespondenz erstellen“ erstellter Brief in einem späteren Workflow-Schritt mit Daten gefüllt wird, halten Sie sich bei der Erstellung des Layouts an folgende Empfehlungen in Bezug auf Abschnitt 508. Andernfalls dient die PDF-Datei des Briefes der Anzeige und Sie können diese Empfehlungen ignorieren:

  • Alle als Zielbereich fungierenden Unterformulare und alle Felder in einem Layout haben eine Aktivierreihenfolge.

  • Felder mit Beschriftungen sind standardmäßig mit Abschnitt 508 konform. Das Feldattribut /field/assist/speak@priority ist standardmäßig auf „custom“ gesetzt, d. h. sofern kein benutzerdefinierter Text für eine Bildschirmlesehilfe bereitgestellt wird, liest die Bildschirmlesehilfe die Beschriftung des Feldes.

  • Legen Sie bei Feldern ohne Beschriftungen eine QuickInfo fest und weisen Sie Bildschirmlesehilfen an, die QuickInfo zu lesen, indem Sie /field/assist/speak@priority="toolTip" festlegen und den Text für die QuickInfo in /field/assist/toolTip angeben.

Datumsformate in Designer und Asset Configuration Manager

Vergewissern Sie sich beim Entwerfen eines Layouts in LiveCycle Designer, dass die Formate für Datumsfelder mit den in Asset Configuration Manager angegebenen Datumsformaten übereinstimmen. Weitere Informationen finden Sie unter Feldwerte formatieren und Muster verwenden in der LiveCycle Designer-Hilfe.

Datumsbereiche erfassen

Wenn eine Datumskombination einzufügen ist, z. B. „startDate“ bis „endDate“, verwenden Sie ein einzelnes Unterformular, um eine korrekte Ausrichtung im endgültigen Brief sicherzustellen und die Anzahl der Felder möglichst gering zu halten.

Bindungen auf Formularebene festlegen

Wenn ein Layout viele Felder und Zielbereiche enthält, die einzelnen XML-Elementen zugeordnet sind, verwenden Sie die Bindung auf Formularebene und erstellen Sie einen separaten Knoten für jedes Element. Auf Formularebene verknüpfte Felder werden bei der Zuordnung von Daten in Correspondence Management ignoriert.

Auf Masterseiten keine Unterformulare als Zielbereiche verwenden

Unterformulare als Zielbereiche auf einer Masterseite sind auf der Benutzeroberfläche „Elemente verwalten“ nicht sichtbar, sodass ihnen keine Daten zugeordnet werden können.

Geeignete Positionen und Typen für Zielbereiche auswählen

Wählen Sie Unterformulare beim Entwerfen des Layouts sorgfältig aus. Wenn ein Layout ein einzelnes Unterformular enthält, kann es sich um eine Fließform handeln. Wenn Sie Felder in dem Unterformular platziert haben, können Sie es in ein anderes Unterformular einbetten, sodass das eingebettete Unterformular auch die Fließform annimmt und das Layout nicht beeinträchtigt wird.

Platzieren von Feldern auf Masterseiten

Beachten Sie Folgendes, wenn Sie ein Feld auf eine Masterseite platzieren:

  • Legen Sie die Bindung von Masterseitenfeldern auf Globale Daten verwenden fest.

  • Platzieren Sie das Feld nicht direkt unter das Stamm-PageArea der Masterseite.

  • Betten Sie das Feld in eine benannte Subform ein und stellen Sie sicher, dass die Bindung der benannten Subform auf Name verwenden festgelegt ist.