CalendarView

  • [アーティクル]

CalendarView 要素は、FindItem 操作を、予定表に表示されるセット内の予定表アイテムを返す操作として定義します。

FindItem

CalendarView

<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="https://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <FindItem Traversal="Shallow" xmlns="https://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
 https://schemas.microsoft.com/exchange/services/2006/messages
スキーマ名
 メッセージ スキーマ
検証ファイル
 Messages.xsd
空に設定可能
 False

関連項目