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 produzierten 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 generisch, 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.
WhiteSpaces im R-S Arbeitsablauf
Abbildung A: WhiteSpaces im R-S Arbeitsablauf
Funktionsweise von WhiteSpaces
Abbildung B: WhiteSpace wird abhängig von verfügbarem Platz und Mindestgröße eingefügt
In Abb. B sehen Sie, wie WhiteSpaces in Dokumente eingefügt werden. Auf dem rechten Dokument wird der Inhalt des WhiteSpaces
nicht eingefügt, da nicht genügend Platz auf dem Dokument vorhanden ist (Mindestgröße 250mm x 100mm).
WhiteSpaces werden pro Dokument nur 1 mal eingefügt.
Konfiguration des WhiteSpaces
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 (sofern es sich dabei um eine binäre Ressource handelt)
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 |
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).
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 dazwischengeschaltene 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.
WhiteSpaces verwenden: | WhiteSpaces werden verwendet in: |
---|---|
Ressourcen |
Um mit den Datenstrom-Variablen fortzufahren, klicken Sie bitte hier.