resources[]

Specifies an array of resources available in the scheduler.

Type: Array
Default Value: []

Each element of this array is an object that defines a resource kind - a room, a car or any other resource kind. A resource kind object must have at least the following fields.

There are more fields that can be specified within a resource kind object. They are listed below. For details on how to define a resource and assign it to scheduler appointments, refer to the Resources article.

allowMultiple

Indicates whether or not several resources of this kind can be assigned to an appointment.

Type: Boolean
Default Value: true

When this field is set to true, the dxTagBox widget is used in the Appointment popup window to specify resources for the current appointment. Alternatively, the dxSelectBox widget is used.

dataSource

A data source used to fetch resources to be available in the scheduler.

Default Value: null

You can assign an array directly to this option, as well as use the Data Source object provided by the DevExtreme library.

The resource objects must have particular fields so that the dxScheduler widget can present the resources for end users. For details, refer to the the Define Resources topic.

displayExpr

Specifies the resource object field whose value is displayed by the Resource editor in the Appointment popup window.

Default Value: 'text'

To allow end users to choose a required resource for an appointment, there is a field in the Appointment popup window. This field's label is specified by the label field of the resource kind object. The editor that is used to select a resource depends on the value of the allowMultiple field. The dxTagBox widget is used when a multiple selection is possible. The dxSelectBox widget is used when a single resource can be selected only. Both these widgets have the displayExpr and valueExpr options for specifying the displayed text and actual value of the selected item. These options are set to the displayExpr and valueExpr field values of the resource kind object, respectively.

field

The name of the appointment object field that specifies a resource of this kind.

Type: String
Default Value: ""

Use this option to declare how to call an appointment field to specify a resource of this kind. In addition, the value of this option is used to define grouping by resources in the scheduler.

label

Specifies the label of the Appointment popup window field that allows end users to assign a resource of this kind.

Type: String
Default Value: ""

mainColor

Indicates whether or not resources of this kind have priority in the color identification of the appointments that have resources of different kinds assigned.

Type: Boolean
Default Value: false

In the dxScheduler widget, the appointments that use one of available resources are colored according to the color of this resource. When an appointment uses resources of different kinds, the color of the resource kind whose mainColor option is set to true is used for coloring the appointment.

valueExpr

Specifies the resource object field that is used as a value of the Resource editor in the Appointment popup window.

Default Value: 'id'

To allow end users to choose a required resource for an appointment, there is a field in the Appointment popup window. This field's label is specified by the label field of the resource kind object. The editor that is used to select a resource depends on the value of the allowMultiple field. The dxTagBox widget is used when multiple selection is possible. The dxSelectBox widget is used when a single resource can be selected only. Both these widgets have the displayExpr and valueExpr options for specifying the displayed text and actual value of the selected item. These options are set to the displayExpr and valueExpr field values of the resource kind object, respectively.