Automatisiertes Datenupgrade von Versionen 8.00–12.00 auf Version 24.00
Mit Document Capture Version 24.00 und Expense Management Version 24.00 veröffentlicht Continia Software eine Upgrade-Anleitung, mit dem unsere Partner Document Capture 8.00–12.00, Expense Management 8.00–12.00 oder ein System mit sowohl Document Capture 8.00–12.00 als auch Expense Management 8.00–12.00 aktualisieren können.
In dieser Upgrade-Anleitung wird das Upgrade von Document Capture und Expense Management mit dem automatisierten Datenupgrade auf BC14 beschrieben. Informationen zum manuellen Pre- und Post-Upgrade-Prozess finden Sie unter Manuelles Upgrade von Versionen 8.00–12.00 auf Version 24.00.
Wenn Sie Document Capture oder Expense Management in Microsoft Business Central Cloud verwenden, wird das Haupt-Upgrade automatisch durchgeführt, wenn Sie Document Capture 24.00/Expense Management 24.00 installieren.
Informationen zur Migration einer FOB-basierten Version von NAV/Business Central zu einer On-Premises-Erweiterung/Cloud-Version, finden Sie unter Upgrade von NAV/Business Central mit einer Installation von Expense Management und Expense Management von Business Central On-Premises zur Cloud migrieren.
Voraussetzungen
Wichtig
Wenn Document Capture und Expense Management noch nicht in Ihrem System installiert wurden, sollten Sie nicht die Informationen in diesem Dokument verwenden.
Diese Upgrade-Anleitung kann mit den folgenden Versionen von Document Capture und Expense Management verwendet werden:
Document Capture
- Document Capture 8.00 mit einem beliebigen Service Pack
- Document Capture 9.00 mit einem beliebigen Service Pack
- Document Capture 10.00 mit einem beliebigen Service Pack
- Document Capture 11.00 mit einem beliebigen Service Pack
- Document Capture 12.00 mit einem beliebigen Service Pack
Expense Management
- Expense Management 8.00 mit einem beliebigen Service Pack
- Expense Management 9.00 mit einem beliebigen Service Pack
- Expense Management 10.00 mit einem beliebigen Service Pack
- Expense Management 11.00 mit einem beliebigen Service Pack
- Expense Management 12.00 mit einem beliebigen Service Pack
Wenn auf dem System eine ältere Version läuft, müssen Sie zunächst auf die erforderlichen Versionen aktualisieren (8.00).
In dieser Version wurden die Client- und Serverkomponenten von Document Capture aktualisiert. Das bedeutet, dass Sie diese Komponenten aktualisieren müssen, bevor Sie mit Document Capture und Expense Management arbeiten können. Diese Anleitung hilft Ihnen bei der richtigen Ausführung.
Die Document Capture- und Expense Management-Objekte in dieser Version sind nicht abwärtskompatibel mit älteren Komponenten, ebenso wie die in dieser Version enthaltenen Komponenten nicht abwärtskompatibel mit älteren Objekten sind.
Wichtig
Document Capture 2024 R1 (24.00) und Expense Management 2024 R1 (24.00) sind nur verfügbar, wenn Sie eine der folgenden Versionen von Business Central verwenden:
- Business Central 2024 Release Wave 1 (BC v24)
- Business Central 2023 Release Wave 2 (BC v23)
- Business Central 2023 Release Wave 1 (BC v22)
- Business Central April 2019 (v14, FOB-basiert)
Dies bedeutet, dass Kunden, die ältere NAV/Business Central-Versionen verwenden, nicht auf DC24.00/EM24.00 aktualisieren können. Stattdessen müssen sie auf DC8.00 aktualisieren, da diese Version mit Service Packs unterstützt wird.
Aufgabe 1: Mindestversionsanforderungen prüfen
Stellen Sie sicher, dass auf Ihrem aktuellen System eine der unterstützten Versionen von Document Capture oder Expense Management ausgeführt wird, die im Abschnitt Voraussetzungen aufgeführt sind. Falls dies nicht der Fall ist, müssen Sie der Upgrade-Anleitung von einer früheren Version auf DC8.00–12.00 und/oder EM8.00–12.00 folgen. Weitere Informationen finden Sie unter vorherigen Upgrade-Anleitungen:
- Für Document Capture: Unterstützte Upgradepfade für Continia Document Capture (FOB) (nur für Partner verfügbar)
- Für Expense Management: Unterstützte Upgradepfade für Continia Expense Management (FOB) (nur für Partner verfügbar)
Aufgabe 2: Eine aktualisierte Business Central-Lizenzdatei importieren
Sie müssen eine Partnerentwicklerlizenz verwenden, um den Upgrade-Prozess durchzuführen. Achten Sie nach dem Upgrade darauf, eine neue/aktualisierte Kundenlizenzdatei von Microsoft zu verwenden und diese in NAV zu importieren.
Sie müssen den Business Central Server neu starten, um die neue Lizenz zu verwenden.
Aufgabe 3: Objekte zusammenführen
Wenn Sie das System Ihres Kunden geändert haben, prüfen Sie, ob die geänderten Objekte mit Document Capture- oder Expense Management-Objekten in Konflikt stehen, und führen Sie sie bei Bedarf zusammen. Sie sollten Objekte in einem Testsystem zusammenführen, damit sie für den späteren Import im Upgrade-Prozess bereit sind.
Aufgabe 4: Serverkomponenten aktualisieren
Sie müssen alle unten beschriebenen Installationen mit der ausführbaren Datei Setup durchführen, die sich im Stammverzeichnis des Produktordners (Setup.exe) befindet.
Hinweis
Das Installationsprogramm aktualisiert den Ordner Add-ins (Client/Server) unter dem Standardinstallationspfad. Wenn Ihr Installationspfad also vom Standardpfad von Microsoft abweicht, kopieren Sie den neuen Ordner Add-ins unbedingt in den Ordner, in dem sich Ihre Installation befindet.
Um Ihre Serverkomponenten zu aktualisieren, verwenden Sie die folgende Anleitung:
| Version | Anleitung |
|---|---|
| BC14 | Führen Sie diese Schritte nur aus, wenn Sie Business Central April 2019 (BC14) verwenden:
|
Aufgabe 5: Business Central-Objekte und -Daten aktualisieren
Wichtig
Bevor Sie Objekte ändern oder mit dem Daten-Upgrade beginnen, sichern Sie zuerst die Datenbank.
- Importieren Sie die neuen DC24.00/EM24.00-Objekte aus dem Produktordner. Bei einigen Objekten wird während des Imports möglicherweise eine Warnung angezeigt wird, da einige Teile der neuen Versionsliste ein geändertes Format aufweisen.
- Verwenden Sie in Import Worksheet > Replace all.
- Beim Objektimport sollte Synchronize Schema auf Later eingestellt werden.
Aufgabe 6: Schritte nach dem Upgrade abschließen
So führen Sie den Schritt nach dem Upgrade aus:
- Importieren Sie das Objektpaket mit dem Namen “BC14 - DC8.00-DC11.00 to DC24.00, EM8.00-EM11.00 to EM24.00 – Direct Upgrade Post”.
- Verwenden Sie in Import Worksheet > Replace all.
- Beim Import sollte Synchronize Schema auf Later eingestellt werden.
- Kompilieren Sie alle Document Capture- und Expense Management-Objekte (Versionslistenfilter *DC*|*EM*|*CC*|*DN*|*BF*). Stellen Sie Synchronize Schema auf Later ein.
- Kompilieren Sie alle MenuSuites (nicht nur Document Capture und Expense Management).
- Führen Sie Tools -> Sync. Schema For All Tables -> With Validation aus.
- Wählen Sie Tools -> Data Upgrade -> Start…, um die Seite Start Data Upgrade zu öffnen.
- Wählen Sie unter Execution Mode die Option Serial aus.
- Deaktivieren Sie unter Continue on Error das Kontrollkästchen.
- Klicken Sie auf OK, um die Seite zu schließen.
Die Datenaktualisierung sollte ohne Fehler abgeschlossen werden. Der Post-Upgrade Teil des Prozesses ist nun abgeschlossen.
Hinweis
Das Einkaufsvertragsadministrator-Feld ist dann in der Continia-Benutzer-Einrichtung veraltet. Daher muss den Einkaufsvertragsadministrator-Benutzern nach dem Upgrade der Berechtigungssatz CDC-PC-ADMIN zugewiesen werden.
Problembehandlung beim Datenupgrade
Falls das Daten-Upgrade fehlschlägt, versuchen Sie Folgendes:
- Führen Sie den Powershell-Befehl Get-NAVDataUpgrade [ServerInstance] -ErrorOnly aus, um den eigentlichen Fehler herauszufinden, oder den Debugger mit Debug Next verwenden.
- Wenn Sie die folgende Fehlermeldung erhalten, bedeutet dies, dass ein Problem beim Herunterladen der Control-Add-In-Ressourcen vorliegt. Dieses Problem kann auftreten, wenn Continias Services ausgefallen sind, oder es könnte ein Problem mit der Server-Firewall sein.
- “Function 'UpdatePerDatabase' in the upgrade codeunit '6086106' has failed because of the following error: 'A call to System.Net.WebClient.DownloadData failed with this message: The remote server returned an error: (404) Not Found.'.”
- Versuchen Sie es erneut, indem Sie Tools > Data Upgrade > Resume… ausführen.
- Wenn derselbe Fehler auftritt, können Sie Codeunit 6086106 erstellen und die folgende Codezeile auskommentieren: CODEUNIT.RUN(CODEUNIT::"CDC Capture RTC Library");
- Führen Sie dann Tools > Data Upgrade > Resume… aus.
- Dies überspringt das Herunterladen des Control Add-ins beim Upgrade. Daher müssen Sie es nach dem Daten-Upgrade manuell von der Seite Document Capture Einrichtung herunterladen:
- Klicken Sie auf der Registerkarte Aktionen auf Continia Web Client Add-Ins importieren > Client Add-Ins importieren, um alle relevanten Add-Ins zu importieren.
Aufgabe 7: Clientkomponenten aktualisieren
Um Ihre Clientkomponenten zu aktualisieren, verwenden Sie die folgende Anleitung:
| Version | Anleitung |
|---|---|
| BC14 |
|
Aufgabe 8: Nicht verwendete Anwendungs- und Upgradeobjekte löschen
Nach dem Upgrade der Clientkomponenten sollten Sie sicherstellen, dass alle Objekte kompiliert werden und das Upgrade nicht versehentlich erneut gestartet wird.
So löschen Sie nicht verwendete Anwendungs- und Upgradeobjekte:
- Entfernen Sie die Upgrade-Objekte (Alle Objekttypen, mit Force): Filter: 6086100..6086199
- Nach dem Löschen der Upgrade-Objekte importieren Sie die Upgrade-Platzhalterobjekte aus der Fob-Datei, die die neuen Document Capture/Expense Management-Objekte enthält. Importieren Sie nur die Objekte im ID-Bereich: 6086100..6086199
Aufgabe 9: Das Continia Web Approval Portal aktualisieren
Die letzte Aufgabe im Upgrade-Prozess ist die Aktualisierung des Continia-Webportals:
- Kompilieren Sie alle Document Capture- und Expense Management-Objekte (Versionslistenfilter *DC*|*EM*|*CC*|*DN*|*BF*).
- Führen Sie die Funktion Erzeuge Web Service aus der Continia-Webportal-Liste aus. Diese Funktion muss nur in einem Mandanten ausgeführt werden.
- Wenn Sie weiterhin das Continia Web Portal On-Premises verwenden, erstellen Sie eine neue Website in IIS oder aktualisieren Sie die vorhandene.
- Führen Sie die Funktion Benutzer exportieren aus, um Webbenutzer von der Continia-Benutzerseite in Business Central zu exportieren.