POWL Query Refresh

SAP has provided few standard POWL applications such as MANAGER_MSS_INBOX or IBO_INBOX in which the refresh functionality is achieved through the refresh handler's and to achieve the same in custom POWL applications, SAP has given us few options.

All the standard POWL applications use 'POWL_UI_COMP' standard POWL Webdynpro Component and 'POWL' Webdynpro Applictaion. The 'POWL' Webdynpro Application has 'REFRESHA' and 'REFRESHQ' parameters which controls the way in which the queries get refreshed.

 

Let’s have a look at the possible ways of enabling the auto refresh functionality in the custom POWL applications.

1. While assigning the POWL_TYPE to a Query in the transaction 'POWL_QUERY', set the parameter refresh type to 'On Every List Visit'. This will refresh the query every time user access the application irrespective of the user session.

 

2. In the application configuration of custom POWL application, we can set the parameter (REFRESHQ-Refresh the current Query).

3. While assigning the application to a role (PFCG) add a parameter REFRESHQ and set this to 'X'.

4. In the handle action of feeder interface IF_POWL_FEEDER, set the parameter E_DO_REFERSH to 'X'. This will trigger the query refresh after the user has performed some action on POWL list (Approve/Reject/Opening the form etc.).

5. By scheduling a batch job for the custom queries using the report 'POWL_WLOAD' to Refresh POWL Queries.

Note: Suppose we have made some changes to the existing query logic in the feeder class and the query is still displaying the old results then run the report 'POWL_D04' to delete the cached selection criteria for queries.

Configuring a New POWL Inbox for Workflow Tasks

SAP has provided the following feeder classes using which we can develop the new POWL inbox as per the Requirements.

• CL_IBO_INBOX_FEEDER_ALERT    :          Inbox Feeder for Alert
• CL_IBO_INBOX_FEEDER_BASE      :          Base Feeder Class for Inbox
• CL_IBO_INBOX_FEEDER_NOTIF    :          Inbox Feeder for notification
• CL_IBO_INBOX_FEEDER_UTILS     :          Inbox Feeder Utility Class
• CL_IBO_INBOX_FEEDER_WI          :          Inbox Work Item Feeder

We can find the inbox list provided by SAP in the T-code: POWL_COCKPIT. Some of the standard POWL Inbox's are:

• IBO_INBOX
• MANAGER_MSS_INBOX 

Now, consider a requirement wherein the POWL inbox should have only Work items and the Notifications.

We can achieve this either by changing the configurations of Standard POWL Inboxes or by creating a new inbox.

To change the configurations of Standard POWL Inbox follow the below steps.

a. Run POWL_TYPER transaction and delete the POWL types assigned to the Application (Inbox)

b. Run the transaction POWL_QUERYR and delete the Query ID’s assigned to the Application(Inbox)

Suppose we have to develop a New Inbox then follow the below steps. 

1. Execute the T-Code: FPB_MAINTAIN_HIER and add a New Entry.

  

2. Execute the T-Code: POWL_TYPE and add the new entries. Since the requirement is to include only Workitems and Notifications in the POWL Inbox we can make use of the feeder classes CL_IBO_INBOX_FEEDER_WI and CL_IBO_INBOX_FEEDER_NOTIF.

 3. Execute the T-Code: POWL_ TYPER and assign the POWL ID’s added in the 2^nd step to the Application created in the 1^st step.

4. Execute the T-Code: POWL_QUERY and assign the POWL ID’s added in the 2^nd step to the Queries.

 

5. Execute the T-Code: POWL_QUERYR and assign the Query ID’s added in the 4^th step to the Application created in the 1^st step.

6. Execute the T-Code SE80 and select the Web Dynpro Component ‘POWL_UI_COMP’  and create a component configuration and add the POWL Application.

7. Execute the T-Code SE80 and select the Web Dynpro Component ‘IBO_WDC_INBOX’  and create a component configuration and add the POWL Application.

8. Create an application configuration for the same application ‘IBO_WDC_INBOX’ and assign the component configurations created for ‘POWL_UI_COMP’  and ‘IBO_WDC_INBOX’.

9. To test the New Inbox, Run the T-Code POWL_COCKPIT, Select the Inbox Application and Click on Launch POWL. 

10. Assign this application to the PFCG role and in NWBC desktop Client/ NWBC HTML versions the New Inbox is displayed as shown below.

For Configuring Launchpad and Workflow tasks please refer the below documents from SCN:

• http://scn.sap.com/docs/DOC-31014
• http://scn.sap.com/people/amit.tyagi2/blog/2013/04/22/mss-powl-inbox-config-ehp5-above--launchpadhandler-action

For developing custom POWL applications please refer the below documents.

• http://www.sdn.sap.com/irj/scn/go/portal/prtroot/docs/library/uuid/90838640-02b9-2d10-71a2-c3eb6b881574?overridelayout=true 
• http://help.sap.com/bp_ekit604/BBLibrary/Documentation/K50_How_to_Guide_EN_DE.doc