|
Aufbau der Konfigurationsdatei:
<?xml version="1.0" encoding="UTF-8"?>
<export></export>
<global></global>
<path></path>
<config>
</config>
Ausblenden von Einstellungsdialogen:
Es können Dialogelemente im Editor ausgeblendet werden, dies ist z.B. sinnvoll, wenn die Elemente, auf die sich Einstellung bezieht, nicht vorhanden sind.
Attribut: prop-hide.
Mögliche Werte (semikolon-getrennt):
doc: Register 'Dokument'.
doc-common: Subregister 'Allgemein' im Register 'Dokument'.
doc-column-header: Subregister 'Spaltenkopf' im Register 'Dokument'.
doc-data-field: Subregister 'Datenfeld' im Register 'Dokument'.
doc-table-header: Subregister 'Tabellenkopf' im Register 'Dokument'.
doc-table-footer: Subregister 'Tabellenfuß' im Register 'Dokument'.
pages: Register 'Seiten'.
table: Register 'Tabelle'.
data-fields: Register 'Datenfelder'.
objects: Register 'Objekte'.
Beispiel:
<global prop-hide="doc-table-header;doc-table-footer"></global>
Variablen:
Es können Variablen für verschiedene Bereiche festgelegt werden, der Aufbau ist wie nachfolgend:
<export|global|path>
<variables>
<variable>
<name>IMAGEPATH</name>
<value>d:/temp/</value>
</variable>
</variables>
</export|global|path>
Bereiche
|
Bescheibung
|
export
|
Es können beliebige Variablen (name-Tag) definiert werden, aus denen sich der Dateiname beim Export zusammensetzen soll, z.B. DATUM.MANDANT.pdf.
Der Benutzer kann den Namen ändern.
Beim Export werden die Variablen mit den Werten aus dem value-Tag ersetzt.
|
path
|
Damit z.B. Bilder in Tabellen, die sich in einem bestimmten Ordner befinden, immer gefunden werden, empfiehlt sich die Nutzung von Pfadvariablen.
Beispiel: In der Tabelle wird anstelle von d:/temp/test.svg der Werte {IMAGEPATH}test.svg eingetragen, in das value-Tag wird der Pfad eingetragen, z.B. d:/temp/.
Sollte sich der Ordner ändern, reicht eine Anpassung des Wertes im value-Tag.
|
global
|
Variablen, die direkt in der Tabelle genutzt werden können. Diese müssen folgendermaßen definiert werden: {\var{NAME}}
Bestimmte Variablen werden bereits vom Programm vorgegeben:
PAGENO: Die aktuelle Seitenzahl, z.B. Seite {\var{PAGENO}}.
SUM: Die Summe des Inhalts eines Zahlen- oder Datumsdatenfeldes, dazu muss noch der Index des Datenfeldes als Parameter angegeben werden, z.B. {\var{SUM}{1}}. Bei Datumsfeldern wird als Resultat der Bereich ausgegeben, z.B. 01.01.2017-31.12.2017.
DEF_SUM: Für Summen kann neben dem Index noch ein zweiter Parameter als Startwert der Berechnung angegeben werden, z.B.
{\var{DEF_SUM}{1}{1000}} oder {\var{DEF_SUM}{3}{1.1.2017}}.
COLNAME: Der Name der aktuellen Spalte, optional kann auch eine Spaltennummer (1-Anzahl Datenfelder) angegeben werden, z. B. {\var{COLNAME}{2}}.
CONVERT: Daten werden nur im Datenfeldelement <d> oder in der SUM-Funktion automatisch konvertiert.
Um z.B. eine manuelle Summe im Tabellenfuß oder im Tabellenkopf einzutragen, kann der Wert entweder vorher für die passende Lokalisierung konvertiert werden, oder wenn die Lokalisierung beliebig sein soll, vom Programm konvertiert werden:
{\var{CONVERT}{c}{10.07}}
Der erste Wert enthält dabei den Datentyp, der zweite Wert den Betrag im Format der Einlesedaten.
CURDATE: Das aktuelle Datum.
CURDATETIME: Das aktuelle Datum und die aktuelle Zeit.
CURTIME: Die aktuelle Zeit.
DATERANGENAME: Gibt für einen Datumsbereich (Datumswerte als ISO 8601 semikolon-getrennt) eine Zeichenkette aus:
Beispiel:
{\var{DATERANGENAME}{2016-01-01;2016-01-31}} : Januar 2016.
{\var{DATERANGENAME}{2016-07-01;2016-09-30}} : 3 Quartal 2016.
{\var{DATERANGENAME}{2016-01-01;2016-06-30}} : 1 Semester 2016.
{\var{DATERANGENAME}{2016-01-01;2016-12-31}} : 2016.
{\var{DATERANGENAME}{2016-01-01;2017-01-01}}: 01.01.2016 - 01.01.2017.
CURRENCYSYMBOL: Gibt das Währungssymbol oder den Namen aus:
{\var{CURRENCYSYMBOL}{0}} : ISO-4217 Bezeichnung.
{\var{CURRENCYSYMBOL}{1}} : Währungssymbol.
{\var{CURRENCYSYMBOL}{2}} : Name der Währung.
Zusätzlich stehen noch die Datumsvariablen in der nachfolgenden Tabelle zur Verfügung.
|
Datumsvariablen:
Name
|
Bescheibung
|
DAY
|
Der Tag als Zahl ohne führende Null (1 bis 31).
|
DAY2
|
Der Tag als Zahl mit führender Null (01 bis 31).
|
MONTH
|
Der Monat als Zahl ohne führende Null (1 bis 12).
|
MONTH2
|
Der Monat als Zahl mit führender Null (01 bis 12).
|
YEAR
|
Das Jahr als vierstellige Zahl.
|
HOUR
|
Die Stunde ohne führende Null (0 bis 23).
|
HOUR2
|
Die Stunde mit führender Null (00 bis 23).
|
MINUTE
|
Die Minute ohne führende Null (0 bis 59).
|
MINUTE2
|
Die Minute mit führender Null (00 bis 59).
|
SECOND
|
Die Sekunde ohne führende Null (0 bis 59).
|
SECOND2
|
Die Sekunde mit führender Null (00 bis 59).
|
MSEC
|
Die Millisekunde ohne führende Null (0 bis 999).
|
MSEC3
|
Die Millisekunde mit führender Null (000 bis 999).
|
Damit Variablen beim Export genutzt werden können, oder um Vorgaben für Ausgabeordner festzulegen, ist im Exportbereich für jeden Exporttyp (pic, pdf, odt, text, xlsx), der die Variablen nutzen soll, noch eine weitere Einstellung notwendig:
<export>
<types>
<pdf path="D:/mod_print" subfolder="EÜR" name-scheme="{TITEL}_{BUCHUNGSMODUS}_{DATUMSBEREICH}">
</pdf>
</types>
</export>
Exportvariablen:
Name
|
Bescheibung
|
path
|
Der Ausgabeordner (notwendige Angabe).
|
subfolder
|
Ein optionaler Unterordner (z.B. ein Kategoriename, nach dem die Daten abgelegt werden sollen).
|
name-scheme
|
Ein optionales Namens-Schema, das Werte aus den unter <export><path> festgelegten Werten, sowie evtl. vordefinierte Variablen enthält.
|
Einbindung eigener Dialoge:
In <global> können Schalter definiert werden, die in die Mauspalette eingefügt werden, beim Betätigen des Schalters wird das aufrufende Programm benachrichtigt.
<config><global><toolbuttons><button>
Name
|
Bescheibung
|
name
|
Der Name des Schalters
|
name-lang
|
Der Names des Schalter mit ISO 639-1 Erweiterung. Z.B. name-en
Sofern beim Programmstart eine Sprache mit dem Parameter lang übergeben wurde, sucht das Programm einen passenden Schaltertext dazu.
|
tooltip
|
Ein optionaler Tooltip für den Schalter.
|
tooltip-lang
|
Der Names des Schalter mit ISO 639-1 Erweiterung. Z.B. tooltip-en
Sofern beim Programmstart eine Sprache mit dem Parameter lang übergeben wurde, sucht das Programm einen passenden Tooltip dazu.
|
icon
|
Ein optionaler Dateiname mit Pfad zu einer Symboldatei.
|
Beispiel:
<config>
<global>
<toolbuttons>
<button>
<name>Datumsauswahl...</name>
<name-de>Datumsauswahl...</name-de>
<name-en>Select date...</name-en>
<tooltip>Datumsbereich ändern.</tooltip>
<tooltip-de>Datumsbereich ändern.</tooltip-de>
<tooltip-en>Change date range.</tooltip-en>
<icon>/media/icons/ic_date_range_black_24dp_1x.png</icon>
</button>
</toolbuttons>
</global>
</config>
|