How to integrate with PeopleXD
A step by step guide detailing how to integrate Ravio with PeopleXD
Prerequisites
Ensure that you are an Administrator of your PeopleXD account before starting this integration.
Step by Step Instructions
Step 1 - Find your PeopleXD Tenant ID
Your tenant name can be supplied by your PeopleXD representative, or you can find the tenant name based on your portal URL, e.g., if your Portal URL is https://my.corehr.com/pls/coreportal_acmep/... then your tenant name is [acmep].
Enter it in the connection flow:
Step 2 - Create a new OAuth App
-
Open your CorePortal.
-
Navigate to the Security module (your administration account should have access to this module).
-
Navigate to the Web Service Apps tab in the left sidebar.
-
Click on the blue Create new application button in the top right corner.
-
Give the Application a name.
-
Click on Unmask Credentials and copy them over to the connection flow:
Step 3 - Assigning the Correct Privileges
The Ravio connection flow will display which permissions are needed specifically for your connection.
Add the following privileges to the application and click Complete:
/v1/filter/active/:date?- Method = GET
/v1/person/basicattributes/:personnelNo- Method = GET
/v1/person/genderidentity/:personnelNo- Method = GET
/v1/person/reportsto/:personnelNo- Method = GET
/v1/person/salary/:personnelNo- Method = GET
/v1/contact/user/:person/- Method = GET
/v1/udf/user/- Method = GET
/v1/person/appointment/:personnelNo- Method = GET
/v1/organisation/structure/config- Method = GET
/v1/organisation/structure/nodes/:structureCode?- Method = GET
Grant access to all patterns listed in your flow in PeopleXD:
Step 4 - Add the Connection details in Ravio
Now log into Ravio, and head to Manage My Data > HR System. Then Connect your HR System.
You will be prompted to enter your Client ID and Client Secret in Ravio which will complete the integration.