Seitenhistorie

Verwendung

Ein Das WorkItem-Objekt ist eine die konkrete Realisierung einer Seite bzw. eines Dokuments zum Druck oder Archiv. Das WorkItem generiert ein Formular aus dem Input-DokumentSeitentyps innerhalb des Dokuments.

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

...

FinishingFirst Value
BackPageFirst Value
BackPageNext Value
RotateToFirstValue
RotateToNext Value
GutterFirst Value
GutterNext Value
Copy No
CopyText Value
Occurance No
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
DocRefVolFields Value
ArcVolFields Value
SapRefVolFields  Value
WIFields Value
ESSFields Value
PDFFields Value
PDFProfile Value
ArcPDFProfile Value
ContinuationTextPage Value
ContinuationTextBackPage Value
Layout

...

 Value
LayoutElement

...

 Value
DataBind

...

 Value
EmbeddedFiles

...

 Value
DoNotCountPages

...

 Value
ContributionFileName

...

 Value
ResourceFileName

...

 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
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
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
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

...

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

...

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.

...

...

CopyText Original, Kopie 1, Kopie 2, Kopie Buchhaltung

...

...

CopyText Kopie %C

FieldOrValue
Occurance  ist eine positive Integer Zahl größer 0, wobei 1 der Standardwert ist. Occurance gibt ähnlich wie Copy eine Kopienanzahl an, jedoch bezeichnet OCCURANCE nicht n gleiche Kopien wie bei Copy, sondern n unterschiedliche Kopien, da das WorkItem jedes Mal komplett neu berechnet wird.

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

...

...

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

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) 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.

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.

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.

POSITIONS *() 

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

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.

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.

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.

BILL()[*]

Zieht alle Groups an und druckt daraus alle Positions.

*()[*]

...

...

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.

...

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 der Druck-Datei transferiert. Dort tragen die Variablen dann noch Die Felder erhalten das Präfix RW„RW_Doc_“.

Syntax

VolFields FieldName[,FieldName[..]]

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

Syntax

...

DocRefVolFields FieldName[,FieldName[..]]

WIFields oder WorkItemFields ArcVolFields 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.

...

in die VOL-Datei der Archiv-Datei transferiert. Die Felder erhalten das Präfix „RW_Doc_“.

Syntax

ArcVolFields FieldName[,FieldName[..]]

SapRefVolFields ist ESSFields oder EnvelopeSortSystemFields ist eine Aufzählung von Feldnamen. Die hier angegebenen Felder werden im aktuellen Dokument gesucht und dem EnvelopeSortSystem zur Berechnung der Kuvertiersteuerung mitgegebenin die VOL-Datei der SapRef-Datei transferiert. Die Felder erhalten das Präfix „RW_Doc_“.

Syntax

...

SapRefVolFields FieldName[,FieldName[..]]

...

PDFFields WIFields oder WorkItemFields 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.

...

als Beschreibungsvariablen auf Seitenebene in das zu erzeugende PDF eingefügt.

Syntax

WIFields FieldName[,FieldName[..]]

ESSFields oder EnvelopeSortSystemFields ist eine Aufzählung von Feldnamen. Die hier angegebenen Felder werden im aktuellen Dokument gesucht und dem EnvelopeSortSystem zur Berechnung der Kuvertiersteuerung mitgegeben.

Syntax

ESSFields FieldName[,FieldName[..]]

FieldOrValue
PDFProfile PDFFields 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 oder das Schlüsselwort ArcPDFProfile.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[..]]

FieldOrValueFieldOrValue
ArcPDFProfile  hat die gleiche Funktionsweise wie  PDFProfile . Der einzige Unterschied besteht darin,  dass  es nur für Archiv-PDFs genutzt wird und nicht für  PrintFileArchivierung  funktioniert.

...

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
   ...
}

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 oder das Schlüsselwort ArcPDFProfile.

FieldOrValueFieldOrValue
ArcPDFProfile  hat die gleiche Funktionsweise wie  PDFProfile . Der einzige Unterschied besteht darin,  dass  es nur für Archiv-PDFs genutzt wird und nicht für  PrintFileArchivierung funktioniert.

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:

...

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.

...

...

+---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:

...

...

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 gelese

...

\hello.xml,Kommentar;d:\world.pdf    Mehrere Files
hello.xml,Kommentar,$global.Embedded   Inhalt aus einem Feld gelese

...