Compartilhar via

CalendarView

  • Artigo

O elemento CalendarView define uma operação FindItem como retornando itens de calendário em um conjunto conforme eles aparecem em um calendário.

FindItem

Modo de exibição do Calendário

<CalendarView MaxEntriesReturned="" StartDate="" EndDate="" />

Modo de exibição do Calendário

Atributos e elementos

As seções a seguir descrevem os atributos, os elementos filhos e os elementos pai.

Atributos

Atributo Descrição
MaxEntriesReturned
Descreve o número máximo de resultados a serem retornados na resposta FindItem.
StartDate
Identifica o início de um período de tempo consultado para itens de calendário. Todos os itens de calendário que têm um tempo de término antes do StartDate não serão retornados. O valor de StartDate pode ser especificado no formato UTC (tempo universal coordenado), como em 2006-01-02T12:00:00Z ou em um formato em que o deslocamento de fuso horário e horário local é especificado, como em 2006-01-02T04:00:00-08:00.

Esse atributo é necessário.
EndDate
Identifica o fim de um período de tempo consultado para itens de calendário. Todos os itens de calendário que têm um tempo de início ativado ou após EndDate não serão retornados. O valor de EndDate pode ser especificado no formato UTC, como em 2006-02-02T12:00:00Z ou em um formato em que o deslocamento de fuso horário e horário local é especificado, como em 2006-02-02T04:00:00-08:00.

EndDate deve ser maior ou igual a StartDate; caso contrário, um erro é retornado. Esse atributo é necessário.

Elementos filho

Nenhum.

Elementos pai

Elemento Descrição
FindItem
Define uma solicitação para encontrar itens em uma caixa de correio.

A seguir está a expressão XPath para esse elemento:
/FindItem

Comentários

Se o elemento CalendarView for especificado em uma solicitação FindItem, o serviço Web retornará uma lista de itens de calendário único e ocorrências de itens de calendário recorrentes dentro do intervalo especificado por StartDate e EndDate.

Se o elemento CalendarView não for especificado em uma solicitação FindItem, o serviço Web retornará uma lista de itens de calendário único e itens de calendário mestre recorrentes. As ocorrências de calendário de um item de calendário recorrente não são expandidas.

As consultas CalendarView só devem usar as propriedades a seguir, pois dão suporte a consultas de calendário mais rápidas.

Propriedades do blob de recorrência

  • MapiStartTime

  • MapiEndTime

  • SubjectPrefixInternal

  • NormalizedSubjectInternal

  • MapiSubject

  • Local

  • AppointmentColor

  • MapiIsAllDayEvent

  • MapiHasAttachment

  • FreeBusyStatus

  • ReminderIsSetInternal

  • ReminderMinutesBeforeStartInternal

  • AppointmentState

  • AllAttachmentsHidden

  • ChangeHighlight

Calculado a partir do blob de recorrência primária ou mestre

  • ItemId

  • IsRecurring

  • IsException

  • AppointmentRecurring

  • MapiStartTime

  • MapiPRStartDate

  • MapiEndTime

  • MapiPREndDate

  • CalendarItemType

  • GlobalObjectId

  • TimeZoneDefinitionStart

  • TimeZoneDefinitionEnd

Propriedades do item de calendário mestre

  • Entryid

  • ChangeKey

  • ItemClass

  • SentRepresentingEmailAddress

  • SentRepresentingDisplayName

  • SentRepresentingEntryId

  • AppointmentRecurrenceBlob

  • TimeZone

  • TimeZoneBlob

  • TimeZoneDefinitionRecurring

  • CleanGlobalObjectId

  • AppointmentRecurring

  • IsException

  • IsRecurring

  • MapiSensitivity

  • ContainerClass

  • MapiPRStartDate

  • MapiPREndDate

  • Categories

O esquema que descreve este elemento está localizado no diretório virtual do IIS que hospeda os Serviços Web do Exchange.

Exemplo

O exemplo a seguir mostra uma solicitação FindItem. Uma solicitação bem-sucedida retorna uma resposta que inclui itens de calendário que começaram em 2006-05-18T00:00:00-08:00 ou depois e terminaram antes de 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>

Elemento de informações

Elemento Exemplo
Namespace
 http://schemas.microsoft.com/exchange/services/2006/messages
Nome do esquema
 Esquema de mensagens
Arquivo de validação
 Messages.xsd
Pode ser vazio
 False

Confira também