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

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

• Développer des clients de service web pour Exchange

• Opération FindItem

• Opération GetItem

• Opération FindFolder

• Opération GetFolder