Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

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

Anker
WorkItem_FormFileName
WorkItem_FormFileName
FormFileName Name

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.

Scroll Pagebreak


Anker
WorkItem_PDFImportType
WorkItem_PDFImportType
PDFImportType Value

...

0 FirstOverlayAll als Overlay beginnend auf der ersten Seite des WorkItems, alle PDF-Seiten.
1 NextOverlayAll als Overlay beginnend auf der zweiten Seite des WorkItems, alle PDF-Seiten.
2 Add als Anhang nach den positionsbedingten Seiten des WorkItems, alle PDF-Seiten.
3 FirstOverlayDoc als Overlay beginnend auf der ersten Seite des WorkItems, nur soviel Seiten, wie das WorkItem positionsbedingt besitzt.
4NextOverlayDoc als Overlay beginnend auf der zweiten Seite des WorkItems, nur soviel Seiten, wie das WorkItem positionsbedingt besitzt. 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.

Scroll Pagebreak


Anker
WorkItem_PDFImportDocuments
WorkItem_PDFImportDocuments
PDFImportDocuments Value

...

NextPage Name oder
NextPage NameVorderseite#NameRückseite

Scroll Pagebreak


Anker
WorkItem_DesignsFirst
WorkItem_DesignsFirst
DesignsFirst Value
DesignsNext Value

...

Section
Column
width7%


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

Scroll Pagebreak


Anker
WorkItem_PageDescriptorFirst
WorkItem_PageDescriptorFirst
PageDescriptorFirst Value
PageDescriptorNext Value

...

Section
Column
width7%


Column
Codeblock
titleBeispiel
PageDescriptorFirst test print
PageDescriptorNext  test print

...



Anker
WorkItem_PaperTypeFirst
WorkItem_PaperTypeFirst
PaperTypeFirst Value
PaperTypeNext Value

...

Section
Column
width7%


Column
Codeblock
titleBeispiel
PaperTypeFirst letterhead
PaperTypeNext  payment form

...


Anker
WorkItem_IntrayFirst
WorkItem_IntrayFirst
IntrayFirst Value
IntrayNext Value

...

Section
Column
width7%


Column
Codeblock
titleBeispiel
IntrayFirst lower_tray
IntrayNext  upper_tray

Scroll Pagebreak



Anker
WorkItem_OuttrayFirst
WorkItem_OuttrayFirst
OuttrayFirst Value
OuttrayNext Value

...

Section
Column
width7%


Column
Codeblock
titleBeispiel
OuttrayFirst backside_bin
OuttrayNext  frontside_bin

Scroll Pagebreak


Anker
WorkItem_FinishingFirst
WorkItem_FinishingFirst
FinishingFirst Value
FinishingNext Value

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

Scroll Pagebreak



Anker
WorkItem_BackPageFirst
WorkItem_BackPageFirst
BackPageFirst Value
BackPageNext Value

...

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.

Scroll Pagebreak


Anker
WorkItem_CopyText
WorkItem_CopyText
CopyText Value

...

Section
Column
width7%


Column

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
titleBeispiel
CopyText Kopie %C


Anker
WorkItem_Printer Occurance
WorkItem_Printer
Printer
Occurance
 Occurance
 No

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.

Scroll Pagebreak


Anker
WorkItem_Printer
WorkItem_Printer
Printer Value

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

Scroll Pagebreak


Anker
WorkItem_Archive
WorkItem_Archive
Archive Value

...

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.

Scroll Pagebreak


Anker
WorkItem_PageReverser
WorkItem_PageReverser
PageReverser Value

...

Anker
WorkItem_BeforeCalc
WorkItem_BeforeCalc
BeforeCalc

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

...

Anker
WorkItem_AfterCalc
WorkItem_AfterCalc
AfterCalc

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

...

Section
Column
width7%


Column

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?

Scroll Pagebreak


Syntax

Positions Section[,Section[...]]

...

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

Scroll Pagebreak


Syntax

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

...

Section
Column
width26%


Column
Codeblock
titleBeispiel
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.

...

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.scroll-pagebreak


Syntax

               GroupName([SortField])[PosName|… ] 

...

Section
Column
width26%


Column
Codeblock
titleBeispiel
*()[*]

...



Anker
WorkItem_BackPageDesignsFirst
WorkItem_BackPageDesignsFirst
BackPageDesignsFirst Value
BackPageDesignsNext Value

...

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.

Scroll Pagebreak


Anker
WorkItem_TrailerWorkItem
WorkItem_TrailerWorkItem
TrailerWorkItem Name

...

TrailerFields FieldName[,FieldName[..]]

Scroll Pagebreak


Anker
WorkItem_IndicantFields
WorkItem_IndicantFields
IndicantFields Value

...

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[..]]


Anker
WorkItem_ArcVolFields DocRefVolFields
WorkItem_ArcVolFields
ArcVolFields Value
DocRefVolFields
DocRefVolFields

DocRefVolFields ist eine Aufzählung von Feldnamen. Die hier angegebenen Felder werden im aktuellen Dokument gesucht und in die VOL-Datei der DocRef-Datei transferiert. Die Felder erhalten das Präfix „RW_Doc_“.


Syntax

DocRefVolFields FieldName[,FieldName[..]]


Anker
WorkItem_ArcVolFields
WorkItem_ArcVolFields
ArcVolFields Value

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. Die Felder erhalten das Präfix „RW_Doc_“.

Scroll Pagebreak


Syntax

ArcVolFields FieldName[,FieldName[..]]


Anker
WorkItem_SapRefVolFields
WorkItem_SapRefVolFields
SapRefVolFields

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


Syntax

ArcVolFields SapRefVolFields FieldName[,FieldName[..]]

...

ESSFields FieldName[,FieldName[..]]

Scroll Pagebreak


Anker
WorkItem_PDFFields
WorkItem_PDFFields
PDFFields Value

...

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

Section
Column
width7%


Column
Hinweis

Bei EinzelPDF kommen jeweils die angegebenen PDFProfile zur Anwendung, dies kann zu zusätzlichen Druckstapeln und/oder Ausgabedateien führen.



Anker
WorkItem_ArcPDFProfile
WorkItem_ArcPDFProfile
ArcPDFProfile Value

...

Section
Column
width7%


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

...


Anker
WorkItem_Layout
WorkItem_Layout
Layout Value

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:

LayoutGesuchte LayoutElementeArbeitsweise
UPSpielt keine RolleRealisiert N-Up Printing. Die logischen Seiten werden unabhängig von ihrem LayoutElement-Namen der Reihenfolge nach in die ContentAreas hinein platziert. Sind alle ContentAreas der Seite gefüllt, so erfolgt ein Seitenwechsel.
LRLEFT und RIGHTRealisiert 2-Up Printing so, dass Layoutelemente mit LEFT in der ersten ContentArea und Layoutelemente RIGHT in der zweiten ContentArea der physikalischen Seite ausgegeben werden. Die physikalische Seite muss exakt zwei ContentAreas besitzen.

...

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.

Scroll Pagebreak


Anker
WorkItem_DataBind
WorkItem_DataBind
DataBind Value

...

Section
Column
width7%


Column
Codeblock
titleBeispiel
+---Pos1
|     +---Pos11
|     |     +---Fieldx
|     +---Pos12
|           +---Pos121
|           |     +---Fieldx
|           +---Pos122
|                 +---Fieldx
+---Pos2
      +---Fieldy

DataBind Pos1.Pos12

Es werden die Positionen Pos121 und Pos122 abgearbeitet.

Scroll Pagebreak


Anker
WorkItem_EmbeddedFiles
WorkItem_EmbeddedFiles
EmbeddedFiles Value

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:

Section
Column
width8%


Column

1) FileName

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

2) Kommentar (optional)
 

Section
Column
width8%


Column

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.

...

Section
Column
width7%


Column
Codeblock
titleBeispiel
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

...