SAP SuccessFactors β SAP Analytics Cloud & SAP Datasphere
The definitive, up-to-date, end-to-end integration guide β from API setup to business content onboarding.
1 Prerequisites & Landscape Overview
This guide covers two independent integration paths that share the same SuccessFactors OData API foundation:
Path A β SAC (Direct)
- SAC tenant with admin / BI role
- Access to Connections and Content Network
- SAC outbound IP ranges known (for SFSF allowlisting)
Path B β Datasphere
- Datasphere subscription active on BTP
DW Administratorrole collection- Space provisioned for HR/People analytics
- Datasphere outbound IP ranges known
SuccessFactors Admin Center Access Required
- OData API Data Dictionary
- Manage OAuth2 Client Applications
- Manage Permission Roles / Manage Users
- IP Restriction Management
- Company System and Logo Settings
https://api4.successfactors.com), SAC/Datasphere tenant URLs, and the list of SFSF modules in scope (EC, Recruiting, Talent, Comp, LMS, etc.).
2 Shared SFSF API & Security Foundation
Both SAC and Datasphere consume the same SFSF OData V2 API. Configure this foundation once.
2.1 Enable OData API & Identify Service URL
- Admin Center β Company System and Logo Settings β enable OData API + V2.
- Admin Center β OData API Data Dictionary β note the Service Root URL:
https://apiX.successfactors.com/odata/v2
Confirm entities are visible: PerPerson, EmpEmployment, EmpJob, FODepartment, FOLocation.
2.2 Create the Technical User
- Admin Center β Manage Users β create
TECH_SF_API. - Assign email; disable interactive logon if allowed.
- Manage password expiry via your IAM/PAM policy.
2.3 Create Permission Role & Group
- Create role
SAC_DS_API_ROLEwith:- General User β User Login
- Manage Integration Tools β Allow Admin to Access OData API
- Employee Central data (Personal, Employment, Job, Comp, Org)
- Module-specific read permissions (Recruiting, Talent, LMS)
- Create group
API_TECH_GROUPcontainingTECH_SF_API. - Assign role β group β target population.
2.4 IP Allowlisting
In IP Restriction Management, add both SAC and Datasphere outbound IP ranges for your region.
3 Path A β SAP Analytics Cloud β SuccessFactors (Direct)
3.1 Register OAuth2 Client in SFSF
- Admin Center β Manage OAuth2 Client Applications β Register Client Application.
- Fill in:
- Application Name:
SAC_Analytics - Application URL: SAC tenant URL
- Confidential Client: Yes
- Upload X.509 certificate (from SAC, for SAML bearer)
- Application Name:
- Save and record: Client ID, Secret/Cert, Token URL.
3.2 Create the SAC β SFSF Connection
- SAC β Main Menu β Connections β Add Connection.
- Under Acquire Data, pick SAP SuccessFactors.
- Fill:
- Name:
SFSF_EC_Import - Server URL:
https://apiX.successfactors.com - Company ID
- Auth: OAuth2 SAML Bearer
- Client ID / Token URL from step 3.1
- Technical User:
TECH_SF_API
- Name:
- Test β Save.
4 Onboard SuccessFactors Business Content in SAC
SAC content is onboarded from the Content Network and repointed to your direct SFSF connection β no dependency on Datasphere.
4.1 Import Business Content Packages
- SAC β Files β Content Network β Business Content.
- Search "SAP SuccessFactors" and import:
- Employee Central β Core HR
- Workforce Analytics β Headcount / Turnover
- Recruiting
- Talent / Performance & Goals
- Select all objects β Import to a public folder.
4.2 Repoint Placeholder Connection
The imported package includes a placeholder connection. Edit it and enter your SFSF details β or repoint each modelβs data source to SFSF_EC_Import.
4.3 Initial Import & Scheduling
- Open each model β Data Management β Data Source β Import Data.
- Validate row counts and query errors.
- Configure Schedule Settings: daily delta or full refresh.
4.4 Validate Stories & Dashboards
Cross-check totals against SFSF Ad Hoc Reports. Adjust role-based access to expose stories to end-user groups.
5 Path B β SAP Datasphere β SuccessFactors
5.1 Space Setup
- Launch Datasphere from BTP β confirm
DW Administratorrole collection. - Navigate to System β Spaces β create
HR_ANALYTICS. - Assign your user (and any data modelers) as members.
5.2 Create SFSF Connection in Datasphere
- Open Connections β select space
HR_ANALYTICS. - Go to the Local Connections tab β Create.
- Search SuccessFactors β select the tile.
- Connection details:
- URL:
https://apiX.successfactors.com/odata/v2 - Version: OData V2 (auto)
- Auth Type: User Name and Password
- User Name:
APIUSER@COMPANYIDβ e.g.TECH_SF_API@HXM2345 - Password: technical user password
- URL:
- Click Next Step, provide Business Name
SFSF_HR_DS, then Create Connection β Validate.
USER@COMPANYID β different from SAC. This is the most frequent connection error.
5.3 Consuming SFSF Data
- Browse entities in Data Builder β Sources.
- Build Replication Flows for snapshot or delta loads.
- Build Data Flows for transformations.
- Model Analytic Models (Dimensions: org, location, job family; Measures: Headcount, FTE, Turnover).
- Optionally expose Analytic Models to SAC as live connections.
6 Datasphere SSL Certificate Handling
If validation fails at the SSL layer, Datasphere may not yet trust the SFSF certificate chain. Export and upload it manually.
6.1 Export the SFSF Certificate
- Open your SFSF URL (e.g.
https://salesdemo.successfactors.eu) in a browser. - Log in with a normal SFSF user.
- Click the π padlock β Connection is secure β Certificate is valid β Show certificate.
- Open the Details tab β Export β save as
sf_cert.cer.
6.2 Upload Certificate to Datasphere
- Datasphere β System β Configuration β Security.
- Click Add Certificate β browse to
sf_cert.cer. - Add description (e.g. "SFSF EU Prod SSL") β Upload.
- Verify creation and expiry dates in the Security overview.
6.3 Re-validate the Connection
- Return to Connections β Local Connections in space
HR_ANALYTICS. - Select
SFSF_HR_DSβ click Validate. - Expected: Connection is valid
7 Authentication Strategy: Username/Password vs OAuth2/X.509
Username & Password (Datasphere)
- Simplest, fully supported
- Format:
USER@COMPANYID - Works well for initial setup / POCs
- Requires password rotation strategy
OAuth2 / SAML Bearer with X.509 (SAC & optional for DS)
- Certificate-based, no shared password
- Preferred for production
- Requires registration of X.509 in SFSF OAuth client
- Longer-lived β rotate before certificate expiry
8 End-to-End Verification Checklists
Track your progress β state is saved locally in your browser.
0 of 0 tasks complete