Jump to

• Request
• Response
• Examples

Set a file property

put

/rest/ofscCore/v1/resources/{resourceId}/{propertyLabel}

Important: This information only applies to Oracle Field Service environments. You can verify whether you've Oracle Field Service or Oracle Fusion Field Service, by signing in and checking on the About page.

This method creates the specified 'file' property for the specified resource.

Note: The maximum size of the file that can be uploaded is 5 MB.

Request

Supported Media Types

• application/octet-stream

Path Parameters

• propertyLabel(required): string
  The label of a custom property. This custom property must be of type 'file'.
• resourceId(required): string
  The unique identifier of the resource in Oracle Field Service. This maps to the resource field 'external_id' and is not necessarily set for all resources. The resources without this parameter are not visible to the operation.

Header Parameters

• Content-Disposition: string
  The custom filename for the property. For example, Content-Disposition: attachment; filename="photo-of-the-door.jpg" sets the filename for the property to 'photo-of-the-door.jpg'.
• Content-Type: string
  The media type of the property. For file properties of type 'image' having content-type as 'image/png', 'image/jpeg', or 'image/gif', Oracle Field Service generates a preview thumbnail that appears in Manage/Mobility.

Body ()

Root Schema : File

Type: string(binary)

Title: File

The contents of the file. This is usually binary data.

Back to Top

Response

Supported Media Types

• application/json
• application/schema+json

204 Response

This section describes the 204 status response for this operation. This response code indicates that the operation completed successfully. This operation does not return elements in the response body.

Default Response

This section describes the default error response for this operation.

Body ()

Root Schema : Error

Type: object

Error response

Show Source

• detail: string
  The detailed information about the error.
• status: string
  The HTTP status code.
• title: string
  The summary of the error message.
• type: string
  The URL of the page containing the error details.

{
    "type":"object",
    "properties":{
        "type":{
            "type":"string",
            "description":"The URL of the page containing the error details."
        },
        "title":{
            "type":"string",
            "description":"The summary of the error message."
        },
        "status":{
            "type":"string",
            "description":"The HTTP status code."
        },
        "detail":{
            "type":"string",
            "description":"The detailed information about the error."
        }
    },
    "description":"Error response"
}

Back to Top

Examples

The following example shows how to set a file property of a resource by submitting a PUT request on the REST resource using cURL.

curl -u '<CLIENT-ID>@<INSTANCE-NAME>:<CLIENT-SECRET>' -X PUT --data-binary @filename.jpeg 'https://<instance_name>.fs.ocs.oraclecloud.com/rest/ofscCore/v1/resources/john.smith/uploadedPic'

Example of Response Header

The following shows an example of the response header.

HTTP/1.1 204 No Content

Back to Top