This tutorial covers the configuration of the Universal Worklist (UWL) for Guided Procedures actions. It shows how to configure the UWL in the SAP NetWeaver Composition Environment when the Guided Procedures are executed locally. It also covers required configuration when the Universal Worklist is on a SAP NetWeaver Portal 7.0, and Guided Procedures actions are in SAP NetWeaver Composition Environment.

1. Configuring UWL on SAP NetWeaver CE for local Guided Procedures Actions

• Begin by adding the Guided Procedures connector to Universal Worklist.
• Navigate to System Administration -> System Configuration.
• Select Universal Worklist -> Administration.

• Select to add a new system
• Enter a System Alias and select the “GuidedProceduresConnector”. In the following example, SAP used GPSystem as our System Alias.
• Select save and you are done.

This is all the setup required for local Guided Procedures actions to appear in the local UWL running on the SAP NetWeaver Composition Environment.

2.1. Viewing the created XML

After you add your new system, you can see the XML that was created by selecting ““Click to Administrate Item Types and View Definitions”

You can now see the created xml for file uwl.gp.config

If you have problems executing Guided Procedures actions from UWL after doing the configuration, refer to SAP Note 1131403.

The following is the correct XML.

2.2 XML for GP connector

<?xml version="1.0" encoding="utf-8"?><!DOCTYPE UWLConfiguration PUBLIC '-//SAP//UWL1.0//EN''uwl_configuration.dtd'><UWLConfiguration version="2.0"><ItemTypes><ItemType name="uwl.task.gp" connector="GuidedProceduresConnector"defaultView="uwlTaskGPView" defaultAction="launchGP" executionMode="default"><Actions><Action name="launchGP" groupAction="no" handler="IViewLauncher"referenceBundle="launch_sap" returnToDetailViewAllowed="yes"launchInNewWindow="no" launchNewWindowName="GPWindow"launchNewWindowFeatures="resizable=yes,scrollbars=yes,status=yes,toolbar=no,menubar=no,location=no,directories=no"><Properties><Property name="DynamicParameter" value="app.processId=${item.processID}&amp;app.taskId=${item.activityID}&amp;"/><Property name="page" value="pcd:portal_content/com.sap.pct/platform_add_ons/com.sap.caf.eu.gp.folders.gp/com.sap.caf.eu.gp.roles.runtime/com.sap.caf.eu.gp.worksets.runtime/com.sap.caf.eu.gp.pages.procinstance2"/><Property name="System" value="SAP_LocalSystem"/></Properties></Action></Actions></ItemType></ItemTypes><Views><View name="uwlTaskGPView" selectionMode="SINGLESELECT" width="98%"supportedItemTypes="uwl.task.gp" columnOrder="subject, process,creatorId, createdDate, dueDate, status" sortby="dueDate:ascend,createdDate:descend" tableDesign="STANDARD" visibleRowCount="10"headerVisible="no" queryRange="undefined" tableNavigationFooterVisible="yes" tableNavigationType="CUSTOMNAV" actionRef="" refresh="300"dueDateSevere="86400000" dueDateWarning="259200000" emphasizedItems="new" displayOnlyDefinedAttributes="yes" dynamicCreationAllowed="yes"actionPosition="bottom"><Descriptions default="Guided Procedures"><ShortDescriptions><Description Language="de" Description="Guided Procedures"/><Description Language="en" Description="Guided Procedures"/></ShortDescriptions></Descriptions><DisplayAttributes><DisplayAttribute name="phase" type="string" width="" sortable="yes"format="default" hAlign="LEFT" vAlign="BASELINE" maxTextWidth="0"headerVisible="yes"><Descriptions default="Phase"><ShortDescriptions><Description Language="de" Description="Phase"/><Description Language="en" Description="Phase"/>Your Description - Configuring UWL for Guided Procedures on CompositionEnvironment</ShortDescriptions></Descriptions></DisplayAttribute><DisplayAttribute name="process" type="string" width="" sortable="yes"format="default" hAlign="LEFT" vAlign="BASELINE" maxTextWidth="0"headerVisible="yes"><Descriptions default="Process"><ShortDescriptions><Description Language="de" Description="Process"/><Description Language="en" Description="Process"/></ShortDescriptions></Descriptions></DisplayAttribute></DisplayAttributes><Actions><Action name="launchGP" groupAction="no" handler="IViewLauncher"referenceBundle="launch_sap" returnToDetailViewAllowed="yes"launchInNewWindow="no" launchNewWindowName="GPWindow"launchNewWindowFeatures="resizable=yes,scrollbars=yes,status=yes,toolbar=no,menubar=no,location=no,directories=no"><Properties><Property name="DynamicParameter" value="app.processId=${item.processID}&amp;app.taskId=${item.activityID}&amp;"/><Property name="page" value="pcd:portal_content/com.sap.pct/platform_add_ons/com.sap.caf.eu.gp.folders.gp/com.sap.caf.eu.gp.roles.runtime/com.sap.caf.eu.gp.worksets.runtime/com.sap.caf.eu.gp.pages.procinstance2"/><Property name="System" value="SAP_LocalSystem"/></Properties></Action></Actions></View></Views></UWLConfiguration>

One item important to note is <Property name=”System” value=”SAP_LocalSystem”/> which indicates that the system is the local SAP system. Also important to note is the location in the Portal Content Directory for the iViews. value = “pcd:portal_content/com.sap.pct/platform_add_ons/com.sap.caf.eu.gp.folders.gp/com.sap.caf.eu.gp.folders.pages/com.sap.caf.eu.gp.pages.procinstance2”. You can see this by navigating to Content Administration -> Portal Content. Then select Portal Content -> Content Provided by SAP -> platform_add_ons -> Guided Procedures -> Pages -> Process Instance. If you look at the path you will see the full path in the pcd. This path should match your xml path.

3 . When the Universal Worklist executes in SAP NetWeaver 7.0

The following steps outline configuration required for GP actions in a CE system need to appear in SAP NetWeaver 7.0 UWL. The steps to complete this task are also covered in online help at: http://help.sap.com/saphelp_nw70/helpdata/EN/43/ef06a7860c7061e10000000a1553f6/content.htm. Note: The user ID on the CE system must be exactly the same as the user ID on the 7.0 system. In your SAP NetWeaver Portal 7.0 landscape directly, add the SAP NetWeaver Composition Environment system as a web service system. Enter the WSDL URL for the CE system. The WSDL you need is:

• http://<hostname>:<port>/GPWorkItemProvider/Default?wsdl
• Setup the user management as UIDPW.
• Create a system alias.

The following graphic shows the CE system setup in a 7.0 system landscape.

The user ID on the 7.0 system must be the same as the user ID on the CE system. It is not required that you do any user mapping, however the user name must be the same on both systems. Add the system entered in the system landscape to the UWL administration, using the Guided Procedures connector. This is done the same way as if it was a local GP connector. The system alias must match the system alias given in the portal system landscape.

After registering the system, you need to upload XML to configure the UWL behaviour. The name=”uwl.task.gp._SystemAlias_for_remote_system” will be GPRemote from our example, or the name system name you used. Of course, the value for the url must be your host and port.

<ItemType name="uwl.task.gp._SystemAlias_for_remote_system_"connector="GuidedProceduresConnector"defaultView="uwlTaskGPView" defaultAction="editItem" executionMode="default"><Actions><Action name="editItem" groupAction="" handler="UrlLauncher"returnToDetailViewAllowed="yes"launchInNewWindow="yes"><Properties><Property name="app.taskId" value="${item.activityID}"/><Property name="url" value="http://_host_:_port_/webdynpro/dispatcher/sap.com/caf~eu~gp~ui~rt/Runtime"/><Property name="app.processId" value="${item.processID}"/></Properties><Descriptions default="Open Task"/></Action></Actions></ItemType>

Update the Visual Administrator settings on the 7.0 system:

• In the Visual Administrator tool, navigate to Cluster -> <system ID> -> Server <instance number> -> Services -> Web Services Security.
• Under Web Services, select Security Configuration -> Web Service Clients -> sap.com caf~eu~gp~model~uwlproxy -> com.sap.caf.eu.gp.model.uwl.proxy.facade*DefaultPort_Document.
• Set the authentication type to BASIC and provide a username and password. These credentials must match the administrator’s username and password on the provider system (on the 7.0 system)
• Make sure that you have assigned the portal role GP Administrator to the user that accesses the Web service.
• Save the changes.

Optionally, you might want to test the WSDL URL (http://<CEhost:port>/GPWorkItemProvider/Default?wsdl) from the 7.0 operating system to ensure the ports are set correctly to reach the WSDL.

Refresh the cache in the UWL and ensure there are Guided Procedures actions in the runtime of the CE system. Navigate to the UWL of the 7.0 system. The work items will appear. If you want to see the system the work items are from, then use the personalization to add the system ID as a column. The following screen shot shows a UWL running on SAP NetWeaver Portal 7.0, with actions from Guided Procedures executing in SAP NetWeaver Composition Environment, Enhancement Package 1.

3.1 Checklist if things do not work after you have completed the configuration

If you complete the configuration steps as outlined, and you still do not see the guided procedures actions in the 7.0 UWL, check the following:

• On the SAP NetWeaver 7.0 system, open a browser and enter the WSDL to ensure the ports are set correctly: http://<CEhost:port>/GPWorkItemProvider/Default?wsdl.
• On the SAP NetWeaver 7.0 system, use the web services navigator to test the WSDL and ensure you receive a result.
• Add the system to the “white list” from the Visual Administrator. Details on how to do this are listed in this link: http://help.sap.com/saphelp_nw04/helpdata/en/7c/f257422d095542e10000000a1550b0/frameset.htm.
• Ensure the proxy settings in the Visual Administrator are setup correctly. In our example, our 7.0 was on 10.22.42.158, port 50000. In the following screen shot we used an asterisk (*) in the white list, in our exclude list we included 10*.

Ensure the proxy settings are setup correctly in the 7.0 portal. If you must make changes, be sure to restart the service.

Restart the service

Once you have checked and updated these items, the guided procedures actions from SAP NetWeaver CE will appear in the UWL running on SAP NetWeaver 7.0.

Click on the following link to access the official SAP tutorial on:

• Configuring UWL for Guided Procedures on Composition Environment.