Werkzeuge zur Steuerung von BIRT-Berichten

Die folgenden Optionen für BIRT können auf dreierlei Wegen aktiviert werden:

• Parameter an der Vorlage
• Umgebungsvariable
• Session-Value-Buffer

Die Optionen werden in der genannten Reihenfolge ausgewertet. Spätere Aufrufe überladen frühere.

Ab JustRelate CRM 8.0 erhalten Sie ein Werkzeug, mit dem sich seit BIRT 4.8 geändertes Verhalten korrigieren lässt. Das geänderte Verhalten besteht darin, dass bei der DOCX-Ausgabe Inhalte in Tabellenzellen abgeschnitten werden, wenn BIRT feststellt, dass sie dort nicht hineinpassen. Das vorherige Verhalten war, dass der Text oder die Zahl in der Zelle umbrechen.

Um das vorherige Verhalten wiederherzustellen, modifiziert der Präprozessor das Layout (rptDesign), indem er bei  label, text und data-Tags in Tabellenzellen die Eigenschaft overflow hinzufügt und deren Wert auf visible setzt.

Dies geschieht in zwei Situationen:

1. Bei einem Klick auf Bearbeiten oder Ansehen und Kopieren zum Client. Die Manipulation des Layouts wird beim anschließenden Einchecken zurück in die Datenbank geschrieben. Hinweis: Bei Ihren eigenen Vorlagen empfehlen wir, die Änderung als neue Version einzuchecken.
2. Beim Aufruf eines Reports und Kopieren des Layouts in das BIRT Arbeitsverzeichnis auf dem Applikationsserver.

Bitte verwenden Sie folgende Namen bei Verwendung als:

Parameter: OVW_VIS
Variable: PSA_BIRT_RPT_OVW_VIS
Session: PSA_BIRT_RPT_OVW_VIS

Mögliche Werte:
y - Änderung durchführen
n - keine Änderung

Die Notwendigkeit eines Postprozessors zeigt sich beim Erstellen von E-Mails. BIRT setzt bei HTML-Ausgabe das gesamte Ergebnis in eine Tabelle mit unsichtbaren Rahmen. Daraus ergibt sich ein unerwünschtes Verhalten beim Empfänger der E-Mail. Macht dieser das E-Mail-Fenster schmal, wird der Text abgeschnitten. Zieht er das E-Mail-Fenster breiter, wird die Fensterbreite nicht ausgenutzt, weil die Tabelle eine statische Breite hat.

Ab JustRelate CRM 7.3: Um das Soll-Verhalten (Fließtext) wiederherzustellen, muss die von BIRT hinzugefügte Tabelle wieder entfernt werden. Der Postprozessor nimmt an, dass das die äußerste Tabelle im ersten div-Element ist. Aus der ersten td-Zelle der Tabelle werden alle Kinder zum div-Element hinzugefügt. Leider kann der Postprozessor nicht erkennen, ob eine äußere Tabelle mit genau diesen Eigenschaften von BIRT hinzugefügt wurde oder vom Gestalter der Vorlage so beabsichtigt war. 

Der Postprozessor muss also auf Vorlagenebene abschaltbar sein.

Parameter: INL_HTM_TAB
Variable: PSA_BIRT_RPT_INL_HTM_TAB
Session: PSA_BIRT_RPT_INL_HTM_TAB

Mögliche Werte: y / n wie oben

Ab JustRelate CRM 7.6: Die nächste Postprozessor-Maßnahme ist sicherlich bei allen E-Mail-Generierungen sinnvoll. Einige Anwender haben berichtet, dass E-Mails nicht zugestellt werden konnten, weil BIRT ein script-Element generiert, das zwar keinen Code enthält, aber von einigen Mailservern als potenziell schädlich erkannt wird. 

Aufgabe des Postprozessors ist es, aus Sicherheitsgründen alle script-Elemente zu entfernen.

Parameter: REM_SCR
Variable: PSA_BIRT_RPT_REM_SCR
Session: PSA_BIRT_RPT_REM_SCR

Mögliche Werte: y / n wie oben

Ab JustRelate CRM 8.0: Auch die nächste Postprozessor-Maßnahme ist elementar für den Versand von E-Mails mit Bildern. BIRT erlaubt bei allen Objekten, bei denen die Größe definierbar ist (also auch bei Bildern), die Einheit für Breite und Höhe (Pixel, Punkte, Inch, Zentimeter, Millimeter etc.) frei zu wählen und speichert die entsprechenden Werte und Einheiten auch im generierten HTML-Markup ab (cm | mm | in | pt | px).

Sämtliche Browser und E-Mail-Clients kommen damit gut zurecht, außer Microsoft Outlook. Dort ist die einzig zulässige Einheit Pixel (px). Andere Einheiten werden ignoriert. Bilder werden in den meisten Fällen zu groß dargestellt.

Aufgabe des Postprozessors ist es, die in BIRT wählbaren Einheiten bei img-Elementen in px umzurechnen.

Parameter: CNV_IMG_DIM
Variable: PSA_BIRT_RPT_CNV_IMG_DIM
Session: PSA_BIRT_RPT_CNV_IMG_DIM

Mögliche Werte:
sty - Ändert nur den Wert und die Einheit im style-Attribut.
att - Entfernt die Dimension aus dem style und trägt sie als separates Attribut beim img-Tag ein.

Ab JustRelate CRM 8.0: Die nächste Postprozessor-Maßnahme sorgt für eine korrekte Darstellung von Schriftarten im CRM-Web-Client. Das erste div-Tag hat die id __BIRT_ROOT und einen style mit einer Schriftart. Ohne Postprozessor zeigt der CLOB-Editor des Web-Client aufgrund des o. g. Styles in den nachfolgenden Elementen eine falsche Schriftart an.

Um dies zu verhindern, modifiziert der Postprozessor den Style des ersten div-Tags, das die id __BIRT_ROOT hat.

Parameter: REM_ROO_STY
Variable: PSA_BIRT_RPT_REM_ROO_STY
Session: PSA_BIRT_RPT_REM_ROO_STY

Mögliche Werte:
fnt - Entfernt font-family aus dem style-Attribut.
all - Entfernt das gesamte style-Attribut.