Troubleshooting

Common Errors

A Missing Precondition

A condition necessary to proceed further is not satisfied.

Solution - Add the If-Match key in the header of the request and provide the corresponding etag value. Make sure you remove the backslashes from the etag value before using it.

Unexpected Internal Server

This can occur when uploading a file.

Along with it, the following errors appear in the odp-default-log file in <ifs_home>\instance\<instance_name>\logs\odata-provider\<endpoint> folder.

detected.com.ifsworld.fnd.provider.processor.FndErrorProcessor.processError() : Illegal base64 character 2b

Solution - When sending a Base 64 encoded filename using the “X-IFS-Content-Disposition” header via REST API, it should be encoded to support Base 64 URL encoding standard. (Base 64 encoded string should not contain plus (+) and slash (/) characters.)

Debugging a Request

When you come across an error for which you need more details, you can append the query with ?odata-debug=json.

For example, let us assume that the following error is not comprehensive.

By appending the query as shown below, you can find additional details that enable debugging in the Body.