Rule schema
Used to set targets for continuous rest within specific periods.
Show properties
Show properties
Labels for the rule. Labels can be used to group rules together. For example, if multiple rules are related to the same shift type, they can all be labeled with the same label.
The importance of the rule. The higher the importance, the more it will be taking the rule into account. Under strict importance, the rule may never be violated.
Filters to determine the scope of the rule. Used to indicate what the rule should be applied to (which employees, which shifts, etc). Leaving this empty means that the rule always applies.
Show filters – properties
Show filters – properties
Show employees – properties
Show employees – properties
Show matchTypes – properties
Show matchTypes – properties
Used to indicate how to apply the id filters. For example, if set to NONE, entities with the specified ids will be excluded. Default: “ANY”.
Show shifts – properties
Show shifts – properties
Show matchTypes – properties
Show matchTypes – properties
Used to indicate how to apply the id filters. For example, if set to NONE, entities with the specified ids will be excluded. Default: “ANY”.
Show targets – properties
Show targets – properties
Show options – properties
Show options – properties
List of periods in the schedule. Periods can be defined explicitly or through a recurrent definition (for example, to generate weeks).
Show blockedPeriods – properties
Show blockedPeriods – properties
List of days in the schedule. Each day will become one period. By default, each period will last the entire day. If a startTime and/or endTime are specified, these will apply to each period.
Show days – properties
Show days – properties
List of days of the week. Will apply to all days in the schedule that match any of the specified weekdays.
TIME ISO 8601 format hh:mm. Equivalent to the 24h format of a single day. Use 00:00 to represent midnight.
List of custom period definitions. Each custom period definition defines one period in the schedule.
Show customDefinitions – item structure
Show customDefinitions – item structure
Show startDay – properties
Show startDay – properties
Show endDay – properties
Show endDay – properties
TIME ISO 8601 format hh:mm. Equivalent to the 24h format of a single day. Use 00:00 to represent midnight.
TIME ISO 8601 format hh:mm. Equivalent to the 24h format of a single day. Use 00:00 to represent midnight.
Show recurrentDefinition – properties
Show recurrentDefinition – properties
The number of days between the start of each period. If not specified, this defaults to the value of daysPerPeriod, creating non-overlapping consecutive periods. Setting daysBetweenStarts to 1 will create a sliding window of periods.
Show startDay – properties
Show startDay – properties
Show endDay – properties
Show endDay – properties
TIME ISO 8601 format hh:mm. Equivalent to the 24h format of a single day. Use 00:00 to represent midnight.
TIME ISO 8601 format hh:mm. Equivalent to the 24h format of a single day. Use 00:00 to represent midnight.
Groups of periods during which periodic rest should be met. The rule is considered satisfied if there is at least one period group for which the periodic rest is met for all of its periods. Cannot be used together with the regular ‘periods’ field.
Show periodGroups – item structure
Show periodGroups – item structure
List of days in the schedule. Each day will become one period. By default, each period will last the entire day. If a startTime and/or endTime are specified, these will apply to each period.
Show days – properties
Show days – properties
List of days of the week. Will apply to all days in the schedule that match any of the specified weekdays.
TIME ISO 8601 format hh:mm. Equivalent to the 24h format of a single day. Use 00:00 to represent midnight.
List of custom period definitions. Each custom period definition defines one period in the schedule.
Show customDefinitions – item structure
Show customDefinitions – item structure
Show startDay – properties
Show startDay – properties
Show endDay – properties
Show endDay – properties
TIME ISO 8601 format hh:mm. Equivalent to the 24h format of a single day. Use 00:00 to represent midnight.
TIME ISO 8601 format hh:mm. Equivalent to the 24h format of a single day. Use 00:00 to represent midnight.
Show recurrentDefinition – properties
Show recurrentDefinition – properties
The number of days between the start of each period. If not specified, this defaults to the value of daysPerPeriod, creating non-overlapping consecutive periods. Setting daysBetweenStarts to 1 will create a sliding window of periods.
Show startDay – properties
Show startDay – properties
Show endDay – properties
Show endDay – properties
TIME ISO 8601 format hh:mm. Equivalent to the 24h format of a single day. Use 00:00 to represent midnight.
TIME ISO 8601 format hh:mm. Equivalent to the 24h format of a single day. Use 00:00 to represent midnight.
List of periods in the schedule. Periods can be defined explicitly or through a recurrent definition (for example, to generate weeks).
Show periods – properties
Show periods – properties
List of days in the schedule. Each day will become one period. By default, each period will last the entire day. If a startTime and/or endTime are specified, these will apply to each period.
Show days – properties
Show days – properties
List of days of the week. Will apply to all days in the schedule that match any of the specified weekdays.
TIME ISO 8601 format hh:mm. Equivalent to the 24h format of a single day. Use 00:00 to represent midnight.
List of custom period definitions. Each custom period definition defines one period in the schedule.
Show customDefinitions – item structure
Show customDefinitions – item structure
Show startDay – properties
Show startDay – properties
Show endDay – properties
Show endDay – properties
TIME ISO 8601 format hh:mm. Equivalent to the 24h format of a single day. Use 00:00 to represent midnight.
TIME ISO 8601 format hh:mm. Equivalent to the 24h format of a single day. Use 00:00 to represent midnight.
Show recurrentDefinition – properties
Show recurrentDefinition – properties
The number of days between the start of each period. If not specified, this defaults to the value of daysPerPeriod, creating non-overlapping consecutive periods. Setting daysBetweenStarts to 1 will create a sliding window of periods.
Show startDay – properties
Show startDay – properties
Show endDay – properties
Show endDay – properties
TIME ISO 8601 format hh:mm. Equivalent to the 24h format of a single day. Use 00:00 to represent midnight.
TIME ISO 8601 format hh:mm. Equivalent to the 24h format of a single day. Use 00:00 to represent midnight.
The following example defines a periodic rest rule that ensures that all employees get at least one 48-hour long continuous rest in each week.
{
"rules": {
"periodicRestRules": [
{
"id": "48-hours-per-week",
"importance": "HIGH",
"targets": {
"continuousRest": {
"minHours": 48
}
},
"periods": {
"recurrentDefinition": {
"daysPerPeriod": 7
}
}
}
]
}
}
The following example defines a periodic rest rule that ensures that all employees get at least one 72-hour long continuous rest in each month.
{
"rules": {
"periodicRestRules": [
{
"id": "72-hours-per-month",
"importance": "HIGH",
"targets": {
"continuousRest": {
"minHours": 72
}
},
"periods": {
"customDefinitions": [
{
"startDay": {
"date": "2022-01-01"
},
"endDay": {
"date": "2022-01-31"
}
},
{
"startDay": {
"date": "2022-02-01"
},
"endDay": {
"date": "2022-02-28"
}
}
]
}
}
]
}
}
Metrics
The following status metric is available for tracking on Periodic Rest rules:| Metric key | Description |
|---|---|
PERIODIC_REST.CONTINUOUS_REST_VIOLATIONS | Number of employee-rule combinations that violate the continuous-rest requirement. |