Activities List Web Page
A new Activities List web page is available when you use the Find Processes web page to access the Workflow Monitor. The section titled, Using the Find Processes Web Page in the "Monitoring Workflow Processes" chapter of the Oracle Workflow Guide is updated as follows to reflect the incorporation of this new page.
Using the Find Processes Web Page
The Oracle Workflow Find Processes web page allows you to query for a list of workflow process instances that match certain search criteria. From the Process List that appears, you can select a single process instance to review in more detail.
You can view details about the completed notification activities in the Notifications List web page that appears, or choose Advanced Options to display details about other activities in the Activities List web page. You can also navigate to the Workflow Monitor from the Notifications List to administer the process or see a graphical representation of the process and its status.
To Specify Search Criteria in the Find Processes Page
1. You can enter search criteria using any combination of the following fields to find a subset of workflow process instances:
- Process Status--Specify Any Status, Active, or Complete.
- Item Type--Select the item type of the workflow process instances you want to find, or select All to find workflow process instances for all item types.
- Item Key or User Key--Specify an item key or a user key. An item key presents the internal identifier of an item whereas a user key is an end-user identifier assigned to an item. A user key may not necessarily be unique to an item. See: SetItemUserKey.
- Process Name--Specify the display name of a process activity.
2. If you log on as a user with Workflow Administrator privileges, you can search for and display any process instance, even if you do not own the process. In the Process Owner field, enter the internal name of any role defined in WF_ROLES to list only processes owned by that role. Alternatively, leave the field blank to list all process instances that match your search criteria regardless of the process owner.
If you do not have Workflow Administrator privileges, then the Process Owner field reflects the internal name of the role you are logged in as for the current web session and you are allowed to search and display only processes that you initiated or are the primary participant of.
Note: You can set the owner of a process by making a call to the WF_ENGINE.SetItemOwner API. The owner of a process is the person who initiated the process or is the primary participant of the process.
3. Optionally, you can also find workflow process instances with activities that are Suspended, In Error, or that have Any Status.
4. You can find workflow process instances that have activities waiting for a response from a particular user or role.
5. You can also identify workflow process instances that have not progressed for a specified number of days.
6. When you finish entering your search criteria, choose Find to display all matching process instances in the Process List web page.
To Review the Process List
1. The Process List provides a summary of all workflow process instances that match your search criteria as specified in the Find Processes web page.
2. The process instances are listed in ascending order first by item type, then by item key.
3. The Process List summarizes the status of each process instance, as indicated by the Complete, In Error, and Suspended columns.
4. Choose a process link in the Process Name column to display the Notifications List for that process instance.
To Review the Notifications List
1. The Notifications List shows all the current notifications that have been sent for a process that required a response. The list summarizes what each notification activity is, who it is assigned to, when it was sent, whether it has been completed, how many days have passed before completion, as well as what its result is.
Note: If the process itself is in an error state, and the cause of the error was from a notification, the result of that notification may appear as a link in the Result column. Choose that link to display the cause of the error.
2. Choose the user link in the Who column if you want to send email to the user that the notification has been assigned to.
Note: You can display a helpful hint about any link on the Notifications List web page by placing your cursor over the link. The hint appears in your web browser's status bar.
4. You can also choose the View Diagram button to display the process instance in the Workflow Monitor for a graphical representation of the process status. If you connected to the current web session as a user with Workflow Administrator privileges, the Workflow Monitor displays the process in 'ADMIN' mode, otherwise the process is displayed in 'USER' mode. See: Workflow Monitor.
To Filter Activities in the Activities List
1. The Activities List web page lets you specify various criteria to filter for specific activities of interest.
2. Use the Activity Status Options checkboxes to specify any activity status of interest. A status of Active also includes activities that are in the Notified, Deferred and Waiting state.
3. Use the Activity Type checkboxes to specify the types of activities you want to view. You can choose to display notification activities that require a response, notification activities that do not require a response, process or function activities, and/or activities that belong to the Standard item type.
4. Once you finish selecting your criteria, choose Filter Activities to display the activities that match your criteria.
5. The resulting activities summary list includes the following columns of information:
- Status--the status of the activity, which is either Active, Complete, Error or Suspend.
- Who--the performer of the activity. If the activity is a function activity, the Workflow Engine is the performer. If the performer is a person, you can click on the link to that person's name to send mail to that individual.
- Parent Activity--the process activity that this activity belongs to, unless the activity itself is the top level process. The parent activity provides a link to the details of its definition.
- Activity--the name of the activity. This activity provides a link to the details of its definition.
- Started--the date and time when the activity was initiated.
- Duration--the amount of time taken to complete the activity, shown as one unit lower than the most significant unit of time taken. If the activity took only seconds to complete, then only seconds are shown.
- Result--the result of the activity. If the activity has a status of Error, then the result provides a link to the error name, error message, and error stack associated with the error.
Note: You can display a helpful hint about any link on the Activities List web page by placing your cursor over the link. The hint appears in your web browser's status bar.
6. You can sort the activities summary list based on any column by clicking on a column header. An asterisk (*) appears next to the column title to indicate that it is being used for sorting. If the asterisk is to the left of the column title, the sort order is ascending. If the asterisk is to the right of the column title, the sort order is descending. Clicking multiple times on the same column title reverses the sort order.