Automated data upgrade from version 7.00 to version 8.00

Mit Document Capture Version 8.00 und Expense Management Version 8.00 veröffentlicht Continia Software eine kombinierte Upgrade-Anleitung, mit der unsere Partner Document Capture 7.00, Expense Management 7.00 oder ein System mit sowohl Document Capture 7.00 als auch Expense Management 7.00 aktualisieren können.

Wichtig

Diese Upgrade-Anleitung kann nur mit den Versionen von Dynamics NAV verwendet werden, die die Data Upgrade Tools von Microsoft unterstützen. (Microsoft Dynamics NAV 2016 und höher).

Diese Upgrade-Anleitung beschreibt das Upgrade von Document Capture and Expense Management mit dem automatisierten Datenupgrade auf die NAV-Version (NAV 2016 bis BC14), die aktuell mit Document Capture and Expense Management verwendet wird.

Wenn die Dynamics NAV-Version kein Datenupgrade unterstützt oder Sie nach dem manuellen Prozess vor und nach dem Upgrade suchen, finden Sie weitere Informationen unter Manuelles Upgrade von Version 7.00 auf Version 8.00.

Wenn Sie Document Capture oder Expense Management in Microsoft Dynamics Business Central Cloud verwenden, wird das Haupt-Upgrade automatisch durchgeführt, wenn Sie Document Capture 8.00 installieren.

Informationen zur Migration von einer FOB-basierten Version von NAV/BC zur On-Premises-Erweiterung und/oder Cloud finden Sie unter Upgrade von NAV/Business Central mit einer Installation von Document Capture und Document Capture von Business Central On-Premises zur Cloud migrieren.

Sie können dese Upgrade-Anleitung mit den folgenden Versionen von Document Capture und Expense Management verwenden:

Document Capture

  • Document Capture 7.00 mit einem beliebigen Service Pack

Expense Management

  • Expense Management 7.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.

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

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

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 wichtig, dass Sie der Upgrade-Anleitung von einer früheren Version auf DC7.00 und/oder EM7.00 folgen. Weitere Informationen finden Sie unter vorherigen Upgrade-Anleitungen:

Aufgabe 2: Eine aktualisierte NAV-Lizenzdatei importieren

Sie müssen eine Partnerentwicklerlizenz verwenden, um den Upgrade-Prozess durchzuführen. Achten Sie nach dem Upgrade darauf, eine neue oder aktualisierte Kundenlizenzdatei von Microsoft zu verwenden und diese in NAV zu importieren.

Wenn Sie den Dynamics NAV-Server verwenden, müssen Sie den Dynamics NAV-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: Alle Tools und Komponenten installieren

Sie müssen alle unten beschriebenen Installationen mit der ausführbaren Document Capture Setup-Datei durchführen, die sich im Stammverzeichnis des Produktordners (Setup.exe) befindet.

Hinweis

Das Installationsprogramm aktualisiert den Ordner Add-ins (Client und/oder 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.

Aufgabe 5: Serverkomponenten aktualisieren

Um Ihre Serverkomponenten zu aktualisieren, folgen Sie je nach Ihrer Version von NAV/Business Central einer der folgenden Anleitungen:


VersionAnleitung
NAV Server 2016 -> BC14Führen Sie die folgenden Schritte nur aus, wenn Sie Dynamics NAV 2016 -> Microsoft Dynamics 365 Business Central Frühjahr 2019 Update (BC14) verwenden:
  1. Stoppen “Microsoft Dynamics NAV Server”.
  2. Deinstallieren “Document Capture RTC Server Components”.
  3. Installieren Sie “die Document Capture RTC Serverkomponenten”.
  4. Wenn Sie’den Microsoft Dynamics NAV Server nicht am Standardspeicherort installiert haben, müssen Sie die Add-Ins manuell vom Standardspeicherort an den aktuellen Installationsort verschieben.
  5. Start “Microsoft Dynamics NAV Server”.
NAV RTC Upgrade PCFühren Sie nur die folgenden Schritte aus, wenn Sie Dynamics NAV RTC:
  1. auf dem Computer, auf dem Sie das Upgrade durchführen, verwenden Sie müssen ”Document Capture RTC Client” und ”Document Capture RTC Components (Scanner)”deinstallieren.
  2. Installieren Sie “Document Capture RTC Client”.
  3. Installieren Sie “Document Capture RTC Komponente (Scanner)” falls nötig.
  4. Wenn Sie’t installiert haben den Microsoft Dynamics NAV RTC Client in der Standardposition Sie müssen die Add-ins manuell von der Standardposition an den aktuellen Speicherort Ihrer Installation verschieben.

Aufgabe 6: NAV-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 DC8.00/EM8.00-Objekte aus dem Produktordner.
  2. Bei einigen Objekten wird während des Imports möglicherweise eine Warnung angezeigt, da einige Teile der neuen Versionsliste ein geändertes Format aufweisen. Verwenden Sie in Import Worksheet > Replace all.
  3. Beim Objektimport sollte Synchronize Schema auf Later eingestellt werden.

Warnung

Für alle Versionen von NAV 2013 bis Business Central Oktober 2018 (BC v13) gilt: Beim Importieren des DC8.00/EM8.00-Objektpakets überspringen Sie die folgenden vier Seiten. Die Seiten wurden unbeabsichtigt in die Release-Pakete aufgenommen – und werden in Service Pack 1 entfernt.

  • Seite 5 Währungen
  • Seite 10 Länder/Regionen
  • Seite 209 Maßeinheiten
  • Seite 472 MwSt.-Buchungsmatrix

Aufgabe 7: Nach dem Upgrade

So führen Sie den Schritt nach dem Upgrade aus:

  1. Importieren Sie das Objektpaket mit der folgenden Bezeichnung: “(Ihre NAV-Version) - Document Capture 8.00, Expense Management 8.00 - DataUpgrade.fob”.
  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*). Stellen Sie Synchronize Schema auf Later ein.
  5. Kompilieren Sie alle MenuSuites (nicht nur Document Capture und Expense Management).
  6. Führen Sie Tools -> Sync. Schema For All Tables -> With Validation aus.
  7. Wählen Sie Tools -> Data Upgrade -> Start…, um die Seite Start Data Upgrade zu öffnen.
  8. Wählen Sie unter Execution Mode die Option Serial aus.
  9. Deaktivieren Sie unter Continue on Error das Kontrollkästchen.
  10. Klicken Sie auf OK, um die Seite zu schließen.

Der Post-Upgrade Teil des Prozesses ist nun abgeschlossen.

Problembehandlung beim Datenupgrade

Falls das Daten-Upgrade fehlschlägt, versuchen Sie Folgendes:

  1. Falls das Datenupgrade fehlschlägt, müssen Sie den Powershell-Befehl Get-NAVDataUpgrade [ServerInstance] -ErrorOnly ausführen, 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 '6086102' 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 6086102 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 8: Clientkomponenten aktualisieren

Um Ihre Clientkomponenten zu aktualisieren, verwenden Sie die entsprechende Anleitung für Ihre Version von NAV/Business Central aus der folgenden Tabelle.


VersionAnleitung
NAV RTC Clients 2016Führen Sie nur die folgenden Schritte aus, wenn Sie Dynamics NAV 2016 verwenden:
  1. “Deinstallieren Sie Document Capture RTC Client Components”.
  2. “Installieren Sie Document Capture RTC Client Components”.
NAV RTC Clients 2017 -> 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 NAV Clients verteilt, wenn erforderlich.

Aufgabe 9: Upgrade-Objekte löschen

Nach Abschluss des Upgrades entfernen Sie die Upgrade-Objekte (alle Objekttypen, mit Force):

Filter: 6086100..6086199

Hinweis

Bei älteren Versionen als NAV 2015 müssen die Upgrade-Tabellen vor dem Löschen manuell geleert werden.

Aufgabe 10: Das Continia Web Approval Portal aktualisieren

Die letzte Aufgabe im Upgrade-Prozess ist die Aktualisierung des Continia-Webportals:

  1. Abhängig von der Version, die Sie verwenden, müssen die Web-Portal-Objekte entweder importiert werden oder sie sind bereits enthalten:
    • Für Versionen von NAV 2009 R2 und älter: Wenn Sie NAV-Objekte aus diesen frühen Versionen verwenden, müssen Sie die aktualisierten Web-Portal-Objekte aus dem Produktordner importieren.
    • Für NAV 2009 R2 und spätere Versionen sind diese Objekte im Basispaket enthalten.
  2. Kompilieren Sie alle Document Capture- und Expense Management-Objekte (Versionslistenfilter *DC*|*EM*|*CC*|*DN*).
  3. Führen Sie die Funktion Erzeuge Web Service aus der Continia-Webportal-Liste aus. Diese Funktion muss nur in einem Mandanten ausgeführt werden.
  4. Wenn Sie weiterhin das Continia Web Portal On-Premises verwenden, erstellen Sie eine neue Website in IIS oder aktualisieren Sie die vorhandene.
  5. Führen Sie die Funktion Benutzer exportieren aus, um Webbenutzer von der Continia-Benutzerseite in NAV zu exportieren.

Informationen zum Thema

Manuelles Upgrade von Version 7.00 auf Version 8.00