A newer version of this page is available. Switch to the current version.

Mappings

  • 4 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.