Definition
WhiteSpaces ermöglichen es, dynamisch freie Bereiche auf den Dokumenten mit Inhalt zu füllen.
Sie sind die einzige Möglichkeit, Inhalt außerhalb der festen Layout-Bereiche des Transaktions-Formulars zu platzieren.
WhiteSpaces werden allerdings nicht einem festen Bereich auf den Dokumenten zugeordnet, sondern für jedes Formular
wird einzeln berechnet, ob und wie der WhiteSpace eingefügt werden soll. WhiteSpaces, die Sie für ein Formular definieren,
werden also nicht auf jedem Dokument platziert, sondern nur auf denen, auf denen genügend Platz vorhanden ist.
Dies ermöglicht es Ihnen, freie Flächen automatisch ausnutzen zu lassen. Zu diesem Zweck werden
in WhiteSpaces Eckdaten angegeben, wie z.B. die Mindestgröße des freien Bereichs oder ob der WhiteSpace vor oder nach
dem eigentlichen Dokumentinhalt platziert werden muss.
Aus diesen Daten berechnet das R-S dann individuell, ob der WhiteSpace eingefügt werden kann.
Hauptanwendungsgebiet von WhiteSpaces ist Werbung: Ist auf einem Dokument noch genügend freie Fläche übrig,
platziert das R-S dort den WhiteSpace mit Werbung.
Verwandte Seiten
WhiteSpaces im R-S Arbeitsablauf
Abbildung A: WhiteSpaces im R-S Arbeitsablauf
WhiteSpaces werden durch WhiteSpace-Erweiterungen eingebunden. Neben der Möglichkeit, in Whitespace-Erweiterungen
direkt einen WhiteSpace, den Sie im Dokument nutzen möchten, anzugeben, können Sie dort auch Variablen und Regeln angeben.
Die Variable / Regel müssen dann allerdings einen WhiteSpace zurückgeben. So ist es möglich, durch Regeln WhiteSpaces bedingt einzubinden.
Gibt die angegebene Variable / Regel einen anderen Wert zurück als einen WhiteSpace, so wird die WhiteSpace-Erweiterung inaktiv.
Konfiguration des WhiteSpace
Auch wenn WhiteSpaces nicht manuell im Dokument eingefügt werden können gibt es diverse Einstellungsmöglichkeiten, mit denen Sie
die Platzierung von WhiteSpaces bedingt steuern können. Folgende Einstellungen sind für WhiteSpaces verfügbar:
Mindestgröße des freien Bereichs
Abbildung C: WhiteSpaces unterschiedlicher Größe
Sie können für den WhiteSpace eine Mindestgröße angeben. Diese Mindestgröße bestimmt, wie groß der freie Bereich auf dem Dokument
mindestens sein muss, damit der WhiteSpace platziert wird. Der Inhalt des WhiteSpaces wird dann auch auf die angegebene Größe skaliert.
Das Ergebnis sehen Sie in Abb. C: Mit einer Mindestgröße von 5x2 cm, 10x4 cm und 25x10 cm.
Da der freie Bereich auf dem Dokument kleiner als 25x10 cm ist, wird der 3. WhiteSpace in Abb. C nicht auf dem Dokument platziert.
Wie die Dimension des WhiteSpaces in der Praxis angegeben wird sehen Sie hier.
Position auf dem Dokument
Sie können bestimmen, auf welchen Seiten des Dokuments der WhiteSpace aufgebracht werden darf. Folgende Optionen sind verfügbar:
| Option | Beschreibung | Erlaubte Seiten |
|---|---|---|
FIRST | Nur auf der ersten Seite des Dokuments. |  |
LAST | Nur auf der letzten Seite des Dokuments |  |
ANY | Auf einer beliebigen Seite des Dokuments |  |
Ist auf keine der erlaubten Seite genug freie Fläche zur Platzierung des WhiteSpaces, wird er weggelassen.
Wenn Sie ANY auswählen, wird der WhiteSpace auf der ersten geeigneten Seite eingefügt. WhiteSpaces werden pro Dokument nur 1 mal eingefügt.
Wie die Position des WhiteSpaces auf dem Dokument in der Praxis angegeben wird sehen Sie hier.
Position auf der Seite
Analog dazu müssen Sie auch festlegen, wo auf der Seite der WhiteSpace aufgebracht werden darf. Folgende Optionen sind verfügbar:
| Option | Beschreibung | Beispiel |
|---|---|---|
TOP | Vor dem Inhalt der Seite (oben) |  |
BOTTOM | Nach dem Inhalt der Seite (unten) |  |
Wie die Position des WhiteSpaces auf der Seite in der Praxis angegeben wird sehen Sie hier.
Eine Bedingung für den WhiteSpace
Optional können Sie dem WhiteSpace eine Bedingung geben. Diese Bedingung muss einen boolschen Wert zurückgeben (wahr oder falsch, 1 oder 0).
Möglich sind z.B. EVAL-Anweisungen. Der WhiteSpace wird nur auf das Dokument angewendet, wenn die Bedingung wahr zurückgibt.
Andernfalls wird der Inhalt des WhiteSpace auch dann nicht in das Dokument eingefügt, wenn genügend Platz vorhanden ist.
Abbildung D: Bedingte Anwendung eines WhiteSpaces
In Abb. D ist exemplarisch die Verwendung eines WhiteSpaces mit Bedingung dargestellt. Das Dokument wird 2x generiert.
Die dazwischen geschaltene Bedingung verlangt, dass die Variable DS.PARTNER_ID den Wert ProfiForms hat.
Dies ist beim 1. Durchlauf (oberer) der Fall, beim 2. Durchlauf nicht (Dort ist der Wert OtherPartner). Die Bedingung ist also nur
beim 1. Durchlauf erfüllt. Dementsprechend wird der WhiteSpace auch nur beim 1. Durchlauf angewandt und in das Dokument eingefügt.
Wie die Bedingung des WhiteSpaces in der Praxis angegeben wird sehen Sie hier.
Auf welchen Teilen des Formulars der WhiteSpace platziert werden darf
Das Transaktions-Formular kann einzelne Formular-Teile (Bereiche) vorgeben, auf denen WhiteSpace platziert werden darf.
Damit ist es möglich, Teile des Dokumentes, auf denen kein WhiteSpace platziert werden soll, festzulegen (z.B. wichtige Unterlagen).
Gibt das Transaktions-Formular keine Formular-Teile vor, darf WhiteSpace auf dem kompletten Dokument platziert werden.
Es ist dann auch nicht möglich, einen WhiteSpace auf nur einen Teil des Dokuments anwenden zu lassen. Definiert das Transaktions-Formular
Formular-Teile, müssen Sie die gewünschten Teile, auf die Sie den WhiteSpace anwenden möchten, angeben. Wenn Sie keine Formular-Teile
auswählen, wird der WhiteSpace auf allen erlaubten Bereichen des Dokuments angewendet.
Wie Formular-Teile in der Praxis ausgewählt werden sehen Sie hier.
Beschränkungen des Transaktions-Formulars
Neben den Formular-Teilen werden durch das Transaktions-Formular noch weitere Einschränkungen definiert.
So legt das Formular fest, ob WhiteSpaces überhaupt in einem Dokument verwendet werden dürfen.
Ebenso gibt das Transaktions-Formular eine Obergrenze für die Nutzung von Werbe-Fläche an. Liegt die Obergrenze für Werbung
beispielsweise bei 50%, dürfen nicht mehr als 50% der freien Fläche auf den Dokumenten durch WhiteSpaces eingenommen werden.
Außerdem bestimmt das Formular, ob WhiteSpaces einen Seitenüberlauf verursachen dürfen, also ob durch das Einfügen eines WhiteSpaces
in das Dokument der Inhalt so verschoben werden darf, dass eine neue Seite für den verschobenen Inhalt nötig wird. Es wird allerdings nie
eine neue Seite begonnen, auf der sich ausschließlich ein WhiteSpace befindet, sondern immer nur, wenn auch Inhalt auf die Seite verschoben wird.
Wenn die Option aktiviert ist, wird auch festgelegt, ob die neue Seite auch die Rückseite der Dokumentseite sein darf oder ob nur Simplex-Druck erlaubt ist.
Das Transaktions-Formular kann solche Verschiebungen allerdings auch komplett verbieten, falls dadurch ein Portosprung entstehen würde.
Hier wird erklärt, wo Sie diese Einstellungen einsehen können.
| WhiteSpaces verwenden: | WhiteSpaces werden verwendet in: |
|---|---|
 Ressourcen |
1.3.6 Logische Beileger | 1.3.8 Datenstrom-Variablen
Überblick
Inhalte