6.1.1 Using the Process Instance Execution Log
The following describes how to use the execution log:
- Organization of this subsection
(1) Using the execution log to handle an inquiry about an error that has occurred
To handle an inquiry about an error that has occurred, use the execution log for process instances as follows:
-
Use the business process execution log's error messages to identify the cause of the error and correct it.
-
Check the status of the process instances.
- When there is a correlation set that can be identified
-
Search the process instances, using as the search condition the correlation set in the request message that was sent by the service requester. You can uniquely identify the target by using a correlation set as the search condition.
- When the correlation set is unknown
-
Search the process instances based on the process instance start date and time acquired from the request message, or based on the status of the target process instance (such as Executing).
-
From the search result, acquire detailed information about the process instance's correlation set, variable, or activity in order to identify the target process instance.
If you used a correlation set for the search, you can also identify the process instance based on the displayed start date and time.
-
Perform one of the following operations according to the status of the process instance:
- When the status is "Executing" or Error occurred
-
Re-execute the process instance or delete the process instance execution log. Then, issue a request to the service requester to re-transmit the request message.
- When there is no information about the process instance (no hit in the search result)
-
Issue a request to the service requester to re-transmit the request message.
(2) Using the execution log to facilitate testing of a business process
After a test run of a process instance finishes during development of a process instance, you can also check the status to improve the process instance. The following procedure shows how you can use the execution log of process instances to facilitate testing of a business process:
-
Search the process instance execution logs for a business process that has been made persistent, using a correlation set, date/time, or status as the search condition in order to narrow the target.
-
From the search result, acquire detailed information about the process instance's correlation set, variable, or activity in order to identify the target process instance.
-
Perform one of the following operations according to the status of the process instance:
-
Acquire the status of the process instance that was executed.
-
Re-execute the process instance whose status is Executing or Error occurred.
-
Delete any unneeded process instances.
-
The following subsections describe how to search process instances, view their information and statuses, delete execution log information, and re-execute process instances.
(3) Displaying the Tracking page from the GUI
You can use either windows or commands to manage the process instance execution log.
If you use windows to manage the process instance execution log, you can display information on the Tracking page. To display the Tracking page, do the following:
-
In the tree view, select the business process whose process instance execution log you wish to check.
-
In the editor area, choose the Tracking tab.
The Tracking page is displayed in the editor area.