Seitenhistorie

...

Ein DocDef-Objekt repräsentiert inputseitig ein Dokument und legt wichtige Verarbeitungsmerkmale fest, die für das Dokument über alle WorkItems hinweg von Bedeutung sind. Über ein WorkListVariant-Objekt verweist ein DocDef-Objekt auf ein oder mehrere WorkItems.

Syntax

DocDef Name {

FormFileName

...

 Name
Copy

...

 No
Printer

...

 Name
DocRef

...

 Name
Archive

...

 Value
Print

...

 Value
SourceCopy

...

 Value
WorkItems

...

 Value
WorkListVariant

...

 Name
DocRefFields

...

 List
JoinKey

...

 Value
SortKey

...

 Value
MaterialExchangeSet

...

 Value
BeforeCalc  {
  ...
}
AfterCalc  {  
  ...
}
Grouping  { 
  ...
}

AutoPositioning

...

 Value
Positioning  {
  ...
}
Recognition

...

 bzw.  Rec  {
 

...

...
}
Qualifier

...

 Value
XMLOutput

...

 Value
SupplementWorkItem

...

 Value
EmbeddedFiles  Value

}

Erklärung

FieldOrValue
FormFileName setzt für die WorkItems einen Standardfile, welcher die physikalischen Seiten und SubForms definiert. Der FormFileName kann im WorkItem überschrieben werden.

...

Archive @GETSUBSTITUTE("ArchivTab", JF_REPRINT)

...

...

FieldOrValue
SourceCopy ist ein Schalter mit den Werten 1 und 0. Steht SourceCopy auf 1, werden die Dokumente nach dem Passieren des Input-Interfaces im internen ReportWriter-Format in eine Datei gespeichert. Andernfalls gibt es keine Copy des internen Dokuments. Das SourceCopyFile dient vor allem der besseren Lesbarkeit des Input-Dokuments und der Kontrolle des Input-Interfaces.

FieldOrValue
WorkItems ist eine kommaseparierte Liste mit Namen von WorkItems, die zur Ausgabe abgearbeitet werden sollen. Ist das Schlüsselwort WorkItems angegeben, so wird die Angabe einer WorkListVariant ignoriert. Das Schlüsselwort kann mehrfach vorkommen. Die Werte der jeweiligen Schlüsselwörter werden aneinander gehängt.

...

DocRefFields ist eine kommaseparierte Liste von Variablen, die in die DocRef-Liste des Dokuments kopiert werden. Die DocRef-Liste wird in der weiteren Verarbeitung noch durch Standard-DocRef-Fields erweitert und kann dann über die im Schlüsselwort OutFileDocRefFields des CommonSettings-Basis-Objektes ausgegeben werden.
Als Offset für die Seitenzähler C1FROMSHEET, C1TOSHEET bzw. C2FROMSHEET, C2TOSHEET kann die Variable C1PAGEOFFSET bzw. C2PAGEOFFSET mitgegeben werden. Das Offset sollte der Seitengröße der Headerpage entsprechen.

...

FieldOrValue
Alle Dokumente, die den gleichen JoinKey besitzen und den gleichen Qualifier miteinander teilen, werden noch vor der DV-Freimachung und den anderen Dokument-Logistischen-Verfahren zu einem Dokument zusammengefasst. JoinKey entspricht damit der Aufgabenstellung der Porto-Optimierung, bei der möglichst alle Sendungen an einen Empfänger zu einer Sendung zusammengefasst werden. Der JoinKey sollte die Adresse des Sendungsempfängers oder dessen Kundennummer sein.

...

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

Syntax

DocDef Name {

BeforeCalc {
...
}

}

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

Syntax

DocDef Name {

AfterCalc {
...
}

}

...

Grouping beinhaltet ein oder mehrere Group-Objekte. Jedes Group-Objekt ist eine konkrete Anweisung dafür, wie nachfolgende Positionen zu einer Group zusammengefasst werden. Ein Group-Objekt definiert für eine solche Klammer die Anfangs- und Endpositionen. Für die StartPosition kann optional in Klammern noch ein Feld und dessen Wert angegeben werden. Beim Grouping wird die Position nur als StartPosition erkannt, wenn der Name der Position übereinstimmt und das Feld in der Position den vorgegebenen Inhalt hat.

Syntax

Grouping {

...
Group GROUPNAME {

StartPos POSITIONNAME[(FIELD=

...

VALUE)][,POSITIONNAME[(FIELD=

...

VALUE)][...]]
[StopBeforePos POSITIONNAME[,POSITIONNAME[...]]]
[StopAfterPos POSITIONNAME[,POSITIONNAME[...]]]

}
...

}

Um ein Grouping nicht nur in Group-Strukturen erzeugen zu können, sondern auch Subpositionen bilden zu können im Sinnes eines vollständigen strukturierten Baumes. kann man folgende Schlüsselwörter nutzen:

Target	Target ist ein Schalter mit den Werten GROUP und TREE, wobei GROUP der Standardwert ist. Steht der Schalter auf GROUP, so wird das Grouping in Group-Strukturen erzeugt. Steht der Schalter auf TREE, so wird das Grouping in Positionen und SubPositionen erzeugt.
GroupedNode	GroupedNode ist ein Positionsname, der beim Target TREE optional angewandt wird. Ist GroupedNode gesetzt, so werden alle gruppierten Positionen zu SubPositionen der unter GroupedNode angegebenen Position. Ist GroupedNode nicht gesetzt, werden alle gruppierten Positionen auf der höchsten Ebene erzeugt.   Bitte keine strukturierten Namen angeben.
NoneGroupedNode	NoneGroupedNode ist ein Positionsname, der beim Target TREE optional angewandt wird. Ist GroupedNode gesetzt, so werden alle nicht gruppierten Positionen zu SubPositionen der unter NoneGroupedNode angegebenen Position. Ist NoneGroupedNode nicht gesetzt, bleiben alle nicht gruppierten Positionen auf der höchsten Ebene.   Bitte keine strukturierten Namen angeben.

Syntax

Grouping {

Target TREE
GroupedNode GR
NoneGroupedNode NGR
Group Collect {

StartPos CSTART
StopBeforePos CSTART

}

}

FieldOrValue
AutoPositioning ist ein Schalter mit den Werten 0 und 1, wobei 0 der Standard ist. Wenn AutoPositioning eingeschaltet ist, dann ist jede andere Positioning-Angabe ohne Wirkung. Ist AutoPositioning eingeschaltet, so erfolgt die Zuordnung der Felder der globalen Tabelle zu Positionen über die aus der XDP-Datei gelesenen Informationen. AutoPositioning arbeitet nur, wenn auf DocDef-Ebenen ein FormFileName angegeben wurde. Aus der angegebenen XDP-Datei werden alle SubForms gelesen und die Felder der globalen Tabelle mit den Feldern der SubForms verglichen. Passt ein Feld zu einer SubForm, so wird eine neue Position im ReportWriter eröffnet und das Feld dort hinein bewegt. Sind die folgenden Felder auch in der SubForm enthalten, so werden diese ebenfalls dorthin bewegt. Feldwiederholungen führen auch zur Wiederholung der Position. Passt ein Feld nicht in das zuletzt gefundene SubForm, so beginnt die Suche nach einem passenden SubForm erneut.

Positioning wandelt Kopffelder in Positionen um. Es wird eine Liste erzeugt, in der die Schlüsselfelder und der Positionsname definiert sind. Schlüsselfelder sind die Namen der Felder, die eine Position erzeugen. Alle nachfolgenden Felder eines Schlüsselfeldes werden mit in die neue Position übernommen. Trifft der Algorithmus auf ein weiteres oder ein gleich benanntes Schlüsselfeld, so wird eine neue Position eröffnet.

Syntax

Positioning {

FieldName1 Position1
FieldName2 Position2
...

}

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

...

XMLOutput nimmt das Input-Dokument unabhängig vom Input-Format und erzeugt es als XML-Output in einem File, der alle XML-Output-Dokumente enthält. XMLOutput ist ein Schalter mit drei Werten, wobei NONE bzw. 0 der Standardwert ist:

...

SupplementWorkItem ist eine Namensrefernz auf das WorkItem, das zur Darstellung von Logical Supplements aus dem Redaktionssystem verwendet wird. Das SupplementWorkItem wird nur dann ausgeführt, wenn das Redaktionssystem Logical Supplements für das Dokument definiert.

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 gelesen