MetaServer > Help > Errors

280 MetaServer Errors

Use the Errors tab to view and manage documents that caused a critical (red) error. For more information about error states please follow this link.

Select Worfklows

Select one more more workflows to filter the errors list. Only the errors related to the selected workflows will be listed.

The icon turns red if not all workflows are selected to clearly indicate that not all errors will be listed.

Retry Action

Retry the selected document with the failed action. Use this after fixing errors caused by problems outside of MetaServer, like an offline database or an XML or CSV file that MetaServer cannot updated because locked by an external program (e.g. Excel).

If the cause of the error is not fixed and you retry the action regardless, the document will fail again and be relisted in the errors list.

Reprocess Document

Reprocess the document(s) from the beginning of the workflow. Use this after fixing mistakes in the MetaServer workflow definition.

The function is not available if the document originates from a document set*. Use Reprocess Set to reprocess such documents.

* A document set originates from a single PDF file containing multiple documents that has been separated in multiple documents using separation rules or using the Organizer.

Reprocess Set

If the error document is part of a document set*, this function reprocesses the full set and re-separates and reprocesses all documents of the set. Use this after fixing mistakes in the separation process of the workflow.

* A document set originates from a single PDF file containing multiple documents that has been separated in multiple documents using separation rules or using the Organizer.

Delete Document(s) (Ctrl+D)

If you want to delete error documents from the list, select one or more documents and press the Delete Document button or press Ctrl+D.

Page Navigation

If the selected document has multiple pages, the page navigation buttons are active. You can also use the Page Up and Page Down keys to page through the document

Refresh Errors List (F5)

When you open the Errors tab, it is automatically refreshed.

While you are managing errors, you can force a refresh by pressing the Refresh List button or by pressing the F5 key.

Select Server

A system can contain several MetaServers. Select the MetaServer you want to work with.

If the MetaServer is not on the same domain as the client, you can enter the server’s URL manually by pressing the arrow under the icon and by selecting “Select by URL”.

You can find the correct URL by opening this setup window on the server. Click on the image to enlarge.

The Errors List, Document Viewer and Properties Panel

Errors List

The left panel shows a list of all documents that triggered a fatal error.

The columns indicate:

– What workflow each document belongs to

– When the documents were created

– The full path and the original file name of the imported document

– A description of the error

– If the document was part of a document set*: Yes / No

* A document set originates from a single PDF file containing multiple documents that has been separated in multiple documents using separation rules or using the Organizer.

Document Viewer

The center panel displays the document. You can page through the document if it has multiple pages.

If the document triggered an error because the file was damaged, the document cannot be displayed and the viewer will display this error image:

Properties Panel

You can double click on any of the properties and copy the content to share it through email or through our support form.

The right panel lists all properties of the selected document:

– The Action History: All the actions the document passed through. The action before the last (sending the error email alert) is the action that failed. In our example that is the Export Folder action. 

In our example, the workflow updates an XML file during Export. The cause of the error in above screen shot was the XML being opened in MS Excel and therefore locked. Consequently MetaServer was not able to update the file generating the error. The solution was to close Excel to unlock the XML file and press Retry Action to process the document successfully.

– Exception Information: Detailed information about the error.

– Field Values: Browse towards the bottom of the list to see the field values

The Status Bar

Server: The name of the machine MetaServer is running on.

Documents: The total number of documents in the MetaServer queue across all workflows. The counter does not get filtered by the Select Workflows function and always shows the total document count for both selected and unselected workflows.

In organizer: Number of documents available (not locked by any user) for Organizing. The counter only shows the count of the selected workflows. See Select Workflows button.

Skipped: Number of documents available (not locked by any user) for Organizing with skipped status. The counter only shows the count of the selected workflows. See Select Worklows button.

In validation: Number of documents available (not locked by any user) for Validation. The counter only shows the count of the selected workflows. See Select Workflows button.

Skipped: Number of documents available (not locked by any user) for Validation with skipped status. The counter only shows the count of the selected workflows. See Select Workflows button.

Errors: Number of documents in error state. These documents triggered a red error.  Errors and the documents that caused them can be viewed and managed in the Errors tab. The counter only shows the count of the selected workflows. See Select Workflows button.