Professional Documents
Culture Documents
Guide)
Table of Contents
Purpose of this document
What is SAP Enhancement Package 5
Implementation Overview
Switch Framework
Support packs
Tools for new implementation / upgrade
1. Initial Setup for Employee Self Service (ESS) in EHP5
1.1 Business Packages and System Requirements
1.2 Web Dynpro Objects
1.3 Portal Objects
1.4 Prerequisite Configuration
2. Creating a Custom ESS Launchpad
3. Assigning the custom Launchpad to Floor Plan Manager
4. Locating the ‘ESS Overview’ Portal iView.
5. Customizing the ‘ESS Menu’ application.
6. Customizing the ‘Personal Information’ application
7. Customize the Personal Information Application Configuration (HRESS_AC_PERSINFO)
8. Customize the Personal Information Component Configuration (HRESS_CC_PER_OVP)
9. Customize the Personal Information Overview Screen
10. Configure country Specific Screens using HRESS_CC_PER_CONFIG
11. Create Country- Specific custom Screens
12. Create/Customize Country Specific Screens
13. Modify /Remove fields from ESS Screens
14. Add custom fields to ESS Screens
15. Advanced customizations using the Feeder Class
16. References
Switch Framework
After the installation, no user interface or process change takes place. You must explicitly activate
new functions so that they become visible in the system. As a result, changes are predictable and
there are no side effects as only the activated areas change.
With the switch framework technology (transaction SFW5), it is possible to control the activation
of new SAP objects in ABAP-based SAP systems. The activation process triggers a background
job that automatically performs all changes in the SAP system. It is recommended to test the
installation and up gradation on a sandbox system.
After you have activated a business function, you can see the changes and new developments in
the SAP system, for example
Menu entries
New screens
New fields on the application user interfaces
IMG activities required for the implementations
New table entries in Customizing tables and system tables
You can create a transport request with the current settings of the switch framework. You can
check functional changes and the impact of an activated business function in advance in the
business function documentation.
Support packs
SAP enhancement packages have Support Packages of their own that are equivalent to the Support
Package versions of the underlying SAP system. Install the enhancement package in combination
with the latest available Support Package stack. This approach reduces installation, modification
adjustment, and testing effort. Using this strategy, you can install SAP enhancement packages as a
normal maintenance activity together with Support Package stacks.
An enhancement package requires a specific Support Package stack level in the source release
SAP system. If the SAP system is on a lower Support Package stack level, all relevant Support
Package stacks are automatically included into the download queue, as well as the latest available
Support Packages for the enhancement package.
Please refer https://service.sap.com/sap/support/notes/1484460 for all EHP5 related support packs
1.2 Web Dynpro Objects
ESS UIs are based on WebDynpro applications. Customization can be done through
application configurations delivered by SAP for each application component.
Use SE80 to access application configurations (Package – Web Dynpro – Application
Configurations).
The following table is a list of commonly used ESS packages and application configurations:
Package Application Configuration. Service
Personal
PAOC_ESS_PER_WDA HRESS_AC_PERSINFO Information
Personal
Information
HRESS_CC_PER_OVR_<subtype> International
PAOC_ESS_PER_XX _XX overview screen
Personal
Information
International
PAOC_ESS_PER_XX HRESS_CC_PER_DTL_<subtype>_XX detail screen
Performance
PAOC_HAP_PA_PMP_UI HRESS_AC_PMP_EMPLOYEE Appraisal PMP
1.3 Portal Objects
The following portal contents are included in BP ESS 1.50:
a. iView:
Overview: portal_content/com.sap.pct/every_user/com.sap.pct.erp.ess.wda.bp_folder/
com.sap.pct.erp.ess.wda.iviews/com.sap.pct.erp.ess.wda.Overview
b. Page:
Overview: portal_content/com.sap.pct/every_user/com.sap.pct.erp.ess.wda.bp_folder/
com.sap.pct.erp.ess.wda.pages/com.sap.pct.erp.ess.wda.Overview
c. Workset:
Employee Self-Service:
portal_content/com.sap.pct/every_user/com.sap.pct.erp.ess.wda.bp_folder/
com.sap.pct.erp.ess.wda.worksets/com.sap.pct.erp.ess.wda.Employee_Self_Service
d. Role:
portal_content/com.sap.pct/every_user/com.sap.pct.erp.ess.wda.bp_folder/
com.sap.pct.erp.ess.wda.roles/com.sap.pct.erp.ess.wda.Employee_Self_Service_WDA
To make the contents accessible, assign the role Employee_Self_Service_WDA or a customized copy
of the role to users or user groups. In User Administration. Any custom content should be assigned to
the role.
1.4 Prerequisite Configuration
a. Business Function HCM_ESS_WDA_1
Activate this business function (SFW5) to enable ESS ABAP functionality. Use SFW2 to
check its status.
To change the Contents, like the processes seen above in each of the groups we have to create a custom launchpad.
Go to transaction LPD_CUST. Select ESS (Role), Menu (instance) as shown below.
Once inside the ESS Menu, we will see the following applications under the ESS Launch pad:
For customization, it is better to create a new Launchpad as a copy of the Standard SAP ESS Menu. To do this, go
back to transaction LPD_CUST, and select ‘New Launchpad’.
Enter following details on the next screen
Click on ‘New Folder’ to create new nodes like ‘Benefits & Payment’ Etc on the right hand side in ZESS Launchpad.
Once the Folders are created, we can drag and drop applications from the SAP standard launchpad to the custom one
as shown below
Once the custom launchpad is ready, we need to ensure that we see the custom launchpad on the portal instead of the
standard one. For this we need to make some modifications using the Component Configuration in Floor Plan
Manager.
We can add various types of objects in the launchpad like WebDynpro ABAP or Java Application , a SAP
transaction , a URL page , a Portal Object etc . See screenshot below :
3. Assigning the custom Launchpad to Floor Plan
Manager
Goto transaction SE80, in the Repository Browser & select ‘WebDynpro Comp. / Intf. ‘. Enter the component name
‘FPM_LAUNCHPAD_UIBB’ and press enter.
Select the ‘HRESS_CC_MENU_AREA_GROUP’ Component Configuration and click on ‘Start Configurator’.
Once the Component Configuration is opened in a browser window, Change the ‘Role’ property of ‘launchpad’ to
ZESS as shown below. The default value should be ESS.
So far we have customized the ESS Launchpad to add / remove applications as per our need and have assigned the
custom launchpad to FPM. Now that we have the launchpad customized, let’s see how to make the Portal point to
custom applications instead of the standard one.
In Step 1, we saw how to change the content inside each of the groups above by creating a custom launchpad. The
layout of the groups and their appearance (not their content) can be managed by making a copy of the
HRESS_AC_MENU Configuration.
Go to SE80, Open Component ‘FPM_OVP_COMPONENT’, Navigate to WebDynpro Applications ->
HRESS_A_MENU->Applic. Configurations as shown below. Select HRESS_AC_MENU and click on Start
Configurator.
Once you click on ‘Start Configurator’, new browser windows should open which will display the Application
configuration.
To make a copy of the Application config, click the ‘Copy. Then we will have to enter Configuration Name,
Description, Package and Transport Request for the Copy object as shown below.
This copy can now be seen in the Object navigator and can be used to make any customizations required.
6. Customizing the ‘Personal Information’
application
ESS contains various applications like Personal Information, Benefits and Payment, Travel and Expenses etc. Let’s
see how to customize the Personal Information Screen.
The Standard Personal Info screen consists of following sections:
1. Personal Data
2. Addresses
3. Communication
4. Bank Information
5. Family Members / Dependents
6. Internal Data
7. Benefits Medical Information
Screenshot for Standard Personal Information Screen delivered by SAP
To customize the screen above, we need to modify the Application Configuration (HRESS_AC_PERSINFO).
After creating a copy by giving the appropriate transport request. Go back to SE80 Goto, open WebDynpro
component FPM_OVP_COMPONENT -> WebDynpro Applications -> HRESS_A_PERSINFO -
>ZHRESS_AC_PERSINFO. Click on Start Configurator.
You will see the following screen for ZHRESS_AC_PERSINFO Application Configuration., Click on Display button
On the next screen, we see that our custom application configuration (ZHRESS_AC_PERSINFO) is still bound to the
a standard Component Configuration for Personal Information (HRESS_CC_PER_OVP)
This means that we are still referring to the Standard SAP Screen. We need to customize the Component
Configuration for Personal Information (HRESS_CC_PER_OVP) and assign it to our custom Application
Configuration (ZHRESS_AC_PERSINFO).
8. Customize the Personal Information Component
Configuration (HRESS_CC_PER_OVP)
With the component configuration, you can control the behavior of each individual component within a Web Dynpro
application or the user interface of individual views. For each component, several records of configuration data can be
created. This kind of data record contains different types of attribute, Web Dynpro built-in attributes, component
attributes, and administration data.
For more information about component configurations, refer the following link:
http://help.sap.com/saphelp_nw70ehp1/helpdata/en/47/b1693856293c5ce10000000a421937/content.htm
SE80 Goto, open WebDynpro component FPM_OVP_COMPONENT -> Component Configuration ->
HRESS_CC_PER_OVP. Click on ‘Start Configurator’.
Once you see the Component Configuration screen, click on ‘Copy’ to make a Copy and enter proper name, Package
and transport request.
Once the copy is created we can start customizing it.
Go Back to SE80, open WebDynpro component FPM_OVP_COMPONENT -> Component Configuration ->
ZHRESS_CC_PER_OVP1. Click on ‘Start Configurator’.
Once the Component Configuration is opened in a new browser, click on ‘Change’
You will then see the below screen which Shows the FPM layout of the Personal Information Overview page
The Component Configuration has two parts, ‘Hierarchy’ on the Left hand side and ‘Preview’ on the right hand side.
The Personal Information FPM has two logical entities:
1. The ‘Overview’ screen ( as seen above) which has ‘Business Cards’ to various process
2. The ‘Detail’ Screen which is shown upon clicking on a business card in overview page and contains more details
about the particular process
The Hierarchy sections show a list of all the Details screens as well as the overview screen. Clicking on each page on
the left side shows the FPM preview on the right side. The Figure above shows a preview of the Overview page.
On the attributes screen use the ‘Hidden Element’ Checkbox to hide that UIBB from the overview screen.
b. Modify the Component Configuration of a UIBB
In case we need to use a different component configuration than the one provided by SAP, we can change that in the
Attributes window.
c. Adding a custom WDA application to the Overview Screen
We can also embed custom applications on the Overview Page. To do this the custom WebDynpro Component needs
to implement FPM interfaces as seen below:
Once the FPM interfaces are implemented the custom application can then be added to the over view screen as
follows:
Select the appropriate ‘Section’ of the Overview page in the left pane
Then Click ‘Add UIBB’ on the right, from the dropdown menu, selects ‘Add UIBB’ again.
On the next screen enter information about the custom application
Save the Overview Configuration and the custom application can be seen on the overview screen along with other
Standard SAP components as seen below:
You will see the below screen next
You can sort the configuration by Country or Infotype.
Here you can which Country is using which screen. For example, if you need to see which screen is used for US
Address, do the following:
Sort the table by Country Version
Scroll down and Select ‘USA’, you will see all the Infotype and subtypes configured for USA
Then Click on ‘Addresses’, on the right side we can see the Country Version 10 (USA) & Infotype 0006 (Address)
To check which screen is used for US Address, select the UIBB under Addresses
Following things are to be noticed on the right side of the screen:
Action on UIBB – Replace
Source UIBB – HRESS_CC_PER_DTL_ADDRESS_XX ( Detail screen for International
Address)
Target UIBB – HRESS_CC_PER_DTL_ADDRESS_US ( Detail screen for US Address)
This means that the component dynamically replaces the International Screen with the US Screen during runtime.
This way, we can find out the Screen Configuration used by any Country for any Infotype.
We will now see how to develop a ‘custom’ screen for an Infotype and use it in ESS.
Click on Start Configurator, once the browser opens create a Copy of the Configuration and give it the name
ZHRESS_CC_PER_OVR_ADDRESS_US. Please note the naming convention, custom object should start
with ‘Z’, and replace the XX by US. XX stands for international version.
Once the custom configuration (ZHRESS_CC_PER_OVR_ADDRESS_US) is created, open it in SE80 &
click on Start Configurator
You will then be able to see the Configuration with a list of fields as shown below.
13. Modify /Remove fields from ESS Screens
Here you can modify / remove any fields and save the configuration. Just select the field you desire to delete
and click on the delete button.
See screenshot below on how to remove ‘valid to’ field.
In addition to removing unwanted fields, we also have the option to modify other properties related to the
screen field. Here are some of the properties:
UI Element Type ( Text view , input field etc) Design ( Bold , Italic etc )
Width Alignment
Tooltip Layout
Here is an example of what can be achieved by removing / modifying screen properties:
These fields can be modified/removed from the overview screen. Follow similar process to modify/remove
fields form the detail screen. Please note that detailed screen uses the WebDynpro component
FPM_FORM_UIBB . (Overview screen uses FOM_LIST_UIBB)
In case custom fields need to be added to the screen, these fields need to be added to the CI INCLUDE of
the respective structure. The above screenshot shows custom fields added the include CI_US_R0006 of the
US screen structure HCMT_BSP_PA_US_R0006.
The same custom screen fields can now be seen in the FPM configuration for US address
HRESS_CC_PER_DTL_ADDRESS_US.
Please note that adding fields to the structure only makes them available to be added on the screen. We need
to use HRPAD00INFTYUI BADI. For more information on this BADI please see the following link:
http://help.sap.com/erp2005_ehp_05/helpdata/en/4f/d526cb575e11d189270000e8322f96/content.htm
The above screenshot shows available methods in the implementation of HRPAD00INFTYUI BADI. The
method ‘INPUT_CONVERSION’ is used to transfer data from the screen to the Infotype (PA*** table). The
‘OUTPUT_CONVERSION’ method can be used to transfer data from the Infotype (PA*** table) to the
screen.
Following extract of the code from the ‘OUTPUT CONVERSION’ method shows how to move values from
the Infotype to screen fields.
Similarly , data can be moved from the Screen to the Infotype using the ‘INPUT CONVERSION’ method.
Once we click the ‘Edit Feeder’ button it will show the name of the Feeder class as seen below
We can either add a custom feeder class here or change the existing one in SE80 as shown:
The Feeder class has various methods which can be modified as required to customize the output.
We have covered majority of the aspects of customizing ESS screens spanning the pre-requisites to the
customizations required in the code. Please see the references section below for additional information links.
16. References
SAP EHP 5 Homepage
http://help.sap.com/erp605/
Business Package for Employee Self-Service (WDA) 1.50
http://help.sap.com/erp2005_ehp_05/helpdata/en/25/340b0507434193adbfe3f8fc8896c7/content.htm
Customizing fields in overview screen
http://help.sap.com/erp2005_ehp_05/helpdata/en/77/804c18e1844944b7f8baf53159be78/frameset.htm
Configuration of services
http://help.sap.com/erp2005_ehp_05/helpdata/en/3a/fe6eac579d4a9ead651d77
9a2dbd23/content.htm
Innovations in SAP ERP HCM
http://sapehp5.blogspot.com/
Products: SAP ERP Human Capital Management
Topics: Enterprise Resource Planning
12809 Views
Average User Rating
(5 ratings)
inShare
12 Comments
Siddharth Rajora Jul 20, 2012 7:13 PM
Excellent work!
But for the launchpad you dont need to copy as indicated by Sagar in his earlier blogs and hardcode the
value into the FPM launchpad.
Like (0)
o
Virag Shinde Jul 20, 2012 7:22 PM (in response to Siddharth Rajora)
Thanks Siddharth. I will update the document in line with the other blogs to make sure we have
the best solution possible.
Like (0)
o
Sai Balajii Nukalla Nov 5, 2012 2:28 PM (in response to Siddharth Rajora)
Hi Siddharth,
I have made the changes to the standard ESS Launchpad. But what attribute values do we have to
give to the Component Configuration HRESS_CC_MENU_AREA_GROUP so that the changed
launch pad would be displayed on the Portal? Please let me know.
I have posted the discussion here http://scn.sap.com/thread/3261824 just incase if this is not the
correct place to discuss.
Thanks for the help,
Balajii
Like (0)
Ramanjaneyulu Vajja Jul 20, 2012 7:55 PM
Great job ! Virag
This is most useful document for who are going to implement ESS module on EHP5.
Like (0)
SANGHAMITRA KARTHIK Jul 20, 2012 8:39 PM
Nice Article and very helpful. You have taken a lot of efforts to put it up. Great job !
Like (0)
Manivannan Palanisamy Aug 23, 2012 9:10 AM
Very good article!!! and very helpful to beginners
Like (0)
Sahil Kohli Sep 18, 2012 1:48 PM
Hi Virag,
Excellent Blog!
We are having EHP 6 .. want to ask you whether thr is much difference b/w EHP5 & 6. I am unable to find
a good explanatory blog on EHP6.
Regards
Sahil Kohli
Like (0)
Yugandhar Reddy Sep 19, 2012 10:19 PM
Hi Virag,
This is an excellent blog, in one single blog you have explained end to end, starting from how to activate
the switches, how to configure, customize the ESS apps.
It’s a great helpful document. It’s worth of 5 or 6 blogs of effort.
Good Job. Hope we would be seeing more contributions from you.
Regards,
Yugandhar Reddy
Like (0)
Arpita Bhandari Oct 24, 2012 11:41 AM
Hi Virag,
Great work! Very informative blog and the number of views itself (6178 to date!) tells how much needed it
was
Cheers,
Arpita
Like (0)
Virag Shinde Oct 24, 2012 3:46 PM
Thank you all
Like (0)
girish kumar Oct 31, 2012 3:04 PM
Well presented information, highly organised notes, thanks for sharing!
Like (0)
Song Lin Nov 1, 2012 6:07 AM
So great, thanks.