CalendarView
CalendarView 要素は、FindItem 操作を、予定表に表示されるセット内の予定表アイテムを返す操作として定義します。
<CalendarView MaxEntriesReturned="" StartDate="" EndDate="" />
CalendarView
属性と要素
以下のセクションで、属性、子要素、親要素について説明します。
属性
属性 | 説明 |
---|---|
MaxEntriesReturned |
FindItem 応答で返される結果の最大数について説明します。 |
StartDate |
予定表アイテムに対してクエリを実行する期間の開始を識別します。 StartDate より前の終了時刻を持つすべての予定表アイテムは返されません。 StartDate の値は、2006-01-02T12:00:00Z のように協定世界時 (UTC) 形式で指定することも、2006-01-02T04:00:00-08:00 のようにローカル時刻とタイム ゾーン オフセットが指定されている形式で指定することもできます。 この属性は必須です。 |
EndDate |
予定表アイテムに対してクエリを実行する期間の終了を識別します。 EndDate 以降の開始時刻を持つ予定表アイテムはすべて返されません。 EndDate の値は、2006-02-02T12:00:00Z のように UTC 形式で指定することも、2006-02-02T04:00:00-08:00 のようにローカル時刻とタイム ゾーン オフセットが指定されている形式で指定することもできます。 EndDate は StartDate 以上である必要があります。それ以外の場合はエラーが返されます。 この属性は必須です。 |
子要素
なし。
親要素
要素 | 説明 |
---|---|
FindItem |
メールボックス内のアイテムを検索する要求を定義します。 この要素への XPath 式を次に示します: /FindItem |
注釈
FindItem 要求で CalendarView 要素が指定されている場合、Web サービスは、StartDate と EndDate で指定された範囲内の 1 つの予定表アイテムと定期的な予定表アイテムの出現の一覧を返します。
FindItem 要求で CalendarView 要素が指定されていない場合、Web サービスは、1 つの予定表アイテムと定期的なマスター予定表アイテムの一覧を返します。 定期的な予定表アイテムの予定表の出現回数は展開されません。
CalendarView クエリは、より高速な予定表クエリをサポートするため、次のプロパティのみを使用する必要があります。
繰り返し BLOB プロパティ
MapiStartTime
MapiEndTime
SubjectPrefixInternal
NormalizedSubjectInternal
MapiSubject
場所
AppointmentColor
MapiIsAllDayEvent
MapiHasAttachment
FreeBusyStatus
ReminderIsSetInternal
ReminderMinutesBeforeStartInternal
AppointmentState
AllAttachmentsHidden
ChangeHighlight
プライマリ定期的な BLOB またはマスターから計算されます
ItemId
IsRecurring
IsException
AppointmentRecurring
MapiStartTime
MapiPRStartDate
MapiEndTime
MapiPREndDate
CalendarItemType
GlobalObjectId
TimeZoneDefinitionStart
TimeZoneDefinitionEnd
マスター 予定表アイテムのプロパティ
EntryId
ChangeKey
ItemClass
SentRepresentingEmailAddress
SentRepresentingDisplayName
SentRepresentingEntryId
AppointmentRecurrenceBlob
TimeZone
TimeZoneBlob
TimeZoneDefinitionRecurring
CleanGlobalObjectId
AppointmentRecurring
IsException
IsRecurring
MapiSensitivity
ContainerClass
MapiPRStartDate
MapiPREndDate
Categories
この要素を記述するスキーマは、Exchange Web サービスをホストする IIS 仮想ディレクトリに置かれています。
例
次の例は、FindItem 要求を示しています。 成功した要求は、2006-05-18T00:00:00-08:00 以降に開始され、2006-05-19T00:00:00-08:00 より前に終了した予定表アイテムを含む応答を返します。
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<soap:Body>
<FindItem Traversal="Shallow" xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<ItemShape>
<t:BaseShape>IdOnly</t:BaseShape>
<t:AdditionalProperties>
<t:FieldURI FieldURI="calendar:Start"/>
<t:FieldURI FieldURI="calendar:End"/>
<t:FieldURI FieldURI="item:Subject"/>
</t:AdditionalProperties>
</ItemShape>
<CalendarView MaxEntriesReturned="2" StartDate="2006-05-18T00:00:00-08:00" EndDate="2006-05-19T00:00:00-08:00"/>
<ParentFolderIds>
<t:DistinguishedFolderId Id="calendar"/>
</ParentFolderIds>
</FindItem>
</soap:Body>
</soap:Envelope>
要素の情報
要素 | 例 |
---|---|
Namespace |
http://schemas.microsoft.com/exchange/services/2006/messages |
スキーマ名 |
メッセージ スキーマ |
検証ファイル |
Messages.xsd |
空に設定可能 |
False |