Roadmap - Configuring the Worklist Service for WebCenter Portal Applications

Managing the Worklist Service 22-7 To work with the Worklist service, you must install Oracle SOA Suite. For information about how to install Oracle SOA Suite, see the Oracle Fusion Middleware Installation Guide for Oracle SOA Suite and Oracle Business Process Management Suite. After installing Oracle SOA Suite, you can integrate the Worklist service into your WebCenter applications by setting up connections to the BPEL server.

22.3.2 BPEL Server - Security Considerations

The Worklist service displays tasks for the currently authenticated user. For WebCenter users to store and retrieve tasks on an Oracle SOA Suite BPEL server, their user names must either exist in a shared user directory LDAP, or be set up similarly on both the WebCenter application and the BPEL Server. For example, if the user rsmith wants to use the Worklist service to store and retrieve tasks from the BPEL server, you must ensure that the user rsmith exists on both the BPEL server and within your application. To access BPEL task details from the WebCenter Worklist component, without incurring additional login prompts, WebCenter and Oracle SOA Suite servers must be configured to a shared Oracle Single Sign-On server. For more information, see Section 30.2, Configuring Oracle Access Manager OAM and Section 30.3, Configuring Oracle Single Sign-On OSSO. For a secure connection you can optionally configure WS-Security between SOA and WebCenter Spaces. For information, see Chapter 32, Configuring WS-Security.

22.3.3 BPEL Server - Limitations in WebCenter

Worklist task flows function inside authenticated pages only. If Worklist task flows are placed on unsecured pages, that is public pages that are not navigated to from an application on which the user has logged in, the warning message You must log in to view Worklist content. is displayed. This is done to ensure that a session for the current users is available to determine which users tasks are to be queried.

22.4 Setting Up Worklist Connections

This section includes the following subsections: ■ Section 22.4.1, What You Should Know About Worklist Connections ■ Section 22.4.2, Registering Worklist Connections ■ Section 22.4.3, Activating a Worklist Connection ■ Section 22.4.4, Modifying Worklist Connection Details ■ Section 22.4.5, Deleting Worklist Connections

22.4.1 What You Should Know About Worklist Connections

The Worklist service enables WebCenter applications to show authenticated users a list of BPEL worklist items currently assigned to them. BPEL worklist items are open BPEL tasks from one or more BPEL worklist repositories. A connection to every BPEL server that delivers worklist items is required. Multiple worklist connections are allowed so that WebCenter users can monitor and manage assignments and notifications from a range of BPEL servers. 22-8 Oracle Fusion Middleware Administrators Guide for Oracle WebCenter If a BPEL server cannot be contacted, the Worklist task flow indicates that the connection is unavailable and any reason for the error is recorded in the servers diagnostic log. This log is located on the server that hosts the worklist components log directory. For a WebCenter Spaces application: .user_projectsdomainsbase_domainserversWC_SpaceslogsWC_Sp aces-diagnostic.log. For a WebCenter Portal application: .user_projectsdomainsbase_domainserversWC_SpaceslogsWC_Cu stomPortal-diagnostic.log. WebCenter Spaces WebCenter Spaces requires a BPEL server connection to support its internal workflows, that is, Space membership notifications and Space subscription requests. The BPEL server providing this functionality is always a BPEL server included with the Oracle SOA Suite. For more information, see Section 9.3, Specifying the BPEL Server Hosting WebCenter Spaces Workflows. The Worklist service can share the SOA instance connection and by doing so, display worklist items relating to Space activity in each users Worklist task flow.

22.4.2 Registering Worklist Connections

This section includes the following subsections: ■ Section 22.4.2.1, Registering Worklist Connections Using Fusion Middleware Control ■ Section 22.4.2.2, Registering Worklist Connections Using WLST

22.4.2.1 Registering Worklist Connections Using Fusion Middleware Control

To register a Worklist connection: 1. Log in to Fusion Middleware Control and navigate to the home page for WebCenter Spaces or the WebCenter Portal application. For more information, see: ■ Section 6.2, Navigating to the Home Page for WebCenter Spaces ■ Section 6.3, Navigating to the Home Page for WebCenter Portal Applications 2. Do one of the following: ■ For WebCenter Spaces - From the WebCenter menu, choose Settings Service Configuration . ■ For WebCenter applications - From the Application Deployment menu, choose WebCenter Service Configuration. 3. From the list of services on the WebCenter Service Configuration page, select Worklist .

4. To register a new connection, click Add

Figure 22–3 . Managing the Worklist Service 22-9 Figure 22–3 Configuring Worklist Connections 5. Enter a unique name for the Worklist connection and set it as the active connection Table 22–3 . This connection is picked up after you restart the managed server. 6. Enter connection details for the BPEL server Table 22–4 . Table 22–3 Worklist Connection - Name Field Description Name Enter a unique name for the connection. The name must be unique across all connection types within the WebCenter application. This name may be displayed to users working with the worklist feature in the WebCenter application. Users may organize their worklist assignments through various sorting and grouping options. The option Group By Worklist Server displays the name you specify here so its important to enter a meaningful name that other users will easily recognize, for example, Human Resources. Active Connection Select to activate this worklist connection in the WebCenter application. Once activated, worklist items from the associated BPEL server display in users worklists. Multiple worklist connections may be active at a time, enabling WebCenter users to monitor and manage assignments and notifications from a range of BPEL servers. If you need to disable a connection for any reason, deselect this option. Edit mode only. Check boxes indicate whether other components share this connection: ■ Worklist Indicates whether the Worklist service displays items associated with this connection. ■ WebCenter Spaces Application Indicates whether WebCenter Spaces uses the same BPEL server connection for internal workflows, such as Space membership notifications, Space subscription requests, and more. The BPEL server that provides this functionality is the BPEL server included with the Oracle SOA Suite. For more information, see Section 9.3, Specifying the BPEL Server Hosting WebCenter Spaces Workflows. Although not shown here, the Notification service might be set up to use the BPEL server connection too. See, Section 18.2, Setting Up a Notifications Connection Type . Before modifying connection properties, consider impact to any other components that share this connection.