SAP Knowledge Base Article - Public

2902948 - OData entity PerAddressDEFLT, how to get the country specific fields

Symptom

1. You have configured homeAddress via Manage Business Configuration (Admin Center -> Manage business configuration -> homeaddress (Expand the addresses) -> Click on homeAddress_XXX 

2. Address details are not visible for XXX (country) in the OData Dictionary screen of SFOdata.PerAddressDEFLT, nor in the Metadata XML

3. You wish to understand why country specific fields are not displayed

Environment

  • SuccessFactors
  • BixZ

Cause

OData API merges fields of different countries and only exposes one entity PerAddressDEFLT. This is the intended design and behavior of the product, which was agreed by our PM and Architects teams when exposing the entity.  Currently the field label is always pulled from the merged field

Resolution

Here is the logic to expose PerAddressDEFLT fields:

  • Expose the first field which matches below conditions: 
  • If a field is configured in both SDM and CSF SDM, SDM wins 
  • If a field is configured in multiple CSF SDM, the first country wins
  • The maximum length will be merged to use the maximum length among all the configurations  
  • If some fields are configured as picklists for any country or in the global DM, we will expose the field as picklist field. For example, custom_string1 can be defined in CDM for corporateAddress as picklist=A1, and it can be also defined in CSF CDM for corporateAddress of country=USA as picklist=B1 
  • If the same field is configured as different type (Worker / FO / MDF) in different DM or different countries, the field will be ignored in odata API for query
  • Please submit an enhancement request, should you have a strong business requirement for the API to behave differently: https://launchpad.support.sap.com/#/notes/2281168

See Also

https://launchpad.support.sap.com/#/notes/2281168

Keywords

PerAddressDEFLT, OData, homeaddress  , KBA , LOD-SF-INT-ODATA , OData API Framework , How To

Product

SAP SuccessFactors HXM Core 1911