h1. Konfiguration

Jeder Aufruf aus dem ERP für eine Recherche oder Archivierung wird über eine individuelle Konfigurationsdatei pro "TableKey":https://projekte.bsc-computer.de/projects/erp2inoxision/wiki/Befehlszeilenaufruf#Argumente gesteuert.

Anhang Aufbau der Dokumentenklasse und Schlagwörter in Inoxision werden die Konfigurationsdateien angepasst.

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 in Inoxision Archive

h2. Systemvariablen

In jeder Konfiguration können zwei Systemvariablen verwendet werden.

TABLEKEY
* enthält den Schlüssel zur eindeutigen Identifikation eines Datensatz. 
 Beispiele Belegnummer, Kundennummer, Artikelnummer, etc.
* Schreibweise als Variable: $TABLEKEY$

TABLETYP (optional)
* enthält eindeutigen Kenner des Bereich. Die Bezeichnung ist wahlfrei muss jedoch immer gleich lauten.
 z.B. Angebot, Bestellung, ART, Artikel,Kunde,Lieferant, etc.
* Schreibweise als Variable: $TABLETYP$


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 das Ergebnis eines SQL-Statement welches ein eindeutiges Ergebnis aus der ERP Datenbank liefert. 
* Im SQL-Statement können alle Systemvariablen verwendet werden
* Das SQL-Statement wird beim Ausführen im Hintergrund mit den passenden Werten aus der Datenbank befüllt 
* Beispiel für die Definition von Variablen
<pre>
[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$'
</pre>

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 [General], [Execute] und [Variables].
Die Schreibweise ist keysensitiv und ist zwingend einzuhalten. Die Reihenfolge ist unerheblich

* Der Bereich [General] 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 in der Anwendung 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. 
Zweck und Funktion wird deshalb nicht separat erläutert, siehe Inoxision-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:
<pre>
[Execute]
InputType=BINARY
AutoExecute=1
OutputArchiveName=Adpt_Belege
KeywordValues#0=Belege.Belegnummer|$TABLEKEY$|
KeywordValues#1=Belege.Belegart|Eingangsrechnung|
KeywordValues#2=Belege.Belegdatum|$VARIABLE01$|
KeywordValues#3=Belege.DebKrednummer|$VARIABLE03$|
KeywordValues#4=Belege.Adressnummer|$VARIABLE02$|
KeywordValues#5=Belege.Adressname|$VARIABLE04$|
KeywordValues#6=Belege.Archivdatum|%date% %time%|
SwapProcess=0
CreateFullTextChecked=1
DeleteSourceFileChecked=1
</pre>


* Bereich [Variables] 
In diesem Bereich werden eigene Benutzervariablen zur Datengewinnung aus dem ERP definiert.
exemplarische Beispiele für Aufrufe aus der Datenbank: 
<pre>
[Variables]
VARIABLE01=select CONVERT(varchar(10), datum, 104) from Beleg where Belegtyp = '$TABLETYP$' and Belegnummer ='$TABLEKEY$'; 
VARIABLE02=select ADRESSNR From BELEG where Belegnummer = '$TABLEKEY$';
VARIABLE03=select Debitorennummer from Kunde where Kundennummer = (select Kundennummer from Beleg where Belegnummer= '$TABLEKEY$');
VARIABLE04=select Firma from BELEG where  Belegnummer= '$TABLEKEY$';
</pre>

h2. Aufbau Konfigurationsdatei für Recherche 

Eine Konfigurationsdatei zur Recherche von Dokumenten enthält drei Sektionen.
Die drei Sektionen sind [General], [Variables] und [Search]
Die Schreibweise ist keysensitiv und ist zwingend einzuhalten 

* Der Bereich [Generak] 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 eines Kunden|Beschriftung wie für den Anwender sichtbar|

* Bereich [Search] 
In diesem Bereich können alle ARCHIVEexecute-Parameter des Inoxision Integrationsclient angewendet werden. 
Zweck und Funktion wird deshalb nicht separat erläutert, siehe Inoxision-Handbuch DokuIntegrationsclient.pdf
Bei den Werten können alle Systemvariablen, Benutzervariablen sowie konstante Werte verwendet werden.
Benutzervariablen sind immer optional und werden nur eingerichtet, wenn benötigt.
Ebenso können die klassischen Umgebungsvariablen von Inoxision verwendet werden.
Beispiel:
<pre>
[Search]
SearchArchiveName=Adpt_Belege
SearchType=MASK
AutoExecute=1
Operator=AND
ListFields=Belege.Belegtyp|Belege.Belegnummer|Belege.Belegdatum|Belege.Adressnummer|Belege.Adressname|Belege.Archivdatum
SearchFields=Belege.Beleg|$VARIABLE01$|Belege.Belegtyp|Eingangsrechnung
FullText=Point
PreviewVisible=RIGHT
PreviewAutoRefresh=1
DeleteConfigFile=1
ForceStartupNextInstance=1
</pre>

* Bereich [Variables] 
In diesem Bereich können eigene Benutzervariablen definieren werden.
siehe weiter oben
Beispiele:
<pre>
[Variables]
VARIABLE01=select Adressnummer from Beleg where belegtyp = '$TABLETYP$' and Belegnummer ='$TABLEKEY$'
</pre>