Human Capital Management Blogs by SAP
Get insider info on SAP SuccessFactors HCM suite for core HR and payroll, time and attendance, talent management, employee experience management, and more in this SAP blog.
cancel
Showing results for 
Search instead for 
Did you mean: 
ImranMohammed
Product and Topic Expert
Product and Topic Expert
5,168

Part 1: Setting up Address Validation Service in BTP


This Blog is a collaboration work between SAP Business Technology Platform (BTP) Team, SAP Data Quality Management Team and SAP SuccessFactors Employee Central – Localization Team.

In this article we want to share our hands-on experience on a recent project experience and learning journey on how to enable on SAP BTP, SAP Data Quality Management, Microservices for Location Data within SAP SuccessFactors Employee Central. Goal is to enable address validation for following countries in SAP SF EC for employee and employee's dependent address by the New Hire and Address change process.

In this blog we will work with the countries/regions below, but the described process can also be used for other countries/regions

  • United States

  • United Kingdom

  • Canada

  • Australia

  • Mexico

  • Singapore


What is Address Validation Service? Address Validation Service helps validate an employee and employee’s dependents address. Address checks determine if address data such as country, region and postal code length is consistent. If you enter inconsistent data, the system displays a relevant error message, and you cannot save or activate the address data.

Address Validation Service is based on SAP Data Quality Management, microservices for location data that is hosted on SAP Business Technology Platform (SAP BTP).

To enable Address Validation Service, configuration must be performed on BTP as well as in SAP SF Employee Central. Hence my post is divided into three-part series.

  • Part 1: Setting up Address Validation Service in BTP.

  • Part 2: Creating Address Mapping Configurations.

  • Part 3: Steps to enable Address Validation Service in SAP Success Factors Employee Central.


Part 1: Setting up Address Validation Service in BTP

Steps to enable Data Quality Management (DQM) microservice is mentioned in detail on SAP Help document. I will focus mainly on high-level steps on BTP side.


BTP DQM Subaccount


DQM service was only available in AWS provider and Europe Frankfurt Region for Cloud Foundry environment at the time of writing this blog. You can check the availability/Pricing/Roadmap on SAP Discovery Center.

1. Create Cloud Foundry SubAccount, Space and make sure Data Quality Services and Data Quality Service UI service plan entitlement is selected as shown below.


 


Data Quality Service Entitlement


 

2. Navigate to Space and create Data Quality Service Instance, select Standard Plan and give instance name.


Data Quality Service Instance


3. Create a Service Key, make sure to provide the parameters in JSON format and copy certificate information from SAP SF Employee Central as shown below and then choose Create.

{

"xsuaa": {

"credential-type": "x509",

"x509": {

"certificate": "-----BEGIN CERTIFICATE-----MIIFXXXXXXXXXxxxxXXxx-----END CERTIFICATE-----",

"certificate-pinning": false

}

}

}

Note: The certificate value in the “” ("-----BEGIN CERTIFICATE-----MIIFXXXXXXXXXxxxxXXxx-----END CERTIFICATE-----") needs to be replaced with the certificate information from the CRT file that you have to generate in the SAP SuccessFactors Security Center. Refer to Part 3 of this blog series under Security Center (X509 Certifications) step 3.


Create Service Key



 

4. Make a note of Client ID and URLS to perform the configuration in SF Employee Central.



Data Quality Configuration UI


Make sure to subscribe to Data Quality Service to have Configuration UI Application.


 



DQM Configuration BTP Roles


For Data Quality Service UI to work, DQMMICRO_POWERUSER role is provide. We must create our own role collection and assign it to the user.



Accessing Configuration UI: Access DQM Microservice UI




Note: If you don't see number in Configurations tile then make sure the role DQMMICRO_POWERUSER is correctly assigned to your ID. Configuration tile will show number 9 initially.

Address mapping configuration will be covered in part 2.

Thank you!
5 Comments
nlgro023
Active Contributor
0 Kudos
Thanks for the detailed explanation. I had understood that you need extra licenses for using microservices such as things one. Is that still correct or is it for free (assuming someone takes the steps you described) nowadays?
ImranMohammed
Product and Topic Expert
Product and Topic Expert
0 Kudos
You can try SAP BTP Free Tier account to experience this microservice. Please refer to this blog for details.

 
kollemar
Discoverer
0 Kudos
Not sure why this is needed via the BTP when there is an OOTB validation available in SuccessFactors, see SuccessFactors Employee Central Deep Validations | SAP Blogs?
ImranMohammed
Product and Topic Expert
Product and Topic Expert
I think Deep Validation applies only to Postal/Zip code field and not to any other field in Employee Address. BTP DQM is the robust functionality that can do street level validation. Hope this helps!
ArjenVHooydonk
Contributor

Where does SAP source the data used to validate addresses using DQM?