bbc Fragmente in Formularentwürfen erstellen und verwenden Adobe LiveCycle Designer ES2 November 2009 Version 9
2009 Adobe Systems Incorporated. All rights reserved. Adobe LiveCycle Designer ES2 (9.0) für Microsoft Windows November 2009 This tutorial is licensed for use under the terms of the Creative Commons Attribution Non-Commercial 3.0 License. This License allows users to copy, distribute, and transmit the tutorial for noncommercial purposes only so long as (1) proper attribution to Adobe is given as the owner of the tutorial; and (2) any reuse or distribution of the tutorial contains a notice that use of the tutorial is governed by these terms. The best way to provide notice is to include the following link. To view a copy of this license, visit http://creativecommons.org/licenses/bync-sa/3.0/. Adobe, Adobe logo, Adobe Reader, Acrobat, and LiveCycle are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. Microsoft and Windows are either trademarks or registered trademarks of Microsoft Corporation in the United States and/or other countries. All other trademarks are the property
3 Grundlegendes zu diesem Lernprogramm In diesem Lernprogramm erfahren Sie, wie Sie das Erstellen von Formularsammlungen mit Hilfe von Fragmenten vereinfachen können. Bevor Sie mit der Arbeit beginnen, empfiehlt es sich, sich ein Videolernprogramm anzusehen, in dem die Verwendung von Formularfragmenten Schritt für Schritt erläutert wird. Siehe dazu das Videolernprogramm für Formularfragmente. Zusätzliche Informationen Gewünschte Informationen Fragmente Weitere LiveCycle Designer ES2-Lernprogramme Siehe Fragmente verwenden in der LiveCycle Designer ES2-Hilfe Bestellformular erstellen Bestellformular mit flexiblem Layout
4 Fragmente in Formularentwürfen erstellen und verwenden In den folgenden Schritten erfahren Sie, wie Sie das Erstellen von Formularsammlungen mithilfe von Fragmenten vereinfachen: Grundlagen So öffnen Sie das Musterfragment in der Palette Fragmentbibliothek Fragment erstellen Fragment bearbeiten Fragmente mit Skriptinhalt verwenden Fragmente zum Steuern der Anzeige von Teilformularen Grundlagen Sie haben die Aufgabe, eine Formularsammlung zu erstellen. Aus Erfahrung wissen Sie, dass Sie beim ersten Formular wahrscheinlich sehr viel ausprobieren müssen, bevor Sie mit dem Ergebnis zufrieden sind. Nachdem Sie Ihr erstes Formular erstellt haben, werden Sie jedoch merken, dass Sie den Erstellungsprozess z. B. über Tastaturbefehle vereinfachen und weitere Formulare sehr viel schneller erstellen können. Sie werden z. B. feststellen, dass die meisten der zu erstellenden Formulare eine Lieferadresse enthalten. Anstatt jedes Mal ein neues Teilformular für die Lieferadresse zu erstellen, kopieren Sie das erste Teilformular für die Lieferadresse, das Sie erstellt haben, und speichern es in einer eigenständigen XDP-Datei. Auf diese Weise können Sie das Teilformular für die Lieferadresse ganz einfach in andere Formulare einfügen. Änderungen am Teilformular für die Lieferadresse können Sie entweder in jedem Formular einzeln durchführen, oder Sie ändern die Adresse einmalig in der XDP-Datei und lassen den Abschnitt mit der Lieferadresse in jedem Formular automatisch ersetzen. In LiveCycle Designer ES2 werden diese wiederverwendbaren Bestandteile Fragmente genannt. Anstatt diesen Bestandteil jedes Mal aus einer anderen Datei zu kopieren, können Sie eine Referenz auf das gewünschte Fragment einfügen, das dann im Formular angezeigt wird. Wenn Sie ein Fragment aktualisieren, werden diese Änderungen automatisch von allen Formularen übernommen, die auf das Fragment verweisen. Beim Speichern eines Formulars als PDF-Datei werden alle Fragmente in das Formular eingefügt.
So öffnen Sie das Musterfragment in der Palette Fragmentbibliothek 5 So öffnen Sie das Musterfragment in der Palette Fragmentbibliothek Die Palette Fragmentbibliothek enthält Fragmentbibliotheken. Eine Fragmentbibliothek ist ein Ordner in Ihrem Dateisystem, der die Quelldateien der Fragmente im XDP-Format enthält. Die Bibliothek Eigene Fragmente enthält Musterfragmente, die Sie in Formularentwürfe einfügen oder als Vorlage zur Erstellung neuer Fragmente verwenden können. Um Zugriff auf die Fragmente zu erhalten, öffnen Sie zunächst die Fragmentbibliothek. 1 Wählen Sie Fenster > Fragmentbibliothek, um die Palette Fragmentbibliothek anzuzeigen. 2 Wählen Sie im Menü der Palette Fragmentbibliothek die Option Fragmentbibliothek öffnen. 3 Wählen Sie unter DE\Samples\Forms\Purchase Order\Form Fragments\Fragments den Ordner Fragments aus. 4 Klicken Sie auf OK. Fragment erstellen In diesem Abschnitt lernen Sie, wie Sie Fragmente erstellen. Fragmente können in einer separaten Datei oder in Ihrem aktuellen Formularentwurf erstellt werden. 1 Öffnen Sie unter \DE\Samples\Forms\Purchase Order\Form Fragments\Forms das Musterformular Purchase Order Interactive.pdf. 2 Markieren Sie rechts oben auf dem Formular die Textfeldobjekte Bestellnummer und Bestelldatum.
Fragment erstellen 6 3 Wählen Sie Bearbeiten > Fragmente > Fragment erstellen. 4 Geben Sie im Feld Name z. B. Bestellinformationen als Name des Fragments ein. 5 Geben Sie Bestellnummer und Bestelldatum in das Feld Beschreibung ein. 6 Wenn Sie das Fragment in einer separaten XDP-Datei definieren möchten, die in der Fragmentbibliothek gespeichert wird, aktivieren Sie die Option Neues Fragment in Fragmentbibliothek erstellen. 7 Um das Fragment im aktuellen Dokument zu definieren, wählen Sie Neues Fragment in aktuellem Dokument erstellen. 8 Wählen Sie in der Liste Fragment die Option Fragmentbibliothek öffnen aus. Navigieren Sie zum Verzeichnis DE\Samples\Forms\Purchase Order\Form Fragments\Fragments und wählen Sie den Ordner Fragments aus. 9 Lassen Sie das Kontrollkästchen Auswahl durch Verweis auf neues Formularfragment ersetzen aktiviert, so dass die Textfeldobjekte Bestellnummer und Bestelldatum im Formularentwurf durch das neue Formularfragment ersetzt werden. 10 Klicken Sie auf OK. 11 Speichern Sie den Formularentwurf beispielsweise als Meine Bestellung Interaktiv.pdf. Sie werden feststellen, dass sich die Darstellung der Objekte Bestellnummer und Bestelldatum verändert hat. Sie wurden durch eine Referenz auf das neu erstellte Fragment Bestellinformationen ersetzt. In der oberen linken Ecke eines Fragmentverweises wird ein Fragmentsymbol in der Farbe der Objektgrenzen angezeigt. Die graue Umrandung der Objekte innerhalb eines Fragmentverweises zeigt an, dass sie nicht aus dem Verweis heraus bearbeitet werden können.
Fragment bearbeiten 7 Durch Klicken markieren Sie den Fragmentverweis, durch Ziehen können Sie ihn verschieben. Die einzelnen Objekte eines Fragmentverweises können nicht ausgewählt werden. Aus demselben Grund können die Objekte auch nicht einzeln über die Palette Hierarchie ausgewählt werden. A. Fragmentverweissymbole in einem Teilformular B. Die Objekte eines Fragments können nicht ausgewählt werden Fragmentverweise und deren Inhalt können wie andere Formularobjekte in der Palette Hierarchie verschoben werden. Sie können jedoch keine Objekte in einen Fragmentverweis hineinziehen. Fragment bearbeiten Einer der größten Vorteile von Fragmenten ist, dass sie in mehrere Formulare eingefügt werden können, Änderungen aber nur an einer Stelle durchgeführt werden müssen. In diesem Abschnitt bearbeiten Sie das Fragment Bestellinformationen. Zunächst fügen Sie das Fragment dem Formular Purchase Order Dynamic Interactive.pdf hinzu. Anschließend können Sie den Effekt der Bearbeitung des Fragments Bestellinformationen in mehreren Formularentwürfen sehen. 1 Öffnen Sie die Datei Purchase Order Dynamic Interactive.pdf. 2 Markieren Sie die Objekte Bestellnummer und Bestelldatum und löschen Sie sie. 3 Klicken Sie in der Palette Fragmentbibliothek auf das Fragment Bestellinformationen und ziehen Sie es in den Formularentwurf. 4 Speichern Sie den Formularentwurf beispielsweise als Meine Bestellung Dynamisch Interaktiv.pdf. 5 Klicken Sie mit der rechten Maustaste auf den Fragmentverweis Bestellinformationen und wählen Sie Fragmente > Fragment bearbeiten. Die Quelldatei des Fragments Bestellinformationen wird in Workbench ES2 zur Bearbeitung geöffnet.
Fragmente mit Skriptinhalt verwenden 8 6 Ersetzen Sie Bestellnummer beispielsweise durch Bestellnr. 7 Öffnen Sie die Musterformulare Meine Bestellung Interaktiv.pdf und Meine Bestellung Dynamisch Interaktiv.pdf. Der Fragmentverweis wurde in beiden Formularen aktualisiert. Sie haben gelernt, wie Sie ein Fragment erstellen und verändern. Sie können einen Fragmentverweis auch in ein eingebettetes Objekt umwandeln oder Überschreibungen für einen Fragmentverweis erstellen, die sich nur auf den Verweis im aktuellen Formular bezieht. Im Folgenden erhalten Sie detailliertere Informationen zu Musterformularen sowie Erläuterungen zu einigen weiteren nützlichen Eigenschaften von Fragmenten. Fragmente mit Skriptinhalt verwenden Fragmente können wiederverwendbare JavaScript-Funktionen oder Werte enthalten, die unabhängig von einem bestimmten Skriptobjekt gespeichert werden. Diese Fragmente werden verwendet, um benutzerdefinierte Funktionen und Eigenschaften zu erstellen, die Sie an mehreren Stellen in einem Formular oder in mehreren Formularen verwenden können. Das Musterfragment countryscript steuert beispielsweise die Interaktion zwischen den Dropdown-Listen Land und Bundesstaat in den Musterformularen. Die Optionen, die in der Dropdown-Liste Bundesstaat angezeigt werden, hängen von der Auswahl in der Dropdown-Liste Land ab. So testen Sie ein einfaches Skriptfragment 1 Öffnen Sie das Musterformular Meine Bestellung Interaktiv.pdf und klicken Sie auf die Registerkarte PDF-Vorschau im Layout-Editor. 2 Wählen Sie im Abschnitt Bestellt von in der Dropdown-Liste Land den Eintrag Canada und klicken Sie danach auf die Dropdown- Liste Bundesstaat. In der Liste werden die kanadischen Provinzen angezeigt.
Fragmente mit Skriptinhalt verwenden 9 3 Wählen Sie dann in der Dropdown-Liste Land den Eintrag United States und klicken Sie danach auf die Dropdown-Liste Bundesstaat. In der Liste werden die US-Bundesstaaten angezeigt. Nachfolgend erhalten Sie detaillierte informationen zum Fragment countryscript in den Musterformularen. So zeigen Sie das Skript im Fragment countryscript an 1 Klicken Sie in der Palette Fragmentbibliothek mit der rechten Maustaste auf das Fragment countryscript und wählen Sie Fragment bearbeiten. Das Fragment wird in der Palette Hierarchie als untergeordnetes Element von Variablen aufgeführt. Fragmente können keine Skripten enthalten, die mit anderen Formularobjekten verbunden sind. Dies gilt z. B. für Ereignisskripten wie validate, calculate oder initialize. 2 Wählen Sie in der Palette Hierarchie das Skriptobjekt countryscript. 3 Erweitern Sie den Skript-Editor, um das Skript anzuzeigen. Die Dropdown-Listenobjekte drpdelivertocountry und drpdelivertostateprv in den Fragmenten OrderedByAddress und DeliverToAddress der Musterformulare verweisen jeweils auf das Fragment countryscript. 4 Klicken Sie in der Palette Fragmentbibliothek mit der rechten Maustaste auf das Fragment DeliverToAddress und wählen Sie Fragment bearbeiten.
Fragmente zum Steuern der Anzeige von Teilformularen 10 5 Wählen Sie in der Palette Hierarchie das Dropdown-Listenobjekt drpdelivertocountry aus und sehen Sie sich das Skript im Skript-Editor an. Beachten Sie, in welcher Weise auf das Fragment countryscript verwiesen wird. Fragmente zum Steuern der Anzeige von Teilformularen Im Musterformular Purchase Order Dynamic.xdp werden Fragmente verwendet, um die Fußzeile zu konfigurieren. So wird sichergestellt, dass je nachdem, mit welchen Daten das Formular zusammengeführt wird, stets die richtige Adresse dargestellt wird. Wird das Musterformular mit der Datei Purchase Order Canada.xml zusammengeführt, wird das Fragment FooterCanada instanziiert. Wird das Formular jedoch mit der Datei Purchase Order US.xml zusammengeführt, wird das Fragment FooterUS instanziiert. 1 Öffnen Sie die Datei Purchase Order Dynamic.xdp und klicken Sie auf Datei > Formulareigenschaften > Vorschau. 2 Klicken Sie im Feld Datendatei auf die Durchsuchen-Schaltfläche und wählen Sie unter DE\Samples\Forms\Purchase Order\ Form Fragments\Data die Datei Purchase Order US.xml aus. 3 Klicken Sie auf Öffnen und dann auf OK. 4 Klicken Sie im Layout-Editor auf die Registerkarte PDF-Vorschau. Wie Sie sehen, wird in der Fußzeile eine US-amerikanische Adresse angezeigt. 5 Klicken Sie auf Datei > Formulareigenschaften > Vorschau. 6 Klicken Sie im Feld Datendatei auf die Durchsuchen-Schaltfläche und wählen Sie unter DE\Samples\Forms\Purchase Order\ Form Fragments\Data die Datei Purchase Order Canada.xml aus. 7 Klicken Sie auf Öffnen und dann auf OK. 8 Klicken Sie im Layout-Editor auf die Registerkarte PDF-Vorschau. Wie Sie sehen, wird in der Fußzeile eine kanadische Adresse angezeigt.
Fragmente zum Steuern der Anzeige von Teilformularen 11 Sehen Sie sich als Nächstes an, wie dieser Auswahlabschnitt erstellt wurde. So zeigen Sie die Fragmente FooterCanada und FooterUS an 1 Klicken Sie in der Palette Hierarchie mit der rechten Maustaste auf das Fragment FooterCanada. 2 Wählen Sie Fragmente > Fragment bearbeiten. Das Fragment besteht aus zwei statischen Textobjekten, von denen eines eine kanadische Adresse enthält. 3 Wiederholen Sie die angegebenen Schritte, um das Fragment FooterUS anzuzeigen. So zeigen Sie den Auswahlabschnitt in der Fußzeile des Bestellformulars an 1 Öffnen Sie das Musterformular Purchase Order Dynamic.xdp und klicken Sie im Layout-Editor auf die Registerkarte Masterseiten. 2 Verwenden Sie die Bildlaufleiste, um die Fußzeile anzuzeigen. Beachten Sie, dass die beiden Fragmentverweise FooterCanada und FooterUS in dem Teilformularsatz übereinander liegend dargestellt werden. Bei der Wiedergabe des Formulars wird jedoch, je nach Dateneingabe, jeweils nur eine der beiden Fußzeilen angezeigt. Da die Größe der Fußzeile an die Seite angepasst wurde, wird außerdem ein Symbol angezeigt, das über aufgetretene Eigenschaftsüberschreibungen für Fragmentverweise informiert. 3 Wählen Sie in der Palette Hierarchie den Teilformularsatz aus. Wählen Sie danach in der Palette Objekt die Registerkarte Teilformularsatz und klicken Sie auf die Schaltfläche Alternativen bearbeiten. Das Dialogfeld Datenteilformulare bearbeiten zeigt Bindung, Sprache und Ausdrücke für die alternativen Fußzeilen-Fragmente an.
Wie geht es weiter? 12 4 Öffnen Sie die Dateien Purchase Order US.xml und Purchase Order Canada.xml in einem Texteditor. Beachten Sie, dass der Wert für <americas> </americas> in der Datei Purchase Order US.xml mit US angegeben ist und in der Datei Purchase Order Canada.xml mit Canada. Dieser Wert bestimmt, welches Fragment instanziiert wird, wenn die Daten mit dem Formular zusammengeführt werden. Wie geht es weiter? Sie haben verschiedene Möglichkeiten kennen gelernt, wie Sie die Erstellung und Pflege einer Formularsammlung mit Hilfe von Fragmenten vereinfachen und beschleunigen können. Weitere Informationen zu Fragmenten finden Sie unter Fragmente verwenden in der LiveCycle Designer ES2-Hilfe.