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 SchedulerItemBase.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 SchedulerItemBase.QueryStart property to the data source field.
AppointmentMappings.QueryEnd Specifies the mapping that binds the appointment's SchedulerItemBase.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 SchedulerItemBase.ResourceId and AppointmentItem.ResourceIds properties to the data source field.
AppointmentMappings.Start (required mapping) Specifies the mapping that binds the appointment's SchedulerItemBase.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 SchedulerItemBase.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.Brush Gets or sets the mapping that binds the appointment label's AppointmentLabelItem.Brush property to the data source field.
AppointmentLabelMappings.BrushName Gets or sets the mapping that binds the appointment label's AppointmentLabelItem.BrushName property to the data source field.
AppointmentLabelMappings.BrushSavingType Specifies the format type used to store the brush information.
AppointmentLabelMappings.Caption Gets or sets the mapping that binds the appointment label's AppointmentLabelItem.Caption property to the data source.
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.Brush Specifies the mapping that binds the appointment label's AppointmentStatusItem.Brush property to the data source field.
AppointmentStatusMappings.BrushName Gets or sets the mapping that binds the appointment label's AppointmentStatusItem.BrushName property to the data source field.
AppointmentStatusMappings.BrushSavingType Specifies the type of format used to store the brush information.
AppointmentStatusMappings.Caption Specifies the mapping that binds the appointment status's AppointmentStatusItem.Caption property to the data source field.
AppointmentStatusMappings.Id Specifies the mapping that binds the appointment status's SourceObjectContainer.Id property to the data source field.

Resource Mappings

Mapping Description
ResourceMappings.Brush Specifies the mapping that binds the resource's ResourceItem.Brush property to the data source field.
ResourceMappings.BrushName Specifies the mapping that binds the resource's ResourceItem.BrushName property to the data source field.
ResourceMappings.BrushSavingType Specifies the format type used to store the brush information.
ResourceMappings.Caption Specifies the mapping that binds the resource's ResourceItem.Caption 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.

Time Region Mappings

Mapping Description
TimeRegionMappings.Brush Gets or sets the mapping that binds the time region's TimeRegionItem.Brush property to the data source.
TimeRegionMappings.BrushName Gets or sets the mapping that binds the time region's TimeRegionItem.BrushName property to the data source.
TimeRegionMappings.BrushSavingType Specifies the type of format used to store the brush information.
TimeRegionMappings.Type Gets or sets the mapping that binds the time region's TimeRegionItem.Type property to the data source.