Business Partner objects in SAP HCM Talent Management
There is a myth in SAP HCM Talent Management, which goes by the name of “Business Partners”. Aren’t they just for e-Recruiting, like TREX? No! Since I am seeing a number of people getting into issues with external systems such as TREX and STVN SuccessionPlanning, I thought I’d try and highlight the requirement of the SAP Business Partner in SAP HCM Talent Management.
What are they and what are they for?
In SAP HCM Talent Management the Business Partner, represented by object BP in the SAP ERP HCM system, is used for objects to “communicate” between instances of themselves in different external systems. Most commonly these are used for communication between SAP ERP HCM and e-Recruiting, TREX and STVN SuccessionPlanning. And before you ask if they are required, yes they are. Without Business Partners you face issues such as no data in STVN SuccessionPlanning or TREX search results coming back with rows of blank data.
So how do I set up Business Partners?
There are a number of steps required to setup Business Partners for SAP HCM Talent Management:
- Enable integration switches
- Setup number ranges
- Setup groupings
- Apply SAP note 845002 (HRALX: HRALXSYNC performance)
- Synchronize Business Partner objects for Central Persons objects
- Generate Business Partner objects for Central Persons objects
First of all the Business Partner integration switches needs to be enabled, if they are not already. This is performed in IMG > Personnel Management > Organizational Management > Integration > Integration with SAP Business Partner > Activate Integration by setting the following switches:
- HRAC: X
- PBPHR: ON
Once the switches are set then a Business Partner number range must be setup in tcode BUCF, if it hasn’t already been setup. Run tcode BUCF and select the Change Intervals button. In the next screen add a new interval with the following values:
- No.: 01
- From number: 0000000001
- To number: 0999999999
- Current number: 0
Once the other two previous requirements are in place, groupings must be setup in IMG > Cross–Application Components > SAP Business Partner > Business Partner > Basic Settings > Number Ranges and Groupings > Define Groupings and Assign Number Ranges. A new entry to the customizing table should be added with the following values:
- Grouping: 0001
- Short Name: Int.No.Assgnmnt
- Description: Internal Number Assignment
- Number range: 01
- Int.Std.Grping: X
Before synchronizing Business Partners SAP note 845002 (HRALX: HRALXSYNC performance) should be applied. Once done, run report Z_HRALXSYNC_CHANGEDATE. This report corrects the “changes since” date in the SAP&DEFAULT variant of HRALXSYNC (more on that later) from 01/01/1900 for improved processing.
The next step is to synchronize and, if required, generate missing Business Partners. This is done using report HRALXSYNC and both synchronization and generation can be done at the same time using the following instructions:
- In the select screen select the checkbox for Branch from Organization Structure
- In the selection box for this option select the OrgUnit at the top of the organization structure
- Select Execute
Once the report has run all the Business Partner objects are now synchronized. There may be one or more objects that are not in the correct status and need to be repaired. For the purpose of SAP HCM Talent Management we just need to repair the generate Business Partner objects for the Central Persons that don’t have one. To do this:
- Use the Object Selection window to find the Central Person objects that have no Business Partner object (All Objects > Central Persons > Without Partner)
- In the right window select all of these objects and select the Repair button
And au voila, now you have Business Partners setup, synchronized and generated.
Note: There are may be issues with Central Person objects that represent employees who are now inactive in SAP. All errors must be corrected for the batch job to run (see below), not just those within the organization structure.
Can I setup HRALXSYNC to run regularly?
I’m glad you asked, since SAP supply a variant of the HRALXSYNC report for exactly this reason. To setup to run on a periodic basis SAP supplies the variant SAP&DEFAULT to use, so simply schedule the job using this variant in SM36. However, please note that this job will not run correctly if any errors occur when the standard report is run. The Change Since date will not update to the latest date if any errors occur when the report variant is run.
What possible issues might I face with generating Business Partners in HRALXSYNC?
Well, there are 3 or 4 common errors that I’ve seen that might cause an issue with generating Business Partners. There are many common errors that do not cause issue with generating Business Partners for SAP HCM Talent Management and as a result they are not covered here. In some organizations it is worth consulting the wider SAP HCM community to see what impact any of these changes might have. Some of the most common errors are:
- Postal code must have length xx
- Geocoder SAPO: Country not specified completely (Customizing)
- Address type XXDEFAULT does not exist: Address usage XXDEFAULT cannot be created
- Key 01 is not defined as name format for country xx
The first error – “Postal code must have length xx” – can be corrected by finding the CP, checking the address in PA30 for the Person object and then setting the correct check rule for the postal code in IMG > SAP NetWeaver > General Settings > Set Countries > Set Country-Specific Checks. The second error – “Geocoder SAPO: Country not specified completely (Customizing)” – is corrected by running the report GEOCODING_SET_GEOFLAG, ticking the checkbox for Disable Geoservices and hitting Execute.
For the error “Address type XXDEFAULT does not exist: Address usage XXDEFAULT cannot be created” a new entry must be created in table TB009 with the following values:
- Address Type: XXDEFAULT
- Several uses:
- Short name: Stand. Address
- Name: Standard Address
For the error “Key 01 is not defined as name format for country xx” the relevant country grouping must be created in table T500L.
Thanks for the goodies, but what about the BAdIs?
There are a number of BAdIs used to retrieve data for HRALXSYNC. This is really for reference, since SAP HCM Talent Management (with exception of e-Recruiting) only requires the existence of the Business Partner objects. These BAdIs include:
So, here you’ve read a bit of background about why Business Partners are used and needed in SAP HCM Talent Management, how you can set them up and what issues to look out for. Hopefully this has cleared up some of the issues and myths surrounded Business Partners and SAP HCM Talent Management!