Partager via

CalendarView

  • Article

L’élément CalendarView définit une opération FindItem comme renvoyant des éléments de calendrier dans un ensemble tels qu’ils apparaissent dans un calendrier.

FindItem

CalendarView

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

CalendarView

Attributs et éléments

Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.

Attributs

Attribut Description
MaxEntriesReturned
Décrit le nombre maximal de résultats à retourner dans la réponse FindItem.
StartDate
Identifie le début d’un intervalle de temps interrogé pour les éléments de calendrier. Tous les éléments de calendrier dont l’heure de fin est antérieure à StartDate ne seront pas retournés. La valeur de StartDate peut être spécifiée au format UTC (temps universel coordonné), comme au 2006-01-02T12:00:00Z, ou dans un format où l’heure locale et le décalage de fuseau horaire sont spécifiés, comme dans 2006-01-02T04:00:00-08:00.

Cet attribut est obligatoire.
EndDate
Identifie la fin d’un intervalle de temps interrogé pour les éléments de calendrier. Tous les éléments de calendrier dont l’heure de début est sur ou après EndDate ne seront pas retournés. La valeur de EndDate peut être spécifiée au format UTC, comme dans 2006-02-02T12:00:00Z, ou dans un format où l’heure locale et le décalage de fuseau horaire sont spécifiés, comme dans 2006-02-02T04:00:00-08:00.

EndDate doit être supérieur ou égal à StartDate ; sinon, une erreur est retournée. Cet attribut est obligatoire.

Éléments enfants

Aucun.

Éléments parents

Élément Description
FindItem
Définit une demande de recherche d’éléments dans une boîte aux lettres.

Voici l’expression XPath de cet élément :
/FindItem

Remarques

Si l’élément CalendarView est spécifié dans une requête FindItem, le service Web retourne une liste d’éléments de calendrier uniques et d’occurrences d’éléments de calendrier récurrents dans la plage spécifiée par StartDate et EndDate.

Si l’élément CalendarView n’est pas spécifié dans une requête FindItem, le service Web renvoie une liste d’éléments de calendrier uniques et d’éléments de calendrier maîtres récurrents. Les occurrences de calendrier d’un élément de calendrier périodique ne sont pas développées.

Les requêtes CalendarView doivent uniquement utiliser les propriétés suivantes, car elles prennent en charge des requêtes de calendrier plus rapides.

Propriétés de l’objet blob de périodicité

  • MapiStartTime

  • MapiEndTime

  • SubjectPrefixInternal

  • NormalizedSubjectInternal

  • MapiSubject

  • Emplacement

  • AppointmentColor

  • MapiIsAllDayEvent

  • MapiHasAttachment

  • FreeBusyStatus

  • ReminderIsSetInternal

  • ReminderMinutesBeforeStartInternal

  • AppointmentState

  • AllAttachmentsHidden

  • ChangeHighlight

Calculé à partir de l’objet blob de périodicité ou de la forme de base principale

  • ItemId

  • IsRecurring

  • IsException

  • AppointmentRecurring

  • MapiStartTime

  • MapiPRStartDate

  • MapiEndTime

  • MapiPREndDate

  • CalendarItemType

  • GlobalObjectId

  • TimeZoneDefinitionStart

  • TimeZoneDefinitionEnd

Propriétés de l’élément de calendrier principal

  • EntryId

  • ChangeKey

  • ItemClass

  • SentRepresentingEmailAddress

  • SentRepresentingDisplayName

  • SentRepresentingEntryId

  • AppointmentRecurrenceBlob

  • TimeZone

  • TimeZoneBlob

  • TimeZoneDefinitionRecurring

  • CleanGlobalObjectId

  • AppointmentRecurring

  • IsException

  • IsRecurring

  • MapiSensitivity

  • ContainerClass

  • MapiPRStartDate

  • MapiPREndDate

  • Categories

Le schéma qui décrit cet élément se trouve dans le répertoire virtuel IIS qui héberge les services web Exchange.

Exemple

L’exemple suivant montre une requête FindItem. Une requête réussie retourne une réponse qui inclut des éléments de calendrier qui a commencé à 2006-05-18T00:00:00-08:00 ou après et qui s’est terminée avant le 19T00-00: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>

Informations sur l'élément

Élément Exemple
Espace de noms
 http://schemas.microsoft.com/exchange/services/2006/messages
Nom du schéma
 Schéma Messages
Fichier de validation
 Messages.xsd
Peut être vide
 False

Voir aussi