SAP Build Apps Integration with SAP SuccessFactors: Step-by-Step Guide
1. Overview
This guide explains how to integrate SAP Build Apps with SAP SuccessFactors to fetch employee details. It
covers the complete workflow, system connections, and configuration in a step-by-step manner.
2. Workflow Overview
1. Register an OAuth client in SuccessFactors to enable secure API access.
2. Configure a Destination in SAP BTP to connect Build Apps to SuccessFactors.
3. Connect the destination in SAP Build Apps as a data source.
4. Configure data variables in Build Apps to fetch and store employee data.
5. Build UI components to display the employee data.
3. Detailed Steps
Step 1: SuccessFactors Preparation
• Log in to SAP SuccessFactors Admin Center.
• Navigate to Manage OAuth2 Client Applications.
• Register a new OAuth client with the following:
• Grant Type: Client Credentials
• Define appropriate scopes (e.g., EmpEmployment, PerPersonal, User)
• Assign permissions in Role-Based Permissions (RBP) for the client
• Note down:
• Client ID
• Client Secret
• OAuth Token Service URL (authorization server)
• Obtain the SuccessFactors API endpoint:
• Example: [Link]
• Test with Postman to verify employee data is accessible.
Step 2: Configure Destination in SAP BTP
• Log in to the SAP BTP Cockpit.
• Go to your Subaccount → Connectivity → Destinations.
• Create a new destination:
• Name: SuccessFactorsAPI
• Type: HTTP
1
• URL: [Link]
• Proxy Type: Internet
• Authentication: OAuth2ClientCredentials
◦ Client ID: from SuccessFactors
◦ Client Secret: from SuccessFactors
◦ Token URL: OAuth token service URL from SuccessFactors
• Save the destination.
• Click Check Connection to verify connectivity.
Step 3: Configure SAP Build Apps Data Source
• Open your app in SAP Build Apps.
• Go to the Data section.
• Click Add Data Source → SAP BTP Destination.
• Choose the destination you created ( SuccessFactorsAPI ).
• Select the OData entities you want to use:
• For example: PerPersonal (personal details), EmpEmployment (employment data), User (login data).
Step 4: Configure Data Variables in Build Apps
• Go to the Variables section of your app.
• Click Add Variable → Data Variable.
• Choose the data resource (e.g., PerPersonal).
• Set it as a Collection if you want a list of employees, or Single Record for one employee.
• Name the variable (e.g., allEmployees ).
• Configure optional query parameters:
• Filters (e.g., employmentStatus eq 'active')
• Sorting (e.g., by lastName ascending)
• Limit (e.g., top 50 records)
• Bind the data variable to UI components in your app (e.g., List, Card).
Step 5: Build UI in SAP Build Apps
• Drag and drop a List or Card component onto your screen.
• Bind its data source to your data variable (e.g., allEmployees ).
• Map displayed fields:
• First name
• Last name
• Email
• Job title, etc.
• Test in the Build Apps preview.
Step 6: Test and Deploy
• Verify the app displays employee details correctly.
• Test filters and navigation.
• Deploy the app.
2
4. System Landscape Map
Systems involved:
• SAP SuccessFactors (source of employee data)
• SAP BTP (hosting the destination)
• SAP Build Apps (consumer of the data)
Connections:
1. SAP Build Apps → SAP BTP Destination → SuccessFactors OData API
2. OAuth2 Client → Secure API token from SuccessFactors
3. BTP Destination → enables connectivity between Build Apps and SuccessFactors
5. Notes
• All API permissions must be correctly configured in SuccessFactors RBP.
• Destination setup requires precise client credentials and token URLs.
• Test each layer separately (Postman → BTP Destination → Build Apps) before deploying.
6. References
• SAP Build Apps Documentation
• SAP SuccessFactors OData API Guide
• SAP BTP Cockpit Documentation
Prepared by: SAP BTP Solution Architecture
