h1. TemplateFiles

Die TemplateFiles sind Beispieldateien für die Konfiguration der Aufrufe aus den Belegtypen oder Stammdaten in Selectline.
Je nach Aufbau der Dokumentenklasse und Schlagwörter in Inoxision ist eine Anpassung notwendig.
Jeder Unterordner entspricht einem Belegtyp bzw. Stammdatentyp der SelectLine Warenwirtschaft 
Hinweis: Die TemplatesFiles können in SL2inoxision jederzeit aktualisiert werden. Dabei werden die vorhandenen Dateien aktualisiert. 


h2. Liesmich-Datei

* im Unterordner findet sich eine Liesmich-Datei mit relevanten Informationen zu Tabelle und Schlüssel in Selectline Warenwirtschaft.
* Bsp: TemplateFiles „QB“ : TabellenBeschreibung=Bestellung
* Ebenso werden mögliche Systemvariablen zur Verwendung in den Konfigurationen aufgelistet. 
* Beispielinhalt:
<pre>
TabellenBeschreibung=Eingangsrechnung
Tabellenname=BELEG

mögliche Systemvariablen:
Blobkey=QE
BLOBKEY (enthält den zweistelligen Kenner des Datensatz. z.B. QF für Tabelle Auftrag
Schreibweise als Variable: $BLOBKEY$

TABLEKEY
TABLEKEY (enthält den Schlüssel des Datensatz. Bei Belegen  = Belegnummer. Bei Kunden = Kundennummer  
Schreibweise als Variable: $TABLEKEY$

Belegtyp=E
BELEGTYP (enthält den einstelligen Kenner der Tabelle. Nur bei Belegtabellen ansonsten leer! (z.B. F=Auftrag 
Schreibweise als Variable: $BELEGTYP$
</pre>


h2. Arten der Konfigurationsdateien

Alle Konfigurationsdateien sind im INI-Format aufgebaut.
Es gibt zwei unterschiedliche Arten von Konfigurationsdateien.
Konfigurationsarten
* Ablage von Dokumenten in Inoxision Archive
* Recherche von Dokumenten aus Inoxision Archive

h2. Systemvariablen

In jeder Konfiguration können mindestens folgende Systemvariablen verwendet werden

BLOBKEY
* enthält den zweistelligen Kenner des Tabelle z.B. QF für Tabelle Auftrag
* Schreibweise als Variable: $BLOBKEY$

TABLEKEY
* enthält den Schlüssel des Datensatzes. Bei Belegen  = Belegnummer. Bei Kunden = Kundennummer.  Bei Artikel = Artikelnummer
* Schreibweise als Variable: $TABLEKEY$

BELEGTYP
* enthält den einstelligen Belegtyp der Tabelle. (z.B. F=Auftrag)
* Nur bei Belegtabellen vorhanden, ansonsten leer! 
* Schreibweise als Variable: $BELEGTYP$

h2. Benutzervariablen

Es können eigene Benutzervariablen erstellt und verwendet werden.
In jeder Konfigurationsdatei können bis zu 99 eigene Variablen erstellt werden.

h3.  Wert einer Benutzervariablen

* Der Wert einer Benutzervariablen ist ein SQL-Statement welches ein eindeutiges Ergebnis aus der Selectline Datenbank des aktuellen 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
<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 Ablage

Eine Konfigurationsdatei zur Archivierung von Dokumenten enthält drei Sektionen.
Die drei Sektionen sind [System], [Variables] und [Execute].
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|Ablage ohne Vorschau|Beschriftung der Kachel 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, wie zum
Beispiel:
<pre>
[Execute]
InputType=BINARY
AutoExecute=0
OutputArchiveName=Adpt_Belege
KeywordValues#0=Belege.Belegnummer|$TABLEKEY$|
KeywordValues#1=Belege.Belegtyp|Angebot|
KeywordValues#2=Belege.Belegdatum|$VARIABLE01$|
KeywordValues#3=Belege.Adressnummer|$VARIABLE02$|
KeywordValues#4=Belege.Adressname|$VARIABLE04$|
KeywordValues#5=Belege.Adressort|$VARIABLE03$|
KeywordValues#6=Belege.DebKredNummer|$VARIABLE05$|
KeywordValues#7=Belege.Bearbeiter|$VARIABLE06$|
KeywordValues#8=Belege.Bruttobetrag#|$VARIABLE07$|
KeywordValues#9=Belege.Nettobetrag#|$VARIABLE08$|
KeywordValues#10=Belege.Archivdatum|%date%|
SwapProcess=0
CreateFullTextChecked=1
DeleteSourceFileChecked=1
</pre>


* Bereich [Variables] 
In diesem Bereich können eigene Benutzervariablen definieren werden.
siehe [[TemplateFiles#Benutzervariablen]] weiter oben
Beispiele:
<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$'
VARIABLE03=select ort from Beleg where belegtyp = '$BELEGTYP$' and Belegnummer ='$TABLEKEY$'
VARIABLE04=select Anzeigename from Beleg where belegtyp = '$BELEGTYP$' and Belegnummer ='$TABLEKEY$'
VARIABLE05=select Konto from Beleg where belegtyp = '$BELEGTYP$' and Belegnummer ='$TABLEKEY$'
VARIABLE06=select Name from mitarbw where benutzer=(select angelegtvon from beleg where belegtyp = '$BELEGTYP$' and Belegnummer ='$TABLEKEY$')
VARIABLE07=select EuroBrutto from Beleg where belegtyp = '$BELEGTYP$' and Belegnummer ='$TABLEKEY$'
VARIABLE08=select EuroNetto from Beleg where belegtyp = '$BELEGTYP$' and Belegnummer ='$TABLEKEY$'
</pre>

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 der Kachel 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:
<pre>
[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
</pre>

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

h2. Beispiel-TemplateFiles

Nachfolgend mitgelieferte Beispiele für alle Belegtypen

* AblagemitVorschau.txt
  Bei Auwahl dieser Variante öffnet sich im Anwenderbereich automatisch das ausgewählte Dokument mit der Verschlagwortung in Inoxision, um Einträge zu kontrollieren und zu ergänzen.

* AblagemitWorkflow.txt
  Im Anwenderbereich wird das Dokument per Workflow direkt verarbeitet.

* Recherche_alleDokumenteAdresse.txt
  Alle Dokumente der ermittelten Adressnummer werden in inoxisionARCHIVE angezeigt und können darüber geöffnet werden.

* Recherche_alleDokumenteZuBeleg.txt
  Alle Dokumente zu der Belegnummer werden in inoxisionARCHIVE angezeigt und können darüber geöffnet werden.