3797159 - SF OData API: Cannot Navigate from EmpEmployment / User to Background Entities

When querying the SAP SuccessFactors OData V2 API using EmpEmployment or User as the start entity, you are unable to navigate to or expand Background entities (e.g. Background_Education, Background_WorkExperience, etc.)

Image/data in this KBA is from SAP internal systems, sample data, or demo systems. Any resemblance to real data is purely coincidental. 

• SuccessFactors HCM Core
  • OData API

This is a product limitation by design.

Background entities (e.g., Background_Education, Background_WorkExperience) and Employment / User entities belong to structurally separate entity families in the OData V2 data model. There is no standard OData navigation property connecting EmpEmployment or User to Background_xxx entities.

No OData navigation path exists from EmpEmployment or User to Background_xxx entities. OData V2 traversal between entities depends entirely on defined navigation properties in the metadata — if no property exists, the navigation is unavailable. 

You can verify the available navigation properties for EmpEmployment and User by reviewing the OData metadata:

GET /odata/v2/$metadata
No Background_xxx navigation property will be found under either entity.

Option 1 — Query Background Entity Directly as Root Entity (Recommended)

Instead of navigating from EmpEmployment or User, query the Background_xxx entity directly as the root entity in your OData API call.

From the Background entity, you can navigate outward to the User entity via userIdNav to retrieve related employment or personal information.

Option 2 — Migrate to MDF-Based Background Objects

If your business process requires greater flexibility — consider replacing standard Background Elements with custom MDF-based background objects that mirror the same field structure.

MDF objects are automatically exposed through OData V2 API and support bidirectional navigation via defined association properties.

• refer to: KBA 2588609 - Navigation from starting entity not found in Integration Center
• refer to: Integration Center: Data Model Navigator and navigation depth

background_certificates, user entity, empemployment, background elements, odata navigation, association missing, expand to user, starting entity, background_education, background_workexperience, mdf background objects, certificates extraction, field configuration , KBA , LOD-SF-INT-ODATA , OData API Framework , LOD-SF-INT-MDF , Metadata Framework API (MDF) , Problem