Skip to end of metadata
Go to start of metadata

Problem

When launching a task from the UWL, you see that the launching is not correct. Different problems may arise due to that. For example a task launching an application running in Standards mode (UI5, HTML5, etc), and using Navigation Mode 3 (headerless portal navigation).

Application might not open at all, or the navigation within the application might face problems. 

Keywords

  • UWL
  • launchInNewWindow
  • launch in new window

Solution

To change the navigation mode used when launching a task, you first need to check the UWL Support Information to see what the XML file defining the Item is, and what the itemtype to which the item belongs is.

Say that you find the following:

This means that you have to seek for the current definition of this work item inside of XML file with name HRAdmin. All the XML files can be found by going to System Administration --> System Configuration --> Universal Worklist & workflow --> Universal Worklist Administration --> Click to administrate Item types and view definitions.

There, select the XML file (HRAdmin, in this example) and search for the Item Type, which in this example is uwl.task.webflow.TS179000160

Copy ALL the <Itemtype... XML tag. In this example:

-------------------------------------------------------------------
<ItemType name="uwl.task.webflow.TS17900160" connector="WebFlowConnector" defaultView="com.sap.pct.erp.hradmin.HRAdminWDAView" defaultAction="launchIView" executionMode="pessimistic">
<ItemTypeCriteria externalType="TS17900160" connector="WebFlowConnector"/>
<Actions>
<Action name="launchIView" groupAction="no" handler="SAPAppLauncher" referenceBundle="com.sap.pct.erp.hradmin.openform" returnToDetailViewAllowed="yes" launchInNewWindow="yes">
<Properties>
<Property name="SAPIntegrator" value="ROLES://portal_content/com.sap.pct/specialist/com.sap.pct.erp.hradmin.bp_folder/com.sap.pct.erp.hradmin.11.bp_folder/com.sap.pct.erp.hradmin.11.roles/com.sap.pct.erp.hradmin.11.HRAdministrator/overview/com.sap.pct.erp.hradmin.11.overview/com.sap.pct.erp.hradmin.11.start_processes"/>
<Property name="DynamicParameter" value="WI_ID=${item.externalId}"/>
</Properties>
</Action>
</Actions>
</ItemType>
-------------------------------------------------------------------

 Paste it in a new XML file. Notice that a valid UWL XML file must have the following syntax 
-------------------------------------------------------------------
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE UWLConfiguration PUBLIC '-//SAP//UWL1.0//EN' 'uwl_configuration.dtd'>
<UWLConfiguration version="1.0">
<Actions>
</Actions>
<ItemTypes> 
</ItemTypes>
<Views> 
</Views> 
</UWLConfiguration>
-------------------------------------------------------------------

Now, include the ItemType definition in your new XML file, and modify the launchInNewWindow property to the desired value. The possible values are listed on SAP KBA 2158932.

In case you need the new window to be rendered in Standards document mode of Internet Explorer browser, then the resulting XML would stay like the following:
-------------------------------------------------------------------
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE UWLConfiguration PUBLIC '-//SAP//UWL1.0//EN' 'uwl_configuration.dtd'>
<UWLConfiguration version="1.0">
<Actions>
</Actions>
<ItemTypes> 
<ItemType name="uwl.task.webflow.TS17900160" connector="WebFlowConnector" defaultView="com.sap.pct.erp.hradmin.HRAdminWDAView" defaultAction="launchIView" executionMode="pessimistic">
<ItemTypeCriteria externalType="TS17900160" connector="WebFlowConnector"/>
<Actions>
<Action name="launchIView" groupAction="no" handler="SAPAppLauncher" referenceBundle="com.sap.pct.erp.hradmin.openform" returnToDetailViewAllowed="yes" launchInNewWindow="SHOW_STANDARDS_EXTERNAL_HEADERLESS">
<Properties>
<Property name="SAPIntegrator" value="ROLES://portal_content/com.sap.pct/specialist/com.sap.pct.erp.hradmin.bp_folder/com.sap.pct.erp.hradmin.11.bp_folder/com.sap.pct.erp.hradmin.11.roles/com.sap.pct.erp.hradmin.11.HRAdministrator/overview/com.sap.pct.erp.hradmin.11.overview/com.sap.pct.erp.hradmin.11.start_processes"/>
<Property name="DynamicParameter" value="WI_ID=${item.externalId}"/>
</Properties>
</Action>
</Actions>
</ItemType>

</ItemTypes>
<Views> 
</Views> 
</UWLConfiguration>
------------------------------------------------------------------- 

As it can be seen, with this XML the navigation mode would switch from 1 to 10. Notice the following differences:

  • Navigation Mode 1 - Display in Separate Window - launchInNewWindow="yes"
  • Navigation Mode 10 - Display in separate headerless portal window (standard mode) - launchInNewWindow="SHOW_STANDARDS_EXTERNAL_HEADERLESS"

Further details about the possible values can be obtained on SAP KBA 2158932.

NOTE: After changing the value in the xml file ,Upload the xml file with high priority and clear the UWL Cache as per KBA 2141647

Clearing the cache is not recommended in production environment.

  • No labels