Jump to

• Request
• Response
• Examples

Set resource preferences of an activity

put

/rest/ofscCore/v1/activities/{activityId}/resourcePreferences

This operation sets the resource preferences for the specified activity.

Resource preferences are used to identify if a resource is preferred/required or forbidden from being assigned to an activity.

If the specified activity already contains resource preferences, this operation replaces them with the values specified in the request.

Request

Path Parameters

• activityId(required): string
  The unique identifier of the activity in Oracle Field Service.

Body ()

Root Schema : Resource Preferences

Type: object

Title: Resource Preferences

The collection of resource preferences that can be assigned to an activity.

Show Source

• items: array Items
  Title: Items

  The array of required preferences for the specified activity.

{
    "description":"The collection of resource preferences that can be assigned to an activity. ",
    "properties":{
        "items":{
            "items":{
                "$ref":"#/definitions/resourcePreference"
            },
            "type":"array",
            "description":"The array of required preferences for the specified activity. ",
            "title":"Items"
        }
    },
    "title":"Resource Preferences",
    "type":"object"
}

Nested Schema : Items

Type: array

Title: Items

The array of required preferences for the specified activity.

Show Source

• Array of: object Resource Preference
  Title: Resource Preference

  The resource preference of an activity.

{
    "items":{
        "$ref":"#/definitions/resourcePreference"
    },
    "type":"array",
    "description":"The array of required preferences for the specified activity. ",
    "title":"Items"
}

Nested Schema : Resource Preference

Type: object

Title: Resource Preference

The resource preference of an activity.

Show Source

• preferenceType(required): string
  Title: Preference Type

  Allowed Values: [ "required", "preferred", "forbidden", "warehouse" ]

  The type of resource preference for the activity.

  • preferred - the resource is preferred while routing.
  • required - the activity can only be assigned to a required resource.
  • forbidden - the activity cannot be assigned to the specified resource.
  • warehouse - inventory may be installed from the specified resource
• resourceId: string
  Title: Resource ID

  The unique identifier of the resource in Oracle Field Service.

{
    "required":[
        "preferenceType"
    ],
    "properties":{
        "resourceId":{
            "type":"string",
            "description":"The unique identifier of the resource in Oracle Field Service. ",
            "title":"Resource ID"
        },
        "preferenceType":{
            "type":"string",
            "enum":[
                "required",
                "preferred",
                "forbidden",
                "warehouse"
            ],
            "description":"The type of resource preference for the activity.<ul><li>preferred - the resource is preferred while routing.</li><li>required - the activity can only be assigned to a required resource.</li><li>forbidden - the activity cannot be assigned to the specified resource.</li><li>warehouse - inventory may be installed from the specified resource</li></ul>",
            "title":"Preference Type"
        }
    },
    "description":"The resource preference of an activity.",
    "title":"Resource Preference",
    "type":"object"
}

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.

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 resource preferences of an activity by submitting a PUT request on the REST resource using cURL.

curl -X 'PUT' \
     -u '<CLIENT-ID>@<INSTANCE-NAME>:<CLIENT-SECRET>' \
     -H 'Content-Type: application/json' \
     --data-binary '{
    "items": [
        {
            "resourceId": "11103",
            "preferenceType": "preferred"
        },
        {
            "resourceId": "11104",
            "preferenceType": "preferred"
        },
        {
            "resourceId": "11105",
            "preferenceType": "forbidden"
        }
    ]
}' \
     'https://<instance_name>.fs.ocs.oraclecloud.com/rest/ofscCore/v1/activities/4225269/resourcePreferences'

Example of Response Header

The following shows an example of the response header.

HTTP/1.1 204 No Content
Server: nginx/1.2.7
Date: Fri, 18 Mar 2016 02:20:17 GMT
Content-Type: application/json; charset=utf-8
Connection: close

Back to Top