CIB workbench Anwenderhandbuch

8. CIB workbench Benutzeroberfläche

8.3. Menüblock VorlagenCockpit

Allgemein
Aktivierung
Plugin Manager
Platzhalter für Aufrufparameter
PlugIns
Anwendungsfälle

Allgemein

Das VorlagenCockpit ist eine optionale Zusatzfunktionalität um eigene Prozesse (PlugIns), die im Zusammenhang mit einem Vorlagenprojekt stehen, in die CIB workbench einzuhängen.

Dafür steht ein kleiner PlugIn-Manager als Dialogoberfläche bereit, über den man eigene Menüpunkte mit den dazu gehörigen Funktionen in dieses Cockpit einfügen kann.

Aktivierung

Das VorlagenCockpit ist standardmäßig in der CIB workbench nicht sichtbar. Dieser Menüblock kann durch einen Eintrag in der benutzereigenen CIB workbench.ini Datei aktiviert werden.

Zu Details kontaktieren Sie bitte die CIB Berater.

Plugin Manager

Über den Menüpunkt "Manager…" öffnet sich eine Dialogmaske "PlugIn Manager". Dort können über die folgenden Eingabefelder die Zusatzfunktionen (PlugIns) beschrieben werden:

Bezeichnung der Zusatzfunktion
Verweis auf das Zusatzprogramm, das mit dem Menüpunkt verknüpft ist bzw.
direkte Eingabe der Kommandozeile
Zusatzprogramme können sein:

Exe Dateien (z.B. CIB runshell)
BAT(ch) und CMD Dateien

Genauere Beschreibung dieser Zusatzfunktion, die dann in der PlugIn-Liste als Tooltip angezeigt wird

Die Dialogmaske bietet zusätzliche Buttons um die PlugIns

	zu testen
	hinzuzufügen
	zu entfernen
	in der Reihenfolge umzusortieren

Platzhalter für Aufrufparameter

Da in der Regel Verarbeitungs-Prozesse in das VorlagenCockpit eingehängt werden, die in Bezug zu der aktuell geöffneten Vorlage stehen, können einige Aufrufparameter durch die CIB workbench mit den Daten aus dieser Vorlage automatisch vorbelegt werden.

Es handelt sich derzeit um 12 Parameter, die in der Prozedur als Platzhalter verwendet werden können und zur Laufzeit durch die CIB workbench mit den aktuellen Werten aus der Vorlage belegt werden.

Syntax:
Die Parameter sind in %...% zu klammern und in Großbuchstaben zu schreiben.

Beispiel:
%WORKSPACE%

Parameterliste:

ACTIVEDOCUMENT	Dokument, das gerade in MS Word aktiv ist
BASE	Basisbaustein der Vorlage
DATA	Zugeordnete Datenquelle (kann auch eine individualisierte Datenquelle sein)
DATADIR	Pfad zu dieser Datenquelle
INSTALLDIR	Installationsverzeichnis der CIB workbench
LC	Lizenz-Company der CIB workbench
LK	Lizenz-Key der CIB workbench
PROGRAMFILES	Verzeichnis ????
PROJECTDIR	Projektverzeichnis bei XSS Edition
ROOT	Wurzeldokument
WINDIR	????
WINSYSDIR	?????
WORKSPACE	In der CIB workbench eingestelltes Arbeitsverzeichnis

PlugIns

Der Menüpunkt "PlugIns" listet alle vom Anwender im "PlugIn Manager" erstellten Funktionen auf.

Sie können durch Anklicken direkt gestartet werden.

Achtung:

Der Regelfall wird sein (speziell bei Verwendung von Platzhaltern für Aufrufparameter), dass die PlugIns aus dem Menü nur funktionieren, wenn in der CIB workbench auch ein Vorlagenprojekt geladen ist.

Anwendungsfälle

Im Folgenden soll die Verwendung des VorlagenCockpits an Hand zweier fachlicher Anwendungsfälle gezeigt werden.

Generator Texthandbuch / Mastervertrag

Aus einer Vorlage wird ein RTF erzeugt, in dem alle INCLUDETEXT aufgelöst sind. Alle sonstigen Feldbefehle bleiben erhalten und werden optisch aufbereitet, so dass das im RTF enthaltene Regelwerk gut ersichtlich wird.

Dem Generator geht intern immer ein CIB merge Template-Combine voraus (Parameter „template-combine“).

Die optische Aufbereitung erfolgt durch den CIB format. Sie wird derzeit nur von einer speziellen CIB format Version (CIB format 7.0.14a) unterstützt. Standardmäßig ist dieser CIB format nur in der CIB workbench Version 2.9.202 enthalten. Daher muss in anderen Versionen der CIB workbench die CIB format DLL getauscht werden.

Die Aufbereitung wird durch die Property "ShowTHB" gesteuert:

0 ausgeschaltet (default)

1 optische Aufbereitung eingeschaltet

Diese Property wird nur beim Ausgabeformat RTF unterstützt. Dieses Ausgabeformat ist nur zur Verwendung in diesem Generator freigegeben.

Die Property "ShowTHB" führt zu den folgenden Darstellungen im RTF:

cib-formfield Schalter werden – wenn vorhanden - ausgewertet und zur Informationsumsetzung mit benutzt
checkbox wird durch ein rotes Kästchen repräsentiert
Beispiel: ☐ Trifft zu
radio-button (Gruppe) wird durch einen roten Kreis repräsentiert
Beispiel: ◯ Fall1 ◯ Fall2
DANN / SONST Bereiche (IF / THEN / ELSE) werden in Rot mit „A+Ebenennummer >“ und mit „< + E+Ebenennummer“ geklammert
Beispiel: A3>und vieles mehr<E3
SOLANGE-Schleifen werden durch Wiederholung + Wingdings Schleifensymbol gekennzeichnet
Beispiel: <Wiederholung> ↺
Variablennamen werden durch <...> in roter Farbe geklammert und es wird der Variablentyp in die Ausgabe geschrieben (Datum, Signatur, Text, Ganzzahl, Kommazahl, Valutadatum)
Beispiel: <Text>
static Variablen werden inhaltlich aufgelöst und in blau in das Ergebnisdokument generiert
Beispiel: Der Kreditrahmen
value= Vorbelegungen werden in grünen <....> Klammern (statt roten) ausgegeben
Beispiel: <EUR> <Kommazahl>
Datenfelder die in einer IF oder COMPARE Anweisung als Operand benutzt werden, sind in rot und mit […] (statt <….>) geklammert
Beispiel: [VertragLeistungseinzug] [VertragZinsen]
Dropdown ist mit einem Pfeilsymbol und den Optionen in [....] ersichtlich
Beispiel: ⇩ [allg. Unternehmenszwecke;Investitionsausgaben;Betriebsmittelbedarf]
INCLUDEPICTURE-Befehl, bei dem der Dateiname über eine Variable eingesteuert wird
Beispiel: <DYNAMISCHE BILDDATEI>
Codepassen aus Maskenbereichen entfallen
AUSNAHME: Tabellenzeilen (=Kommentar) werden ausgegeben -> das ist ggf. eine Besonderheit in der DZ BANK die woanders hinderlich ist?
Druckbereich -Klammerbefehle entfallen
REC-Bereich –Klammerbefehle entfallen

Die Property „IfThenElsePart="AllBranches"“ sorgt dafür, dass im Ausgabe-RTF beide Zweige (THEN und ELSE) generiert werden.

Aufrufparameter:

m-LicenseKey="%LK%" -m-LicenseCompany="%LC%" "-ma%WORKSPACE%" "-mqD:\temp\traces" -mo!Mastervertrag_rtf.rtf -mL!merge.log -mx -m-LicenseKey="%LK%" -m-LicenseCompany="%LC%" -m-template-combine -ms -mi"%ROOT%" "-m-SET=CIBDOCUMENTBASE=%BASE%" -m@1 ShowTHB="1" IfThenElsePart="AllBranches" -r d:\temp\traces\Mastervertrag_rtf.rtf d:\temp\traces\Mastervertrag_out.rtf

Beispiel, Auszug aus einem Dokument:

…….

Der Kreditrahmen dient der Finanzierung
◯A2>⇩ [allgemeiner Unternehmenszwecke;von Investitionsausgaben;des Betriebsmittelbedarfs]<E2
◯A2> <Text><E2
<E1
☐A1> Für die Saisonlinie gilt die o. g. abweichende Laufzeit.
<E1
<Wiederholung> ↺
je Terminkredit.<E3
Es können Zinsbindungsperioden von
☐A3> 1<E3
☐A3>
☐A4> , <E4
3<E3
☐A3>
<varListeAuswahl6FremdWaehrung> A4>, <E4

Monaten vereinbart werden, sofern die Fälligkeit der Tranche die des Kreditrahmens nicht überschreitet.

…….

XslFo Konvertierung

In diesem Beispiel wird die aktuelle Vorlage mit Daten aus einer zugeordneten Datenquelle zu einem Zwischenergebnis im RTF Format aufbereitet und anschließend in das XslFo -Format konvertiert.

Damit kann eine Fehleranalyse durchgeführt werden, wenn ein Druckstück beim zentralen Druck ausgesteuert wurde und die Ursache nicht bekannt ist.

Aufrufprogramm

CIB runshell (aus der Installationsbasis der CIB workbench)

Aufrufparameter

"-mqD:\Projekte\Beratung\Konsoldierung Vertraege\02 Arbeitsverzeichnisse\Workspace\OWV0000002" "-ma%WORKSPACE%" -mo!d:\temp\xfo\Ausgabedokument.rtf "-mhXML:%DATA%" -md//multi -m-multidatafile -mL!d:\temp\xfo\merge.log -mx -m-LicenseKey="%LK%" -m-LicenseCompany="%LC%" -ms -mi"%ROOT%" "-m-SET=CIBDOCUMENTBASE=%BASE%" -m@1 AnalyseOptions=Graphics MultiRtfSingleOutput=1 AllowCutTableCells=0 PageSelection="AUSF1,0" FontsEmbedded=0 GraphicCompressMethod=JPEG AnalysisFilename=d:\temp\xfo\format_analyze.txt HideGraphics="{{all};0,0mm;235.5mm;12.5mm;291,0mm}}" OutputFormat=FormatXslFo UseComplexFieldResults=1 -xfo d:\temp\xfo\Ausgabedokument.rtf