Automatisiertes Datenupgrade von Versionen 8.00–24.00 auf Version 25.00

  • 28.01.2026
  • 12 Minuten Lesedauer

Dies ist eine kombinierte Upgrade-Anleitung für das Release von Document Capture Version 25.00 und Expense Management Version 25.00. Partner können diese Anleitung verwenden, um Document Capture 8.00–24.00, Expense Management 8.00–24.00 oder ein System mit sowohl Document Capture 8.00–24.00 als auch Expense Management 8.00–24.00 zu aktualisieren.

Verwenden Sie diese Anleitung, um Document Capture und Expense Management mit dem automatisierten Datenupgrade auf BC14 zu aktualisieren. Informationen zum manuellen Pre- und Post-Upgrade-Prozess finden Sie unter Manuelles Upgrade von Versionen 8.00–24.00 auf Version 25.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 25.00/Expense Management 25.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
  • Document Capture 24.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
  • Expense Management 24.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 R2 (25.00) und Expense Management 2024 R2 (25.00) sind nur verfügbar, wenn Sie eine der folgenden Versionen von Business Central verwenden:

  • Business Central 2024 Release Wave 2 (BC v25)
  • Business Central 2024 Release Wave 1 (BC v24)
  • Business Central 2023 Release Wave 2 (BC v23)
  • Business Central April 2019 (v14, FOB-basiert)

Dies bedeutet, dass Kunden, die ältere NAV/Business Central-Versionen verwenden, nicht auf DC25.00/EM25.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–24.00/EM8.00–24.00 folgen. Weitere Informationen finden Sie unter vorherigen Upgrade-Anleitungen:

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, müssen Sie den neuen Ordner Add-ins in den Ordner kopieren, in dem sich Ihre Installation befindet.

Um Ihre Serverkomponenten zu aktualisieren, verwenden Sie die folgende Anleitung:

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: Business Central-Objekte und -Daten aktualisieren

Wichtig

Bevor Sie Objekte ändern oder mit dem Daten-Upgrade beginnen, sichern Sie zuerst die Datenbank.

  1. Importieren Sie die neuen DC25.00/EM25.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.
  2. Verwenden Sie in Import Worksheet > Replace all.
  3. 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:

  1. Importieren Sie das Objektpaket mit dem Namen “BC14 - DC8.00-D24.00 to DC25.00, EM8.00-EM24.00 to EM25.00 – Direct Upgrade Post”.

  2. Verwenden Sie in Import Worksheet > Replace all.

  3. Beim Import sollte Synchronize Schema auf Later eingestellt werden.

  4. Kompilieren Sie alle Document Capture- und Expense Management-Objekte (Versionslistenfilter *DC*|*EM*|*CC*|*DN*|*BF*|*CA*). Stellen Sie Synchronize Schema auf Later ein. Einige Objekte von Document Capture/Expense Management werden möglicherweise nicht kompiliert. Sie werden später im Upgrade-Prozess gelöscht.

  5. Wenn Sie MS Dynamics NAV 2019 Frühjahr oder früher verwenden, aktualisieren Sie die Workflow-Vorlagen. In der aktuellen Version wurden die Workflow-Vorlagen aktualisiert und müssen in jedem Mandanten manuell aktualisiert werden. Gehen Sie hierzu wie folgt vor:

    1. Deaktivieren Sie die aktuellen Workflows, die mit Expense Management verknüpft sind (sie haben das Präfix CEM).
    2. Führen Sie die Codeunit 6086372 – CEM-Workflow-Setup manuell aus, wodurch neue Workflow-Vorlagen generiert werden.
    3. Erstellen Sie aus jeder dieser Vorlagen neue Workflows. Denken Sie daran, die Workflows nach ihrer Erstellung zu aktivieren

  6. Kompilieren Sie alle MenuSuites (nicht nur Document Capture und Expense Management).

  7. Führen Sie Tools -> Sync. Schema For All Tables -> With Validation aus.

  8. Wählen Sie Tools -> Data Upgrade -> Start…, um die Seite Start Data Upgrade zu öffnen.

  9. Wählen Sie unter Execution Mode die Option Serial aus.

  10. Deaktivieren Sie unter Continue on Error das Kontrollkästchen.

  11. 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.

Problembehandlung beim Datenupgrade

  1. Falls das Datenupgrade fehlschlägt, führen Sie den Powershell-Befehl Get-NAVDataUpgrade [ServerInstance] -ErrorOnly aus, um den eigentlichen Fehler herauszufinden, oder verwenden Sie den Debugger mit Debug Next.
  2. Wenn Sie die 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.”
  3. Sie können es erneut versuchen, indem Sie Tools > Data Upgrade > Resume… ausführen.
  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 dem Datenupgrade manuell von der Seite Document Capture Einrichtung herunterladen:
    • Klicken Sie auf der Registerkarte Aktionen auf Import Continia Web Client Add-Ins > Import Client Add-Ins, um alle relevanten Add-Ins zu importieren.

Aufgabe 7: Clientkomponenten aktualisieren

Um Ihre Clientkomponenten zu aktualisieren, verwenden Sie die folgende Anleitung:

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 Business Central-Client verteilt, wenn erforderlich.

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:

  1. Entfernen Sie die Upgrade-Objekte (Alle Objekttypen, mit Force): Filter: 6086100..6086199
  2. 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:

  1. Kompilieren Sie alle Document Capture- und Expense Management-Objekte (Versionslistenfilter *DC*|*EM*|*CC*|*DN*|*BF*|*CA*).
  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 Business Central zu exportieren.

Informationen zum Thema

Manuelles Upgrade von Versionen 8.00–24.00 auf Version 25.00