Upon completion of an ingest, DISCO will provide you with up to two reports: the Ingest Report (full) and the Errors Report (errors only). If there were no errors associated with the ingest, you will see only see the ingest report. If there were errors or other issues that need attention, DISCO will generate an Errors Report. To access these reports, login to DISCO and navigate to your top menu and select DATA > Ingest. From there, select which ingest session you'd like a report. Click on the button "download report." In the screenshot here, you'll see the option for the entire report (“Everything”) and a report on the Errors Only.
If you select Errors Only (as illustrated here), a spreadsheet identifying the errors will be downloaded. Below is a screenshot with an Errors Report:
Here are some common errors, with a description of the message in the Errors Report, a general priority level of the issue, and how to resolve the error/warning:
|Password Protected||The file could not be opened because it is password protected.||High|
|How to Handle a Password Protected File: If a file is password protected, you need to obtain the password for each protected file. Then, send the password to email@example.com. We will unlock and re-ingest the file. To search and view the file information in DISCO, copy the text from the Errors Only report column "InstanceID." This is the DISCO ID that the system assigns to each instance of a document as it is processed. Copy the number before the decimal and use the following example search in DISCO to view the document, replacing "234" with your own document ID number: "id(234)".|
|Container Extraction Failed||Unable to extract file. Unable to save the zip entry to storage.||High|
|Container Extraction Failed||1 item could not be extracted from this container||Medium|
|Container Extraction Failed||Unable to extract file. Zero byte attachment skipped.||N/A|
How to Handle a "Container Extraction Failed" Errors: Depending on the error message, this could be a high, medium, or low priority. If there is a message in the first few rows of your Errors Report that reads "Unable to extract file," this could be a high priority, as it could mean that a container housing several documents was corrupted. In this case, complete the following steps:
1 - Contact firstname.lastname@example.org about the error message.
2 - Once DISCO logs the issue, send another copy of the container. The file may have been corrupted in transit, so DISCO will first try to ingest the container a second time to see if this resolves the issue.
3 - If the second send of the container obtains the same error, you will need to go back to the source of the original file(s) and request another copy of the container that is not corrupted.
|Near Native Skipped||Excel documents larger than 1000 PDF pages will remain native||Low|
|Near Native Skipped||Text files greater than 1000 PDF pages will be processed as native||Low|
|How to Handle a "Near Native Skipped" Error: This message is usually a warning that the file you are trying to ingest is very large and will slow down your ingest. If the file is over 100,000 pages, for example, it will not be OCRed by DISCO. Instead, you will need to download the original version of the file from within the DISCO document viewer and review the native. However, there may be an instance where DISCO interprets the wrong file type and then gives you this error message. Make sure to review the column "file path" to confirm that the file extension matches the error message.|
|Unsupported Format||The format of the file is currently unsupported.||N/A|
|How to Handle an "Unsupported Format" Error: If you receive this error, it means that the file format is not supported as a known file type in DISCO, and therefore it won’t render as a DISCO image. Review our list of Supported File Formats to confirm that the file type is unsupported. However, even if “unsupported” the file is available in DISCO, however, to review the document, you will need to download the original version of the file from within the DISCO document viewer and review the native.|