ESS MSS Multi-Client Configuration - Part1 _ SCN

4/22/2014 ESS MSS Multi-Client Configuration - Part1 | SCN

http://scn.sap.com/community/erp/hcm/employee-self-service/blog/2013/07/25/ess-mss-multi-client-configuration-guide 1/26

Getting Started Newsletters Store

Products Services & Support About SCN Downloads

Industries Training & Education Partnership Developer Center

Lines of Business University Alliances Events & Webinars Innovation

Login RegisterWelcome, Guest Search the Community

Activity Communications Actions

Brow se

SAP ERP HCM Employee Self-Service

Previous

post

Next

post

0 Tweet 0

1. IntroductionThis blog is based on my experience in one of the projects that I have worked sometime ago!!!. It describes how to

configure SAP Enterprise Portal to point to multiple backend clients in ESS/MSS scenarios.

Within EP 7.0 / ESS MSS 600, Web Dynpro ESS/MSS package is pre-configured by default for a unique Logical

System. This causes severe restrictions in a multi-client environment.

2. Business ScenarioTo support providers shared methodology, it must be possible to maintain ESS/MSS landscape in a manner that

allows multiple customers to be implemented within multiple clients on the same system with a unique Portal.

Below scenario shows a portal pointing to multiple clients from the same backend system containing ESS/MSS

scenarios. It is a pre-requisite that the usernames in backend clients and portal should be the same. In this scenario,

the users logged in to portal are able to access the backend using SSO logon tickets. And also, a Central User

Administration (CUA) as to be implement in the landscape, one system or one client can dedicated for

ESS MSS Multi-Client Configuration - Part1

Posted by Srinivasan Govindaswamy in SAP ERP HCM Employee Self-Service on Jul 25, 2013 1:42:58 PM



3. Single-Client Configuration InformationBy default ESS/MSS is configured for a single backend client. There are a number of configurations required in Portal



as well as the backend like setting up JCo, System landscape, ADS and so on. The entire set of standard

configurations can be found here:

http://help.sap.com/saphelp_erp2005/helpdata/en/f6/263359f8c14ef98384ae7a2becd156/frameset.htm

4. Multi-Client Configuration InformationThis document assumes that all the ESS/MSS scenarios are working for a single backend client (e.g.: 100). In the

following steps we will configure the portal to point to a new client (200)

5. Implementation Multi-client steps

5.1 Set up JCo Destinations

Various JCo connections are already setup for client 100 on the Web Dynpro J2EE server on which the self-service

components have been implemented. To create a new set of JCo connections for client 200, implement the steps

provided in the following URL and ensure that the parameter for property client is provided as 200: Suffix CL2 with



the name as shown in below screenshot.

http://help.sap.com/saphelp_erp2005/helpdata/en/ca/115e4088dc0272e10000000a155106/content.htm

5.2 Business Package copy for the new client

The default downloaded ESS/MSS Business Package will be paced under:

Portal Content > Content Provided by SAP > End User Content > Employee Self-Service.

Portal Content > Content Provided by SAP > line_manager > Manager Self-Service.

Make a copy of these Folders and paste it in a new location. Ensure to create a Copy and not a Deltalink.

Use Multiple Property Replacement to add new value for the Application Parameter properties of WebDynpro

iviews. Following is the example of a possible value for Application Parameter property. This value will change

as per the JCo Destinations created in the system, for each client.

sap-wd-arfc-useSys=SAP_BPS:CL2&sap-wd-arfc-useSys=SAP_BPS_MetaData:CL2&sap-wd-arfc-

useSys=SAP_cProjects:CL2&sap-wd-arfc-useSys=SAP_cProjects_MetaData:CL2&sap-wd-arfc-

useSys=SAP_ECC_Financials:CL2&sap-wd-arfc-useSys=SAP_ECC_Financials_MetaData:CL2&sap-wd-arfc-



useSys=SAP_R3_Financials:CL2&sap-wd-arfc-useSys=SAP_R3_Financials_MetaData:CL2&sap-wd-arfc-

useSys=SAP_R3_HumanResources:CL2&sap-wd-arfc-

useSys=SAP_R3_HumanResources_Metadata:CL2&sap-wd-arfc-

useSys=SAP_R3_HumanResources_MetaData:CL2&sap-wd-arfc-

useSys=SAP_ECC_HumanResources:CL2&sap-wd-arfc-useSys=SAP_R3_SelfServiceGenerics:CL2&sap-wd-

arfc-useSys=SAP_R3_SelfServiceGenerics_MetaData:CL2&sap-wd-arfc-

useSys=SAP_R3_SelfServiceGenericsFIN:CL2&sap-wd-arfc-

useSys=SAP_R3_SelfServiceGenerics_MetaDataFIN:CL2&sap-wd-arfc-useSys=SAP_R3_Travel:CL2&sap-wd-

arfc-useSys=SAP_R3_Travel_MetaData:CL2&sap-wd-arfc-useSys=WD_MODELDATA_DEST:CL2&sap-wd-

arfc-useSys=WD_RFC_METADATA_DEST:CL2&sap-wd-arfc-

useSys=WD_RSDAS_MODELDATA_DEST:CL2&sap-wd-arfc-

useSys=WD_RSDAS_RFC_METADATA_DEST:CL2

5.2.1 Application Parameters property for newly copied Business Package

If Multiple Property Replacement was not used to provide Application Parameter for iviews, navigate to the

iviews belonging to e.g. client 200 Business Package and provide the Application Parameters that point to the

newly created JCo connections (client 200) manually. This value will change as per the JCo Destinations

created in the system, for each client.

Here is an example of a complete Iview Application Parameter:

sap-wd-arfc-useSys=SAP_BPS:CL2&sap-wd-arfc-useSys=SAP_BPS_MetaData:CL2&sap-wd-arfc-

useSys=SAP_cProjects:CL2&sap-wd-arfc-useSys=SAP_cProjects_MetaData:CL2&sap-wd-arfc-

useSys=SAP_ECC_Financials:CL2&sap-wd-arfc-useSys=SAP_ECC_Financials_MetaData:CL2&sap-wd-arfc-

useSys=SAP_R3_Financials:CL2&sap-wd-arfc-useSys=SAP_R3_Financials_MetaData:CL2&sap-wd-arfc-

useSys=SAP_R3_HumanResources:CL2&sap-wd-arfc-useSys=SAP_R3_HumanResources_Metadata:CL2&sap-

wd-arfc-useSys=SAP_R3_HumanResources_MetaData:CL2&sap-wd-arfc-

useSys=SAP_ECC_HumanResources:CL2&sap-wd-arfc-useSys=SAP_R3_SelfServiceGenerics:CL2&sap-wd-arfc-

useSys=SAP_R3_SelfServiceGenerics_MetaData:CL2&sap-wd-arfc-



useSys=SAP_R3_SelfServiceGenericsFIN:CL2&sap-wd-arfc-

useSys=SAP_R3_SelfServiceGenerics_MetaDataFIN:CL2&sap-wd-arfc-useSys=SAP_R3_Travel:CL2&sap-wd-arfc-

useSys=SAP_R3_Travel_MetaData:CL2&sap-wd-arfc-useSys=WD_MODELDATA_DEST:CL2&sap-wd-arfc-

useSys=WD_RFC_METADATA_DEST:CL2&sap-wd-arfc-useSys=WD_RSDAS_MODELDATA_DEST:CL2&sap-wd-

arfc-useSys=WD_RSDAS_RFC_METADATA_DEST:CL2

5.3 Set up Systems / Aliases

Navigate to System Administration > Portal Content > and define a new system object that points to client

200. Please note that already a system object should be available for client 100. It is simple to make a copy of

the same and point the new one to client 200. (as seen in below screenshot). Also change the name of the

system object. (E.g: SAP_ECC_BP3_CL2).

Define the necessary System Alias for the system, pointing to Client 200:



5.4 UWL Configuration

Navigate to System Administration > Universal Worklist & Workflow > Universal Worklist Administration.

Here you can define connections to systems as item providers for the Universal Worklist. Add the newly

created system alias here (as mentioned in the screenshot below).

Please note that WebDynpro Launch System is the system alias of the system which contains the Web Dynpro

ESS/MSS Business Packages. Usually it will be the same system as the Portal. So this system alias (as per above



screenshot example: WebDynpro_XSS) refers to the Enterprise Portal system which contains the deployed Web

Dynpro ESS/MSS applications.

In Order to restrict access to the corresponding Universal Worklist System, we need to register each system with a

specific System Configuration Group, to make it easier we will use the name, ie SAP_WebDynpro_XSS for client 100,

SAP_WebDynpro_XSS_CL2 for 200

http://help.sap.com/saphelp_nw70/helpdata/EN/92/a88931f2dd4631b9e8d530697d89c9/frameset.htm

Then restrict the role to use the corresponding System Configuration Group:

Open the role Manager Self Service and edit Overview->Work Overview->Work Overview page.



Select Universal Worklist iView from the page and click on Open button.



Set the value(SAP_WebDynpro_XSS) for the parameter System Configuration Group. Above screenshot is for client

100.

For Client 200, open the Manager Self Service role from the below path and set the value

(SAP_WebDynpro_XSS_CL2)



5.5 PCD Location Replication in SPRO

The PCD location of ESS/MSS client 200 iviews should be the same as the resource attribute URL of PCD Page in

SPRO. To make these two configurations point to the same URL, navigate to any iview belonging to the ESS/MSS

client 200 Business Package. Open the iview object and copy the url from PCD location.

After copying the URL, open the backend system SPRO configurations for ESS from SAP logon and open the

resource object that corresponds to the particular iview e.g:

EMPLOYEE_CHANGEOWNDATA_SERVICE05. Paste the url at URL of PCD Page and save. (Refer to screenshot

below):



5.6 XML Configuration upload for UWLFor the PCRs of different clients to work in Portal, we need to upload a custom xml file with Jco parameters specific to

the client.

Navigate to System Administration > Universal Worklist & Workflow > Universal Worklist Administration. Click on the

link Click to Administrate Item Types and View Definitions. Here, you can upload a new configuration xml with

nodes pointing to specific tasks in swfvisu (backend table). In this configuration, we pass a

property with the value of Jco pointing to the desired client. An example is provided below.

XML Configuration



5.7 IView Resource Key Mapping to change PCD Location

Below is the example of iview list with the corresponding service key in spro. The PCD location parameter of these

iviews and the related service keys should be the same.

ESS:

Benefits and Payment

Benefits and Payment EMPLOYEE_BENEFITPAY_ERP2005_PAG

Benefits Participation EMPLOYEE_BENPARTICIPATION_SERVICE05

Enrollment EMPLOYEE_GENERICENROLLMENT_SERVICE05

Paycheck Inquiry Service EMPLOYEE_PAYCHECK_SERVICE05

Print Enroll EMPLOYEE_GENERICENROLL_PRINT_SERVICE05

Total Compensation EMPLOYEE_TOTALCOMP_SERVICE05

Deferred Compensation (Country) EMPLOYEE_DEFERREDCOMP_SERVICE05

Net Calculation (Country) EMPLOYEE_NETCALCULATION_SERVICE05

Semiretirement (Country) EMPLOYEE_SEMIRETIREMENT_SERVICE05

Valueentitle (Country) EMPLOYEE_VALUEENTITLE_SERVICE05

Career and Job

Candidate Applications EMPLOYEE_CANDIDATE_APPLICATIONS_SRV05

Career and Job EMPLOYEE_CAREER_PAG

Career and Job Services EMPLOYEE_CAREER_ERP2005_PAG



Data Overview EMPLOYEE_CANDIDATE_DATA_OVERVIEW05

Direct Service EMPLOYEE_CANDIDATE_DIRECT_APPL_SERVICE05

Job Favorites EMPLOYEE_CANDIDATE_FAVORITES_SERVICE05

Personal Settings EMPLOYEE_CANDIDATE_PERSONAL_SETTINGS05

Profile Release EMPLOYEE_CANDIDATE_PROFILE_RELEASE0

Profile Service EMPLOYEE_CANDIDATE_PROFILE_SERVICE05

Search Jobs EMPLOYEE_CANDIDATE_SEARCH_JOBS_SERVICE05

Skills Profile EMPLOYEE_SKILLSPROFILE_SERVICE05

Corporate Information

Code of Conduct Application EMPLOYEE_CORPORATE_CONDUCT_SERVICE05

Corporate Information EMPLOYEE_CORPORATEINFO_ERP2005_PAG

Employee Search

Change Own Data EMPLOYEE_CHANGEOWNDATA_SERVICE05

Employee Search EMPLOYEE_SEARCH_ERP2005_PAG

OrgChart EMPLOYEE_ORGCHART_SERVICE05

Who Is Who EMPLOYEE_WHOISWHO_SERVICE05

Life and Work Events

Benefits (Country) EMPLOYEE_LIFEWORK_BENEFITS_SERV_US

Birth of Child (Country) EMPLOYEE_LIFEWORK_BIRTHCHILD_DE_SERVICE

Birth/Adoption (Country) EMPLOYEE_LIFEWORK_BIRTH_SERV_US

Change Employment Status EMPLOYEE_LIFEWORK_CHANGESTATUS_SERV_US

Divorce EMPLOYEE_LIFEWORK_DIVORCE_SERV_US

Life and Work Events EMPLOYEE_LIFEWORKEVENTS_ERP2005_PAG

Marriage EMPLOYEE_LIFEWORK_MARRIAGE_SERV_US

Maternity Leave EMPLOYEE_LIFEWORK_MATLEAVE_DE_SERVICE

My First Days EMPLOYEE_LIFEWORK_FIRSTDAYS_SERV_US

Terminate Employment EMPLOYEE_LIFEWORK_TERMINATEEMP_SERV_US

Termination EMPLOYEE_LIFEWORK_TERMINATION_DE_SERVICE

Personal Information

EIC Authentication EIC_AUTHENTICATION

EIC Request EIC_SERVICE_REQUEST

Personal Information EMPLOYEE_PERSINFO_ERP2005_PAG

Addresses (Country Specific) EMPLOYEE_ADDRESS_DE_SERVICE05

Bank Information (Country Specific) EMPLOYEE_BANK_DE_SERVICE05

Family Member/Dependants (Country) EMPLOYEE_FAMMEMBER_DE_SERVICE05

Personal Data (Country Specific) EMPLOYEE_PERSDATA_DE_SERVICE05



Purchasing

Purchasing EMPLOYEE_PURCHASING_ERP2005_PAG

Travel and Expenses

Cancel Trip EMPLOYEE_TRAVEL_CANCELTRIP_SRV05

Create Expense report EMPLOYEE_TRAVEL_EXPENSES_SRV05

Create Travel Plan EMPLOYEE_TRAVEL_PLANNING_SRV05

Create Travel Request EMPLOYEE_TRAVEL_REQUEST_SRV05

Delete Expense Report EMPLOYEE_TRAVEL_EXPENSES_DELETE_SRV05

Delete Travel Request EMPLOYEE_TRAVEL_REQUEST_DELETE_SRV05

Display Trip Form EMPLOYEE_TRAVEL_TRIPFORM_SRV05

My Alerts EMPLOYEE_TRAVEL_MYALERTS_SRV05

My Credit Card Receipts EMPLOYEE_TRAVEL_CCIMPORT_SRV05

My Travel Profile EMPLOYEE_TRAVEL_PROFILE_SRV05

My Trips and Expenses EMPLOYEE_TRAVEL_ALLMYTRIPS_SRV05

Personalize Data EMPLOYEE_TRAVEL_PERSONALIZATION_SRV05

Route Planning EMPLOYEE_TRAVEL_ROUTING_SRV05

Switch Personnel Number EMPLOYEE_TRAVEL_CHANGE_PERSNO_SRV05

Travel and Expenses EMPLOYEE_TRAVEL_ERP2005_PAG

Travel Information EMPLOYEE_TRAVEL_COMPANYTIP_SRV05

Unlock Personnel Number EMPLOYEE_TRAVEL_UNLOCK_PERSNO_SRV05

Work Environment

Equipment Monitor EMPLOYEE_EQUIPMENTCARD_SERVICE05

Work Environment EMPLOYEE_WORKENVIRONMENT_ERP2005_PAG

Working Time

Clock-In/Out Correction EMPLOYEE_TIMECORRECTION_SERVICE05

Leave Request EMPLOYEE_LEAVEREQUEST_SERVICE05

Leave Request: Approval EMPLOYEE_LEAVEREQUESTAPPROVER_SERVICE05

Record Working Time EMPLOYEE_RECORDWORKTIME_SERVICE05

Release Working Time EMPLOYEE_RELEASEWORKTIME_SERVICE05

Time Accounts EMPLOYEE_WORKTIME_EFFREPORTING_DISPLAY05

Time Statement EMPLOYEE_TIMESTATEMENT_SERVICE05

Time Statement, Periodic EMPLOYEE_TIMESTATEMENTPER_SERVICE05

Overview EMPLOYEE_WORKTIME_ERP2005_PAG

Certify Actual Effort (Country) EMPLOYEE_WORKTIME_EFFREPORTING_CERTIFY05

Change Effort plan (Country) EMPLOYEE_WORKTIME_EFFREPORTING_CHANGE05

Create Effort plan (Country) EMPLOYEE_WORKTIME_EFFREPORTING_CREATE05



Display Effort plan (Country) EMPLOYEE_WORKTIME_EFFREPORTING_DISPLAY05

MSS:

Record Working Time MSS_HCM_SERV_RELACTIVITY_ESS_CA

Clock-In / Out Corrections MSS_HCM_SERV_RELACTIVITY_ESS_WTCOR

Total Compensation Statement MSS_HCM_SERV_RELACTIVITY_ESS_TCS

Personal Data MSS_HCM_SERV_RELACTIVITY_ESS_PDATA_DE

Addresses MSS_HCM_SERV_RELACTIVITY_ESS_ADDR_DE

Bank Information MSS_HCM_SERV_RELACTIVITY_ESS_BANK_DE

Family Members / Dependents MSS_HCM_SERV_RELACTIVITY_ESS_FAM_DE

Skills Profile MSS_HCM_SERV_RELACTIVITY_ESS_SKL

Trips and Expenses MSS_HCM_SERV_RELACTIVITY_ESS_TRA_EXP

Credit Card Receipts MSS_HCM_SERV_RELACTIVITY_ESS_TRA_CRE

Create Travel Request MSS_HCM_SERV_RELACTIVITY_ESS_TRA_REQ

Create Travel Plan MSS_HCM_SERV_RELACTIVITY_ESS_TRA_PLAN

Travel Profile MSS_HCM_SERV_RELACTIVITY_ESS_TRA_PROF

Start Processes MSS_HCM_SERV_RELACTIVITY_START_PROCESSES

Search Processes MSS_HCM_SERV_RELACTIVITY_SEAR_PROCESSES

5.8 Leave Request specific setup Multi-clientBelow is the process to setup the leave request approval process from the UWL in the new client.

Existing configuration for Client 100

1. SAP standard workflow for Leave Request is WS12300111 which is already configured for client 100.The task

TS12300097 is the approver step in the workflow template WS12300111. This approver step is configured in the

transaction SWFVISU in the backend in client 100 as follows.



New configuration for Client 200

Copy workflow template WS12300111 and save a copy in client 200 say WS99900235. Copy is done using



transaction PFTC.

Copy the task TS12300097 for ex: TS99900140

Now Replace the task TS12300097 from Workflow WS99900235 with the new task TS99900140

Create a new entry in transaction SWFVISU with the task id TS99900140 as shown below:

New configuration for Client 200 (required in Portal)



5.9 Provide Relevant Portal Roles for the new Client

Logon as Portal Administrator and provide relevant roles for a new user who requires access to client 200.

5.10. Multi-Client Configuration in R/3 (Backend)



5.10.1 ISR Server URLThe ISR Server URL is client specific. This needs to be changed/created in the new client. ISR Server URL is

necessary to be maintained as this URL helps in displaying the created PCR form in the Action box of the HR Admin.

Here are the steps to maintain the URL:

1. Go to transaction SM30. Enter view name V_ISRSERVER

2. Maintain an entry in view V_ISRSERVER as follows:

Entry type in Web: Entry Using Adobe PDF

Server Call of ISR Forms: http://hostname:/webdynpro/dispatcher/sap.com/pcui_gp~isr/

5.10.2 Maintain HR Admin for new clientHR Admin is needed as part of the PCR form approval process. The PCR form after the approval form the approving

manager is sent to the HR Admin who updates the data from the form into the backend.

HR Admin is configured in the following path in SPRO:

Personnel Management Personnel Administration Organizational Data Organizational Assignment Define

Administrator

User-id of the HR Admin is maintained here under column SAP name.



Once the HR Admin is configured in the SPRO then this HR Admin is assigned to the employee in transaction PA30

infotype 0001 as shown in the below screen:



5.10.3 Pre-requisitesEnsure that the following forms are activated.

Time statement form activation:

ESS Path: ESSWorking timeTime Statement

When creating new client sometimes the smartforms used for time statement are inactive in the backend which

needs to be activated. Here are the steps to activate the forms.

1. Go to transaction HRFROMS in the backend

2. Select form SAP_TIM_99_0002 and click Change.

3. Activate the form using the Activate button.

Follow the same steps for activating the following forms if it is not activated:

SAP_TIM_99_0001 - Time Statement for a Chosen Period

Salary Statement:

ESS Path: ESS Benefits and Payments Salary Statement

To display the salary statement for an employee, the following infotypes need to be maintained in the backend

transaction PA30 followed by executing a payroll report. Else system will not be able to display the salary statement in

the portal.



Following info types need to be maintained:

0003

0012

0012

0008

Once all the infotypes are maintained, and then execute the following report.

SAP Easy Menu HR Payroll Europe Germany Start Payroll.

Head Count / Head Count (FTE):

BI Reports that needs to be activated under MSS:

MSS Path:

MSS Overview Team Head count

MSS Overview Team Head count ( FTE )

Part 2 of this blog can be found at ESS MSS Multi-Client Configuration - Part2

4136 View s

Products: sap_erp_human_capital_management Topics: enterprise_resource_planning Tags: portal, ess,

employee_self_service, mss, config, manager_self_service, multi_client



Follow SCNSite Index Contact Us SAP Help Portal

Privacy Terms of Use Legal Disclosure Copyright

Average User Rating

(3 ratings)

0 Tweet 0

3 Comments

Like (0)

Siddharth Rajora Oct 10, 2013 5:36 PM

Very informative blog, You have taken so much time to share your expertiseMany thanks!

Like (0)

Srinivasan Govindasw amy Oct 10, 2013 7:08 PM (in response to Siddharth Rajora)

Thanks Siddharth..

Like (0)

Juan Gonzalez Mar 17, 2014 10:31 PM

Is this posible for LSO & E-Recruiting?

ESS MSS Multi-Client Configuration - Part1 _ SCN

Documents

new client

single backend client

property client

multiclient environment

backend system

multiple backend clients

essmss landscape

multiple clients