Versionen im Vergleich

Schlüssel

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

Verwendung

Das

  •  Unter "PosName[|PosName [...]]([SortField])" → Wildcard ein Hinweisfeld eingefügt, muss geprüft und freigegeben werden. Aus Version.cpp // StringC VersionOfProduct=L"5.9.1016",VersionOfOMS=L"3.8";/* 23.03.2016

...

Verwendung

Ein WorkItem-Objekt ist eine die konkrete Realisierung einer Seite bzw. eines Dokuments zum Druck oder Archiv. Das WorkItem generiert ein Formular aus dem Input-Dokument.Seitentyps 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 Value
LayoutElement Value Value
DataBind Value Value
EmbeddedFiles Value Value
DoNotCountPages
Value Value
ContributionFileName
Value Value
ResourceFileName Value 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.

...


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

...



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

...


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.

...


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.

...

Section
Column
width26%


Column
Codeblock
titleBeispiel
POSITIONS *() 
Hinweis

Es ist lediglich unterstützt den gesamten Filenamen als * anzugeben. Kombinationen aus Text ? und * sind nicht zulässig. Auch dürfen keine Wildcards im Pfad oder der Extention enthalten sein.

Codeblock
c:\scan\*.xtf reportwriter.tci -all OUT
 c:\scan\*.xtf logistics.tci -all OUT


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

...

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

Syntax

               GroupName([SortField])[PosName|… ] 

...

Section
Column
width26%


Column
Codeblock
titleBeispiel
*()[*]

Scroll Pagebreak



Anker
WorkItem_BackPageDesignsFirst
WorkItem_BackPageDesignsFirst
BackPageDesignsFirst Value
BackPageDesignsNext Value

...

Section
Column
width7%


Column
Codeblock
titleBeispiel
WORKITEM payment form {
   ...
   Central 1
   ...
} ...
}


Anker
WorkItem_HeaderWorkItem
WorkItem_HeaderWorkItem
HeaderWorkItem  Name

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

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.


Anker
WorkItem_HeaderWorkItem IndicantWorkItem
WorkItem_HeaderWorkItem IndicantWorkItem
HeaderWorkItem  IndicantWorkItem Name

Ist dieses WorkItem das erste WorkItem eines Druckstapels, so wird das hier definierte HeaderWorkItem im Sinne einer HeaderPage vor den Druckstapel gestelltIndicantWorkItem als separater Druckjob zur Beschreibung des eigentlichen Druckjobs generiert. Die mit HeaderFields IndicantFields definierten Felder werden dem HeaderWorkItem IndicantWorkItem als globale Felder mitgegeben ebenso wie alle Statusinformationen des Druckjobs. 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.


Anker
WorkItem_TrailerWorkItem HeaderFields
WorkItem_TrailerWorkItem HeaderFields
TrailerWorkItem Name

...

HeaderFields Value

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


Anker
WorkItem_IndicantWorkItem TrailerFields
WorkItem_IndicantWorkItem TrailerFields
IndicantWorkItem Name

...

TrailerFields Value

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

Scroll Pagebreak


Anker
WorkItem_HeaderFields IndicantFields
WorkItem_HeaderFields IndicantFields
HeaderFieldsIndicantFields Value

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


Syntax

HeaderFields IndicantFields FieldName[,FieldName[..]]


Anker
WorkItem_TrailerFields VolFields
WorkItem_TrailerFields VolFields
TrailerFieldsVolFields Value

TrailerFields VolFields ist eine Aufzählung von Feldnamen. Die hier angegebenen Felder werden im aktuellen Dokument gesucht und in das TrailerWorkItem transferiertdie VOL-Datei der Druck-Datei transferiert. Die Felder erhalten das Präfix „RW_Doc_“.


Syntax

TrailerFields VolFields FieldName[,FieldName[..]]

...


Anker
WorkItem_IndicantFields DocRefVolFields
WorkItem_IndicantFields DocRefVolFields
IndicantFields ValueDocRefVolFields

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


Syntax

IndicantFields DocRefVolFields FieldName[,FieldName[..]]


Anker
WorkItem_VolFields ArcVolFields
WorkItem_VolFields ArcVolFields
VolFieldsArcVolFields Value

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

Scroll Pagebreak


Syntax

VolFields ArcVolFields FieldName[,FieldName[..]]


Anker
WorkItem_ArcVolFields SapRefVolFields
WorkItem_ArcVolFields SapRefVolFields
ArcVolFields ValueSapRefVolFields

ArcVolFields SapRefVolFields 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.

...


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

...