xamSchedule コンポーネントが機能するようにするには、このコンポーネントのいくつかのプロパティを特定の必要となる設定に構成する必要があります。
以下は、コントロール、コンポーネント、およびエンティティ型で分類された必要となる設定のリストです。
ビュー (XamMonthView、 XamDayView、 XamScheduleView、 XamOutlookCalendarView および XamDateNavigator) プロパティ
DataManager - スケジュール情報を表示するために XamScheduleDataManager のインスタンスに設定する必要があります。
XamScheduleDataManager プロパティ
DataConnector - ScheduleDataConnectorBase 派生クラス (たとえば、 ListScheduleDataConnector または WcfListScheduleDataConnector) に設定する必要があります。
CurrentUserId - アラーム機能のために必要です。また、 CalendarGroups が DataManager または View で指定されていない場合、CurrentUserId が必要になります。このような場合、CurrentUser の PrimaryCalendar が表示されます。
CalendarGroups - このプロパティはオプションですが、カレンダー グループが DataManager で定義されておらず、CalendarGroupsOverride がビューで移植されない時には、CurrentUser の PrimaryCalendar が表示されるため、CurrentUserId が必要となります。
ListScheduleDataConnector は複数の ItemsSource プロパティ (たとえば、 AppointmentItemsSource) を公開しており、スケジュール エンティティ オブジェクトの作成元の情報を取得するために使用されます。また、ItemsSource プロパティごとに、対応する PropertyMappings プロパティ (たとえば、 AppointmentPropertyMappings) があり、データ オブジェクトに関する情報が項目ソースから対応するスケジュール エンティティのプロパティにどのようにマップされるのかを定義するために使用されます。
以下は、さまざまな ItemsSource プロパティのリストと、必要とされる時期と場合に関する情報です。
ResourceItemsSource - これは常に必要とされます。
ResourceCalendarItemsSource - 複数のカレンダーをひとつの Resource に関連付けるために必要です。このプロパティが指定されない場合、コネクターはリソースごとにデフォルトの ResourceCalendar を作成し、PrimaryCalendar として設定します。
AppointmentItemsSource - Appointment アクティビティを使用/表示するために必要です。
RecurringAppointmentItemsSource - 予定の繰り返しをサポートする時のオプションです。指定されると、コネクターは特定の日の範囲のアクティビティのリストを提供するなど、繰り返しアクティビティに関係する操作をより効率的に処理できます。
AppointmentItemsSource - Task アクティビティを使用/表示するために必要です。
JournalItemsSource - Journal アクティビティを使用/表示するために必要です。
ActivityCategoryItemSource - アクティビティ分類項目を使用するために必要です。
ExchangeScheduleDataConnector は直接 Exchange Server に接続して、1 人以上のユーザーのスケジュール データを管理します。以下は、接続で必要となるプロパティのリストと構成方法の詳細です。
ServerConnectionSettings - Url プロパティを有効な Exchange Server Url に設定した ExchangeServerConnectionSettings クラスのインスタンスでなければなりません。
Users または UseDefaultCredentials - IEnumerable<ExchangeUser> コレクションに少なくとも 1 人のユーザーがおり、コネクタの Users プロパティで設定されなければなりません。これは、管理するユーザーのデータの情報を提供します。
エンティティ型 (つまり、 Resource、 ResourceCalendar、 Appointment、 Task、 Journal) ごとに、特定のプロパティが必要とされます。常に必要とされるプロパティもありますが、特定の機能をサポートすべき場合に必要とされるプロパティもあります。以下は、エンティティ型ごとの必要とされるプロパティのリストで、それらのすべてに PropertyMappings が指定される必要があります:
リソース型
Id - 常に必要とされ、一意でなければなりません。
Appointment / Journal / Task 型
Id - 常に必要とされ、アクティビティ タイプごとに一意でなければなりません。
Start - 常に必要とされます。
End - Task および Appointment で必要とされますが、Journal の場合はオプションです。
OwningResourceId - 常に必要とされます。
OwningCalendarId - ResourceCalendarItemsSource の設定に必要です。
IsTimeZoneNeutral - アクティビティ(timezone neutral アクティビティ) のフローティング数をサポートするために必要です。
ReminderInterval および ReminderEnabled - アラームをサポートするために必要です。
Recurrence - 繰り返しアクティビティをサポートするために必要です。
RootActivityId、 OriginalOccurrenceStart、 OriginalOccurrenceEnd、 IsOccurrenceDeleted、 VariantProperties、 RecurrenceVersion - 繰り返しアクティビティがサポートされる時にバリアンスをサポートするために必要です。
Categories - 分類項目をサポートするために必要です。
ResourceCalendarPropertyMappings - ResourceCalendarItemsSource の設定に必要です。
Id - 常に必要とされ、一意でなければなりません。
OwningResourceId - 常に必要とされ、一意でなければなりません。
フィールドの包括的なリストとデータ ソースでフィールドを定義する方法についてのヒントは、 バックエンド データ ソースでフィールドをマップを参照してください。