Documents5 XML Importe

DieDas AnpassungenUpdate-Paket amenthält Invoice-Standard werden Form von XML-Import-Dateien zur Verfügung gestellt. Es können - wenn nicht anders beschrieben -nur die Installations-für das Update benötigten XML-Dateien verwendet werden. Da nicht alle XML importiert werden sollten, sollte diese Anleitung gut gelesen werden!Dateien!

 

Update Portal-Skripte

ImDie ersten Schritt werden die verschlüsselten Skripte aktualisiert.können Hierfürgesammelt kannals die XML-Import-Datei aus dem Installations-OrdnerXML importiert werden. Hierfür werden passende XML-Import-Dateien bereitgestellt. Es wird jedoch nicht nur der Skript-Inhalt, sondern auch die Skript-Eigenschaften überschrieben und das wirkt sich vor allem auf die Job-Skripte aus!

• Die Einstellungen an den konfigurierten Job-Skripten sollten vor dem Update notiert werden, denn die Einstellungen werden durch das Update überschrieben!
Jobs könnten deaktiviert oder wieder aktiviert werden oder werden zu anderen Zeitpunkten ausgeführt! Daher sollten die Einstellungen vorab notiert werden und müssen nach dem Update wieder manuell hergestellt werden.

Die User-Exit-UserExit-Skripte dürfen beliebig projektspezifisch angepasst und erweitert werden. Aus diesem Grund sollten diesedie angepassten Skripte regelmäßig gesichert werden.

Auch

Das wennUpdate keinePakte Anpassungenenthält analle denUserExit-Skripte Skriptenals vorgenommenEinzel-XML-Export wurdenund könnendiese diewerden neuenpro Skript-VersionenKategorie Beispiel-Konfigurationenin enthalten,einem dieseparaten imOrdner Projektabgelegt. Die noch nicht gewünschtexistierenden sind!Skripte müssen importiert werden. Die Skripte aus der Skript-Kategorie "Dexpro_UserExit_NavScripts" werden nur bei einer Navision-Anbindung benötigt.

Die UserExit-bereits existierenden Skripte müssen nicht zwingend angepasst werden. Folgende Anpassungen werden daherempfohlen:

einzeln

• DEXPRO__UserExit_AfterLogin
  Das Skript soll als XML-ExportEigenschaft bereitgestellt."afterLoginScript" Hieram mussMandanten inhinterlegt jedemwerden.
Einzelfall
• DEXPRO__UserExit_Autocomplete
  Einträge entschiedenzu werden,neuen obFeldern einkönnen Skript bestehen bleibt oder ausgetauschtübernommen werden
soll.
• DEXPRO__UserExit_TechActionLib
  In Manchmalder aktuellen Version enthalten die neuenFunktionen Skript-Versioneneinen sinnvolleParameter Optimierungen"log". Bei den beim Kunden verwendeten Funktionen sollte der Parameter ergänzt und Beispiel-Konfigurationenvorhandene fürutil.out() neuesollten Funktionendurch log.info() bzw. log.err() ersetzt werden. Das erleichtert die Supportfälle.
  In der Funktion ue_Archiving() wird vor der Archivierung die sqz-Datei vom Squeeze-Register entfernt und eindas häufigerRegister Grundwird fürausgeblendet. UpdatesNach sindder neueArchivierung Features.wird Ausder diesemArchivKey Grundder kannMappe esin sichdie lohnenTabelle einigeInvoice_Posting_Head Funktionengeschrieben. abzugleichen.Diese Neu hinzugekommene UserExit-SkripteParts sollten importiert- wenn noch nicht vorhanden - übernommen werden.

 

In jedem Fall müssen die vorhandenen UserExit-Skripte mit den neuen Skripten auf neue UserExit-Skripte abgeglichen werden. Fehlende Skripte können bei einem Update zu fehlern führen.

 

Update Workflow

Der Workflow muss nur importiert werden, wenn sich die Versionsnummer geändert hat. Nach dem Update des Mappentypen muss der aktuelle Workflow als Standard-Workflow hinterlegt werden. So lange wie einige Mappen noch ältere Workflow-Versionen verwenden, müssen diese Workflows unter "Zulässige Workflows" gelistet sein!

Wenn die Documents-Lizenz keine freie Workflow-Lizenz enthält muss der alte Workflow deaktiviert werden. Die bestehenden Mappen laufen trotzdem mit dem alten Workflow weiter. Es können nur keine neuen Workflows mit der alten Workflow-Version gestartet werden. Neu angelegte Mappen starten mit der neuen Version.

 

UpdateManueller MappentypenAbgleich Invoice Mappentyp / ManuellerUpdate AbgleichotrAccessProfile und otrUser

An dieser Stelle werden explizit beide Varianten vorgestellt. In der Regel wird am Mappentypen "Invoice" zu viel angepasst.angepasst, Dasum betrifftan dieser Stelle ein Mappentyp-Update empfehlen zu können. Ein Mappentyp-Update verändert die Feldreihenfolge auf allen Registern;Registern auchund inalle Feldeigenschaften werden auf den Standard zurückgesetzt. Die Trefferlisten und Suchmasken,Suchmasken diewerden Anlage neuer Felder sowie die Anlage neuer benutzerdefinierter Aktionenüberschrieben und weitereralle Anpassungen.weiteren Durch das Einspielen des Update-MappentypenAnpassungen werden alle Anpassungenggf. wieder überschrieben!zurückgestellt und müssen zeitaufwändig wieder angepasst werden. Aus diesem Grund wird von einem Mappentyp-Update dringen abgeraten!

Die projektspezifischen Anpassungen am Mappentypen müssen demnach sehr gut dokumentiert werden, wenn diese Variante gewählt wird. Die Wiederherstellung der einzelnen projektspezifischen Anpassungen ist sehr zeitaufwändig.

Projektspezifisch hinzugefügte Felder werden durch den XML-Update-Mappentypen nach ganz oben verschoben und müssen manuell wieder an die korrekte Stelle geschoben werden. Auch die Anordnung der Standard-Felder und projektspezifisch angepasste Standard-Feld-Eigenschaften gehen verloren und müssen manuell wieder hergestellt werden.

Angepasste Standard-Feld-Eigenschaften sollten alternativ durch die WEB-Feld-Administration umgesetzt werden. Hierdurch erspart man sich die Anpassung am Mappentypen bei späteren Updates.

Alternativ besteht die Möglichkeit des manuellen Abgleichs, indem man den Mappentypen auf dem Kundensystem öffnet und parallel die neue Version des Mappentypen auf einem zweiten Monitor öffnet. die Felder sollte man alphabetisch sortiert anzeigen lassen. Dadurch werden fehlende Felder schnell erkannt und können manuell hinzugefügt werden. Schwierig ist es, wenn Feldeigenschaften hinzugefügt wurden, wie zum Beisipel eine Autocomplete-Funktion auf dem Kreditor-Namen oder der Bestellnummer. Hierfür ist es ratsam die Änderungen in der "INVOICE_CHANGELOG.md" zu lesen.

Ähnlich kann man bei den benutzerdefinierten Aktionen vorgehen. Neue Mappeneigenschaften können - müssen aber nicht zwingend übernommen werden.

Wenn nach den Anpassungen ein "Mappen ändern" durchgeführt werden muss, dann werden alle durch den Workflow angepassten Feldeigenschaften auf die Standardwerte zurückgesetzt. In diesem Fall muss der JOB "Invoice_JOB_SetFieldConfig" ausgeführt werden. Dieser führt für alle Invoice-Akten die Aktion "Feldkonfiguration laden" aus.

 

Update öffentliche Ordner

Bei den öffentlichen Ordnern muss zwischen den Outbars "Invoice" und den Administrations-Outbars unterschieden werden. Die Ordner auf der Outbar "Invoice" wurden bereits im Projekt passend für den Kunden ein- und ausgeblendet und gegebenenfalls wurden projektspezifische Ordner hinzugefügt; benutzerdefinierte Aktionen an Ordnern hinzugefügt und Zugriffsberechtigungen gesetzt. Die komplette Konfiguration entspricht in der Regel bereits genau dem, was der Kunde sehen möchte und durch ein Update auf die neueste Invoice-Version würden größtenteils nicht benötigte Ordner importiert. Hier ist die Empfehlung nur sinnvolle Neuerungen zu übernehmen. Unter "XML SingleExports\Folders\Invoice\" befinden sich die einzelnen XML-Importe zu den Ordnern. Hier können einzelne XML importiert werden.

Bei den Administrations-Ordnern werden hingegen häufig nur wenige bis gar keine Anpassungen vorgenommen. Hier empfiehlt es sich die große XML für den Import der Administrations-Outbar plus Sub-Outbars plus Ordner erneut zu importierten. Dabei werden bestehende Outbars und Ordner überschrieben und neue Ordner werden hinzugefügt.