SAP Knowledge Base Article - Public

2912439 - Document Category field is empty after working in attachments uploaded by API - SuccessFactors OData


You are seeing some issues in the Attachment OData entity for the field documentCategory.

The field value documentCategory is blank (no value / null) after your OData API successful upsert (which included this data).


  • SuccessFactors HXM Suite
    • OData API - Attachment entity


The fields ownerIdType, documentCategory and documentEntityType should be matched. 


If you use USERSSYS_ID, but d:documentCategory and d:documentEntityType are not matched, system will set default values (like blank or null values).

In one testing, we tried upserting the attachment with field "ownerIdType": "USER_ID" and we were having the problem. 

Checking internally with engineering team they asked us to either remove 'ownerId' and 'ownerIdType' from the request payload, or change ownerIdType to 'PERSON_ID", so we upserted another attachment with the following fields in the payload:

<d:fileContent>"XXXXX..."< /d:fileContent>
The upsert above status was OK.
Doing query in the attachment by its Id we confirmed that the 'documentCategory' and 'documentEntityType' were both correct now.


Document Category field, documentCategory, OData API uploaded documents, attachment, files, SuccessFactors HCM HXM Suite, Integration, entity, empty, null, no value, upsert , KBA , LOD-SF-INT-ODATA , OData API Framework , LOD-SF-INT , Integrations , How To


SAP SuccessFactors HXM Suite all versions