Formularkontext aufbauen und verwenden 

Verwendung

Wenn Sie ein zusammengesetztes Formular mit Daten füllen oder Formulardaten anderen Anwendungen und Services zur Laufzeit bereitstellen möchten, verwenden Sie den Formularkontext, um die zu übergebenden Daten zu handhaben. Die zum Aufbau des Formularkontextes benutzten Daten sollen zur Laufzeit im Formular angezeigt werden. Dazu werden die Parameter des Formularkontextes den Feldern des zusammengesetzten Formulars zugeordnet.

Sie bauen den Formularkontext in der Designumgebung auf, wenn Sie das Objekt des zusammengesetzten Formulars in der Designumgebung von Guided Procedures (GP) konfigurieren.

Voraussetzungen

Wenn Sie Vorverarbeitungsservices verwenden möchten, müssen Sie die entsprechenden Callable Objects im Voraus anlegen und aktivieren. Als Vorverarbeitungsservice können Sie jedes beliebige Callable Object verwenden, das im Hintergrund ausgeführt wird und Eingabeparameter definiert, z.B. RFC-Callable-Objects oder Callable Objects zur Hintergrund-Ausführung.

Siehe:

●      Creating Callable Objects for Background Execution

●      Exposing RFCs as Callable Objects

Vorgehensweise

1. Grunddaten für das zusammengesetzte Formular eingeben

...

       1.      Starten Sie die GP-Designumgebung und wählen Sie im Contextual-Navigation-Panel Zusammengesetztes Formular.

       2.      Geben Sie die erforderlichen Daten für das neue Formular ein.

○       Sie können Name und Beschreibung beliebig wählen.

○       Sie können einen vorhandenen Ordner wählen oder einen neuen anlegen.

○       Als Vorlagentyp wählen Sie:

■       PDF-Vorlage, wenn Sie die lokale Java-Persistenz zur Speicherung der Vorlage verwenden.

■       PDF-Vorlage (ABAP-Backend), wenn Sie die ABAP-Infrastruktur für die Formularpersistenz verwenden.

○       Als Verwendungstyp wählen Sie:

■       Feldbasierte Vorlage, wenn Sie ein wiederverwendbares Formular hochladen oder anlegen wollen

■       Schemabasierte Vorlage, wenn Sie das Formularschema aus dem Formularkontext generieren möchten.

       3.      Wählen Sie Weiter.

2. Vorverarbeitungsservices hinzufügen

...

       1.      Auf dem Bild Vorverarbeitung wählen Sie Service hinzufügen.

Durchsuchen Sie die Ordner in der Galerie nach den Callable Objects, die Sie verwenden möchten.

       2.      Um ein Callable Object hinzuzufügen, markieren Sie es und wählen Auswählen.

       3.      Fügen Sie auf diese Weise weitere Services hinzu.

       4.      Wählen Sie abschließend Fertig.

Zur Laufzeit werden die Vorverarbeitungsservices in der Reihenfolge ausgeführt, die Sie beim Hinzufügen festgelegt haben. Sie können die Reihenfolge über Nach oben verschieben und Nach unten verschieben ändern.

Die Reihenfolge ist wichtig, wenn ein oder mehrere Services das Ergebnis der Ausführung von Vorgängerservices als Input verwenden.

3. Parameter zum Formularkontext hinzufügen

...

       1.      Wählen Sie in der Tabelle Vorverarbeitungsservice einen Service aus.

Die Ausgabeparameter des Service werden auf der Registerkarte Formularkontext angezeigt.

       2.      Um einen Parameter zum Formularkontext hinzuzufügen, markieren Sie ihn in der Tabelle Serviceparameter und wählen Parameter hinzufügen.

Er erscheint dann in der Tabelle Formularkontext.

       3.      Um Parameter aus einem anderen Service hinzuzufügen, markieren Sie den Service in der Tabelle Vorverarbeitungsservice und wiederholen Sie den oben beschriebenen Schritt.

Standardmäßig enthält der Kontext eines zusammengesetzten Formulars ene Struktur für die zusätzlichen Felder, die im nächsten Assistentenschritt hinzugefügt werden.

Außerdem gibt es einen Standardeingabeparameter für eine Email-Adresse, an die das Formular geschickt werden kann, wenn es entsprechend konfiguriert wird. Diese Konfiguration wird vorgenommen, wenn das Formular in einem Callable Object gekapselt wird.

Siehe: Exposing Composite Forms as Callable Objects

4. Eingabe- und Ausgabeparameter von Services zu Formularkontexteinträgen zuordnen oder Standards setzen

Vorverarbeitungsservices können Eingabedaten aus dem auszuführenden Formularkontext verwenden.

Dazu müssen Sie die Serviceparameter, die Sie als Eingabe für den Formularkontext verwenden möchten, hinzufügen und anschließend die Formularkontexteinträge den Eingabeparametern der entsprechenden Services zuordnen.

Um die Ergebnisdaten in den Formularkontext aufzunehmen, ordnen Sie die Ausgabeparameter des Service den entsprechenden Formularkontexteinträgen zu.

Sie können auch Standardwerte für Eingabeparameter und Formularkontexteinträge setzen. Beispielswese können Sie Standards für die Eingabeparameter des ersten Vorverarbeitungsservice festlegen.

...

       1.      Wählen Sie die Registerkarte Eingabeparameter.

                            a.      Um die Serviceeingabeparameter dem Formularkontext zuzuordnen, wählen Sie einen Eintrag unter Eingabeparameter und dann einen Parameter aus dem Formularkontext.

Die Zuordnung erfolgt automatisch. Um die Zuordnung aufzuheben, wählen Sie Mapping entfernen.

                            b.      Um einen Standardwert hinzuzufügen, wählen Sie einen Eingabeparameter aus und wählen dann Standard festlegen.

Geben Sie den Standardwert an und wählen Sie Fertig.

       2.      Wählen Sie die Registerkarte Ausgabeparameter.

                            a.      Um die Serviceausgabe dem Formularkontext zuzuordnen, wählen Sie einen Eintrag unter Formularkontext aus und anschließend einen Parameter unter Ausgabeparameter.

Die Zuordnung erfolgt automatisch. Um die Zuordnung aufzuheben, wählen Sie Mapping entfernen.

                            b.      Um einen Standardwert hinzuzufügen, wählen Sie einen Formularkontextparameter aus und wählen dann Standard festlegen.

Geben Sie den Standardwert an und wählen Sie Fertig.

5. Eingabe- und Ausgabeparameter von Vorlagen zu Formularkontexteinträgen zuordnen oder Standards setzen

Bei der Vorbelegung von Formularvorlagen können Sie Eingabedaten aus dem auszuführenden Formularkontext verwenden. Nur feldbasierte Formulare können manuell vorbelegt werden. Schemabasierte Vorlagen werden automatisch vorbelegt.

Um eine Vorbelegung zu ermöglichen, müssen Sie die Felder des zusammengesetzten Formulars als Eingabe den entsprechenden Parametern im Formularkontext zuordnen. Anschließend müssen Sie die Formularkontexteinträge den Ausgabeparametern des zusammengesetzten Formulars zuordnen.

Sie können auch Standardwerte für Eingabe- und Ausgabeparameter von Vorlagen setzen. Beispielsweise können Sie Standardwerte für Vorlageneingabeparameter setzen, so dass bestimmte Werte als Vorbelegungselemente selektiert werden, wenn die PDF-Formulardatei angelegt wird.

Bei Parameterstrukturen, die aus Text- und Wertparametern betehen, wie Dropdown und Liste, kann der eingegebene Eingabeparameterwert (Text) vom Ausgabeparameterwert des zusammengesetzten Formulars abweichen, wenn das Formular abgesetzt wurde. Die Eingabe wird für die Vorbelegung von Feldern der Formularvorlage verwendet, die Ausgabe hingegen zur Fortsetzung des Prozessablaufs, wie z.B. Ausführen einer Aktion oder Abschließen eines Schritts.

...

       1.      Öffnen Sie die Designumgebung des zusammengesetzten Formulars und wählen Sie die Registerkarte Logische Kriterien. Wählen Sie die Drucktaste Zuordnungen definieren.

       2.      Wählen Sie die Registerkarte Eingabeparameter zuordnen.

                            a.      Um einen Formularvorlagenparameter einem Formularkontextparameter zuzuordnen, wählen Sie einen Eintrag unter Vorlagenparameter und dann einen Eintrag aus dem Formularkontext.

Die Zuordnung erfolgt automatisch. Um die Zuordnung aufzuheben, wählen Sie Mapping entfernen.

                            b.      Um einen Standardwert hinzuzufügen, wählen Sie einen Formularkontextparameter aus und wählen dann Standard festlegen.

Geben Sie den Standardwert an und wählen Sie Fertig.

       3.      Wählen Sie die Registerkarte Ausgabeparameter zuordnen.

                            a.      Um einen Formularkontexteintrag einem Vorlagenausgabeparameter zuzuordnen, wählen Sie einen Eintrag unter Formularkontext und dann einen Eintrag aus Vorlagenparameter aus.

Die Zuordnung erfolgt automatisch. Um die Zuordnung aufzuheben, wählen Sie Mapping entfernen.

                            b.      Um einen Standardwert hinzuzufügen, wählen Sie einen Formularkontextparameter aus und wählen dann Standard festlegen.

Geben Sie den Standardwert an und wählen Sie Fertig.

Sie können aus den folgenden Vorlagenparametern auswählen:

Vorlagenparameter

Adobe-UI-Element in Vorlagendatei	Vorlagenparameter des zusammengesetzten Formulars	Parametertyp	Beschreibung
Dropdown-Liste	DropDownList	String	Definiert die Vorbelegung einer Dropdown-Liste. Sie können einen Wert festlegen, der als Vorbelegungselement bei der Erstellung der PDF-Formulardatei ausgewählt wird.
Listbox	ListBox	String	Definiert die Vorbelegung einer Werteliste. Sie können einen Wert festlegen, der als Vorbelegungselement bei der Erstellung der PDF-Formulardatei ausgewählt wird.
Tabelle	Table	Struktur	Tabellenzeilen werden nicht vorbelegt. Wenn Zellen einige Formularfelder enthalten, werden ihre Werte vorbelegt und weitere Tabellenzeilen mit Formularfeldern angelegt. Um die Tabellenzellen vorzubelegen, müssen Sie die Tabelle im Adobe Designer entsprechend konfigurieren. Außerdem müssen Sie die Tabellenzeile einer Listenstruktur im Formularkontext zuordnen.
Ankreuzfeld	Checkbox	Boolean	Definiert die Vorbelegung eines Ankreuzfeldes. Sie können einen Standardwert wie yes setzen, um das Ankreuzfeld auszuwählen. Die Namen der Werte werden im Adobe Designer konfiguriert.
Datums-/Zeitfeld	DateTimeField	●      Datum ●      Zeit ●      Zeitstempel (umfasst Datum und Zeit)	Definiert die Vorbelegung eines Datums-/Zeitfeldes. Im Adobe Designer können Sie auswählen, welches Datumsformat beim Entwurf der Formularvorlage verwendet werden soll.
Numerisches Feld	NumericField	Float	Definiert die Vorbelegung eines numerischen Feldes.
Textfeld	TextField	String	Definiert die Vorbelegung eines Textfeldes.
Dezimalfeld	DecimalField	Decimal	Definiert die Vorbelegung eines Dezimalfeldes.
Auswahlknopf	RadioButtonList	String	Definiert die Vorbelegung eines Auswahlknopfes. Sie können einen Standardwert wie yes setzen, um den Auswahlknopf auszuwählen. Die Namen der Werte werden im Adobe Designer konfiguriert.
●      Dropdown-Liste ●      Ankreuzfeld	Prefill	Struktur	Enthält die Parameterstrukturen aus dem Vorverarbeitungsservice, die Dropdown-Liste und Listbox oder dem im Adobe Designer vergebenen Namen entsprechen. Jede der Strukturen enthält zwei Felder: Text und Wert. Die Strukturen müssen auch eine Liste sein, damit die Kombination Text=Wert unbestimmt vorkommen kann. Der von Ihnen eingebene Eingabeparameterwert (Text) kann von dem Ausgabeparameterwert des zusammengesetzten Formulars abweichen, wenn das Formular abgesetzt wurde.
Bildfeld		Binary	Nicht von GP unterstützt
Kennwortfeld		String	Nicht von GP unterstützt
Signaturfeld		String	Nicht von GP unterstützt
Text			Nicht von GP unterstützt

Die in der Tabellenspalte Vorlagenparameter aufgelisteten Namen sind die Standardnamen, die im Adobe LiveCycle Designer verwendet werden. Sie können die Namen der Vorlagenfelder beim Entwurf der Formularvorlage anpassen. Wenn Sie die Namen zu einem späteren Zeitpunkt anpassen, müssen Sie die aktualisierte Formularvorlage zum Objekt des zusammengesetzten Formulars in der Designumgebung hinzufügen.

       4.      Wenn Sie fertig sind, wählen Sie Sichern.

Ergebnis

Sie können jetzt die Formularvorlage instanziieren und die vorbelegten Formularelemente im generierten PDF-Formular sehen.

Weitere Informationen:

Instantiating and Testing Guided Procedure Forms

Formularkontext