/
REST Objects TimeConstraint

REST Objects TimeConstraint

5.0.0

The TimeConstraint object object can be part of:

  • The Appointment Book object, in the following location:
  • In this situation, a TimeConstraint object represents a period of time when it is permitted to carry out the work of a Work Item when performing an appointment booking.

or:

  • The Work Item object, in the following locations:
  • In this situation, a TimeConstraint object represents a period of time when it is permitted to carry out the associated booked Work Item.

TimeConstraint Object Format

JSON Format
{
	"Desc": "",
	"Period": {
		"Start": "",
		"End": ""
	},
	"Range": {
		"Days": "0000000",
		"RangeStartDt": "",
		"RangeEndDt": "",
		"DayStartTm": "",
		"DayEndTm": "",
		"TZ": ""
	},
	"Type": 1001
}

TimeConstraint Object Properties


Property

Type

Required?

Description

Field Mappings

ServiceDispatch

ServiceMobility

ServiceScheduling

Desc

string

No

A description of the time constraint.

N/A

/TimeConstraints/Desc

N/A

PeriodobjectNo

When present, the TimeConstraint object represents a single, exact period in time.

A TimeConstraint has either a Period or a Range, but not both.

--

StartstringNoThe start of the exact period in time, in UTC.N/A/TimeConstraints/Period/Startearliest

EndstringNoThe end of the exact period in time, in UTC.N/A/TimeConstraints/Period/Endlatest
RangeobjectNo

When present, the TimeConstraint object is represents a period of time that repeats on certain days of the week, between two dates.

A TimeConstraint has either a Period or a Range, but not both.

--

DaysstringNo

Which days of the week the repeating pattern applies to. A string of seven 0 or 1 values to represent each day of the week, off or on. First element is for Sunday.

e.g. "0111110" represents Mon-Fri.

N/AN/AN/A

RangeStartDtstringNo

The first date on which the repeating pattern applies to. If this is not supplied, the repeat is assumed to apply for all dates up to and including RangeEndDt. If neither RangeStartDt nor RangeEndDt is supplied, the pattern applies to all dates.

This is an ISO-8601 date in the format YYYY-MM-DD.

N/A/Range/RangeStartDtN/A

RangeEndDtstringNo

The last date on which the repeating pattern applies to. If this is not supplied, the repeat is assumed to apply for all dates after and including RangeStartDt. If neither RangeStartDt nor RangeEndDt is supplied, the pattern applies to all dates.

This is an ISO-8601 date in the format YYYY-MM-DD.

N/A/Range/RangeEndDtN/A

DayStartTmstringNo

The local time for the start of the constraint on each active day in the range (as defined by Days).

This is an ISO-8601 time in the format HH:mm.

N/AN/AN/A

DayEndTmstringNo

The local time for the end of the constraint on each active day in the range (as defined by Days).

This is an ISO-8601 time in the format HH:mm.

N/AN/AN/A

TZstringNo

The timezone to be used in order to calculate the time indicated by the period e.g. "Europe/London", "America/New_York".

String is an IANA timezone string (see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)

N/A/Range/TZN/A
TypeintegerNo

The type of constraint:

  • 10: Appointment
  • 20: Contract
  • 30: Shift
N/A/TimeConstraints/TypeN/A

Related content

TimeConstraints Object
TimeConstraints Object
More like this
Booking.objects
Booking.objects
More like this
Integration ServiceOptimizer Common API Concepts Requesting Appointments Promise Sets
Integration ServiceOptimizer Common API Concepts Requesting Appointments Promise Sets
More like this
Integration ServiceOptimizer Common API Concepts Requesting Appointments Promise Sets
Integration ServiceOptimizer Common API Concepts Requesting Appointments Promise Sets
More like this