SAP Knowledge Base Article - Public

3483864 - Business First Name Alt 1 RBP not following parent field - SuccessFactors OData API

Symptom

You are trying to query alternate language fields using odata api but API is not fetching some alternate language fields.

Query:
Query: https://<api-server>/odata/v2/PerPersonal?$select=businessFirstName,businessFirstNameAlt1,businessLastName,businessLastNameAlt1,firstName,firstNameAlt1,lastName,lastNameAlt1,personIdExternal,startDate&$filter=personIdExternal eq '*****'

Here businessFirstNameAlt1, businessLastNameAlt1 are alternative language fields.

Response:

<d:personIdExternal>******</d:personIdExternal>
                <d:startDate m:type="Edm.DateTime">2022-10-01T00:00:00</d:startDate>
                <d:firstName>XXXX</d:firstName>
                <d:lastName>YYYY</d:lastName>
                <d:businessLastName>Li</d:businessLastName>
                <d:lastNameAlt1>Display Last Name YYYY</d:lastNameAlt1>
                <d:firstNameAlt1>Display First Name XXXX</d:firstNameAlt1>
                <d:businessFirstName>XXXX</d:businessFirstName>
            </m:properties>

As we can see in above response, alternative language fields for Display First Name((firstNameAlt1) and Display Last Name(lastNameAlt1) is being fetched but Legal First Name(businessFirstNameAlt1) and Legal Last Name(businessLastNameAlt1) not got fetched although it is being maintained in the Employee Profile.

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

Environment

  • SAP SuccessFactors HCM Suite
    • Employee Central
    • OData API

Reproducing the Issue

  1. Maintain Legal First Name(businessFirstNameAlt1) and Legal Last Name(businessLastNameAlt1) in the Employee Profile as shown below.

     

  2. Run APi query: https://<api-server-url>/odata/v2/PerPersonal?$select=businessFirstName,businessFirstNameAlt1,businessLastName,businessLastNameAlt1,firstName,firstNameAlt1,lastName,lastNameAlt1,personIdExternal,startDate&$filter=personIdExternal eq '*****'
  3. Response:
    <d:personIdExternal>******</d:personIdExternal>
                    <d:startDate m:type="Edm.DateTime">2022-10-01T00:00:00</d:startDate>
                    <d:firstName>**</d:firstName>
                    <d:lastName>**</d:lastName>
                    <d:businessLastName>**</d:businessLastName>
                    <d:lastNameAlt1>***</d:lastNameAlt1>
                    <d:firstNameAlt1>****</d:firstNameAlt1>
                    <d:businessFirstName>**</d:businessFirstName>
                </m:properties>

    As we can see in above response, alternative language fields for Display First Name((firstNameAlt1) and Display Last Name(lastNameAlt1) is being fetched but Legal First Name(businessFirstNameAlt1) and Legal Last Name(businessLastNameAlt1) not got fetched although it is being maintained in the Employee Profile.

Cause

Business First Name Alt field is not following the RBP of parent field.

Resolution

Currently this is identified as bug. This fix should be released in b2411 i.e,. in 2nd release around November. This issue has work around.

Workaround:

You can grant admin permission "Employee Central HRIS OData API (read-only)" to the API user when querying.

See Also

Permission Settings | SAP Help Portal

Keywords

Alternative Language Fields, Legal First Name, businessFirstNameAlt1, Legal Last Name, businessLastNameAlt1, ODATA API, null, not fetching, RBP, Personal Information, language fields, Business First Name Alt 1, alternative fields are not fetched. , KBA , LOD-SF-INT-EC , Employee Central SFAPI & OData Entities , Problem

Product

SAP SuccessFactors HXM Suite 2311