Menü der Dokumentation

Nachvollziehen von Migrationsfehlern

Folgende Maßnahmen können beim Nachvollziehen von Migrationsfehlern helfen:

Einsehen der Migrationsoberfläche und des Migrationsreports (PDF-Datei)

Einen Überblick über die Anzahl aufgetretener Fehler erhalten Sie in der Migrationsoberfläche, in der die Fehler des letzten Migrationsdurchlaufs tabellarisch angezeigt werden. Einen Gesamtüberblick über alle Fehler in allen Migrationsläufen finden Sie im Migrationsbericht. Den Migrationsbericht können Sie unter Migrationsbericht herunterladen. Im Folgenden erfahren Sie weitere Einzelheiten zum Nachvollziehen von Migrationsfehlern.

Detaillierte Fehlerübersicht auf der Seite "Migrationsfehler"

Die Fehlerübersicht zeigt alle Migrationsfehler aus dem letzten Migrationsdurchlauf und besteht aus folgenden zwei Bereichen:

  • Grafische Darstellung: Zeigt die Verteilung der aufgetretenen Fehlertypen. Die Größe der Segmente entspricht der Anzahl der Fehler.

  • Fehlerliste: Enthält alle aufgetretenen Fehlertypen. Hinter den Fehlertypen wird jeweils in Klammern dargestellt, bei wie vielen Dokumenten der Fehler aufgetreten ist. Je Dokument können mehrere Fehler auftreten. Entsprechend können Dokumente bei mehreren Fehlertypen gezählt werden. Innerhalb eines Fehlertyps wird jedes Dokument jedoch nur einmal gezählt.

Zu jedem aufgeführten Fehlertyp stehen weitere Details zur Verfügung, die Sie mit einem Klick auf den entsprechenden Diagrammbereich oder den Fehlertyp in der Liste öffnen können. Die Detailanzeige enthält folgende Bereiche:

  • Fehlerbeschreibung: Beschreibung der Fehlerursache.

  • Anzahl betroffener Dokumente: Gesamtanzahl der Dokumente mit diesem Fehler.

  • Beispieldokumente: Dateipfade zu bis zu drei Dokumenten, bei denen der Fehlertyp aufgetreten ist.

  • Fehlerbehebung: Handlungsempfehlungen zur Behebung des Fehlers.

Ggf. werden zusätzliche Informationen angezeigt, z.B. die Liste nicht zugeordneter Benutzer. Außerdem steht ggf. ein Aktionsbutton zur Verfügung. Klicken Sie auf den Button (z.B. Zuordnungen bearbeiten), um direkt zur relevanten Konfigurationsseite zu wechseln.

Einsehen des Protokolls und des Fehlerprotokolls des Connectors

Bei Fehlern helfen die Protokolle des Connectors weiter. Standardmäßig verwendet der Connector zum Protokollieren d.3 logview. Zusätzlich kann ein Protokoll in eine Datei geschrieben werden, wenn dies in der Konfiguration des Connectors aktiviert wird.

Einsehen der Dokumentprotokolle

Je Dokument wird im Exportverzeichnis eine <Dateiname>.data.log- und eine <Dateiname>.replaced.json-Datei (falls in den Fehlerbehebungseinstellungen (Debugeinstellungen) aktiviert) während des Migrationsprozesses erstellt. In der LOG-Datei werden alle Aktivitäten und Fehlermeldungen protokolliert, die bei der Verarbeitung des Dokuments aufgetreten sind. In der REPLACED.JSON-Datei wird der erzeugte und an die Cloud übermittelte Metadatensatz des Dokuments protokolliert.

Aktivieren des Fehlerbehebungsprotokolls (Debug Log)

Wenn das aktuelle Protokoll nicht ausreicht, um nachzuvollziehen, warum ein Fehler auftritt, können Sie das Protokollierungslevel (Log Level) erhöhen. Sie können das Fehlerbehebungsprotokoll während der Konfiguration der Migration aktivieren.

Deaktivieren des Virenscanners für das Exportverzeichnis

Wenn Leistungsprobleme auftreten, kann ein Virenscanner dafür verantwortlich sein. Für eine Erhöhung der Leistung können Sie eine Ausnahme für das Exportverzeichnis hinzufügen. Bewerten Sie vorab jedoch genau das Risiko der Deaktivierung.