2 Getting Started with Process Workspace

This chapter tells you how to start and log in to Process Workspace, navigate its interface, and configure your preferences.

Process Workspace is a customizable web-based interface enabling users to access and manage tasks and process instances according to their roles and responsibilities.

To help you get started with Process Workspace, this chapter contains these topics:

For information about troubleshooting human workflow issues, see section "Human Workflow Troubleshooting" of Oracle Fusion Middleware Administrator's Guide for Oracle SOA Suite and Oracle Business Process Management Suite.

2.1 Understanding Process Workspace

Table 2-1 lists and describes the users for whom Process Workspace is designed.

Table 2-1 Users of Oracle Business Process Management Workspace

User Profile Description

Process Participants

This is the most basic profile, common to all users. It enables you to:

  • Organize, find, claim, and perform work assigned or delegated either to you or to your group

  • Delegate work to another user

  • Create and manage personal rules—for example, whom to send tasks to when you are on vacation

  • Define and share views

  • Manage personal preferences

  • View reports and dashboards

These users may be spread throughout the organization or work outside the company.

A process participant may be one who not only initiates the process, but can also track its progress and, if appropriate, withdraw it.

Process Owners

Users who manage one or more business process. They act on tasks belonging to the process but assigned to other users, in addition to their own end-user access. They want to know how process instances are moving in those processes. To get this perspective, they typically use dashboards.

These users usually reside on the business side of the house as part of the operations organization. They may also be supervisors.


Includes two types of administrative users:

  • Business administrators: Users responsible for administering Process Workspace—for example, adding mapped attributes, changing the look and feel, or ensuring that the web application is both running and accessible. Administers tasks that are in an errored state, for example, tasks that must be reassigned or suspended. They can also change application preferences and map attributes, and manage rules for any user or group, in addition to their own end-user access. They typically need access to Fusion Middleware Control Console as well as to the computers where Process Workspace resides.

  • Process administrators: Users responsible for administering processes—for example, creating shared views; assigning or removing roles, permissions, and groups; and mapping roles.


Users with other process participants reporting to them. To ensure that process instances execute as expected, supervisors can:

  • Access staff work

  • Reassign and delegate work as needed

  • Handle escalations from individuals reporting to them

  • Generate reports regarding work distribution and productivity

  • Specify extended user properties

Process analysts typically use the Oracle Business Process Analysis Suite or Business Process Composer to create process models. They can also use process analyst role within Oracle BPM Studio.

Process developers typically use Oracle BPM Studio to model and implement the components of a business application. They may occasionally use Oracle Business Process Composer (Business Process Composer) for modeling basic processes.

2.2 Starting and Logging In to Process Workspace

To start Process Workspace, you must have installed Oracle SOA Suite, and the Service Integration server must be running. See your installation documentation for more information.

To start and log into Process Workspace:

  1. Go to


    The host_name is the name of the host computer on which Oracle SOA Suite is installed.

    The port_number is the one used at installation.

  2. Enter the user name and password.

    You can use the preseeded user name to log in as an administrator. If you have loaded the demo user community in the identity store, then you can use other users such as jstein or jcooper.

    The user name and password must exist in the user community provided to JAZN.

  3. Click Login.


  • If you expect to have a large number of users using Process Workspace simultaneously, then set the session time-out value to no more than 5 minutes. To do this, expand the Process Workspace .ear file, open the web.xml file, and update the time-out parameter.

  • If user identities are stored in Microsoft Active Directory, then at times authentication can fail due to the inability of Oracle WebLogic Server, where Process Workspace is running, to communicate with the Active Directory installation. This can occur when Oracle WebLogic Server and Active Directory are in separate domains.

    To resolve this issue, add the entry for the Active Directory host's address to the /etc/hosts file on machine where Process Workspace is running.

2.3 Navigating Process Workspace

Figure 2-1 shows Process Workspace as it first appears by default when you log in.

Figure 2-1 Process Workspace Home

Description of this graphic follows.
Description of "Figure 2-1 Process Workspace Home"

At the highest level, Process Workspace provides four default tabs:

  • Tasks

  • Activity Guides

  • Process Tracking

  • Standard Dashboards

It also provides a link in the top right toolbar for performing administration.

In addition to the default tabs, you can create your own custom tabs, with each one appearing as a separate page in Process Workspace. For more information about creating custom tabs, see Chapter 6, "Creating and Editing Custom Pages in Process Workspace".

An administrator can choose whether to show or hide the default tabs. The administrator can also specify which tab page is displayed when the user logs in. For information on hiding and showing default tabs, see Section 9.1.8, "How to Show or Hide the Default Tab Pages in Process Workspace"

This section contains these topics:

2.3.1 About the Process Workspace Tasks Page

After a user logs in, the Home page displays the Tasks page by default. The Tasks page displays tasks for the user based on the user's permissions and assigned groups and roles.

Within the Tasks page, the My Tasks page and the Inbox are displayed by default. The actions allowed from the Actions list depend on the logged-in user's privileges.

The Tasks page enables you to do the following:

  • Perform authorized actions on tasks in the worklist, acquire and check out shared tasks, define personal to-do tasks, and define subtasks.

  • Filter tasks in a worklist view based on various criteria.

  • Work with standard work queues, such as high priority tasks, tasks that are due soon, and so on. Work queues enable users to create a custom view to group a subset of tasks in the worklist—for example, high priority tasks, tasks due in 24 hours, expense approval tasks, and more.

  • Define custom work queues.

  • Gain proxy access to part of another user's worklist.

  • Define custom vacation rules and delegation rules.

  • Enable group owners to define task dispatching rules for shared tasks.

  • Collect a complete workflow history and audit trail.

  • Use digital signatures for tasks.


If you change a user's privileges in Oracle Enterprise Manager Fusion Middleware Control Console while the user is logged in to Process Workspace, the changes take effect only after a subsequent login by the user. This is true for situations in which there are two active worklist sessions: one in which the user is logged in before the privileges are changed, and one in which the same user logs in after the privileges are changed. In the first case, the changes to the user's privileges do not take effect while the user is logged in. In the second case, when the user logs in to the second instance of Process Workspace, the changes to the user's privileges do take effect. Navigating the Process Workspace Tasks Page

This page lists all the tasks and work items assigned to you, depending on your role. For example, all users will see the My Tasks, Initiated Tasks and Administrative Tasks pages. Only supervisors will see the My Staff page. The Tasks page has these sections, as shown in Figure 2-2:

  • Task navigator on the left

  • Task list on the upper half of the right side

  • Task details on the lower half of the right side

Figure 2-2 Process Workspace Tasks Page

Description of this graphic follows.
Description of "Figure 2-2 Process Workspace Tasks Page"

Table 2-2 Components of the Tasks Page

Component Description


The tabs displayed depend on the role granted to the logged-in user.

  • Everyone (the user role) sees My Tasks, Initiated Tasks and Administrative Tasks.

  • Users who are also supervisors see the My Tasks, Initiated Tasks, My Staff Tasks and Administrative Tasks tabs.

  • Users who are also administrators (the BPMProcessAdmin), but not supervisors, see the My Tasks, Initiated Tasks, and Administrative Tasks.

  • Users who are supervisors and administrators see all the tabs— My Tasks, Initiated Tasks, My Staff Tasks, and Administrative Tasks.


The processes the user is authorized to initiate.

Worklist Views

  • Inbox—Shows all tasks that result from any filters you used. The default shows all tasks.

  • My Work Queues—Shows standard views and views that you defined. The Standard Views are Due Soon, High Priority, Past Day, Past Week, Past Month, Past Quarter, and New Tasks.

  • Proxy Work Queues—Shows shared views.

Task Status

A bar chart shows the status of tasks in the current view.

Display Filters

Specify search criteria from the Assignee, Status, or Search fields. The category filters that are available depend on which tab is selected.

  • From the My Tasks page, the Assignee filters are My, Group, My & Group, Previous (tasks worked on in the past), and Reviewer. From the Initiated Tasks page, the only assignee filter is Creator. From the My Staff Tasks page, the only assignee filter is Reportees. From the Administrative Tasks page, the only assignee filter is Admin.

  • The Status filters include Any, Assigned, Completed, Suspended, Withdrawn, Expired, Errored, Alerted, Information Requested.

Use Search to enter a keyword or use Advanced Search.

Actions List

Select a group action (Claim) or a custom action (for example, Approve or Reject) that was defined for the human task. Claim appears for tasks assigned to a group or multiple users; one user must claim the task before it can be worked. Other possible actions for a task, such as system actions, are displayed on the Task Details page for a specific task. You can also create ToDo tasks and subtasks here.

Default Columns

Title—The title specified when the human task was created. Tasks associated with a purged or archived process instance do not appear.

Number—The task number generated when the BPEL process was created.

Priority—The priority specified when the human task was created. The highest priority is 1; the lowest is 5.

Assignees—The user or group or application roles.

State—Select from Assigned, Completed, Errored, Expired, Information Requested, Stale, Suspended, or Withdrawn.

Created—Date and time the human task was created.

Expires—Date and time the tasks expires, specified when the human task was created.

Task Details

The lower section of the worklist displays the inline view of the Task Details page. Buttons indicate available actions. The Process Workspace Task Details Page

Figure 2-3 shows an example of a Task Details page. This page is invoked by selecting a task from the inbox on the Process Workspace Tasks page.

Figure 2-3 Example of a Task Details Page

This illustration is described in the text.
Description of "Figure 2-3 Example of a Task Details Page"

The task details page has the following components:

  • Basic information including the title of the task—for example, Help Desk Request for wfaulk—task number, creator, assignees, state, created date, the person who acquired the task, priority, expiration date, and other flex fields.

  • Action buttons—For custom actions defined in the human task—for example, Resolved and Unresolved for a help desk request or Approve and Reject for a loan request. For the administrator, task initiator, or manager, Withdraw may also appear.

  • Other Actions—System task actions, beyond the custom actions defined for the task—as described in Table 2-3.

    Table 2-3 System Task Actions

    Action Description


    If a task is assigned to a group or multiple users, then the task must be claimed first. Claim is the only action available in the Action list for group or multiuser assignments. After a task is claimed, all applicable actions are listed.


    If you are not able to complete a task, you can escalate it and add an optional comment in the Comments area. The task is reassigned to whomever is specified by the administrator. If no escalation path is specified, then the task is escalated to your supervisor (up one level in a hierarchy).


    Use this action to send a task down one level in the workflow to the previous assignee.


    If you are a manager, you can delegate a task to reportees. A user with BPMWorkflowReassign privileges can delegate a task to anyone.


    If a task is assigned to a group or multiple users, it can be released if the user who claimed the task cannot complete the task. Any of the other assignees can claim and complete the task.


    If a task is about to expire, you can renew it and add an optional comment in the Comments area. The task expiration date is extended one week. A renewal appears in the task history. The renewal duration for a task can be controlled by an optional parameter. The default value is P7D (7 days).

    Submit Information and Request Information

    Use these actions if another user requests that you supply more information or to request more information from the task creator or any of the previous assignees. If reapproval is not required, then the task is assigned to the next approver or the next step in the business process.

    Suspend and Resume

    If a task is not relevant, you can suspend it. These options are available only to users who have been granted the BPMWorkflowSuspend role. Other users can access the task by selecting Previous in the task filter or by looking up tasks in the Suspended status. A suspension is indefinite. It does not expire until Resume is used to resume working on the task.


    If you are the creator of a task and do not want to continue with it, for example, you want to cancel a vacation request, you can withdraw it and add an optional comment in the Comments area. The business process determines what happens next. You can use the Withdraw action on the home page by using the Creator task filter.

  • Content—The payload. The fields displayed are specific to how the human task was created.

  • Short History—Provides a graphical view of a task flow and lists all versions created by the following tasks:

    • Initiate task

    • Reinitiate task

    • Update outcome of task

    • Completion of task

    • Erroring of task

    • Expiration of task

    • Withdrawal of task

    • Alerting of task to the error assignee

    You can include the following actions in the short history list by modifying the shortHistoryActions element.

    • Acquire

    • Ad hoc route

    • Auto release of task

    • Delegate

    • Escalate

    • Information request on task

    • Information submit for task

    • Override routing slip

    • Update outcome and route

    • Push back

    • Reassign

    • Release

    • Renew

    • Resume

    • Skip current assignment

    • Suspend

    • Update

  • History Details—The approval sequence and the update history for the task.

    To see all actions performed, including those that do not change the task, such as adding comments, check Full History.

  • Comments and Attachments:

    • Comments entered by various users who have participated in the workflow. A newly added comment and the commenter's user name are appended to the existing comments. A trail of comments is maintained throughout the life cycle of the task. To add a comment, you must have permission to update the task.

      For information about how to add a comment, see Section 3.7, "Adding Comments and Attachments to Tasks in Process Workspace"

    • Attachments are documents or reference URLs associated with a task. These are typically associated with the workflow as defined in the human task or attached and modified by any of the participants using the task list. To add or delete an attachment, you must have permission to update the task. When adding file attachments, you can use an absolute path name or browse for a file. Task History

The task history maintains an audit trail of the actions performed by the participants in the workflow and a snapshot of the task payload and attachments at various points in the workflow. The short history for a task lists all versions created by the following tasks:

  • Initiate task

  • Reinitiate task

  • Update outcome of task

  • Completion of task

  • Erroring of task

  • Expiration of task

  • Withdrawal of task

  • Alerting of task to the error assignee

You can include the following actions in the short history list by modifying the shortHistoryActions element.

  • Acquire

  • Ad hoc route

  • Auto release of task

  • Delegate

  • Escalate

  • Information request on task

  • Information submit for task

  • Override routing slip

  • Update outcome and route

  • Push back

  • Reassign

  • Release

  • Renew

  • Resume

  • Skip current assignment

  • Suspend

  • Update

The history provides a graphical view of a task flow, as shown in Figure 2-4.

Figure 2-4 History: Graphical View

Description of this graphic follows.
Description of "Figure 2-4 History: Graphical View"

Table 2-4 describes the icons used in the Task History section.

Table 2-4 Icons for Task History

Icon Description
Shows a person symbol and a large pencil.

Indicates an approver in an ad hoc routing scenario.

Graphic contains a green check mark.

Indicates that the task has been approved

Shows a pair of glasses lying in front of a person symbol.

Indicates that the participant just receives a notification task and the business process does not wait for the participant's response. Participant cannot directly impact the outcome of a task, but in some cases can provide comments or add attachments.

Shows three person symbols each with a plus mark.

Indicates that a set of people must work in parallel. This pattern is commonly used for voting.

Shows three person symbols ascending hierarchically.

Indicates that the participant belongs to a management chain.

Shows a single person symbol

Indicates the simple case in which a participant maps to a user, group, or role.

Shows two todo items with check boxes unchecked.

Indicates that the task is untouched

Select Full task actions to see all actions performed, including those that do not make changes to the task, such as adding comments, as shown in Figure 2-5.

Figure 2-5 History: Full Task Actions

Description of this graphic follows
Description of "Figure 2-5 History: Full Task Actions"

Available ways to view the task history include:

  • Take a task snapshot

  • See future approvers

  • See complete task actions

2.3.2 About the Process Workspace Activity Guides Page

Activity guides organize your tasks into milestones. Each milestone is a specific set of tasks for you to complete, either on your own or in collaboration with others. For each milestone, the activity guide tells you which tasks to complete and in which order. You complete a milestone by completing all the tasks it contains for you. Depending on the nature of the task, you can save an unfinished task and resume it later.

Figure 2-6 shows an example of an activity guide.

Figure 2-6 Sample Activity Guide

This graphic is described in the text.

Using an activity guide, you can:

  • Expand a milestone to see and act on the tasks it includes.

  • View the status and percent completion of the overall business process in which you participate.

For more information about navigating the Activity Guides page, see Section 5.2, "Navigating Activity Guides".

2.3.3 About the Process Workspace Process Tracking Page

Use the Process Tracking page to interact with business processes based on the roles assigned to you.

Using the Process Tracking tab, you can do the following:

  • View the list of process instances pending in your inbox.

  • Execute tasks. That is, carry out a human task on a particular instance.

  • Search for instances by different criteria.

  • Save the searches as a view.

  • View the details of an instance, including the audit trail.

  • Create a new instance, if you have permission to do so.

  • Attach a file to an instance.

  • Add notes to an instance. Navigating the Process Workspace Process Tracking Page

Figure 2-7 Process Workspace Process Tracking Page

This graphic is described in the text.
Description of "Figure 2-7 Process Workspace Process Tracking Page"

The Process Tracking page has these sections:

  • The Applications panel, which shows the list of applications available to you. Here you can perform basic Process Workspace actions, such as creating a new instance performing a given activity, or sorting applications.

    Hovering over the name of an application in the Applications panel displays a tool tip with the application's full name and revision number.

    The applications available in Process Workspace depend on the process design and the roles assigned to the user currently logged in. The list of available applications also depends on the BPM processes that are deployed and running. If no processes are running, or if you are not a participant able to execute an application in any of the processes currently running, then the applications panel is empty.

    In the applications panel, you can sort either of the following:

    • Only the default versions of applications

    • All active versions of applications

    You can sort either by name or by process version. You can filter the same applications by entering in the Search field either full or partial names or full or partial versions.

  • The Views panel, on the lower left half, displays the views available to you in an expandable tree

  • The Pending Components panel shows all suspended processes. If a new version of a process is deployed, and the previously deployed process has instances not yet migrated to the new version, then the previously deployed process is suspended. To resume it, either migrate or suspend any non-migrated instances. For information about resuming suspended processes, see "Resuming a Suspended Process" in Oracle Fusion Middleware Modeling and Implementation Guide for Oracle Business Process Management.

  • The Work Items panel, on the upper right half, shows the task items corresponding to the view you have selected in the Views panel. In this panel, you can choose the columns that are presented in a given view. A particular column arrangement is known as a presentation. Clicking Add/Remove columns displays the Presentation dialog box in which you can define columns.

    The following columns are available:

    • Actions

    • Activity

    • Activity Due Date

    • Copy

    • Creation Time

    • Deadline

    • Description

    • Has Attachments

    • Has Notes

    • Initiated

    • Initiator

    • Initiator Name

    • Instance #

    • Parent Copy

    • Participant

    • poID

    • Priority

    • Process Name

    • Process Due Date

    • Received

    • Status

    • Task Participant (that is, the participant that is currently executing an instance.)

    • Title

  • The Work Item Detail panel, on the lower right half, shows detailed information about a work item that you have selected in the Work Items panel. It has these sections:

    • Details: Shows the priority, process name, when the instance is due to complete, status, creation time, and the assignee if any.

    • Open Activities: Shows the status of any gateways with threads that are still running.

    • Audit Trail: Shows audit details in either a list view, a tree view, or graphical view. You can select the type of activity or sub-process you want to audit: human activities, service activities business rule activities, subprocesses, events, gateways, script activities, other activities, or all of the above.

      If the process includes an input or output payload, then you can display the audit details for that message in a pop-up. Clicking on a particular activity displays the task history.

      For more information about viewing audit details, see Section 4.3.1, "Viewing the Audit Trail in Process Workspace."

    • Comments: Enables you to add comments to the process instance.

    • Attachments: Enables you to add attachments to the process instance.

      For more information about adding comments and attachments to a process instance, see Section 4.3.2, "Associating Comments and Attachments with a Process Instance in Process Workspace."

2.3.4 About the Process Workspace Standard Dashboards Page

Dashboards provide analytical information to monitor process execution as well as user workloads. They provide summary information and enable you to drill down to instance-specific information.

Figure 2-8 shows the Standard Dashboards page.

Figure 2-8 Process Workspace Standard Dashboards Page

This graphic is described in the text.
Description of "Figure 2-8 Process Workspace Standard Dashboards Page"

For additional information about dashboards, see Chapter 7, "Using Dashboards in Process Workspace".

2.4 Accessing Administration Capabilities

The upper right toolbar contains an Administration link as shown in Figure 2-9.

Figure 2-9 Administration Link

Description of this graphic follows.
Description of "Figure 2-9 Administration Link"

Table 2-5 lists and describes the categories in the Administration Areas and tells where to find more information about each one.

Table 2-5 Categories in the Administration Areas

Category Description Information


Model an organization by defining organization units, business calendars, business holidays, roles, and other user properties.

Note: If you are logged into Process Workspace, and changes are made to your organizational membership, you will not see these changes reflected in the interface until you log out and log back in again. This is because, for better performance, the organization unit information is cached when you log into Process Workspace.

Section 10, "Managing Your Organization in Process Workspace (for Administrators)"

Flex Fields (Mapped Attributes)

Create mappings needed for populating mapped attributes.

Section 9.2.1, "Managing Mapped Attributes (Flex Fields) in Process Workspace"

Task Administration

Administer approval groups, task configuration, evidence search, and exceptions

Section 9.2, "Administering and Configuring Task-Related Information in Process Workspace"

Application Preferences

Customize the appearance of the worklist.

Section 9.1, "Setting the Display of the Work Items Panel in Process Workspace"

2.5 Setting Your Preferences in Process Workspace

Table 2-6 lists and describes the preferences you can set and tells you where to find information for setting each preference.

Table 2-6 Preferences

Preference Description Information

Accessing Process Workspace in local languages

Specify your preferred language and time zone.

Section 9.1.3, "How to Specify the Language Locale Information in Process Workspace"

Providing a digital certificate

Provide a digital certificate from a certification authority to verify your credentials.

Section 3.5, "Providing a Digital Certificate in Process Workspace".

Setting rules

Set rules for tasks assigned to a user or group.

Section 3.9.1, "How to Create User Rules in Process Workspace"

Section 3.9.2, "How to Create Group Rules in Process Workspace"

Setting notification preferences

Configure the notification settings to control how, when, and where you receive messages in cases when you have access to multiple communication channels (delivery types).

Section 3.9.4, "Specifying Notification Settings".

Setting accessibility preferences

Select accessibility preferences such as using a screen reader, using high contrast colors, and large fonts.

Section 3.4, "Setting Accessibility Preferences in Process Workspace"

In addition to the preferences mentioned in this section, administrators can also set various preferences for how the Work Items panel is displayed in Process Workspace. For information about setting these application preferences, see Section 9.1, "Setting the Display of the Work Items Panel in Process Workspace".