Batch instance progress bars
This feature allows a user to check the state of a batch instance. This feature shows the details of current state of a batch instance, which can be in any state. When a batch instance is selected from the batch instance grid, the details of the batch instance are displayed in the bottom panel, which consists of two types of data:
-
Batch Instance Details Grid: This is a grid of details regarding the static information of the batch. The grid includes the following information about the batch instance.
-
Batch Class Name: The name of the batch class in which this batch instance is executing.
-
Batch Identifier: The identifier of the batch instance.
-
Batch Name: The name of the batch instance.
-
Batch Description: The description for the batch instance being executed.
-
Batch Priority: The priority of the batch instance being executed. If the priority is edited then when restarting the batch, the new priority is shown.
-
Current Status: The status of batch instance, such as: RUNNING, ERROR, NEW, LOCKED, READY_FOR_REVIEW, READY_FOR_VALIDATION, DELETED.
-
UNC Folder Path: The UNC folder path for the batch class in which this batch instance is currently executing.
-
Error Cause: The error cause if the batch instance is in the ERROR state. This field is available in the grid only if the batch instance is in the ERROR state. It shows the details of the cause for the batch instance ERROR state. If the batch instance is in any state other than ERROR then this field is not be available. If the batch.instance_logging switch in dcma-batch properties is set to true, then the Error Cause label turns up as a hyperlink. You can click this hyperlink to download the Error cause log (only if a log file is present in the batch instance folder).
-
-
Work Flow Start Time: Indicates the time when a batch is picked up for processing (i.e. by pick up service) for further processing. Before processing, this time is empty for a batch instance.
-
Batch Instance Status Bar: This is a grid of status bars for each of the modules configured in the batch class for which batch instance is executing. For example, if the a batch class has four modules: Folder Import, Page Process, Document Assembler, Extraction and Export. Then for this batch instance there will be 5 progress bars stacked horizontally.
The details of each status bar:
-
Each status bar states the current status of the batch in that module.
-
If the module has completed execution, then the status bar will be displayed in a color code of green with the name of module and its percentage completion as 100%.
-
There will be a tooltip over each status bar which displays the details of execution.
-
If the module has executed completely, then tooltip shows the list of executed plugins in the module.
-
If the module has not completed its execution, then the amount of completion for the batch in a module gives the percentage completion of that batch and the respective amount of status bar will be displayed as blue.
-
The tooltip for currently executing module will give details such as the list of plugins which have completed execution, the currently executing plugin and the plugins which are pending execution.
-
The text on the status bar shows the name of the module and the percentage completion of that module.
-
If a module is pending execution then the text on the status bar states only the name of the module and the color of status bar will be yellow.
-
The tooltip for these status bar will show the name of all the plugins which are configured in this module and are pending execution.
-
Usability
The usability for this grid and status bars is to check the real-time running status of a batch instance. You can view the details of batch instance on the Batch Instance Management screen, instead of verifying the details in the database or batch.xml file.