Mappings
- 3 minutes to read
Overview
When you bind the Scheduler to a data source, you need to map appointments, resources, labels and statuses properties to data source fields. The names of the database fields are usually fixed, and you cannot change them. Mappings are used to adjust the Scheduler data model to the existing data model.
The SchedulerControl uses Mapping instances to connect the object properties with the corresponding data fields. Use the Mapping.Converter property to register a value converter for a custom storage format. Review the Mapping Converters topic for more information.
You can define Custom Mappings - any number of mappings to data source fields that are not used by the Scheduler itself. The content of these fields is available using the SourceObjectContainer.CustomFields property of the AppointmentItem, ResourceItem, AppointmentLabelItem and AppointmentStatusItem objects. To specify a custom mapping, create a CustomFieldMapping instance and add it to the MappingsBase.CustomFieldMappings collection. To learn more, see the Custom Fields document.
Appointment Mappings
| Mapping | Description |
|---|---|
| AppointmentMappings.AllDay | Specifies the mapping that binds the appointment’s AppointmentItem.AllDay property to the data source field. |
| AppointmentMappings.Description | Specifies the mapping that binds the appointment’s AppointmentItem.Description property to the data source field. |
| AppointmentMappings.End (required mapping) | Specifies the mapping that binds the appointment’s AppointmentItem.End property to the data source field. |
| AppointmentMappings.Id | Gets or sets the mapping that binds the appointment’s SourceObjectContainer.Id property to the data source field. |
| AppointmentMappings.Location | Specifies the mapping that binds the appointment’s AppointmentItem.Location property to the data source field. |
| AppointmentMappings.LabelId | Specifies the mapping that binds the appointment’s AppointmentItem.LabelId property to the data source field. |
| AppointmentMappings.QueryStart | Specifies the mapping that binds the appointment’s AppointmentItem.QueryStart property to the data source field. |
| AppointmentMappings.QueryEnd | Specifies the mapping that binds the appointment’s AppointmentItem.QueryEnd property to the data source field. |
| AppointmentMappings.RecurrenceInfo (required mapping for recurring appointments) | Gets or sets the mapping that binds the appointment’s AppointmentItem.RecurrenceInfo property to the data source field. |
| AppointmentMappings.Reminder | Gets or sets the mapping that binds the appointment’s AppointmentItem.Reminder property to the data source field. |
| AppointmentMappings.ResourceId | Specifies the mapping that binds the appointment’s AppointmentItem.ResourceId and AppointmentItem.ResourceIds properties to the data source field. |
| AppointmentMappings.Start (required mapping) | Specifies the mapping that binds the appointment’s AppointmentItem.Start property to the data source field. |
| AppointmentMappings.StatusId | Gets or sets the mapping that binds the appointment’s AppointmentItem.StatusId property to the data source field. |
| AppointmentMappings.Subject | Specifies the mapping that binds the appointment’s AppointmentItem.Subject property to the data source field. |
| AppointmentMappings.TimeZoneId | Specifies the mapping that binds the appointment’s AppointmentItem.TimeZoneId propertyto the data source field. |
| AppointmentMappings.Type (required mapping for recurring appointments) | Gets or sets the mapping that binds the appointment’s AppointmentItem.Type property to the data source field. |
Appointment Label Mappings
| Mapping | Description |
|---|---|
| AppointmentLabelMappings.Caption | Gets or sets the mapping that binds the appointment label’s AppointmentLabelItem.Caption property to the data source. |
| AppointmentLabelMappings.Color | Gets or sets the mapping that binds the appointment label’s AppointmentLabelItem.Color property to the data source field. |
| AppointmentLabelMappings.Id | Gets or sets the mapping that binds the appointment label’s SourceObjectContainer.Id property to the data source. |
Appointment Status Mappings
| Mapping | Description |
|---|---|
| AppointmentStatusMappings.Id | Specifies the mapping that binds the appointment status’s SourceObjectContainer.Id property to the data source field. |
| AppointmentStatusMappings.Caption | Specifies the mapping that binds the appointment status’s AppointmentStatusItem.Caption property to the data source field. |
| AppointmentStatusMappings.Brush | Specifies the mapping that binds the appointment label’s AppointmentStatusItem.Brush property to the data source field. |
Resource Mappings
| Mapping | Description |
|---|---|
| ResourceMappings.Caption | Specifies the mapping that binds the resource’s ResourceItem.Caption property to the data source field. |
| ResourceMappings.Color | Specifies the mapping that binds the resource’s ResourceItem.Color property to the data source field. |
| ResourceMappings.Id | Specifies the mapping that binds the resource’s SourceObjectContainer.Id property to the data source field. |
| ResourceMappings.Visible | Gets or sets the mapping that binds the appointment’s ResourceItem.Visible property to the data source field. |