Seitenhistorie

Verwendung

Ein WorkItem-Objekt ist eine konkrete Realisierung eines Dokuments zum Druck oder Archiv. Das WorkItem generiert ein Formular aus dem Input-Dokument.

Syntax

WorkItem Name {

FormFileName Name
PDFImportType Value
PDFImportDocuments Value
FirstPage No
NextPage No
DesignsFirst Value
DesignsNext Value
ArchiveDesignsFirst Value
ArchiveDesignsNext Value
MaterialFirst Value
MaterialNext Value
PaperTypeFirst Value
PaperTypeNext Value
PageDescriptorFirst Value
PageDescriptorNext Value
IntrayFirst Value
IntrayNext Value
OuttrayFirst Value
OuttrayNext Value
FinishingFirst Value
FinishingNext Value
BackPageFirst Value
BackPageNext Value
RotateToFirst Value
RotateToNext Value
GutterFirst Value
GutterNext Value
Copy No
CopyText Value
Printer Value
Print Value
Archive Value
ArchiveText Value
ArcRefFields Value
PageReverser Value
JoinBefore Value
BeforeCalc {
 …
}
AfterCalc {
 …
}
EnvelopeSortSystem {
 ...
}
Positions Value
BackPageDesignsFirst Value
BackPageDesignsNext Value
DuplexFirst Value
DuplexNext Value
Recognition bzw. Rec {
 …
}
Central Value
HeaderWorkItem Name
TrailerWorkItem Name
IndicantWorkItem Name
HeaderFields Value
TrailerFields Value
IndicantFields Value
VolFields Value
ArcVolFields Value
WIFields Value
PDFFields Value
PDFProfile Value
ContinuationTextPage Value
ContinuationTextBackPage Value
Layout Value
LayoutElement Value
DataBind Value
EmbeddedFiles Value

}

Erklärung

FieldOrValue
Der FormFileName bestimmt den File, in dem die physikalischen Seiten und SubForms definiert sind. Fehlt die Angabe, so wird auf die Eingabe vom DocDef zurückgegriffen.

FieldOrValue
PDFImportType ist ein Schalter mit den Werten von 0 bis 4, wobei 0 der Standardwert ist und bestimmt, in welcher Form die unter PDFImportDocuments angegebenen PDF-Files mit dem WorkItem zusammengeführt werden:

FieldOrValue
Ist eine semikolonseparierte Liste von PDF-FileNamen, die in der angegebenen Reihenfolge mit dem WorkItem verbunden werden sollen. Es ist auch möglich nur einzelne Seiten zu importieren. Dazu muss nach dem FileNamen das Pipe-Symbol („|“) gefolgt von der Seitennummer der zu importierenden Seite angegeben werden. Auch XDP- und Images-Dateien lassen sich auf diese Weise importieren. In diesem Fall steht hinter dem Pipe-Symbol der Seitenname des XDPs oder die Bildnummer in der Image-Datei. In welchem Modus die Seiten mit WorkItem verbunden werden, regelt der Parameter PDFImportType.

FieldOrValue
Gibt den Namen der Grundseite einer vom WorkItem generierten FirstPage wieder. Der Standartwert ist Seite1.

FieldOrValue
Name der Grundseite einer vom WorkItem generierten NextPage. Für den Duplex-Betrieb können auch zwei unterschiedliche Grundseiten angegeben werden. Eine, wenn die NextPage eine Vorderseite ist, und eine andere, wenn die NextPage eine Rückseite ist.

Syntax

NextPage Name oder
NextPage NameVorderseite#NameRückseite

FieldOrValue
DesignsFirst und DesignsNext definieren eine Folge an Design-Subformularen und ihren Zielpositionen, so dass die Designs stufenweise auf die Grundseite gebracht werden. Siehe dazu den Abschnitt Designs.

DesignsNext ME_COMPANY_DESIGN,SubForm10;[30mm,120mm],SubForm5+

FieldOrValue
ArchiveDesignsFirst und ArchiveDesignsNext definieren eine Folge von Design-Subformularen und deren Zielpositionen. Im Gegensatz zu DesignFirst und DesignNext werden diese aber nur auf den Archivkopien angebracht. Siehe dazu den Abschnitt Designs.

FieldOrValue
Mit den Material-Definitionen kann je Blatt eine Material bestimmt oder gerufen werden.
Wird kein Material definiert, so prüft das Programm die Höhe und Breite des Seite und sucht sich selbständig ein Standard-Maerial. Wird kein Material gefunden, so wird die Verarbeitung abgebrochen.

Syntax

MaterialFirst Value
MaterialNext Value

MaterialFirst M:LogoPapierXYZ F:DINA4 W:4.2gramm
MaterialNext  M:Zahlschein W:5.6gramm

FieldOrValue
Mit den PageDescriptoren kann je Seite eine globale Variable PageDescriptor definiert werden, die mit im Formular ausgegeben wird.

Syntax

PageDescriptorFirst Value
PageDescriptorNext Value

PageDescriptorFirst test print
PageDescriptorNext  test print

FieldOrValue
Der Papiertyp beschreibt die Art des Papiers, welches in den Papierschacht eingelegt werden muss, der durch das Intray-Kommando angesprochen wird. Aus den Werten von PaperType und Intray wird eine Papierbelegungstabelle erstellt, anhand derer sich widersprechende Papierbelegungen ausgeschlossen werden können.

Syntax

PaperTypeFirst Value
PaperTypeNext Value

PaperTypeFirst letterhead
PaperTypeNext  payment form

FieldOrValue
IntrayFirst und IntrayNext definieren den Papiereinzugsschacht für die FirstPage und die NextPage.

Syntax

IntrayFirst Value
IntrayNext Value

IntrayFirst lower_tray
IntrayNext  upper_tray

FieldOrValue
OuttrayFirst und OuttrayNext definieren den Papierausgabeschacht für die FirstPage und die NextPage.

Syntax

OuttrayFirst Value
OuttrayNext Value

OuttrayFirst backside_bin
OuttrayNext  frontside_bin

FieldOrValue
FinishingFirst und FinishingNext definieren Nachverarbeitungsoptionen, das sogenannte Paperfinishing wie Stapeln (Heften) oder Jogging (versetzte Ablage), für die FirstPage und die NextPage.

FieldOrValue
Mit BackPageFirst und BackPageNext wird die Seite im Design angegeben, die auf die Rückseite der FirstPage bzw. der NextPage gedruckt werden soll. Ist kein Seitenname angegeben, so erfolgt der Ausdruck Simplex (ohne Rückseite).

Syntax

BackPageFirst FormFilePageName
BackPageNext FormFilePageName

BackPageFirst Backpage1

FieldOrValue
RotateToFirst und RotateToNext bestimmen ob die Seite in der Ausgabe gedreht werden soll.
Folgende Werte sind möglich:

RotateToFirst und RotateToNext haben ein Pendant in dem PDFProfile der Ini-Datei. Die Einstellungen im WorkItem haben allerdings Vorrang.

FieldOrValue
GutterFirst und GutterNext bestimmen den Bundsteg als Längenangabe für Rückseiten die nicht statisch sind. Damit kann die Rückseite eines Blattes um die angegebene Längeneinheit orthogonal zur Bindekante versetzt werden, wobei nur positive Werte eine Auswirkung haben. Der Standardwert 0.0mm.
Es wird die gesamte Seite verschoben. Nur Designs, die sich den Positionsbezeichnung ROOT beziehen bleiben an der Originalstelle stehen und werden nicht versetzt.

FieldOrValue
Mit Copy wird die Anzahl der auszugebenden Exemplare des WorkItems definiert. Es werden dabei mehrere Kopien des WorkItems in den Datenstrom generiert. Mit CopyText kann auf jede Kopie noch ein Text aufgebracht werden, der Organisationsmerkmale enthält.

FieldOrValue
Für jede auszugebende Kopie, die über Copy bestimmt wird, kann ein Organisationsmerkmal mitgegeben werden. CopyText unterstützt dabei zwei Methoden. Ist der Wert von Copy auf DocDef-Ebene größer als 1, so wird der CopyText auf Basis der DocDef-Kopien erzeugt.

1. CopyText wird ein kommaseparierter String übergeben. Jeder Token des Strings entspricht einem Organisationstext für eine Kopie.

   Codeblock
   title Beispiel:
   CopyText Original, Kopie 1, Kopie 2, Kopie Buchhaltung

2. CopyText wird ein String mit einer Variablen und ohne Komma übergeben. Enthält der CopyText ein %P, so erfolgt die Ausgabe des CopyTextes ab der ersten Kopie. Enthält CopyText kein %P, so wird CopyText erst ab der zweiten Kopie ausgegeben. Enthält der CopyText den Platzhalter %C oder %P so werden diese beim Generieren ausgetauscht:
   %C Nummer der Kopie-1
   %P Nummer der Kopie

   Codeblock
   title Beispiel:
   CopyText Kopie %C

FieldOrValue
Printer definiert den Ausgabedruck für das WorkItem. Ist bereits ein Drucker im DocDef , so wird dieser für dieses WorkItem überschrieben.

FieldOrValue
Print ist ein Schalter mit den Werten 0 und 1, wobei 1 der Standardwert ist. Steht Print auf 1, so erfolgt die Druckausgabe. Andernfalls wird das Drucken unterbunden (unabhängig vom Schalter Archiv).

FieldOrValue
Archive ist ein Schalter mit den Werten 1 und 0 und bestimmt, ob dieses WorkItem auch zu archivieren ist. Voraussetzung für das Archivieren ist, dass im DocDef das Archivieren für dieses Dokument erlaubt wurde, indem Archive auf eins gesetzt wurde. Wenn ein WorkItem archiviert wird, so enthält das Archivdokument weniger Angaben als das zu druckende Dokument. Angaben zur Portoklassenberechnung, OMR-Steuerung und einige Seitenzähler werden nicht archiviert.

Archive @GETSUBSTITUTE("ArchivTab", JF_REPRINT)

FieldOrValue
ArchiveText bewirkt, dass der angegebene Text als globales Feld mit dem Namen ArchiveText in einem zu archivierenden Dokument erscheint. Die dazugehörige Druckausgabe enthält dieses Feld auch, aber der Inhalt des Feldes bleibt leer.

ArchiveText Archive output

ArcRefFields definieren in einem kommaseparierten String Kopffelder, die zum Archivieren als Referenzvariablen mitgegeben werden. Die erste Variable sollte eine eindeutige Belegnummer sein, da diese im Log des Archivers wiedergefunden werden kann. Jedes WorkItem, das eine eigene ArcRefFields-Liste besitzt, eröffnet im Ausgabedatenstrom für den Archiver ein eigenständiges Archiv-Dokument. Sollen mehrere WorkItems zu einem Archiv-Dokument zusammengefasst werden, so darf nur das erste WorkItem eine eigene ArcRefFields-Liste besitzen.

ArcRefFields JFA_DOCNUM,JFA_DOCDAT,JFA_DOCTYPE

Einige Archivsysteme arbeiten auf Basis eines Volltextindexes. Um diese Funktionalität zu unter-stützen, gibt es ein spezielles Konstrukt, das alle Nettodateninhalte in einem Feld zusammenfasst.

FieldOrValue
Einige Kuvertierstraßen benötigen das gedruckte Dokument in umgekehrter Reihenfolge. PageReverser ist ein Schalter mit den Werten 1 und 0, wobei 0 der Standardwert ist. Ist der PageReserver aktiviert, wird die letzte Seite eines Dokuments zuerst gedruckt.

FieldOrValue
JoinBefore ist ein Schalter mit den Werten 0 und 1, wobei 0 der Standardwert ist. JoinBefore hängt direkt mit dem DocDef-Schlüsselwort JoinKey zusammen. Beim Joinen entsteht aus mehreren Einzeldokumenten ein Gesamtdokument. Im Standardfall werden die Seiten der Teildokumente immer hinten an das Gesamtdokument angehängt. Wenn das nicht gewünscht ist, dann kann mit JoinBefore in einem WorkItem festgelegt werden, dass die Stelle zum Einfügen weiterer Seiten in das Gesamtdokument vor den Seiten diese WorkItems liegt. JoinBefore wirkt sich nicht nur im ersten Teil-Dokument, dem Master-Dokument, eines Gesamtdokuments aus, sondern in jedem anderen außer dem letzten.

BeforeCalc dient zum Berechnen von Feldern und dem Ausführen von Calc-Befehlen. BeforeCalc wird vor der Ausführung des WorkItem aufgerufen.  Die Verwendung inkl. der Liste der Calc-Befehle wird gesondert erläutert (siehe Interne Objekte).

AfterCalc dient zum Berechnen von Feldern und dem Ausführen von Calc-Befehlen. AfterCalc wird vor der Ausführung des WorkItem aufgerufen.  Die Verwendung inkl. der Liste der Calc-Befehle wird gesondert erläutert (siehe Interne Objekte).

Das EnvelopeSortSystem beschreibt alle Werte, die im Zusammenhang mit einem Kuvertiersystem der Portoklassenberechnung bzw. der DV-Freimachung stehen. Die Funktionsweise ist im Kapitel „Interne Objekte“ beschrieben.

Positions definiert die Reihenfolge und die Auswahl von TCI-Positionen, die im dynamischen Bereich des WorkItems angedruckt werden. Bei der Angabe der Positionen werden folgende Einstellungen festgelegt:

1. Kommt die Position aus dem Datenstrom oder ist diese fix anzudrucken?
2. Aus welcher Tabelle kommen die Daten der Position?
3. Wird die Reihenfolge der Positionen aus dem Datenstrom bestimmt oder ist diese fest vorgegeben?
4. Müssen die Positionen sortiert werden?

Syntax

Positions Section[,Section[...]]

Die Sektionen werden in der Reihenfolge von links nach rechts abgearbeitet. Sektionen sind bestimmte Bereiche von Positionen, die Sortierung, Datentabelle und die Entscheidung über fix oder dynamisch miteinander teilen. Eine Sektion kann sein:

1. eine fixe Position
2. die dynamische Auswahl von Positionen aus der Positions-Tabelle
3. die dynamische Auswahl von Positionen aus der Group-Tabelle
   

   ---

   
   

1. Die fixe Position

   Eine fixe Position ruft unabhängig vom Datenstrom eine TCI-Position auf. Die gerufene Position hat aus diesem Grund auch keine lokalen Daten, die im SubForm-Objekt der Position mit angedruckt werden können. 

   Syntax

                  PosName

    

2. Die dynamische Auswahl von Positionen aus der Positions-Tabelle

   Diese Sektion besteht aus der Aufzählung einer oder mehrerer TCI-Positionen, die in der Positions-Tabelle gesucht werden. Dabei werden alle Positionen der Positionstabelle, die der Aufzählung entsprechen, in eine temporäre Liste überführt. Diese Liste kann sortiert und unsortiert ausgegeben werden. Die Werte des Sortierfeldes können numerisch oder alphanumerisch sein. Treten numerische und alphanumerische Werte gemischt auf, so werden die numerischen Werte vor die alphanumerischen Werte sortiert.

   Syntax

                  PosName[|PosName [...]]([SortField])

   Es werden alle Positionen TERMS, ITEM_LINE_1, ITEM_LINE_3F und ITEM_LINE_3F_PRICE gesucht und in der Reihenfolge gedruckt, in der diese in der Positionstabelle standen.

   Codeblock
   title Beispiel:
   TERMS|ITEM_LINE_1|ITEM_LINE_3F|ITEM_LINE_3F_PRICE()

   Es werden alle Positionen ITEM gesucht und nach dem in den ITEM-Positionen vorhandenen Feld ITEM_NO aufsteigend sortiert und gedruckt.

   Codeblock
   title Beispiel:
   ITEM(ITEM_NO)

   Als Alternative zur genauen Angabe der Positionen kann für dynamische Positionen auch ein Wildcard angegeben werden. Es werden alle Positionen zum Druck angestoßen, die als dynamische Position verfügbar sind.

   Codeblock
   title Beispiel:
   POSITIONS *()

   Im nachfolgenden Beispiel werden eine Kopfposition HEADERPOS, alle dynamischen Positionen sowie eine Schlussposition TRAILERPOS angedruckt.

   Codeblock
   title Beispiel:
   POSITIONS HEADERPOS, *(), TRAILERPOS

3. Die dynamische Auswahl von Positionen aus der Group-Tabelle

   Diese Sektion besteht aus der Aufzählung einer oder mehrerer TCI-Positionen, die in der Group-Tabelle gesucht werden. Dabei werden alle Positionen der Positionstabelle, die der Aufzählung entsprechen, in eine temporäre Liste überführt. Diese Liste kann sortiert und unsortiert ausgegeben werden. Die Werte des Sortierfeldes können numerisch oder alphanumerisch sein. Treten numerische und alphanumerische Werte gemischt auf, so werden die numerischen Werte vor die alphanumerischen Werte sortiert.
   
   Syntax

                  GroupName([SortField])[PosName|… ] 

   Es werden alle Groups mit dem Namen DELIV_GROUP in der Reihenfolge des Vorkommens in der Group-Tabelle angezogen und deren Positionen ITEM_LINE und ITEM_LINE_1 gedruckt.

   Codeblock
   title Beispiel:
   DELIV_GROUP()[ITEM_LINE|ITEM_LINE_1]

   Es werden alle Groups mit dem Namen DELIV_GROUP nach dem Feld POSSORT sortiert und deren Positionen ITEM_LINE und ITEM_LINE_1 gedruckt.

   Codeblock
   title Beispiel:
   DELIV_GROUP(POSSORT)[ITEM_LINE|ITEM_LINE_1]

   Als Alternative zur genauen Angabe der Positionen kann für dynamische Positionen und für Group-Namen auch ein Wildcard angegeben werden. Es werden alle Positionen zum Druck angestoßen, die als dynamische Position verfügbar sind.
   
   Zieht alle Groups mit dem Namen BILL an und druckt daraus alle Positionen.

   Codeblock
   title Beispiel:
   BILL()[*]

   Zieht alle Groups an und druckt daraus alle Positions.

   Codeblock
   title Beispiel:
   *()[*]

FieldOrValue
BackPageDesignsFirst und BackPageDesignsNext definieren eine Folge von Design-Subformularen und Positionen für die Rückseite. Siehe dazu den Abschnitt Designs.

FieldOrValue
DuplexFirst bezieht sich hierbei auf die erste Seite eines WorkItems und DuplexNext auf alle Folgeseiten. Bei Seiten, die eine Rückseite haben, wird die Duplex-Eigenschaft <1 ignoriert und
stattdessen die Rückseite mit der Duplex-Einstellung 1 gezogen. DuplexFirst und DuplexNext kennen jeweils vier Zustände.

Syntax

DuplexFirst n
-1 = Duplex aus
0 = keine Angaben (Default)
1 = Duplex LongEdgeBinding
2 = Duplex ShortEdgeBinding

DuplexNext n
-1 = Duplex aus
0 = keine Angaben (Default)
1 = Duplex LongEdgeBinding
2 = Duplex ShortEdgeBinding

Die Recognition steuert, ob ein Objekt ausgeführt wird oder nicht. Die Funktionsweise ist im Kapitel „Interne Objekte“ beschrieben.

FieldOrValue
Central ist ein Schalter mit den Werten 0 und 1 und als FieldOrValue ausgelegt. Mit ihm lässt sich bei der Ansteuerung für mehrere zentrale Drucker zwangsweise die zentrale Verarbeitung festlegen. Bei der Nutzung dieses Schalters muss der Drucker für zentrale Drucke nicht unbedingt leer sein. Ist er leer, so erhält der erzeugte Job als Druckernamen den BaseNamen des Ausgabefiles, andernfalls wird der Druckername wie bei dezentralen Druckern gesetzt. Damit ist diese Erweiterung aufwärtskompatibel zu Konfigurationen aus älteren Installationen. Ist kein Drucker gesetzt, so wird Central für das WorkItem automatisch eingeschaltet.

WORKITEM payment form {
   ...
   Central 1
   ...
}

Ist dieses WorkItem das erste WorkItem eines Druckstapels, so wird das hier definierte HeaderWorkItem im Sinne einer HeaderPage vor den Druckstapel gestellt. Die mit HeaderFields definierten Felder werden dem HeaderWorkItem als globale Felder mitgegeben ebenso wie alle Statusinformationen des Druckjobs.

Ist dieses WorkItem das erste WorkItem eines Druckstapels, so wird das hier definierte TrailerWorkItem im Sinne einer TrailerPage dem Druckstapel hinten angestellt. Die mit TrailerFields definierten Felder werden dem TrailerWorkItem als globale Felder mitgegeben ebenso wie alle Statusinformationen des Druckjobs.

Ist dieses WorkItem das erste WorkItem eines Druckstapels, so wird das hier definierte IndicantWorkItem als separater Druckjob zur Beschreibung des eigentlichen Druckjobs generiert. Die mit IndicantFields definierten Felder werden dem IndicantWorkItem als globale Felder mitgegeben. Ein IndicantWorkItem muss im Gegensatz zu Header- oder TrailerWorkItems einen Drucker definieren. Indicant-Druckjobs kündigen einen Druckjob an oder stellen eine Art Auftragsbegleitzettel oder Produktionsabrechnungszettel dar, da alle Statusinformationen des eigentlichen Druckjobs als globale Felder mit hinein generiert werden.

HeaderFields ist eine Aufzählung von Feldnamen. Die hier angegebenen Felder werden im aktuellen Dokument gesucht und in das HeaderWorkItem transferiert.

Syntax

HeaderFields FieldName[,FieldName[..]]

TrailerFields ist eine Aufzählung von Feldnamen. Die hier angegebenen Felder werden im aktuellen Dokument gesucht und in das TrailerWorkItem transferiert.

Syntax

TrailerFields FieldName[,FieldName[..]]

IndicantFields ist eine Aufzählung von Feldnamen. Die hier angegebenen Felder werden im aktuellen Dokument gesucht und in das IndicantWorkItem transferiert.

Syntax

IndicantFields FieldName[,FieldName[..]]

VolFields ist eine Aufzählung von Feldnamen. Die hier angegebenen Felder werden im aktuellen Dokument gesucht und in die VOL-Datei transferiert. Dort tragen die Variablen dann noch das Präfix RW_Doc_.

Syntax

VolFields FieldName[,FieldName[..]]

ArcVolFields ist eine Aufzählung von Feldnamen. Die hier angegebenen Felder werden im aktuellen Dokument gesucht und in die VOL-Datei der Archiv-Datei transferiert. Dort tragen die Variablen dann noch das Präfix RW_Doc_.

Syntax

ArcVolFields FieldName[,FieldName[..]]

WIFields oder WorkItemFields ist eine Aufzählung von Feldnamen. Die hier angegebenen Felder werden im aktuellen Dokument gesucht und als Beschreibungsvariablen auf Seitenebene in das zu erzeugende PDF eingefügt.

PDFFields ist eine Aufzählung von Feldnamen. Die hier angegebenen Felder werden im aktuellen Dokument gesucht und an das Modul zur PDF-Erzeugung weitergeleitet. Die so gesammelten Felder können im Inhaltsverzeichnis des PDFs verwendet werden. Ein anderer Einsatzzweck ist die Steuerung des PDFProfiles über diese Variablen.

Syntax

PDFFields FieldName[,FieldName[..]]

FieldOrValue
PDFProfile ist eine Namensreferenz auf ein in der reportw.ini unter PDF/Profiles definiertes Eröffnungsprofile. Mit einem solchen Profile können die Grundeigenschaften wie Rechte, Titel, Autor usw. des anzulegenden PDFs gesteuert werden. Mit PDFFields ist es möglich, zusätzlich dazu Variablen aus dem Dokument weiterzugeben, die in den gewählten Profilen über FieldOrValue verwendet werden können. Die Archiv-Ausgabe des WorkItems erfolgt unabhängig von dem hier gesetzten Profile über das Profile Archive.

FieldOrValue
ContinuationTextPage ist ein Text, der auf Seiten ausgegeben wird, die nicht die letzte Seite sind, und dient zur Spezifizierung, auf welcher Seite das Dokument fortgesetzt wird. Der Textstring kann dabei einen Platzhalter %1 beinhalten, der durch die richtige Seitenzahl ersetzt wird.

ContinuationTextBackPage funktioniert ebenso, nur dass keine Seitenzahl generiert wird, sondern nur darauf verwiesen wird, dass es auf der Rückseite weitergeht. Je nachdem, ob es auf der Rückseite oder einer neuen Seite weitergeht, wird der Text ContinuationTextBackPage oder ContinuationTextPage in das globale Feld ContinuationText ausgegeben. Die Ausgabe erfolgt nicht im Archiv-Lauf.

WORKITEM Invoice {
   ...
   CONTINUATIONTEXTPAGE       Weiter auf Seite %1
   CONTINUATIONTEXTBACKPAGE   Weiter auf der Rückseite
   ...
}

FieldOrValue
WorkItem mit dem Schlüsselwort Layout platzieren eine oder mehrere logische Seiten auf den Seiten des aktuellen WorkItems. Ziel der Funktionalität ist es, mehrere logische Seiten (LayoutElement-Seiten) auf einer physikalischen Seite unterzubringen bzw. N-Up-Printing oder logische Seiten nach ihrem LayoutElement-Namen auf Ausgabeseiten zu verteilen. Ein WorkItem mit Layout bringt logische Seiten in den Floating-Bereich (ContentArea) der aktuellen Seite. Dabei werden keine Positionen oder SubForms ausgerechnet oder platziert. Der unter Layout angegebene Name entspricht einem fest vorprogrammierten Layout-Typ. Folgende Layout-Typen sind realisiert:

WorkItems mit dem Schlüsselwort Layout können archiviert und gedruckt werden.

FieldOrValue
WorkItems, die das Schlüsselwort LayoutElement definieren, sind nicht zur direkten Ausgabe bestimmt. Vielmehr werden die Seiten solcher WorkItems in einen Puffer hinein generiert, der den Namen des LayoutElementes trägt. Andere WorkItems im gleichen DocDef, die mit dem Schlüsselwort Layout ein bestimmtes Layout anfordern, ziehen dann die Seiten aus bestimmten Puffern auf das Blatt. WorkItems mit dem Schlüsselwort LayoutElement können archiviert werden. Gedruckt werden sie nur auf dazugehörigen WorkItems mit dem Schlüsselwort Layout. Der Name des LayoutElementes muss zu dem aufrufenden Layout passen. Da Seiten eines WorkItems mit dem Schlüsselwort LayoutElement logische Seiten sind, werden für diese Seiten alle Einstellungen wie Duplex, Tray und PaperType ignoriert.

DataBind ist ein optionaler Wert und gibt eine Position im Daten-Baum des Dokuments an, aus der die Positionen des WorkItems erstellt werden sollen. Existiert die angegebene Position nicht, so wird das WorkItem übersprungen.

+---Pos1
|     +---Pos11
|     |     +---Fieldx
|     +---Pos12
|           +---Pos121
|           |     +---Fieldx
|           +---Pos122
|                 +---Fieldx
+---Pos2
      +---Fieldy

DataBind Pos1.Pos12

Es werden die Positionen Pos121 und Pos122 abgearbeitet.

FieldOrValue
EmbeddedFiles ist ein Schlüsselwort zum Einbetten von Files in das zu erzeugende Druckdokument. Dabei wird ein oder mehrere Files von einer Festplatte gelesen und auf die erste Seite des zu erzeugenden PDFs eingebettet. Der Empfänger des PDFs kann diesen File dann auspacken und separat verarbeiten. EmbeddedFiles kann mehrfach definiert werden und enthält eine semikolonseparierte Liste von Filereferenzen. Eine Filereferenz ist wiederum eine kommaseparierte Liste mit bis zu drei Werten

1. FileName
   

   Name des Files, der eingebettet werden soll. Wird die ein FeldName angegeben, so wird der Inhalt des eingebetteten Files aus dem Feldinhalt gespeißt. Enthält der FileName keinen Pfad, so gilt folgende Suchreihenfolge:
   Lokales Verzeichnis, FormsPath, ImagePath
    

2. Kommentar (optional)
    
3. FeldName (optional)
   
   Ist dort ein FeldName angegeben, so wird der Inhalt des einzubettenden Files nicht aus dem angegeben File selbst gezogen, sondern der Inhalt des Feldes wird als File eingebettet. Dabei wird das Feld gesucht, der Inhalt nach UTF8 konvertiert und dann als Fileinhalt eingebettet.

c:\hello.xml                           Ein File
c:\hello.xml,Kommentar                 Ein File mit Kommentar:
c:\hello.xml,Kommentar;d:\world.pdf    Mehrere Files
hello.xml,Kommentar,$global.Embedded   Inhalt aus einem Feld gelesen

AfterCalc dient zum Berechnen von Feldern und dem Ausführen von Calc-Befehlen. AfterCalc wird nach der Ausführung des DocDef aufgerufen.