Automatisiertes Datenupgrade von Versionen 8.00–12.00 auf Version 24.00

  • 08/07/2024
  • 11 Minuten Lesedauer

Mit Document Capture Version 24.00 und Expense Management Version 24.00 veröffentlicht Continia Software eine kombinierte 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.

Wichtig

Beachten Sie, dass Document Capture 2024 R1 (24.00) und Expense Management 2024 R1 (24.00) nur verfügbar sind, 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/BC-Versionen verwenden, nicht auf DC24.00/EM24.00 aktualisieren können. Stattdessen müssen sie auf DC8.00 aktualisieren, da diese Version weiterhin mit Service Packs unterstützt wird.

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 Hauptupgrade automatisch durchgeführt, wenn Sie Document Capture 24.00 und/oder Expense Management 24.00 installieren.

Informationen zur Migration von der FOB-basierten Version von NAV/BC zur On-Premises-Erweiterung und/oder Cloud finden Sie unter Upgrading NAV/Business Central with Document Capture Installed und Migrating Document Capture from Business Central On-Premises to Cloud.

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 haben wir die Client- und Serverkomponenten von Document Capture aktualisiert, die Sie aktualisieren müssen, bevor Sie mit der Arbeit mit Document Capture und Expense Management beginnen. 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.

Wenn Document Capture und Expense Management noch nicht in Ihrem System installiert wurden, sollten Sie keine Informationen in diesem Dokument verwenden.

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 zusammenfassenden Abschnitt aufgeführt sind. Wenn nicht, ist es sehr wichtig, dass Sie der Upgrade-Anleitung von einer früheren Version auf DC8.00–12.00 und/oder EM8.00–12.00 folgen. Frühere Upgrade-Anleitungen finden Sie unter Supported Upgrade Paths for Continia Document Capture (FOB) und Supported Upgrade Paths for Continia Expense Management (FOB).

Aufgabe 2: Aktualisierte BC-Lizenzdatei importieren

Der Upgrade-Vorgang muss mit einer Partnerentwicklerlizenz durchgeführt werden.

Achten Sie nach dem Upgrade darauf, eine neue oder aktualisierte Kundenlizenzdatei von Microsoft zu verwenden.

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 und/oder Server) im Standardinstallationspfad. Wenn Ihr Installationspfad also vom Standardpfad von Microsoft abweicht, müssen Sie den neuen Ordner Add-ins in den Ordner kopieren, in dem sich Ihre Installation befindet.

Um Ihre Serverkomponenten zu aktualisieren, folgen Sie der Anleitung unten:


VersionAnleitung
BC14Führen Sie diese Schritte nur aus, wenn Sie Business Central April 2019 (BC14) verwenden:
  1. Beenden Sie „Business Central Server Server“.
  2. Deinstallieren Sie „Document Capture RTC Server Components“.
  3. Installieren Sie „Document Capture RTC Server Components“.
  4. Wenn Sie den Microsoft Business Central Server nicht am standardmäßigen Speicherort installiert haben, müssen Sie die Add-ins manuell vom standardmäßigen Speicherort zum aktuellen Speicherort Ihrer Installation verschieben.
  5. Starten Sie „Microsoft Business Central Server“.

Aufgabe 5: BC-Objekte und -Daten aktualisieren

Wichtig

Bevor Sie Objektänderungen vornehmen oder mit der Datenaktualisierung beginnen, sichern Sie unbedingt die Datenbank.

Importieren Sie die neuen DC24.00/EM24.00-Objekte aus dem Produktordner. Beachten Sie, dass bei einigen Objekten während des Imports möglicherweise eine Warnung angezeigt wird, da einige Teile der neuen Versionsliste ein geändertes Format aufweisen. Verwenden Sie Alle ersetzen im Import Worksheet. Stellen Sie die Schemasynchronisierung beim Objektimport auf Später ein.

Aufgabe 6: Datenaktualisierung

Befolgen Sie die nachstehende Anleitung, um die Schritte nach dem Upgrade abzuschließen:

  1. 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 „Alle ersetzen“ im Import Worksheet. Stellen Sie die Schemasynchronisierung beim Import auf Später ein.
  2. Kompilieren Sie alle Document Capture- und Expense Management-Objekte (Versionslistenfilter *DC*|*EM*|*CC*|*DN*|*BF*). Stellen Sie die Schemasynchronisierung auf Später ein.
  3. Kompilieren Sie alle MenuSuites (nicht nur DC und EM).
  4. Wählen Sie Tools -> „Sync. Schema For All Tables“ -> With Validation.
  5. Wählen Sie Tools -> „Data Upgrade“ -> „Start…“, um die Seite Start Data Upgrade zu öffnen.
  6. Wählen Sie unter Execution Mode die Option Serial aus und deaktivieren Sie anschließend das Kontrollkästchen unter Continue on Error. Wählen Sie OK, um die Seite zu schließen.

Die Datenaktualisierung sollte ohne Fehler abgeschlossen werden.

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 bei der Datenaktualisierung

  1. Falls das Datenupgrade fehlschlägt, müssen Sie den Powershell-Befehl Get-NAVDataUpgrade [ServerInstance] -ErrorOnly ausführen, um den eigentlichen Fehler herauszufinden, oder den Debugger mit „Debug Next“ verwenden.
  2. Bei einer Fehlermeldung wie „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.'.“ liegt ein Problem beim Herunterladen der Control Add-in-Ressourcen vor. Dieses Problem kann auftreten, wenn unsere Services ausgefallen sind, oder es könnte ein Problem mit der Server-Firewall sein.
  3. Sie können es erneut versuchen, indem Sie Tools ausführen -> “Data Upgrade” -> “Resume…”.
  4. Wenn derselbe Fehler auftritt, können Sie Codeunit 6086106 erstellen und die folgende Codezeile auskommentieren: CODEUNIT.RUN(CODEUNIT::"CDC Capture RTC Library");
  5. Führen Sie dann Tools -> “Data Upgrade” -> “Resume…” aus.
  6. Dadurch wird das Herunterladen des Control-Add-Ins beim Upgrade übersprungen. Daher müssen Sie es nach der Datenaktualisierung von der Document Capture Einrichtung-Seite manuell herunterladen: Wählen Sie auf der Registerkarte Aktionen die Optionen Continia Web Client-Add-Ins importieren und Client-Add-Ins importieren aus, um alle relevanten Add-Ins zu importieren.

Aufgabe 7: Clientkomponenten aktualisieren

Um Ihre Clientkomponenten zu aktualisieren, folgen Sie der Anleitung unten:


VersionAnleitung
BC14
  1. Deinstallieren Sie „Document Capture RTC Client“.
  2. Deinstallieren Sie „Document Capture RTC Components (Scanner)“.
  3. Client-Add-ins werden jetzt automatisch an alle BC Clients verteilt, wenn erforderlich.

Aufgabe 8: Nicht verwendete Anwendungs- und Upgradeobjekte löschen

Nach Abschluss des Upgrades entfernen Sie bitte 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 DC/EM-Objekte enthält. Importieren Sie nur die Objekte im ID-Bereich: 6086100..6086199

Dadurch wird sichergestellt, dass alle Objekte kompiliert werden und das Upgrade nicht versehentlich erneut gestartet wird.

Aufgabe 9: Das Continia Web Approval Portal aktualisieren

Um das Continia Web Approval Portal zu aktualisieren, gehen Sie folgendermaßen vor:

  1. Kompilieren Sie alle Document Capture- und Expense Management-Objekte (Versionslistenfilter *DC*|*EM*|*CC*|*DN*|*BF*).
  2. Führen Sie die Funktion Erzeuge Web Service aus der Continia-Webportal-Liste aus. Diese Funktion muss nur in einem Mandanten ausgeführt werden.
  3. Wenn Sie weiterhin das Continia Web Portal On-Premises verwenden, erstellen Sie eine neue Website in IIS oder aktualisieren Sie die vorhandene.
  4. Führen Sie die Funktion „Benutzer exportieren“ aus, um Webbenutzer von der Continia-Benutzerseite in BC zu exportieren.