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