Documents Manager

Dieser Abschnitt enthält Infos zum Documents Manager.

Externer Aufruf Documents Manager

Die DOCUMENTSManager.exe befindet sich im Ordner "manager" der Documents-Installation. Über den Manager kann auch auf entfernte Installationen zugegriffen werden. Hier ist nur wichtig, dass die lokale Manager-Version mit der entfernten Version übereinstimmt.

Die exe-Datei kann mit diversen Parametern aufgerufen werden. Um eine Liste aller aktuell verfügbaren Paremter zu erhalten kann die exe-Datei mit "- info" oder "- h" aufgerufen werden.

image-1659681114352.png

Filterausdruck: Erweiterte Documents-API-Syntax

An öffentlichen Ordnern mit dynamischen Filtern kann optional auch die erweiterte Documents-API-Syntax verwendet werden. Hierbei können einzelne Filterausdrücke mit "AND" und "OR" verknüpft werden aber dürfen nicht mit Klammern verschachtelt werden! Folgende Vergleichsoperatoren dürfen verwendet werden:

Operator Bedeutung
= Gleich
!= Ungleich
< Kleiner
> Größer
~ Beinhaltet
|~ Beginnt mit

Das folgende Beispiel filtert alle Rechnungs-Belege mit aktuellem Tagesstempel, wo der Belegtyp im technischen Namen entweder "invoice" enthält oder gleich 'creditvoucher' (Gutschrift) ist.

// Verschachtelte Abfragen sind nicht erlaubt!
DateOfReceipt='%currentDate%' AND 
(InvoiceCreditVoucher~'invoice' OR InvoiceCreditVoucher='creditvoucher')

// Die Klammern müssen aufgelöst werden!
DateOfReceipt='%currentDate%' AND InvoiceCreditVoucher~'invoice' 
OR 
DateOfReceipt='%currentDate%' AND InvoiceCreditVoucher='creditvoucher'

 

 

CrashRecovery nach Neustart ausführen

Nach einer abnormalen Beendigung des DocumentServers muss explizit die Datei documents.ini um den Eintrag

$CrashRecovery 1

erweitert werden. Der Server muss crashen und darf nicht gezielt runtergefahren werden. Dies kann durch die Wartungsoperation "crashServer" oder durch das abschießen der Applikation über den Windows Task-Manager erreicht werden. Der Neustart kann etwas länger dauern.

Nach dem Neustart sollten solche Einträge ins Log geschrieben werden:

Mon Feb 20 12:33:56 2023: Recovering from crash: Checking OIDs
Mon Feb 20 12:33:57 2023: Checking relation tables
Mon Feb 20 12:34:50 2023: Checking class tables
Mon Feb 20 12:34:53 2023: Checking bidirectional relations