configgp-uwl

7/22/2019 configGP-UWL

http://slidepdf.com/reader/full/configgp-uwl 1/14

Configuring UWL for GuidedProcedures on CompositionEnvironment

Appl ies 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 CompositionEnvironment.

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



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


© 2009 SAP AG 2




1 Introduction

This document covers the configuration of Universal Worklist for Guided Procedures actions. It discussesconfiguring UWL in the SAP NetWeaver Composition Environment when the Guided Procedures areexecuted locally. It also covers required configuration when the Universal Worklist is on a SAP NetWeaverPortal 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 theSAP NetWeaver Composition Environment.


© 2009 SAP AG 3




2.1 Viewing the created XML

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

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

Figure 1


© 2009 SAP AG 4

If you have problems executing Guided Procedures actions from UWL after doing the configuration, refer toSAP Note 1131403. The following is the correct XML.

2.2 XML for GP connector

<?xml vers i on="1. 0" encodi ng="utf - 8"?>

<! DOCTYPE UWLConf i gur at i on PUBLI C ' - / / SAP/ / UWL1. 0/ / EN' ' uwl _conf i gur at i on. dt d'

>

<UWLConf i gur at i on versi on="2. 0">





<Act i ons>

<Act i on name=" l aunchGP" groupAct i on="no" handl er=" I Vi ewLauncher"

r ef erenceBundl e=" l aunch_sap" r eturnToDet ai l Vi ewAl l owed="yes" l aunchI nNewWi ndow="no"

l aunchNewWi ndowName="GPWi ndow"

l aunchNewWi ndowFeat ures="r esi zabl e=yes, scr ol l bars=yes, st atus=yes, t ool bar=no, menubar=n

o, l ocat i on=no, di r ect ori es=no">

<Proper t i es>

<Pr oper t y name="Dynami cPar amet er "val ue="app. processI d=${i t em. processI D}& app. t askI d=${i t em. act i vi t yI D}& " / >

<Pr oper t y name="page"

val ue="pcd: por t al _cont ent / com. sap. pct / pl at f orm_add_ons/ com. sap. caf . eu. gp. f ol ders. gp/ c

om. sap. caf . eu. gp. r ol es. r unt i me/ com. sap. caf . eu. gp. wor kset s. r unt i me/ com. sap. caf . eu. gp. p

ages. pr oci nst ance2" / >

<Pr oper t y name="Syst em" val ue="SAP_Local Syst em"/ >

</ Propert i es>

</ Act i on>

</ Act i ons>





<Vi ews>

<Vi ew name="uwl TaskGPVi ew" sel ect i onMode="SI NGLESELECT" wi dt h="98%"support edI t emTypes="uwl . t ask. gp" col umnOr der="subj ect , pr ocess, cr eat orI d,

cr eat edDate, dueDate, st atus" sor t by="dueDate: ascend, cr eat edDate: descend"

t abl eDesi gn="STANDARD" vi si bl eRowCount="10" headerVi si bl e="no" queryRange="undef i ned"

t abl eNavi gat i onFoot erVi si bl e="yes" t abl eNavi gat i onType="CUSTOMNAV" act i onRef =""

r ef r esh="300" dueDat eSevere="86400000" dueDat eWar ni ng="259200000"

emphasi zedI t ems="new" di spl ayOnl yDef i nedAt t r i butes="yes" dynami cCr eat i onAl l owed="yes"

act i onPosi t i on="bott om">

<Descr i pt i ons def aul t ="Gui ded Procedur es">

<Short Descr i pt i ons>

<Descr i pt i on Language="de" Descr i pt i on="Gui ded Procedur es" / >

<Descr i pt i on Language="en" Descr i pt i on="Gui ded Procedur es" / >

</ Short Descr i pt i ons>

</ Descr i pt i ons><Di spl ayAt t r i but es>

<Di spl ayAt t r i but e name="phase" type="st r i ng" wi dt h="" sor t abl e="yes"

f ormat ="def aul t " hAl i gn="LEFT" vAl i gn="BASELI NE" maxTextWi dth="0"

headerVi si bl e="yes">

<Descr i pt i ons def aul t ="Phase">

<Shor t Descr i pt i ons>

<Descr i pt i on Language="de" Descr i pt i on="Phase"/ >

<Descr i pt i on Language="en" Descr i pt i on="Phase"/ >


© 2009 SAP AG 5

https://service.sap.com/sap/support/notes/1131403

https://service.sap.com/sap/support/notes/1131403

</ Descr i pt i ons>

</ Di spl ayAt t r i but e>

<Di spl ayAt t r i but e name="pr ocess" t ype="st r i ng" wi dt h="" sor t abl e="yes"

f ormat ="def aul t " hAl i gn="LEFT" vAl i gn="BASELI NE" maxTextWi dth="0"

headerVi si bl e="yes">

<Descr i pt i ons defaul t ="Process">

<Shor t Descr i pt i ons>

<Descr i pt i on Language="de" Descr i pt i on="Process" / >

<Descr i pt i on Language="en" Descr i pt i on="Process" / >


</ Descr i pt i ons>

</ Di spl ayAt t r i but e>

</ Di spl ayAt t r i but es>

<Act i ons>

<Act i on name=" l aunchGP" groupAct i on="no" handl er=" I Vi ewLauncher"

r ef erenceBundl e=" l aunch_sap" r eturnToDet ai l Vi ewAl l owed="yes" l aunchI nNewWi ndow="no"

l aunchNewWi ndowName="GPWi ndow"

l aunchNewWi ndowFeat ures="r esi zabl e=yes, scr ol l bars=yes, st atus=yes, t ool bar=no, menubar=n

o, l ocat i on=no, di r ect ori es=no">

<Proper t i es>

<Pr oper t y name="Dynami cPar amet er "val ue="app. processI d=${i t em. processI D}& app. t askI d=${i t em. act i vi t yI D}& " / >

<Pr oper t y name="page"

val ue="pcd: por t al _cont ent / com. sap. pct / pl at f orm_add_ons/ com. sap. caf . eu. gp. f ol ders. gp/ c

om. sap. caf . eu. gp. r ol es. r unt i me/ com. sap. caf . eu. gp. wor kset s. r unt i me/ com. sap. caf . eu. gp. p

ages. pr oci nst ance2" / >

<Pr oper t y name="Syst em" val ue="SAP_Local Syst em"/ >

</ Propert i es>

</ Act i on>

</ Act i ons>

</ Vi ew>

</ Vi ews>

</ UWLConf i gur at i on>

2.2.1 Points of Interest in the XML

One item important to note is <Property name="System" value="SAP_LocalSystem"/> which indicates thatthe 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”.


© 2009 SAP AG 6




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. Ifyou look at the path you will see the full path in the pcd. This path should match your xml path.


© 2009 SAP AG 7

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 SAPNetWeaver 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 Environmentsystem 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 thatyou do any user mapping, however the user name must be the same on both systems.


© 2009 SAP AG 8

Add the system entered in the system landscape to the UWL administration, using the Guided Proceduresconnector. This is done the same way as if it was a local GP connector. The system alias must match thesystem 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 namesystem name you used. Of course, the value for the url must be your host and port.

<I t emType name="uwl . t ask. gp. _Syst emAl i as_f or_r emote_syst em_"

connect or="Gui dedPr oceduresConnector" def aul t Vi ew="uwl TaskGPVi ew"

def aul t Acti on="edi t I t em" execut i onMode="def aul t "> <Act i ons>

<Act i on name="edi t I t em" gr oupAct i on="" handl er="Ur l Launcher"

r eturnToDetai l Vi ewAl l owed="yes" l aunchI nNewWi ndow="yes"> <Pr oper t i es>

<Pr oper t y name="app. t askI d" val ue="${i t em. act i vi t yI D}"/ > <Pr oper t y name="ur l "

val ue="ht t p: / / _host _: _por t _/ webdynpr o/ di spat cher/ sap. com/ caf ~eu~gp~ui ~r t / Runt i me"/ > <Pr oper t y name="app. pr ocessI d" val ue="${i t em. pr ocessI D}"/ >

</ Propert i es> <Descri pt i ons def aul t ="Open Task" / >

</ Acti on> </ Act i ons>



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 matchthe 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 Webservice.

Save the changes.


© 2009 SAP AG 9

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.


© 2009 SAP AG 10

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

3.1 Checklist if th ings 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 inthe 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 setcorrectly: http://<CEhost:port>/GPWorkItemProvider/Default?wsdl.

On the SAP NetWeaver 7.0 system, use the web services navigator to test the WSDL and ensure youreceive a result.

Add the system to the “white list” from the Visual Administrator. Details on how to do this are listed in thislink: 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 on10.22.42.158, port 50000. In the following screen shot we used an asterisk (*) in the white list, in ourexclude list we included 10*.


© 2009 SAP AG 11

http://help.sap.com/saphelp_nw04/helpdata/en/7c/f257422d095542e10000000a1550b0/frameset.htm

http://help.sap.com/saphelp_nw04/helpdata/en/7c/f257422d095542e10000000a1550b0/frameset.htm




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


© 2009 SAP AG 12




Restarting the service

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


© 2009 SAP AG 13





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 ofIBM Corporation.

Adobe, the Adobe logo, Acrobat, PostScript, and Reader are either trademarks or registered trademarks of Adobe SystemsIncorporated 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 ofCitrix Systems, Inc.

HTML, XML, XHTML and W3C are trademarks or registered trademarks of W3C®, World Wide Web Consortium, MassachusettsInstitute 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 theirrespective logos are trademarks or registered trademarks of SAP AG in Germany and in several other countries all over the world. Allother product and service names mentioned are the trademarks of their respective companies. Data contained in this document servesinformational purposes only. National product specifications may vary.

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

These materials are provided “as is” without a warranty of any kind, either express or implied, including but not limited to, the impliedwarranties 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 thesematerials. SAP has no control over the information that you may access through the use of hot links contained in these materials anddoes 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 beused in a productive system environment. The Code is only intended better explain and visualize the syntax and phrasing rules ofcertain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errorsor damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or grossly negligent.

configgp-uwl

Documents