h1. Konfiguration
Jeder Aufruf aus GDI für eine Recherche oder Archivierung wird über eine Konfigurationsdatei gesteuert.
Je nach Aufbau der Dokumentenklasse und Schlagwörter in Inoxision ist eine Anpassung notwendig.
Der Inhalt einer Konfigurationsdatei wird nachfolgend beschrieben
h2. Liesmich-Datei
In jedem [[Verzeichnisstruktur#Konfigurationsdateien-pro-Belegart|Konfigurationsverzeichnis]] wird automatisch eine liesmich.txt erstellt.
Diese Datei enthält wertvolle Informationen über Systemvariablen aus GDI.
Beschreibung zur Daten aus dem Bereich V.AN
erstellt am: 07.05.2025 15:52:15
Tabellenname=BELEG
Tabellenbereich=
Programm WAWI
Belegtyp=V
Belegart=AN
Mögliche Systemvariablen:
TABLETYP=BELEG
Name der Tabelle
Schreibweise als Variable: $TABLETYP$
TABLEKEY
enthält den Schlüssel des Datensatz. z.B. bei Belegen die BelegID
Schreibweise als Variable: $TABLEKEY$
Beispiel: V.AN.123456
* diese Informationen können im weitern Verlauf über die Recherche oder Archivierung weiterverwendet werden.
h2. Arten der Konfigurationsdateien
Alle Konfigurationsdateien sind im INI-Format aufgebaut.
Es gibt zwei unterschiedliche Arten von Konfigurationsdateien.
Konfigurationsarten
* Recherche von Dokumenten aus Inoxision Archive
* Archivierung von Dokumenten aus Inoxision Archive
h2. Systemvariablen
In jeder Konfiguration können mindestens folgende Systemvariablen verwendet werden.
siehe Datei liesmich.txt
DOCTYP
* mögliche Werte E oder V
* enthält den einstelligen Bezeichner der angibt ob es sich um Belege des Einkauf oder Verkauf handelt
Schreibweise als Variable:$DOCTYP$
TABLETYP
* Kenner für Belege oder Stammdaten. z.B. AN für Angebot, BE Bestellung, ART Artikel, KUN Kunde, LIE Lieferant
* Schreibweise als Variable: $TABLETYP$
TABLEKEY
* enthält den Schlüssel des Datensatzes. Bei Belegen = Belegnummer. Bei Kunden = Kundennummer. Bei Artikel = Artikelnummer
* Schreibweise als Variable: $TABLEKEY$
h2. Benutzervariablen
Es können eigene Benutzervariablen erstellt und verwendet werden.
In jeder Konfigurationsdatei können bis zu 99 eigene Variablen erstellt werden.
Diese Variablen können direkt für die Verschlagwortung von Dokumenten verwendet werden
h3. Wert einer Benutzervariablen
* Der Wert einer Benutzervariablen ist ein SQL-Statement welches ein eindeutiges Ergebnis aus der GDI Datenbank des Mandanten liefert.
* Im SQL-Statement können alle Systemvariablen verwendet werden
* Das SQL-Statement wird beim Ausführen im Hintergrund mit dem passenden Wert aus der Datenbank befüllt
* Beispiel für die Definition von Variablen
[Variables]
VARIABLE01=select CONVERT(varchar(10), datum, 104) from Beleg where belegtyp = '$BELEGTYP$' and Belegnummer ='$TABLEKEY$'
VARIABLE02=select Adressnummer from Beleg where belegtyp = '$BELEGTYP$' and Belegnummer ='$TABLEKEY$'
In diesem Beispiel würde die VARIABLE01 mit dem Datum eines Beleg befüllt werden und VARIABLE02 mit der Adressnummer aus dem Beleg.
h3. Name und Schreibweise einer Benutzervariablen
* die Benennung der Benutzervariablen erfolgt durch das Wort VARIABLE plus fortlaufende Nummer
Beispiel: VARIABLE01
* zur Verwendung der Benutzervariablen wird die Benutzervariable mit Dollarzeichen ($) umschlossen
Beispiel: $VARIABLE01$
h2. Konfigurationsdatei für Archivierung
Eine Konfigurationsdatei zur Archivierung von Dokumenten enthält drei Sektionen.
Die drei Sektionen sind [System], [Execute] und [Variables].
Die Schreibweise ist Keysensitiv und ist zwingend einzuhalten. Die Reihenfolge ist unerheblich
* Der Bereich [System] kann folgende Schlüssel enthalten
|Schlüssel|Beispiel|Zweck|
|LastUse|04.01.2025 15:37:36|Datum und Uhrzeit der letzten Verwendung|
|Description|Ablage ohne Vorschau|Beschriftung wie für den Anwender sichtbar|
|StraightToWorkflowDirectory|0 (Default) oder 1 | wenn 0, dann Verarbeitung mit ArchiveExecute._ wenn 1 dann Verarbeitung mit über Workflowserver|
|WorkflowDirectory|\\Servername\Freigabename\IxmWorkflowverzeichnis|UNC-Pfad zu Workflowserververzeichnis. Nur wenn StraightToWorkflowDirectory=1|
* Bereich [Execute]
In diesem Bereich können alle ARCHIVEexecute-Parameter des Inoxision Integrationsclient angewendet werden. Siehe Handbuch DokuIntegrationsclient.pdf
Bei den Werten können alle Systemvariablen, Benutzervariablen sowie konstante Werte verwendet werden.
Ebenso können die klassischen Umgebungsvariablen von Inoxision verwendet werden.
Beispiel:
[Execute]
InputType=BINARY
AutoExecute=0
OutputArchiveName=Adpt_Belege
KeywordValues#0=Belege.Belegnummer|$VARIABLE03$|
KeywordValues#1=Belege.Belegart|Angebot|
KeywordValues#2=Belege.Belegdatum|$VARIABLE01$|
KeywordValues#3=Belege.Aktennummer|$VARIABLE05$|
KeywordValues#4=Belege.Adressnummer|$VARIABLE02$|
KeywordValues#5=Belege.Adressname|$VARIABLE04$|
KeywordValues#6=Belege.DebKredNummer|$VARIABLE05$|
KeywordValues#7=Belege.Archivdatum|%date%|
SwapProcess=0
CreateFullTextChecked=1
DeleteSourceFileChecked=1
* Bereich [Variables]
In diesem Bereich können eigene Benutzervariablen definieren werden.
siehe weiter oben
Beispiele:
[Variables]
VARIABLE01=Select substring(100+extract(day from BELEGDAT) from 2 for 2)||'.'||substring(100+extract(month from BELEGDAT) from 2 for 2)||'.'||extract(year from BELEGDAT) From BELEG where BELEGID = '$TABLEKEY$';
VARIABLE02=select ADRESSNR From BELEG where BELEGID = '$TABLEKEY$';
VARIABLE03=select BELEGNR From BELEG where BELEGID = '$TABLEKEY$';
VARIABLE04=select NAME1 from BELEG where where BELEGID = '$TABLEKEY$';
VARIABLE05=select ATKTENNR from BELEG where where BELEGID = '$TABLEKEY$';
h2. Aufbau Konfigurationsdatei für Recherche
Eine Konfigurationsdatei zur Recherche von Dokumenten enthält drei Sektionen.
Die drei Sektionen sind [System], [Variables] und [Search]
Die Schreibweise ist Keysensitiv und ist zwingend einzuhalten
* Der Bereich [System] kann folgende Schlüssel enthalten.
|Schlüssel|Beispiel|Zweck|
|LastUse|04.01.2023 15:37:36|Datum und Uhrzeit der letzten Verwendung|
|Description|Suche alle Belege der Adresse|Beschriftung wie für den Anwender sichtbar|
* Bereich [Search]
In diesem Bereich können alle ARCHIVEexecute-Parameter des Inoxision Integrationsclient angewendet werden. Siehe Handbuch DokuIntegrationsclient.pdf
Bei den Werten können alle Systemvariablen, Benutzervariablen sowie konstante Werte verwendet werden.
Ebenso können die klassischen Umgebungsvariablen von Inoxision verwendet wie zum
Beispiel:
[Search]
SearchArchiveName=Adpt_Belege
SearchType=MASK
AutoExecute=1
Operator=AND
ListFields=Belege.Belegtyp|Belege.Belegnummer|Belege.Belegdatum|Belege.Adressnummer|Belege.Adressname|Belege.Bruttobetrag#|Belege.Nettobetrag#|Belege.Archivdatum
SearchFields=Belege.Adressnummer|$VARIABLE01$|Belege.Belegtyp|Angebot
FullText=Point
PreviewVisible=RIGHT
PreviewAutoRefresh=1
DeleteConfigFile=1
ForceStartupNextInstance=1
* Bereich [Variables]
In diesem Bereich können eigene Benutzervariablen definieren werden.
siehe weiter oben
Beispiele:
[Variables]
VARIABLE01=select Adressnummer from Beleg where belegtyp = '$BELEGTYP$' and Belegnummer ='$TABLEKEY$'