Custom Filter in UWL
Recently I came across the requirement of custom filter in UWL. Customer wants a filter which filters the ESS Work-items with other R/3 related work-items.
Problem Statement in Brief :
Customer was getting all the work-items in his UWL Inbox, either it is related to ESS (e.g. Leave Request approval/rejection, Medical etc.) or R/3 related work items (e.g. SES & PO). User was unable to find out ESS related work-items in the Task view of Universal Work-list.
So, Customer want to differentiate the ESS work-items (leave approval/rejection, medical claims etc.) with other R/3 related work-items.
When I saw the requirement, I was clear that this can be accomplished with the help of Custom views. In this blog, I tried to explain the process steps.
Concept: We need to create a new sub views by modifying and uploading the new “myuwlconfig.xml” file.
Point to Note: All required Task ID (ESS related) must be linked with the new custom view.
We can create custom views for specific tasks. For example, we can create a specific view for the approval of ESS related (Leave requests) Work-Items.
Process Flow:
In order to add custom views you do need to have some knowledge of the backend workflow. The first thing you need to know is the exact step from the workflow where the customized view is required. Workflows are divided into tasks. Each task is one step in the workflow that must be executed. The task links to SAP functionality.
The tasks are stored on the database with TS########.A task is always represented with the letters TS and a number. The number is unique to the task. You must know the exact task number that will link to the custom view.
I have downloaded the standard XML file (uwl.webflow.SAP_ECC_Custom.xml) and changed this XML file with my custom name (myuwlconf.xml) and then upload that into the Portal with high priority. To do this follows the menu path System Administration ® System configuration ®+ Universal Worklist and Workflow +®Universal Worklist Administration.
Below is the Standard UWL Task View:
*Steps: </p><p>1- Download the UWL-System specific file (e.g. uwl.webflow.SAP_ECC_XXX.xml) from the UWL Administration Iview. (We are not going to discuss here how to download & upload the .xml file from UWL Admin & Config Iview) </p><p>2- *Rename that file to “myessuwlconf.xml”.
*3- Insert Code for custom view inside the <Views></Views> Tag.</p><p>4-* Check the validity and upload the file with “high priority”.
5- If your file is not valid, you will get the error message while uploading the custom file.
6- Clear the cache after uploading the file.
In order to create new custom view (Subview or Filter) in UWL without any programming, I added the following code in the xml.
–
Sample Code For Custom View Starts here—-
—-
Sample Code For Custom View Ends here—-
–
Have a closer look into the above code, inside the <View> tag; I have mentioned the different-2 Task number, which required for the ESS work-items.
After Performing above 6 Steps, login to portal and check, you must have the custom view, as shown in below picture.
When you select the custom view, then you will get the following look. This will work as Filter for the ESS work Items.
In backend Business workplace (Tcode- SBWP), we have option to add additional columns, so the approver can see additional details while executing workitem from backend. Is this same possible in UWL?
Thanks, Vinoth
Yes, you can add additonal columns in UWL, for this you need to modify the UWL XML file.
Please check below link for more detail:
http://help.sap.com/saphelp_nw70/helpdata/en/99/6ee25a81a04c87bee21a97123007af/frameset.htm
Thanks,
Dheerendra
Will You please share modified xml file"myuwlconf.xml" to rajeshy2kp@gmail.com.
You were faster than me writing a blog regarding this topic.
One more thing to :All required Task ID (ESS related) must be linked with the new custom view.
If you rename the hr tasks from uwl.task.webflow.xxx to uwl.task.webflow.ess.xxx
you should be able to use this for the parameter supportedItemTypes="uwl.task.webflow.ess".
This uses all ESS tasks. No more updates and better to read ....
Regards,
Kai
Hi Dheera,
Where is the sample code? It's not there in this blog.
I had the same requirement. Would be a great pleasure if you share the content:)
BR,
RAM.
Hi Ram,
dunno hw it got deleted from blog..I will check my repository and post the same again.
Thanks
Dheerendra
Thanks a lot Dheerendra.
Awaiting for your update:)
BR,
RAM
Hi Ram,
Please find the sample code below:
--------------Sample Code starts here--------
<ItemTypes>
<ItemType name="uwl.task.approval.webflow.TS00008267.SAP_ECC
" connector="WebFlowConnector"
defaultView="MyApprovalView" defaultAction="viewDetail"
executionMode="default">
<ItemTypeCriteria systemId="SAP_ECC "
externalType="TS00008267"
connector="WebFlowConnector"/>
<Actions>
<Action name="accept"
groupAction="yes" handler="UserDecisionHandler">
<Properties>
<Property
name="decisionKey" value="2"/>
</Properties>
</Action>
<Action name="reject"
groupAction="yes" handler="UserDecisionHandler">
<Properties>
<Property
name="decisionKey" value="1"/>
</Properties>
</Action>
</Actions>
</ItemType>
</ItemTypes>
<Views>
<View
name="MyApprovalView" selectionMode="SINGLESELECT"
width="98%" supportedItemTypes="uwl.task.approval"
columnOrder="subject, priority, creatorId, createdDate, attachmentCount,
status, accept, reject" sortby="priority:descend, dueDate:ascend,
createdDate:descend" tableDesign="STANDARD"
visibleRowCount="17" headerVisible="no"
queryRange="undefined" tableNavigationFooterVisible="yes"
tableNavigationType="CUSTOMNAV" actionRef=""
refresh="300" dueDateSevere="86400000"
dueDateWarning="259200000" emphasizedItems="new"
displayOnlyDefinedAttributes="yes"
dynamicCreationAllowed="yes" actionPosition="top"
referenceBundle="task_approvals">
<Descriptions default="Custom Mass Approval View">
<ShortDescriptions>
<Description Language="en" Description="Custom Mass
Approval View"/>
</ShortDescriptions>
</Descriptions>
<DisplayAttributes>
<DisplayAttribute name="reject" type="radiobutton"
width="" sortable="no" format="default"
actionRef="reject" referenceBundle="reject"
hAlign="CENTER" vAlign="TOP" maxTextWidth="0"
headerVisible="yes">
<Descriptions default="">
<ShortDescriptions>
<Description Language="en"
Description="Reject"/>
</ShortDescriptions>
</Descriptions>
</DisplayAttribute>
<DisplayAttribute name="accept"
type="radiobutton" width="" sortable="no"
format="default" actionRef="accept" referenceBundle="approve"
hAlign="CENTER" vAlign="TOP" maxTextWidth="0"
headerVisible="yes">
<Descriptions default="">
<ShortDescriptions>
<Description Language="en"
Description="Accept"/>
</ShortDescriptions>
</Descriptions>
</DisplayAttribute>
</DisplayAttributes>
<Actions>
<Action
reference="submitUserDecisions"/>
<Action
reference="Refresh"/>
<Action
reference="defaultGlobalWizard"/>
<Action reference="addToNavigation"/>
<Action
reference="removeFromNavigation"/>
</Actions>
</View>
</Views>
-----------Sample Code Ends here--------------
I would suggest to go thourgh below link before making any change to xml file.
http://help.sap.com/saphelp_nw04s/helpdata/en/4d/1789a925ba42acac0a77b92da4a600/frameset.htm
Thanks
Dheerendra
Dheera,
Thanks a lot:)
BR,
RAM