Documents5 Installations-Ordner

VorZu den Anpassungenaktuellen amInvoice-Versionen Ordnerwerden müssenpassende dieUpdate-Pakete Dienstebereitgestellt. fürDiese den TableService, für Documents und für den Tomcat gestoppt werden. Fürerleichtern das Updatevorgehen bietetbei esUpdates. sich in der Regel an alles zu übernehmen und im Anschluss die Anpassungen wieder zurück zu schreiben. 

Es wird empfohlen den kompletten "Documents5"-Ordner aus demDas Update-Paket zuenthält übernehmen!einen Dieseparaten Konfigurations-DateienOrdner können"Documents5".Dieser späterOrdner überenthält nur die WEB-Administrationfür neuein konfiguriertUpdate werden.relevanten Ordner.

Vor dem Update sollten diese Ordner gesichert werden um projektspezifische Anpassungen zurückspielen zu können!

 

DEXPRO

Es wird empfohlen den DEXPRO-Ordner aus dem Update-Paket über die aktuelle Installation zu kopieren. Am DEXPRO-Ordner wurden in der Regel nur dieDie Konfigurationsdateien "dbConn.json",json" ggf.und die "navConn.json" bei einer Anbindung an Navisionjson" sowie die KonfigurationsdateienKonfiguration für den Table-Service angepasst.sind Diein ursprünglichendem DateienUpdate-Ordner ausnicht enthalten. Entsprechend gehen keine Informationen verloren!

DEXPRO\Licence

Lizenzen werden erst ab der SicherungVerion dürfen1.0.300 nichtverwendet. einfachBei zurückgetauschteinem werden,Update denneiner ggf.älteren wurdenVersion diemuss Dateieneine erweitert!

Lizenz

 beantragt und hier abgelegt werden!

DEXPRO\ScriptExits

AnDie diesemDatei Ordner"GridColumnAggregator.js" wird in Projekten häufiger angepasst! Generell sollten keine Anpassungen vorgenommengut werden!dokumentiert Anpassungenwerden solltenund immerdie inSicherung dendes OrdnerOrdners DEXPRO_ClientExitsist ausgelagertentsprechend werden. 

 wichtig!

DEXPRO\Table-Service

SollteIn der TableServiceUpdate-Version außerhalbist lediglich der Documents-InstallationOrdner liegen,"data" müssenenthalten. Dieser Ordner enthält die DateienStandard-TableService Tabellen-Konfigurationen und diese sollten in diesenden externenProjekten Installations-Ordner kopiert werden. Die Konfigurations-Dateien müssen bei einer externen Installation manuellnie angepasst werden. AlternativProjektspezifische kannKonfigurationen diesollten externeimmer Installationim auf"Custom"-Ordner angelegt werden. Statt bestehende Konfigurationen zu verändern sollten Konfigurationen in den Standard"Custom" umgestelltkopiert werden,und indemdort verändert werden. Hierzu sollte der aktuelleEintrag Dienst"nameApi" deinstalliertum wirdein vorangestelltes "Custom_" erweitert werden und der Aufruf - welcher in der Regel aus UserExit-Skripten heraus erfolgt muss entsprechend angepasst werden. Dieses Vorgehen verinfacht Updates enorm. Andernfalls müssen projektspezifische Anpassungen mnach dem Update identifiziert und manuell zurückgespielt werden.

Nach dem Update muss der TableService-Dienst imneu Standard-Pfadgestartet überwerden. dieDa WEB-Administrationeinige wiederKonfigurationen installiertauf wird.

neue

Projektspezifischeund Anpassungenggf. noch nicht existierende Tabellen zugreifen, sollte der Neustart erst am TableServiceEnde müssendes inUpdates jedem Fall wieder zurückgespielt werden! Der TableService muss später über die WEB-Administration neu konfiguriert werden. Deinstallierte Dienste müssen wieder wieder installiert werden.erfolgen.

 

DEXPRO_ClientExits

Die hier befindlichen Dateien dürfen explizit projektspezifisch angepasst werden.und Dieerweitert Anpassungen sind durch das Update vorerst verloren gegangenwerden und müssen manuell wieder zurück übertragen werden! Die aktuellen Dateien können neue Funktionen enthalten oder es können bestehende Funktionen optimiert worden sein. Aus diesem Grund sollten die projektspezifisch angepassten Dateien nicht einfach zurück kopiert werden!

Projektspezifische Anpassungen sollten immer gut identifizierbar mit Kommentaren versehen werden! Bei vielendiese projektspezifischen Anpassungen kannsollen nicht wieder durch die ÜbertragungStandard-Funktionen entsprechendersetzt werden. Es wird empfohlen die Dateien manuell abzugleichen. Dabei müssen lediglich nicht vorhandene Funktionen hinzugefügt werden. Der Abgleich bestehender Funktion auf Anpassung ist zu aufwändig sein!und sollte nur in Betracht gezogen werden, wenn die Funktionen beim Kunden Probleme bereiten.

 

server\locale

In das "server"-Verzeichnis werden die aktuellen "properties"properties"-Dateien kopiert. DieProjektspezifische Anpassungen sollten auch als "projektspezifischen Anpassung" gekennzeichneten Übersetzungen stehenAnpassung" in der Datenbank undgekennzeichnet werdenworden spätersein beim- andernfalls gehen diese Anpassungen verloren. Beim Hochladen der properties in die Datenbank werden die als projektspezifische Anpassung markierten Einträge nicht überschrieben.überschrieben und manuell hinzugefügte Einträge bleiben in der Datenbank ebenfalls bestehen. Wenn die properties wieder aus den Daten aus der Datenbank geschrieben wird, dann enthalten die neuen properties alle Neuerungen plus die projektspezifischen Anpassungen.

 

SQUEEZE

DurchDie dasDatei Überschreiben"SqueezeConfig.js" der Konfigurationsdateien gehtenthält die Verbindung zum Squeeze-SystemSystem. verloren.Diese DieDatei wird durch das Update nicht überschrieben.  Allerdings wurde der Aufbau der Datei in einer Version geändert. Somit kann es sein, dass die Verbindung musszu späterSqueeze über die WEB-Administrationtrotzdem neu konfiguriert werden und es sollte ein neuer API-Key generiert werden.

Um zu vermeiden, dass die neuen Administrations-Oberflächen in Documents noch nicht vorhandene API-Funktionen aus Squeeze aufrufen, sollte auch Squeeze auf eine aktuelle Version aktualisiert werden.muss.

 

tomcat8\conf\Documents\localhost

Hier empfiehlt es sich die "documents.xml" aus der Sicherung zu verwenden. Erweiterungen aus der aktuellen Datei-Version müssen zunächst in die alte Datei-Version übernommen werden! Im Anschluss kann die alte Datei verwendet werden.

 

Zusammenfassung

• Dienste stoppen (Documents/Tomcat/TableService)
• Ordner "Documents5" aus dem Update-Paket über die Installation kopieren.
• Projektspezifische Anpassungen wieder herstellen (DEXPRO_ClientExits)
• "documents.xml" aus Sicherung zurück auf Erweiterungen überprüfen und zurück kopieren