This document describes the various refresh methods in POWL with reference to SRM and POWL.
Refresh can be triggered by various means in the SRM POWL, the 3 primary methods of refresh will be described in the sections below.
What is Partial Refresh?
The POWL partial refresh allows the online refresh of items in the POWL worklist without any user intervention like clicking the refresh button. This is also generally referred to Automatic Refresh in SRM and is available and introduced to SRM 7.0 from SP6 in the form of a new customizing switch.
Prior to Partial Refresh, what happened?
When users logged onto their Portal, they see a list of Items in the POWL result table. Now if the purchaser selects an item and goes into edit mode and changes, for example, quantity and saves the document, changes made in a BO inside the application are not visible in the POWL result table. The user has to click button REFRESH to see the changes even though it is updated in the database. This is because POWL contains no information about changes done in application to that point. In other words, POWL is not refreshed automatically for each database update done by application. Therefore the user would see the old value for Quantity field in POWL result table.
The proposed solution implemented was that if a user changes a document in an application and press SAVE or any button, which triggers a database update the changes done in the application are immediately visible in the POWL result table, if the corresponding field displayed in the POWL result table is updated in the backend.
An event is fired by the application and communication with POWL is established when database changes are made in the application.
You can active it via SPRO SAP Supplier Relationship Management -> SRM Server -> Cross Application Basic Settings -> POWL and Advanced Search -> Deactivate/Activate automatic refresh of the POWL.
How does this work?
When a user clicks on buttons like order, save, delete etc in the application, an event called PARTIAL_REFRESH is fired by Web Dynpro . Along with this event also information like the Header GUID of BO is also passed as an event parameter. This event is caught by POWL. POWL will then perform a database search using search agent for the corresponding Header GUID and retrieves all the items which belong to the corresponding Business Object.
Each of the POWL classes and interfaces inherit the METHOD REACT_ON_PARTIAL_REFRESH from the class /SAPSRM/CL_CLL_POWL_BASE_AGENT.
Importantly, the partial refresh also makes a re-assessment of the query selection criteria in case these also have changed before the update.
The event PARTIAL_REFRESH is fired from the FPM OVERRIDE HANDLER (/SAPSRM/CL_FPM_OVRIDE_HDLR), Methods HANDLE_POWL_PARTIAL_UPDATE and TRIGGER_POWL_PARTIAL_UPDATE.
Refresh on Query Load
Automatic Refresh on initial load of query. Parameters required to be added to either the portal iView or PFCG entry for NWBC.
The parameters are:
- REFRESHA=X to refresh ALL the queries of the loaded feeder after logon/POWL Load.
- REFRESHQ=X to refresh only the current default query which is opened after logon/POWL Load. The suggestion is to use this one, because "refresh all" is more performance consuming. As a an alternative, you can set Automatic Refresh on Query Switch, to make sure that every query is refreshed before opening it.
The parameter needs to be inserted into the application parameters of the relevant iView in the Portal Content Administration. The parameter must be inserted into each application parameter string where the POWL will be loaded, i.e. adding this to just the ‘Check Status’ iView in the Employee role will only enable the auto refresh for this iView.
Content Administration – Portal Content – Content Provided By SAP – Specialist – SRM 7.0 – Core – iViews – Role Specific - <Relevant Role> - <Relevant iView>
The parameter needs to be inserted into the Web Dynpro application parameters for the relevant node of the role menu.
PFCG - <Role> - Change – ‘Menu’ tab – Right Click the relevant node – Change Nodes (or click 'Details' )– Enter the parameter required (REFRESHQ=X or REFRESHA=X etc)
Refresh on Query Switch
The query will be refreshed when user clicks the POWL query.
Changes are made to the POWL_UI_COMP Web Dynpro Component, more specifically to its associated Component Configurations, these are:
- /SAPSRM/POWL_CONFIG_SC for Employee Self Services,
- /SAPSRM/POWL_CONFIG for other SRM areas.
To set this parameter, follow the steps:
- Access transaction SE80.
- Select Web Dynpro Component POWL_UI_COMP.
- Choose the relevant Component Configuration (e.g. /SAPSRM/POWL_CONFIG_SC POWL Configuration for Employee Self-Service).
- Click Start Configurator button to enter the Component Configurator.
- Go to the element confData.
- The parameter refreshOnQuerySwitch should be selected and saved.
SAP Community Wiki - POWL Refresh from Client Window
SAP Help - The POWL Component at Runtime
Related SAP Notes/KBAs
SAP Note 1461713 - POWL refresh: different options
SAP Note 1438945 - POWL Automatic Refresh
SAP Note 1440946 - Customizing for POWL automatic refresh
KBA 1960232 - Automatic Refresh doesn't Work for Document Status in SRM system
KBA 2196050 - SRM Partial Refresh takes a long time
KBA 2484424 - SRM POWL refresh is not finished