16 Human Workflow

This chapter describes issues associated with human workflow. It includes the following topics:

16.1 General Issues and Workarounds

This section describes general issue and workarounds. It includes the following topics:

16.1.1 Close the .rule File Before Editing Rulesets for Additional Participants

If you add a ruleset to a task participant in the Human Task Editor, this automatically opens the Oracle Business Rules Designer and a corresponding .rule file for editing.

If you then want to add or remove rulesets for additional participants in the Human Task Editor, ensure that you first close the .rule file. This can be done by clicking the x icon for the .rule file tab above the editor. The .rule file cannot be edited (adding or removing rulesets) unless this file is first closed and reopened.

16.1.2 Using Multibyte Characters in Plain Text/HTML Document Task Attachments

If you select Send task attachments with email notifications in the Advanced tab of the Notifications section of the Human Task Editor and add a plain text/HTML document as the task attachment, multibyte characters in the email attached document are replaced with question marks.As a workaround, use a binary document (such as .doc) as the task attachment.

16.1.3 Schema Elements Not Displaying in Expression Builder for Old Projects

If you open a human task file from a release prior to 11g PS2, schema elements do not display in the Expression Builder. For example, perform the following steps:

  1. Open the human task file in Oracle JDeveloper.

  2. In the Assignment section, double-click the participant type and add a participant using the Expression Builder. Note that the schema elements do not display in the Schema section of the Expression Builder dialog. Only the file location is shown.

For 11g R1 and PS1 human tasks, there is a workaround:

  1. Edit anything, such as adding a space in the Task Title field, and select File > Save All.

  2. Close the human task file and reopen it. The Expression Builder correctly displays the schema elements.

Note that this workaround does not apply to 10g human task files.

16.1.4 HierarchyBuilder and HierarchyPrincipal Not Visible in Expression Builder

The visibility flags for the getManager and getPrincipal methods are not enabled in the Oracle Business Rules Editor. This causes the HierarchyBuilder and HierarchyPrincipal functions to not be visible in the Expression Builder dialog.

To make these functions visible, you must first enable the visibility flags for the getManager and getPrincipal methods in the Oracle Business Rules Editor.

  1. Go to Facts > Java Facts.

  2. Click HierarchyBuilder.

  3. Click Edit.

  4. Change the attribute to Methods.

  5. Check the visibility for the getManager and getPrincipal methods.

16.1.5 FYI Tasks Must Be Claimed Before They Can Be Dismissed

If an FYI task is sent to multiple users, a user must first select the Claim button to claim the task before they can dismiss it.

16.1.6 Task Attachments are Automatically Saved

When you add an attachment to a task in Oracle BPM Worklist, it is automatically saved without you having to explicitly save it.

This can cause a conflict in a scenario in which you added an attachment, forgot to delete it, assumed that it was not saved (because you never performed a save action), and then reassigned, approved, or performed a similar action on the task. As a consequence, the task attachment was sent to the next assignee even though you did not intend to send it.

As a workaround, delete the attachment if it was added inadvertently before routing the task to others.

16.1.7 Push Back Action Not Supported If Including the Task History of Another Task

When you include the task history of another task in a SOA composite application, selecting the push back action in Oracle BPM Worklist is not supported. For example:

  1. Create a SOA composite application that includes a BPEL process.

  2. In Oracle BPEL Designer, drag a human task into the BPEL process.

  3. In the Create Human Task dialog, select the Add icon to invoke the Human Task Editor.

  4. Create a human task (for example, named humantask_1).

  5. Add a payload to the task and assign the task to a user (for example, jcooper).

  6. Save the human task and exit the Human Task Editor.

  7. In Oracle BPEL Designer, drag a second human task into the BPEL process.

  8. Create a second human task (for example, named humantask_2) and add a payload to the task.

  9. Assign the second task to another user (for example, jstein).

  10. Click the Advanced tab for the second human task and select the Include task history from checkbox.

  11. From the dropdown list, select the first task, human_task1.

  12. Select Use existing payload.

  13. Save and deploy the SOA composite application.

  14. Invoke an instance of the SOA composite application.

  15. Log in to Oracle BPM Worklist as the assignee of the first task (jcooper), and approve the task for human_task1.

    The task is completed.

  16. Log in to Oracle BPM Worklist as the assignee of the second task (jstein).

    The task for human_task2 is displayed.

  17. From the dropdown box, select Push back.

    Although a push back is completed successfully, the task is still assigned to jstein.

16.1.8 Editing Visibility Rules Invokes a Feedback Dialog with an Exception Error

If you make changes to the visibility rules in the Access page of the Human Task Editor (for example, set assignees to have no access to task history), save your changes, switch to Source view, and then switch back to Design view, a feedback dialog is displayed with an exception error.

Close this dialog. There is no loss of functionality.

16.1.9 Approve and Reject Actions in Actions Tab for Admin User Should Be Disabled

In the Actions tab of the Access page of the Human Task Editor, the Admin user is incorrectly assigned the actions Approve and Reject by default. These checkboxes should be disabled. During runtime, if you log in to Oracle BPM Worklist as the Admin user, the actions Approve and Reject are not in the Actions dropdown list. This is the expected behavior.

16.1.10 Specifying Date From and Date To Values on Notification Management Page

You must specify values for both the Date From and Date To fields in the Search sections on the Notification Management page in Oracle Enterprise Manager Fusion Middleware Control Console to receive the correct search results. These fields do not work independently. Specifying values for only one of these fields does not display the correct search results. To access these fields:

  1. Right-click soa-infra in the navigation tree, and select Service Engines > Human Workflow > Notification Management.

  2. Expand the Search icon in the Outgoing Notifications section or Incoming Notifications section to display the Date From and Date To fields.

16.1.11 Some Fields Do Not Display After Updating and Saving a ToDo Task in a Portlet

After you update and save a ToDo task or a ToDo subtask for a business task in a Worklist Portlet, the following fields should appear, but do not: Assignee, Status, and Search options.

16.1.12 Stuck Java Threads in com.sun.jndi.ldap.Connection.readReply in Workflow on AIX

When multiple LDAP calls to the Oracle WebLogic Embeded LDAP Server are made from Workflow on the IBM AIX platform using the IBM JDK, the client making the LDAP request may hang and errors like the following may be seen in the SOA managed server logs:

Jun 15, 2009 9:47:01 PM PDT Error WebLogicServer BEA-000337 [STUCK] ExecuteThread: '0' for queue: 'weblogic.kernel.Default (self-tuning)' has been busy for "606" seconds working on the request "oracle.bpel.services.workflow.query.ejb.TaskQueryService_oz1ipg_EOImpl", which is more than the configured time (StuckThreadMaxTime) of "600" seconds. Stack trace:

java.lang.Object.wait(Native Method)

Oracle recommends using Oracle Internet Directory (OID) as the LDAP server for Workflow to avoid this error.

16.2 Configuration Issues and Workarounds

This section describes configuration issues and their workarounds. It includes the following topic:

16.2.1 English Is the Only Language Included in the Default localeList

For better performance, only the English language is listed for the LocaleList property in the System MBean Browser in Oracle Enterprise Manager Fusion Middleware Control Console. If you want to display the task title, category, and subcategory in other languages or add additional languages, you must change the required language locale in the System MBean Browser.

  1. Right-click soa-infra in the navigator, and select Administration > System MBean Browser.

  2. Expand Application Defined MBeans > oracle.as.soainfra.config > Server: server_name > WorkflowConfig.

  3. Click human-workflow.

  4. To change the language, perform the following steps:

    1. In the Name column, click LocaleList.

    2. In the Value field, click the value.

    3. In the Name column, click Language.

    4. In the Value field, change en to the language value that you want to use.

    5. Click Apply.

  5. To add additional languages, perform the following steps:

    1. Click the Operations tab.

    2. In the Name column, click createLocale.

    3. In the Value field, enter a value. For better performance, ensure that you include only the languages that you need for task title, category, and subcategory.

    4. Click Invoke.