ESS MSS Multi-Client Configuration – Part1
1. Introduction
This 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 Scenario
To support provider’s 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
3. Single-Client Configuration Information
By 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 Information
This 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 UWL
For 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 <dynamicparameter> property with the value of Jco pointing to the desired client. An example is provided below.
XML Configuration |
---|
<?xml version=”1.0″ encoding=”UTF-8″?> <!DOCTYPE UWLConfiguration PUBLIC ‘-//SAP//UWL1.0//EN’ ‘uwl_configuration.dtd’> <UWLConfiguration version=”1.0″> <ItemTypes> <ItemType name=”uwl.task.webflow.TS50000075.SAP_WebDynpro_XSS_CL2″ connector=”WebFlowConnector” defaultView=”DefaultView” defaultAction=”launchWebDynPro” executionMode=”default”> <ItemTypeCriteria systemId=”SAP_WebDynpro_XSS_CL2″ externalType=”TS50000075″ connector=”WebFlowConnector”/> <Actions> <Action name=”launchWebDynPro” groupAction=”” handler=”SAPWebDynproLauncher” returnToDetailViewAllowed=”yes” launchInNewWindow=”yes” launchNewWindowFeatures=”resizable=yes,scrollbars=yes,status=yes,toolbar=no,menubar=no,location=no,directories=no”> <Properties> <Property name=”WebDynproApplication” value=”IsrFormApprove”/> <Property name=”WebDynproDeployableObject” value=”sap.com/pcui_gp~isr”/> <Property name=”newWindowFeatures” value=”resizable=yes,scrollbars=yes,status=yes,toolbar=no,menubar=no,location=no,directories=no”/> <Property name=”DynamicParameter” value=”sap-wd-arfc-useSys=SAP_R3_SelfServiceGenerics:CL2″/> <Property name=”openInNewWindow” value=”yes”/> <Property name=”display_order_priority” value=”5″/> </Properties> <Descriptions default=””/> </Action> </Actions> </ItemType> |
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-client
Below 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 URL
The 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:<port>/webdynpro/dispatcher/sap.com/pcui_gp~isr/
5.10.2 Maintain HR Admin for new client
HR 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-requisites
Ensure 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.
- Go to transaction HRFROMS in the backend
- Select form SAP_TIM_99_0002 and click “Change”.
- 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
Very informative blog, You have taken so much time to share your expertise
Many thanks!
Thanks Siddharth.. 🙂
Is this posible for LSO & E-Recruiting?