Once the FYI Migrate App is completed, a Migration Audit Report is automatically generated. This is a .CSV report that gives a summary of the total files and documents that have been migrated and lists any errors and excluded files with the reason for the error or exclusion. Only details of errors and excluded files are shown in the report.
The Migration Audit Report is generated after each migrate has run and completed. The file is generated with the following filename and location:
%APPDATA%\FYI Migrate\Reports\Migration Audit Report.csv
The Migration Audit Report is automatically uploaded as a document within your FYI. It is added to the Cabinet FYI Migration which is created in your FYI Cabinets.
Any new versions of the Migration Audit Report file are uploaded as threaded copies and a new report is only uploaded if changes are detected.
The following is an example of the Migration Audit Report for a migration from MYOB.
The following is an example of the Migration Audit Report for a migration from a Windows Explorer system.
The following is a summary of the errors and exclusions that are reported in detail.
Status | Reason | Explanation |
Error |
Failed to upload file |
The file (or note) or the .metadata failed to upload for some reason. |
Error | File is 0... | The file contains no data due to a read error or is a corrupted file in the historical data source. |
Error | Error reading directory, file count may not be accurate | The file may be saved to a folder that has permissions applied that the user running the migration does not have access to. |
Error |
Document file not present in file store |
The file no longer exists, for example, it has been deleted in the historical data source. |
Error |
File is available online only... |
The file has not been synced locally and cannot be uploaded. |
Error |
Failed to get document stream |
The documents were unable to be accessed at the time of running the Migrate app. |
Excluded |
Not present in DMS or not latest version |
For Database-backed migrations, the filename is not present in the documents retrieved from the database, or the version is not the latest. |
Excluded |
Excluded due to filename filter |
Excluded due to filename filters, no extension, temporary files, etc. |
Excluded |
Size equal or greater than 2GB |
The file is equal or greater than 2 gigabytes, so will not be uploaded. |
Warning |
Previously uploaded document missing from datastore |
A file was previously uploaded in a prior migration run, but it is now no longer present. This can lead to more documents in FYI than expected if files have been removed after they’ve already been uploaded. |
Warning |
DMS document file not present in datastore |
For Database-backed migrations, the filename for a document is not present on disk in the folders selected. |
Notes:
- The Migration Audit Report from %APPDATA% is only available for Migrate App version 1.0.0.161 and higher.
- The Migration Audit Report from within FYI is only available for Migrate App version 1.0.0.171 and higher.
- If the Migration cache is reset, a new Migration Audit Report is created.
- If migration is stopped and restarted, the same migration report is updated.
- Cancelling the FYI Migrate does not append the existing report. The Migration Audit Report is created only when the migration cycle is completed.