Compartir a través de

CalendarView

  • Artículo

El elemento CalendarView define una operación FindItem como devolver elementos de calendario en un conjunto a medida que aparecen en un calendario.

FindItem

CalendarView

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

CalendarView

Atributos y elementos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Atributo Descripción
MaxEntriesReturned
Describe el número máximo de resultados que se devolverán en la respuesta FindItem.
StartDate
Identifica el inicio de un intervalo de tiempo consultado para los elementos de calendario. No se devolverán todos los elementos de calendario que tengan una hora de finalización anterior a StartDate . El valor de StartDate se puede especificar en formato de hora universal coordinada (UTC), como en 2006-01-02T12:00:00Z, o en un formato donde se especifica la hora local y el desplazamiento de zona horaria, como en 2006-01-02T04:00:00-08:00.

Este atributo es obligatorio.
EndDate
Identifica el final de un intervalo de tiempo consultado para los elementos de calendario. No se devolverán todos los elementos de calendario que tengan una hora de inicio que esté activada o después de EndDate . El valor de EndDate se puede especificar en formato UTC, como en 2006-02-02T12:00:00Z, o en un formato donde se especifica la hora local y el desplazamiento de zona horaria, como en 2006-02-02T04:00:00-08:00.

EndDate debe ser mayor o igual que StartDate; De lo contrario, se devuelve un error. Este atributo es obligatorio.

Elementos secundarios

Ninguno.

Elementos principales

Elemento Descripción
FindItem
Define una solicitud para buscar elementos en un buzón.

A continuación se muestra la expresión XPath de este elemento:
/FindItem

Comentarios

Si el elemento CalendarView se especifica en una solicitud FindItem, el servicio web devuelve una lista de elementos de calendario único y repeticiones de elementos de calendario periódicos dentro del intervalo especificado por StartDate y EndDate.

Si el elemento CalendarView no se especifica en una solicitud FindItem, el servicio web devuelve una lista de elementos de calendario únicos y elementos de calendario maestro periódicos. Las repeticiones de calendario de un elemento de calendario periódico no se expanden.

Las consultas CalendarView solo deben usar las siguientes propiedades, ya que admiten consultas de calendario más rápidas.

Propiedades de blob de periodicidad

  • MapiStartTime

  • MapiEndTime

  • SubjectPrefixInternal

  • NormalizedSubjectInternal

  • MapiSubject

  • Ubicación

  • AppointmentColor

  • MapiIsAllDayEvent

  • MapiHasAttachment

  • FreeBusyStatus

  • ReminderIsSetInternal

  • ReminderMinutesBeforeStartInternal

  • AppointmentState

  • AllAttachmentsHidden

  • ChangeHighlight

Calculado a partir del blob o patrón de periodicidad principal

  • ItemId

  • IsRecurring

  • IsException

  • AppointmentRecurring

  • MapiStartTime

  • MapiPRStartDate

  • MapiEndTime

  • MapiPREndDate

  • CalendarItemType

  • GlobalObjectId

  • TimeZoneDefinitionStart

  • TimeZoneDefinitionEnd

Propiedades del elemento de calendario maestro

  • EntryID

  • ChangeKey

  • ItemClass

  • SentRepresentingEmailAddress

  • SentRepresentingDisplayName

  • SentRepresentingEntryId

  • AppointmentRecurrenceBlob

  • TimeZone

  • TimeZoneBlob

  • TimeZoneDefinitionRecurring

  • CleanGlobalObjectId

  • AppointmentRecurring

  • IsException

  • IsRecurring

  • MapiSensitivity

  • ContainerClass

  • MapiPRStartDate

  • MapiPREndDate

  • Categories

El esquema que describe este elemento se encuentra en el directorio virtual IIS que hospeda los servicios Web Exchange.

Ejemplo

En el ejemplo siguiente se muestra una solicitud FindItem. Una solicitud correcta devuelve una respuesta que incluye elementos de calendario que se iniciaron en 2006-05-18T00:00:00-08:00 o después y finalizaron 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>

Información del elemento

Elemento Ejemplo
Namespace
 http://schemas.microsoft.com/exchange/services/2006/messages
Nombre de esquema
 Esquema de mensajes
Archivo de validación
 Messages.xsd
Puede estar vacío
 False

Vea también