Anpassung Documents-Installations-Pfad
Sowohl Documents5 als auch Documents6
Dateien kopieren
Zur Sicherheit sollte die bestehende Installation vorab gesichert werden. Der bereitgestellte Documents-Ordner aus der Installation-ZIP-Datei muss über den Documents-Installations-Pfad kopiert werden. Bei einer neuen Installation werden nur Dateien hinzugefügt. Die Update-Varianten enthalten nur die geänderten Dateien.
Anpassung documents.ini
Die documents.ini befindet sich im Sever-Verzeichnis der Documents-Installation. Die Anpassungen mit Beschreibungen werden mit der documents_help.ini ausgeliefert. Folgende Einträge müssen aktiviert werden:
JSMaxMemory 1638400
JSMaxBranch 0
MaxLogFile 100000000
Der PDF-Druck von Handlebars-Documenten-Vorlagen wird größtenteils im Procurement-Modul benötigt. Für bessere Druck-Ergebnisse sollte auf die Chromium-Bibliotheken umgestellt werden. Die Standard-Einstellung muss deaktiviert oder überschrieben werden. Die Einstellung ist nur relevant, wenn der PDF-Druck verwendet wird.
# Usage of Chromium for html to pdf
$convert.html "[INSTALLDIR]\..\createpdf\convert\html_chrome\html2pdf.bat" %input %output
Das Passwort für den DB-Benutzer sollte verschlüsselt werden! Hierfür muss das Passwort wie folgt angegeben werden.
DBPassword {crypt:Password}
Die Anpassungen bzw. die Verschlüsselung des Passworts wirken sich erst durch einen Neustart aus.
Wenn sowohl Testsystem als auch Produktivumgebung verwendet werden, kann der Documents-Manager farblich gekennzeichnet werden. Es bietet sich an, die produktiven Systeme in der Standardfarbe zu belassen und Testsysteme in alternativen Farben. Durch die Farbe merkt der User direkt, auf welchem System er arbeitet. Beispiel:
$DMSkinColor1 50,110,255
$DMSkinColor2 80,80,175
Anpassung documents.xml
Die documents.xml befindet sich in der Documents-Installation und einem Tomcat9 unter:
...\Documents\tomcat9\conf\Catalina\localhost\documents.xml.
Abweichende Ordner-Pfade in der Datei müssen manuell angepasst werden.
Die Einträge dürfen ab Documents 6.1.2 kein abschließendes "/" haben.
<?xml version="1.0" encoding="UTF-8"?>
<Context>
<Resources>
<PreResources base="D:/Documents6/DEXPRO/ScriptExits" webAppMount="/ext/jsp" className="org.apache.catalina.webresources.DirResourceSet" />
<PreResources base="D:/Documents6/DEXPRO_ClientExits" webAppMount="/ext/jsp/DexClientExits" className="org.apache.catalina.webresources.DirResourceSet" />
<PreResources base="D:/Documents6/DEXPRO/WEB-INF" webAppMount="/WEB-INF" className="org.apache.catalina.webresources.DirResourceSet" />
<PreResources base="D:/Documents6/DEXPRO/Gentable" webAppMount="/WEB-INF/classes" className="org.apache.catalina.webresources.DirResourceSet" />
<PreResources base="D:/Documents6/DEXPRO/Skin" webAppMount="/" className="org.apache.catalina.webresources.DirResourceSet" />
<PreResources base="D:/Documents6/DEXPRO/Vue/www" webAppMount="/ext/dex" className="org.apache.catalina.webresources.DirResourceSet" />
<PreResources base="D:/Documents6/DEXPRO/SQUEEZE/www" webAppMount="/ext/dex" className="org.apache.catalina.webresources.DirResourceSet" />
</Resources>
</Context>
Sollte die Datei bereits existieren, müssen die Einträge hinzugefügt werden.
Wenn bereits Einträge bestehen, dann müssen die Skript-Importe zusammengefasst werden.
Bei einem Update älterer Invoice-Versionen ist darauf zu achten, dass der SQUEEZE-Ordner in den DEXPRO-Ordner umgezogen wurde und der Vue-Ordner hinzugekommen ist.