Jump to

• Request
• Response
• Examples

Get resource work zones

get

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

This operation retrieves the details of the work zones assigned to the specified resource.

Request

Path Parameters

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

Query Parameters

• dateFrom: string(date)
  The work zones, which are active starting from the specified date, are retrieved in the response. Specify the date in YYYY-MM-DD format.
• dateTo: string(date)
  The work zones, which are active starting from the date in the dateFrom parameter till the specified date, are retrieved in the response. Specify the date in YYYY-MM-DD format. If you specify the dateTo parameter, then you must also specify the dateFrom parameter.
• onlyActiveWorkZones: boolean

  Indicates if the records related to inactive work zones should be returned in the response.

  If onlyActiveWorkZones=true parameter is specified, the resource work zone assignments related to inactive work zones will be skipped.

  Default Value: false

Back to Top

Response

Supported Media Types

• application/json

200 Response

This section describes the 200 status response for this operation.

Body ()

Root Schema : Work Zones

Type: object

Title: Work Zones

The list of the existing work zones.

Show Source

• items: array Items
  Title: Items

  An array of objects containing the details of the work zones assigned to the resource.

{
    "properties":{
        "items":{
            "items":{
                "$ref":"#/definitions/getResourceWorkZoneObject"
            },
            "type":"array",
            "description":"An array of objects containing the details of the work zones assigned to the resource.",
            "title":"Items"
        }
    },
    "title":"Work Zones",
    "description":"The list of the existing work zones.",
    "type":"object"
}

Nested Schema : Items

Type: array

Title: Items

An array of objects containing the details of the work zones assigned to the resource.

Show Source

• Array of: object Work Zone
  Title: Work Zone

{
    "items":{
        "$ref":"#/definitions/getResourceWorkZoneObject"
    },
    "type":"array",
    "description":"An array of objects containing the details of the work zones assigned to the resource.",
    "title":"Items"
}

Nested Schema : Work Zone

Type: object

Title: Work Zone

Show Source

• endDate: string
  Title: End Date

  The date until when the work zone assignment is effective. Specify the date in 'YYYY-MM-DD' format.
• ratio: integer
  Title: Ratio

  Minimum Value: 1

  Maximum Value: 100

  The work zone ratio of the resource. The default value is 100.
• recurEvery: integer
  Title: Recur Every

  Minimum Value: 1

  Maximum Value: 10000

  The time between each recurrence of the work zone assignment. Depending on the value selected for 'recurrence', the value of the parameter indicates the time between recurrence in days or weeks. For example, if '4' is the value of this parameter, and the 'recurrence' is 'daily', it indicates that the time between each recurrence is four days.
• recurrence: string
  Title: Recurrence

  Allowed Values: [ "weekly", "daily" ]

  The value of this parameter along with the 'Recur Every' parameter defines the time between each recurrence of the work zone assignment. For example, if you specify 'daily' as the value of this parameter and '4' as the value of the 'recurEvery' parameter, then the time between each recurrence is four days.
• startDate(required): string
  Title: Start Date

  The date when the work zone assignment takes effect. Specify the date in 'YYYY-MM-DD' format.
• type: string
  Title: Type

  Allowed Values: [ "regular", "override" ]

  The type of the work zone assignment.
• weekdays: array Weekdays
  Title: Weekdays

  Unique Items Required: true

  The weekdays on which the work zone is assigned to the resources. This parameter is mandatory when the recurrence is weekly.
• workZone(required): string
  Title: Work Zone Label

  Maximum Length: 255

  The identifier of the work zone.
• workZoneItemId: integer
  Title: Work Zone Item ID

  The identifier of the work zone assignment.
• workZoneStatus(required): string
  Title: Work zone status

  Allowed Values: [ "active", "inactive" ]

  Status of the work zone. Note that this is not a status of this workzone assignment to a resource. To modify this parameter use "Work Zones" functions in Metadata API.

{
    "title":"Work Zone",
    "type":"object",
    "properties":{
        "workZone":{
            "type":"string",
            "title":"Work Zone Label",
            "maxLength":255,
            "description":"The identifier of the work zone."
        },
        "ratio":{
            "type":"integer",
            "minimum":1,
            "maximum":100,
            "title":"Ratio",
            "description":"The work zone ratio of the resource. The default value is 100."
        },
        "recurrence":{
            "type":"string",
            "title":"Recurrence",
            "description":"The value of this parameter along with the 'Recur Every' parameter defines the time between each recurrence of the work zone assignment. For example, if you specify 'daily' as the value of this parameter and '4' as the value of the 'recurEvery' parameter, then the time between each recurrence is four days.",
            "enum":[
                "weekly",
                "daily"
            ]
        },
        "type":{
            "type":"string",
            "title":"Type",
            "description":"The type of the work zone assignment.",
            "enum":[
                "regular",
                "override"
            ]
        },
        "weekdays":{
            "title":"Weekdays",
            "description":"The weekdays on which the work zone is assigned to the resources. This parameter is mandatory when the recurrence is weekly.",
            "type":"array",
            "items":{
                "type":"string",
                "enum":[
                    "Sun",
                    "Mon",
                    "Tue",
                    "Wed",
                    "Thu",
                    "Fri",
                    "Sat"
                ]
            },
            "uniqueItems":true
        },
        "recurEvery":{
            "type":"integer",
            "minimum":1,
            "maximum":10000,
            "title":"Recur Every",
            "description":"The time between each recurrence of the work zone assignment. Depending on the value selected for 'recurrence', the  value of the parameter indicates the time between recurrence in days or weeks. For example, if '4' is the value of this parameter, and the 'recurrence' is 'daily', it indicates that the time between each recurrence is four days."
        },
        "startDate":{
            "type":"string",
            "title":"Start Date",
            "description":"The date when the work zone assignment takes effect. Specify the date in 'YYYY-MM-DD' format."
        },
        "endDate":{
            "type":"string",
            "title":"End Date",
            "description":"The date until when the work zone assignment is effective. Specify the date in 'YYYY-MM-DD' format."
        },
        "workZoneItemId":{
            "type":"integer",
            "title":"Work Zone Item ID",
            "description":"The identifier of the work zone assignment."
        },
        "workZoneStatus":{
            "type":"string",
            "title":"Work zone status",
            "enum":[
                "active",
                "inactive"
            ],
            "description":"Status of the work zone. Note that this is not a status of this workzone assignment to a resource. To modify this parameter use \"Work Zones\" functions in Metadata API."
        }
    },
    "required":[
        "startDate",
        "workZone",
        "workZoneStatus"
    ]
}

Nested Schema : Weekdays

Type: array

Title: Weekdays

Unique Items Required: true

The weekdays on which the work zone is assigned to the resources. This parameter is mandatory when the recurrence is weekly.

Show Source

• Array of: string
  Allowed Values: [ "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat" ]

{
    "title":"Weekdays",
    "description":"The weekdays on which the work zone is assigned to the resources. This parameter is mandatory when the recurrence is weekly.",
    "type":"array",
    "items":{
        "type":"string",
        "enum":[
            "Sun",
            "Mon",
            "Tue",
            "Wed",
            "Thu",
            "Fri",
            "Sat"
        ]
    },
    "uniqueItems":true
}

Default Response

This section describes the default error response for this operation.

Body ()

Root Schema : Error

Type: object

Show Source

• detail: string
  The detailed description of this error.
• status: string
  The HTTP status code of this error.
• title(required): string
  The brief description of this error.
• type(required): string
  The URL of the web page containing more details about this error.

{
    "properties":{
        "type":{
            "type":"string",
            "description":"The URL of the web page containing more details about this error."
        },
        "title":{
            "type":"string",
            "description":"The brief description of this error."
        },
        "status":{
            "type":"string",
            "description":"The HTTP status code of this error."
        },
        "detail":{
            "type":"string",
            "description":"The detailed description of this error."
        }
    },
    "required":[
        "type",
        "title"
    ]
}

Back to Top

Examples

The following example shows how to get work zones for a resource by submitting a GET request on the REST resource.

cURL command Example

curl -X GET \
  https://<instance_name>.fs.ocs.oraclecloud.com/rest/ofscCore/v1/resources/SUNRISE/workZones'\
  -u '<CLIENT-ID>@<INSTANCE-NAME>:<CLIENT-SECRET>' \
  -H 'content-type: application/json' \

Response Header Example

HTTP/1.1 200 OK Server: nginx/1.2.7 Date: Mon, Wed, 02 Jun 2021 11:53:49 GMT Content-Type: application/json; charset=utf-8

Response Body Example

{
    "items": [
        {
            "workZoneItemId": 11,
            "workZoneStatus": "active",
            "workZone": "ALTAMONTE SPRINGS",
            "startDate": "2008-03-27",
            "ratio": 100,
            "recurrence": "none",
            "recurEvery": 0,
            "type": "regular"
        },
        {
            "workZoneItemId": 12,
            "workZoneStatus": "active",
            "workZone": "CASSELBERRY",
            "startDate": "2008-03-27",
            "ratio": 100,
            "recurrence": "none",
            "recurEvery": 0,
            "type": "regular"
        },
        {
            "workZoneItemId": 13,
            "workZoneStatus": "active",
            "workZone": "CHULUOTA",
            "startDate": "2008-03-27",
            "ratio": 100,
            "recurrence": "none",
            "recurEvery": 0,
            "type": "regular"
        }
    ],
    "totalResults": 3,
    "links": [
        {
            "rel": "canonical",
            "href": "https:// <instance_name>.fs.ocs.oraclecloud.com /rest/ofscCore/v1/resources/SUNRISE/workZones"
        },
        {
            "rel": "describedby",
            "href": "https:// <instance_name>.fs.ocs.oraclecloud.com/rest/ofscCore/v1/metadata-catalog/resources"
        }
    ]
}

Back to Top