バージョン

バックエンド データ ソースでフィールドをマップ

xamScheduleDataManager にデータを提供する一般的なシナリオは、スケジュール データがデータベースまたはカスタム オブジェクトに保存される場合です。ListScheduleDataConnector は、そのコレクションのスケジュール データを提供する任意の IEnumerable オブジェクトに設定可能な複数の ItemsSource プロパティ (例、 AppointmentItemsSource) を公開します。ListScheduleDataConnector は、データ ソースを問い合わせるために LINQ を使用します。データ ソースが IQueryable である場合、LINQ を使用して、現在の表示に必要となるアクティビティのみを取得します。

作成する xamSchedule エンティティにデータ ソース オブジェクトからプロパティをマップするには、関連する PropertyMappings コレクションを提供する必要があります (例、 AppointmentPropertyMappings)。これらは、データ ソース オブジェクトでプロパティ名を指定する (DataObjectProperty を介して) PropertyMapping オブジェクト、対応する xamSchedule エンティティ プロパティの名前 (例、AppointmentProperty を使用して)、そしてデータ ソース オブジェクトのプロパティ値と xamSchedule プロパティ値の間で変換するために使用できるオプションのコンバーターのコレクションです。以下は、これらのマッピング プロパティを使用している例です。

注: プロパティのマッピング コレクションには、 UseDefaultMappings プロパティがあります。データ ソース オブジェクトのプロパティ名が xamSchedule エンティティ オブジェクトのプロパティ名と同じである場合、このプロパティは自動的にプロパティをマップするために True に設定できます。リフレクションは同じ名前でプロパティを検索するために使用され、一致するプロパティが自動的にマップされます。さらに、一部のプロパティの名前が同じでない場合、それらのプロパティの明示的なプロパティ マッピング エントリをコレクションに追加できます。

XAML の場合:

<ig:ListScheduleDataConnector x:Name="scheduleDataConnector"
            ResourceItemsSource="{Binding CustomResources}"
            ResourceCalendarItemsSource="{Binding CustomCalendars}"
            AppointmentItemsSource="{Binding CustomAppointments}">
<ig:ListScheduleDataConnector.ResourcePropertyMappings>
        <ig:ResourcePropertyMappingCollection>
               <ig:ResourcePropertyMapping ResourceProperty="Id"
                        DataObjectProperty="MyId" />
                <ig:ResourcePropertyMapping ResourceProperty="Name"
                        DataObjectProperty="MyName" />
        </ig:ResourcePropertyMappingCollection>
    </ig:ListScheduleDataConnector.ResourcePropertyMappings>
<ig:ListScheduleDataConnector.ResourceCalendarPropertyMappings>
        <ig:ResourceCalendarPropertyMappingCollection>
                <ig:ResourceCalendarPropertyMapping
                        ResourceCalendarProperty="Id"
                        DataObjectProperty="MyId" />
                <ig:ResourceCalendarPropertyMapping
                        ResourceCalendarProperty="Name"
                        DataObjectProperty="MyName" />
                <ig:ResourceCalendarPropertyMapping
                        ResourceCalendarProperty="OwningResourceId"
                        DataObjectProperty="MyResourceId" />
        </ig:ResourceCalendarPropertyMappingCollection>
    </ig:ListScheduleDataConnector.ResourceCalendarPropertyMappings>
<ig:ListScheduleDataConnector.AppointmentPropertyMappings>
        <ig:AppointmentPropertyMappingCollection>
                <ig:AppointmentPropertyMapping
                        AppointmentProperty="Id"
                        DataObjectProperty="MyId" />
                <ig:AppointmentPropertyMapping
                        AppointmentProperty="Start"
                        DataObjectProperty="MyStart" />
                <ig:AppointmentPropertyMapping
                        AppointmentProperty="End"
                        DataObjectProperty="MyEnd" />
                <ig:AppointmentPropertyMapping
                        AppointmentProperty="OwningResourceId"
                        DataObjectProperty="MyOwnerId" />
                <ig:AppointmentPropertyMapping
                        AppointmentProperty="OwningCalendarId"
                        DataObjectProperty="MyCalendarId" />
                <ig:AppointmentPropertyMapping
                        AppointmentProperty="Subject"
                        DataObjectProperty="MySubject" />
                <ig:AppointmentPropertyMapping
                        AppointmentProperty="Description"
                        DataObjectProperty="MyDescription" />
        </ig:AppointmentPropertyMappingCollection>
    </ig:ListScheduleDataConnector.AppointmentPropertyMappings>
</ig:ListScheduleDataConnector>

Visual Basic の場合:

dataConnector.ResourcePropertyMappings =
    New ResourcePropertyMappingCollection()
dataConnector.ResourcePropertyMappings._
    Add(ResourceProperty.Id, "MyId")
dataConnector.ResourcePropertyMappings._
    Add(ResourceProperty.Name, "MyName")
dataConnector.ResourceCalendarPropertyMappings =_
    New ResourceCalendarPropertyMappingCollection()
dataConnector.ResourceCalendarPropertyMappings._
    Add(ResourceCalendarProperty.Id, "MyId")
dataConnector.ResourceCalendarPropertyMappings._
    Add(ResourceCalendarProperty.Name, "MyName")
dataConnector.ResourceCalendarPropertyMappings._
    Add(ResourceCalendarProperty.OwningResourceId, "MyResourceId")
dataConnector.AppointmentPropertyMappings =_
    New AppointmentPropertyMappingCollection()
dataConnector.AppointmentPropertyMappings._
    Add(AppointmentProperty.Id, "MyId")
dataConnector.AppointmentPropertyMappings._
    Add(AppointmentProperty.Start, "MyStart")
dataConnector.AppointmentPropertyMappings._
    Add(AppointmentProperty.[End], "MyEnd")
dataConnector.AppointmentPropertyMappings._
    Add(AppointmentProperty.OwningResourceId, "MyOwnerId")
dataConnector.AppointmentPropertyMappings._
    Add(AppointmentProperty.OwningCalendarId, "MyCalendarId")
dataConnector.AppointmentPropertyMappings._
    Add(AppointmentProperty.Subject, "MySubject")
dataConnector.AppointmentPropertyMappings._
    Add(AppointmentProperty.Description, "MyDescription")

C# の場合:

dataConnector.ResourcePropertyMappings =
    new ResourcePropertyMappingCollection();
dataConnector.ResourcePropertyMappings.Add(
    ResourceProperty.Id, "MyId");
dataConnector.ResourcePropertyMappings.Add(
    ResourceProperty.Name, "MyName");
dataConnector.ResourceCalendarPropertyMappings =
    new ResourceCalendarPropertyMappingCollection();
dataConnector.ResourceCalendarPropertyMappings.Add(
    ResourceCalendarProperty.Id, "MyId");
dataConnector.ResourceCalendarPropertyMappings.Add(
    ResourceCalendarProperty.Name, "MyName");
dataConnector.ResourceCalendarPropertyMappings.Add(
    ResourceCalendarProperty.OwningResourceId, "MyResourceId");
dataConnector.AppointmentPropertyMappings =
    new AppointmentPropertyMappingCollection();
dataConnector.AppointmentPropertyMappings.Add(
    AppointmentProperty.Id, "MyId");
dataConnector.AppointmentPropertyMappings.Add(
    AppointmentProperty.Start, "MyStart");
dataConnector.AppointmentPropertyMappings.Add(
    AppointmentProperty.End, "MyEnd");
dataConnector.AppointmentPropertyMappings.Add(
    AppointmentProperty.OwningResourceId, "MyOwnerId");
dataConnector.AppointmentPropertyMappings.Add(
    AppointmentProperty.OwningCalendarId, "MyCalendarId");
dataConnector.AppointmentPropertyMappings.Add(
    AppointmentProperty.Subject, "MySubject");
dataConnector.AppointmentPropertyMappings.Add(
    AppointmentProperty.Description, "MyDescription");

上記のサンプル コードでは、カスタム コレクション (CustomResources、CustomCalendars および CustomAppointments) は IEnumerable で、MyId や MyName などは、これらのコレクションが含むカスタム タイプのプロパティ名になります。

特定のプロパティ マッピングは、XamSchedule が正しく機能するために必要となります。ID フィールドはそれらのひとつで、さらに ID 値は項目ソースの各オブジェクトに対して一意でなければなりません。

必要フィールド

リソース:

  • ID - String - ID 値はスケジュール データ コネクターによって作成および保存されません。したがって、含まれる値や長さが一意である限り制約はありません。

ResourceCalendar:

  • ID - String - ID 値はスケジュール データ コネクターによって作成および保存されません。したがって、含まれる値や長さが一意である限り制約はありません。

  • OwningResourceId - String - Resource の ID フィールドからの値は、リソース カレンダーをリソースにリンクするために使用されます。したがって、使用可能な長さは、Resource の ID フィールドで使用可能な長さに対応する必要があります。

Appointment、 Journal および Task に共通:

  • Id - String - 非バリアンス アクティビティでは、デフォルトで GUID 値が文字列として保存されるため、 少なくとも 36 文字を使用できるようにする必要があります。バリアンス アクティビティでは、デフォルトで GUID、反復バージョン、さらに日付時間値が保存され、少なくとも 60 文字必要です。

  • Start - DateTime - このフィールドは null を使用できる DateTime フィールドにすることができます。

  • End - DateTime - このフィールドは null を使用できる DateTime フィールドにすることができます。

  • OwningResourceId - String - Resource の ID フィールドからの値は、リソース カレンダーをリソースにリンクするために使用されます。したがって、使用可能な長さは、Resource の ID フィールドで使用可能な長さに対応する必要があります。

  • StartTimeZoneId - String - 最大 40 文字まで使用できるようにする必要があります。

  • EndTimeZoneId - String - StartTimeZoneId と同じです。

以下のフィールドは、 ResourceCalendarItemsSource が提供される場合に限り必要とされます。

  • OwningCalendarId - String - ResourceCalendar の ID フィールドからの値は、リソース カレンダーをアクティビティにリンクするために使用されます。したがって、使用可能な長さは、ResourceCalendar の ID フィールドで使用可能な長さに対応する必要があります。

タイム ゾーン ニュートラルなアクティビティをサポートするには:

  • IsTimeZoneNeutral - Boolean - このフィールドは null にすることができます。

繰り返しアクティビティをサポートするには:

  • Recurrence - String - 繰り返しルールは、iCalendar RECUR 値形式で保存されます。このフィールドは、30 文字くらいから 100 文字をはるかに超えるテキスト値を持つことができる可変長フィールドにする必要があります。

  • MaxOccurrenceDateTime - DateTime - このフィールドは null を使用できる DateTime フィールドにすることができます。

繰り返しアクティビティのバリアンスをサポートするには:

アラームをサポートするには:

  • ReminderEnabled - Boolean

  • ReminderInterval - TimeSpan

  • Reminder - String - このフィールドは、繰り返しではないアクティビティには不要ですが、繰り返しアクティビティのアラームをサポートするために必要です。このフィールドは可変長テキスト フィールドである必要があります。

オプション フィールド

以下のリストは、オプションのフィールドに対する要件を定義します。これらのフィールドはオプションですが、スケジュール機能をより良くするためにマッピングを提供したい場合があります。

リソース:

  • Name - String

  • EmailAddress - String

  • Description - String

  • FirstDayOfWeek - .NET Nullable DayOfWeek 列挙体型または null を使用できる整数型。

  • DaysOfWeek - String - このフィールドは、ScheduleDaysOfWeek オブジェクトが XML としてシリアル化される可変長テキスト フィールドである必要があります。

  • DaySettingsOverrides - String - このフィールドは、DaySettingsOverridesCollection が XML としてシリアル化される可変長テキスト フィールドである必要があります。

  • IsVisible - Nullable Boolean

  • IsLocked - Boolean

  • UnmappedProperties - String - マッピングが提供されないフィールド値は、XML としてこのフィールドに保存されます。このフィールドは可変長テキスト フィールドである必要があります。UnmappedProperties によって、不要なフィールドの定義を回避できますが、それらのフィールド値をデータ ソースに保存することはできます。

ResourceCalendar:

  • Name - String

  • Description - String

  • BaseColor - String

  • IsVisible - Nullable Boolean

  • UnmappedProperties - String - 上記の Resource の UnmappedProperties の説明を参照してください。

Appointment、 Journal および Task:

ListScheduleDataConnector での LINQ の使用

LINQ はオンデマンドでアクティビティを取得するために使用されます。LINQ クエリが実行されるフィールドは、特定のタイプであることが求められます。

LINQ to SQL の使用

LINQ to SQL を使用する場合、以下のように sql テーブルで DateTime および TimeSpan 列を定義してください。

  • DateTime フィールド - datetime sql データ型の Date-time 範囲は、.NET DateTime データ型より小さくなります。Microsoft SQL 2008 バージョンでは、.NET DateTime データ型に一致するより大きい date-time 範囲が使用できる新しい datetime2 データ型があります。したがって、datetime2 は任意の date-time フィールドに使用される必要があります。SQL サーバーの古いバージョンでは、null を使用できる datetime を使用する必要があり、これによってデフォルト値 (DateTime) を null として保存できます。

  • ReminderInterval - このフィールドは、TimeSpan フィールドにする必要があります。Microsoft SQL サーバーは、組み込みのタイムスパン データ型を持たないので、bigint データ型を使用できます。ただし、LINQ to SQL スキーマでは、LINQ to SQL エンティティ オブジェクトのプロパティ型を .NET TimeSpan に変更する必要があります。LINQ to SQL は、.NET TimeSpan 型と基本の SQL bigint 型で必要な変換を実行するための組み込みロジックを持ちます。

関連トピック

データ コネクターについて

ListScheduleConnector