Partager via

Jeux de propriétés et de réponse des formes dans EWS dans Exchange

  • Article

Découvrez comment gérer les formes de réponse et les jeux de propriétés retournés par l’API managée EWS et EWS dans Exchange.

Le magasin de données Exchange fournit une solution de stockage flexible qui vous permet de stocker différents éléments, tels que les contacts et les entrées de calendrier, dans le même dossier . Toutefois, il peut être difficile de gérer les données retournées à partir d’un appel à une opération EWS ou à une méthode d’API managée EWS.

Pour faciliter la gestion des données retournées par Exchange Online, Exchange Online dans le cadre de Office 365 ou de la version d’Excahange à partir d’Exchange 2013, l’API managée EWS utilise des jeux de propriétés et EWS utilise des formes de réponse. Il s’agit de collections prédéfinies qui fournissent les propriétés les plus courantes d’un élément de magasin. Le jeu de propriétés retourné est déterminé par le type d’élément. Cela signifie que lorsque vous liez un élément à l’aide de la méthode Item.Bind de l’API managée Exchange, vous obtenez un ensemble différent de propriétés en fonction du type d’élément auquel vous effectuez la liaison. La liaison à un élément de calendrier renvoie un ensemble de propriétés différent de celui de la liaison à un élément de contact. De même, si vous utilisez EWS, l’opération GetItem retourne un ensemble différent de propriétés en fonction du type d’élément retourné.

La liaison à un dossier avec la méthode Folder.Bind ou l’utilisation de l’opération GetFolder retourne également différents ensembles de propriétés en fonction du dossier que vous demandez.

Tableau 1. Formes de réponse prédéfinies

Forme de réponse Équivalent de l’API managée EWS Description
ID uniquement
 BasePropertySet.IdOnly
Retourne uniquement l’identificateur de l’élément ou du dossier. La plupart des applications doivent utiliser cette forme de réponse et spécifier toutes les propriétés supplémentaires requises.
Par défaut
 S/O
 Retourne un ensemble prédéfini de propriétés qui sont la valeur par défaut pour l’élément ou le dossier (EWS uniquement).
Toutes les propriétés
 BasePropertySet.FirstClassProperties
Retourne les propriétés que les applications clientes utilisent le plus souvent. Vous pouvez retourner des propriétés supplémentaires à l’aide d’un chemin de propriété.

Formes de réponse par défaut

EWS inclut un ensemble de formes de réponse par défaut pour les dossiers et les éléments.

Le tableau suivant répertorie les propriétés par défaut retournées pour chaque dossier par les opérations FindFolder et GetFolder EWS.

Tableau 2. Propriétés de dossier par défaut

Propriété Boîte de réception Calendar Contacts Éléments supprimés Projets Notes Autres dossiers Boîte d’envoi
Nom d’affichage
 X
 X
 X
 X
 X
 X
 X
 X
Identificateur de dossier
 X
 X
 X
 X
 X
 X
 X
 X
Nombre de sous-dossiers
 X
 X
 X
 X
 X
 X
 X
 X
Nombre total
 X
 X
 X
 X
 X
 X
 X
Nombre d’éléments non lus
 X
 X
 X
 X
 X

Le tableau suivant répertorie les propriétés par défaut retournées pour chaque type d’élément par les opérations FindItem et GetItem EWS.

Tableau 3. Propriétés d’élément par défaut

Propriété Élément de calendrier Contact Élément de message Tâche
Corps
 X(1)
CalendarItemType
 x
CompanyName
 x
CompleteName
 x
DateTimeCreated
 x
DateTimeSent
 x
Date d’échéance
 x(2)
EmailAddresses
 x
Fin
 x
FileAs
 x
From
 x
HasAttachments
 x
 x
 x
 x
ImAddresses
 x
IsAssociated
 x
 x
IsDeliveryReceiptRequested
 x
ItemId
 x
 x
 x
 x
JobTitle
 x
LegacyFreeBusyStatus
 x
Emplacement
 x
Organisateur
 x
PercentComplete
 x
PhoneNumbers
 x
PhysicalAddresses
 x
ResponseObjects
 x(1)
 x(1)
Sensibilité
 x
Taille
 x
StartDate
 x(2)
État
 x
Sujet
 x
 x
 x

Remarques :

  1. Inclus dans la réponse de l’opération GetItem . Non inclus dans la réponse de l’opération FindItem .

  2. Inclus dans la réponse uniquement si le champ contient des données. Non inclus dans la réponse si le champ est vide.

Toutes les propriétés définies et la forme de réponse

Le tableau suivant répertorie les propriétés de première classe retournées par l’appel des méthodes d’API managée EWS Item.Bind et Item.FindItems , ainsi que la forme de réponse « all properties » retournée par les opérations FindItem et GetItem EWS.

Vous pouvez ajouter des propriétés supplémentaires au jeu de propriétés ou inclure des propriétés étendues. Pour plus d’informations, consultez Propriétés et propriétés étendues dans EWS dans Exchange.

Tableau 4. Propriétés de première classe

Propriété
 Élément de calendrier
 Contact
 Élément de message
 Publier un élément
 Tâche
ActualWork
 x
AdjacentMeetingCount
 x
AdjacentMeetings
 x
Alias
 x
AllowNewTimeProposal
 x
AppointmentReplyTime
 x
AppointmentSequenceNumber
 x
AppointmentState
 x
AssignedTime
 x
AssistantName
 x
BccRecipients
 x
BillingInformation
 x
Corps
 x(1)
 x(1)
 x(1)
 x(1)
BusinessHomePage
 x
 x
CalendarItemType
 x
Catégories
 x
 x
 x
 x
CcRecipients
 x
ChangeCount
 x
Children
 x
Sociétés
 x
CompleteDate
 x
CompleteName
 x
ConferenceType
 x
ConflictingMeetingCount
 x
ConflictingMeetings
 x
Contacts
 x
ContactSource
 x
ConversationId
 x
 x
 x
 x
 x
ConversationIndex
 x
 x
ConversationTopic
 x
 x
Culture
 x
 x
 x
 x
 x
DateTimeCreated
 x
 x
 x
 x
 x
DateTimeReceived
 x
 x
 x
 x
 x
DateTimeSent
 x
 x
 x
 x
 x
DateTimeStamp
 x
DelegationState
 x
Delegator
 x
DeletedOccurrences
 x
Service
 x
DirectoryId
 x
DirectReports
 x
DisplayCc
 x
 x
 x
 x
 x
DisplayName
 x
DisplayTo
 x
 x
 x
 x
 x
Date d’échéance
 x
Durée
 x
EffectiveRights
 x
 x
 x
 x
 x
EmailAddresses
 x
Fin
 x
EndTimeZone
 x
FileAs
 x
FileAsMapping
 x
FirstOccurrence
 x
From
 x
 x
Generation
 x
GivenName
 x
HasAttachments
 x
 x
 x
 x
 x
HasPicture
 x
ImAddresses
 x
Importance
 x
 x
 x
 x
 x
Initiales
 x
InReplyTo
 x
 x
 x
 x
 x
InternetMessageId
 x
 x
InternetMessageHeaders
 x
 x
 x
 x
 x
IsAllDayEvent
 x
IsAssociated
 x
 x
 x
 x
 x
IsCancelled
 x
IsComplete
 x
IsDeliveryReceiptRequested
 x
IsDraft
 x
 x
 x
 x
 x
IsFromMe
 x
 x
 x
 x
 x
IsMeeting
 x
IsOnlineMeeting
 x
IsRead
 x
IsReadReceiptRequested
 x
IsRecurring
 x
 x
IsResend
 x
 x
 x
 x
 x
IsResponseRequested
 x
 x
IsSubmitted
 x
 x
 x
 x
 x
IsUnmodified
 x
 x
 x
 x
 x
ItemClass
 x
 x
 x
 x
 x
ItemId
 x
 x
 x
 x
 x
JobTitle
 x
LastModifiedName
 x
 x
 x
 x
 x
LastModifiedTime
 x
 x
 x
 x
 x
LastOccurrance
 x
LegacyFreeBusyStatus
 x
Emplacement
 x
Responsable
 x
MeetingRequestWasSent
 x
MeetingTimeZone
 x
MeetingWorkspaceURL
 x
MiddleName
 x
Mileage
 x
 x
ModifiedOccurrances
 x
MyResponseType
 x
NetShowUrl
 x
NickName
 x
Notes
 x
OfficeLocation
 x
OptionalAttendees
 x
Organisateur
 x
OriginalStart
 x
Propriétaire
 x
ParentFolderId
 x
 x
 x
 x
 x
PercentComplete
 x
PhoneNumbers
 x
PhoneticFirstName
 x
PhoneticFullName
 x
PhoneticLastName
 x
Photo
 x
PhysicalAddresses
 x
PostalAddressIndex
 x
PostedTime
 x
Profession
 x
ReceivedBy
 x
ReceivedRepresenting
 x
Récurrence
 x
 x
References
 x
 x
ReminderDueBy
 x
 x
 x
 x
 x
ReminderIsSet
 x
 x
 x
 x
 x
ReminderMinutesBeforeStart
 x
 x
 x
 x
 x
ReplyTo
 x
RequiredAttendees
 x
Ressources
 x
ResponseObjects
 x(1)
 x(1)
 x(1)
 x(1)
 x(1)
Expéditeur
 x
 x
Niveau de confidentialité
 x
 x
 x
 x
 x
Taille
 x
 x
 x
 x
 x
SpouseName
 x
Démarrer
 x
StartDate
 x
StartTimeZone
 x
État
 x
StatusDescription
 x
Sujet
 x
 x
 x
 x
Surname
 x
TimeZone
 x
ToRecipients
 x
TotalWork
 x
WebClientEditFormQueryString
 x
 x
 x
 x
 x
WebClientReadFormQueryString
 x
 x
 x
 x
 x

Remarques :

  1. Inclus lors de la liaison à un élément et dans la réponse de l’opération GetItem. Non inclus dans le résultat de la méthode Item.FindItems ou dans la réponse de l’opération FindItem.

Voir aussi