configuring uwl on sap netweaver ce for local guided proceduress

14
Configuring UWL for Guided Procedures on Composition Environment Applies to: Guided Procedures with SAP NetWeaver Composition Environment, SAP NetWeaver 7.0, Universal Worklist Summary This paper discusses how to configure the UWL for Guided Procedures in SAP NetWeaver Composition Environment. Author: SAP NetWeaver Product Management Created on: 19 February 2009 SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com © 2009 SAP AG 1

Upload: kprjgd

Post on 06-Mar-2015

98 views

Category:

Documents


2 download

TRANSCRIPT

Page 1: Configuring UWL on SAP NetWeaver CE for Local Guided Proceduress

Configuring UWL for Guided Procedures on Composition Environment

Applies to: Guided Procedures with SAP NetWeaver Composition Environment, SAP NetWeaver 7.0, Universal Worklist

Summary This paper discusses how to configure the UWL for Guided Procedures in SAP NetWeaver Composition Environment. Author: SAP NetWeaver Product Management Created on: 19 February 2009

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com © 2009 SAP AG 1

Page 2: Configuring UWL on SAP NetWeaver CE for Local Guided Proceduress

Configuring UWL for Guided Procedures on Composition Environment

Table of Contents 1 Introduction ......................................................................................................................................................3 2 Configuring UWL on SAP NetWeaver CE for local Guided Procedures Actions ............................................3

2.1 Viewing the created XML ..........................................................................................................................4 2.2 XML for GP connector ..............................................................................................................................5

2.2.1 Points of Interest in the XML ...............................................................................................................................6 3 When the Universal Worklist executes in SAP NetWeaver 7.0.......................................................................8

3.1 Checklist if things do not work after you have completed the configuration...........................................11 Copyright...........................................................................................................................................................14

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com © 2009 SAP AG 2

Page 3: Configuring UWL on SAP NetWeaver CE for Local Guided Proceduress

Configuring UWL for Guided Procedures on Composition Environment

1 Introduction This document covers the configuration of Universal Worklist for Guided Procedures actions. It discusses configuring 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.

2 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 we use 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.

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com © 2009 SAP AG 3

Page 4: Configuring UWL on SAP NetWeaver CE for Local Guided Proceduress

Configuring UWL for Guided Procedures on 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.

Figure 1

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com © 2009 SAP AG 4

Page 5: Configuring UWL on SAP NetWeaver CE for Local Guided Proceduress

Configuring UWL for Guided Procedures on Composition Environment

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"/>

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com © 2009 SAP AG 5

Page 6: Configuring UWL on SAP NetWeaver CE for Local Guided Proceduress

Configuring UWL for Guided Procedures on Composition Environment

</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>

2.2.1 Points of Interest in the XML 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”.

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com © 2009 SAP AG 6

Page 7: Configuring UWL on SAP NetWeaver CE for Local Guided Proceduress

Configuring UWL for Guided Procedures on Composition Environment

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.

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com © 2009 SAP AG 7

Page 8: Configuring UWL on SAP NetWeaver CE for Local Guided Proceduress

Configuring UWL for Guided Procedures on Composition Environment

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.

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com © 2009 SAP AG 8

Page 9: Configuring UWL on SAP NetWeaver CE for Local Guided Proceduress

Configuring UWL for Guided Procedures on Composition Environment

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.

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com © 2009 SAP AG 9

Page 10: Configuring UWL on SAP NetWeaver CE for Local Guided Proceduress

Configuring UWL for Guided Procedures on Composition Environment

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.

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com © 2009 SAP AG 10

Page 11: Configuring UWL on SAP NetWeaver CE for Local Guided Proceduress

Configuring UWL for Guided Procedures on Composition Environment

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*.

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com © 2009 SAP AG 11

Page 12: Configuring UWL on SAP NetWeaver CE for Local Guided Proceduress

Configuring UWL for Guided Procedures on Composition Environment

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

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com © 2009 SAP AG 12

Page 13: Configuring UWL on SAP NetWeaver CE for Local Guided Proceduress

Configuring UWL for Guided Procedures on Composition Environment

Restarting 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.

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com © 2009 SAP AG 13

Page 14: Configuring UWL on SAP NetWeaver CE for Local Guided Proceduress

Configuring UWL for Guided Procedures on Composition Environment

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com © 2009 SAP AG 14

Copyright © 2009 SAP AG. All rights reserved.

No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP AG. The information contained herein may be changed without prior notice.

Some software products marketed by SAP AG and its distributors contain proprietary software components of other software vendors.

Microsoft, Windows, Outlook, and PowerPoint are registered trademarks of Microsoft Corporation.

IBM, DB2, DB2 Universal Database, OS/2, Parallel Sysplex, MVS/ESA, AIX, S/390, AS/400, OS/390, OS/400, iSeries, pSeries, xSeries, zSeries, System i, System i5, System p, System p5, System x, System z, System z9, z/OS, AFP, Intelligent Miner, WebSphere, Netfinity, Tivoli, Informix, i5/OS, POWER, POWER5, POWER5+, OpenPower and PowerPC are trademarks or registered trademarks of IBM Corporation.

Adobe, the Adobe logo, Acrobat, PostScript, and Reader are either trademarks or registered trademarks of Adobe Systems Incorporated in the United States and/or other countries.

Oracle is a registered trademark of Oracle Corporation.

UNIX, X/Open, OSF/1, and Motif are registered trademarks of the Open Group.

Citrix, ICA, Program Neighborhood, MetaFrame, WinFrame, VideoFrame, and MultiWin are trademarks or registered trademarks of Citrix Systems, Inc.

HTML, XML, XHTML and W3C are trademarks or registered trademarks of W3C®, World Wide Web Consortium, Massachusetts Institute of Technology.

Java is a registered trademark of Sun Microsystems, Inc.

JavaScript is a registered trademark of Sun Microsystems, Inc., used under license for technology invented and implemented by Netscape.

MaxDB is a trademark of MySQL AB, Sweden.

SAP, R/3, mySAP, mySAP.com, xApps, xApp, SAP NetWeaver, and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and in several other countries all over the world. All other product and service names mentioned are the trademarks of their respective companies. Data contained in this document serves informational purposes only. National product specifications may vary.

These materials are subject to change without notice. These materials are provided by SAP AG and its affiliated companies ("SAP Group") for informational purposes only, without representation or warranty of any kind, and SAP Group shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP Group products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty.

These materials are provided “as is” without a warranty of any kind, either express or implied, including but not limited to, the implied warranties of merchantability, fitness for a particular purpose, or non-infringement.

SAP shall not be liable for damages of any kind including without limitation direct, special, indirect, or consequential damages that may result from the use of these materials.

SAP does not warrant the accuracy or completeness of the information, text, graphics, links or other items contained within these materials. SAP has no control over the information that you may access through the use of hot links contained in these materials and does not endorse your use of third party web pages nor provide any warranty whatsoever relating to third party web pages.

Any software coding and/or code lines/strings (“Code”) included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or grossly negligent.