Jeux de propriétés et de réponse des formes dans EWS dans ExchangeProperty sets and response shapes in EWS in Exchange

Apprenez à gérer les formes de réponse et les jeux de propriétés qui sont renvoyés par l’API managée EWS et EWS dans Exchange.Learn to manage the response shapes and property sets that are returned by the EWS managed API and EWS in Exchange.

Le magasin de données Exchange offre une solution de stockage flexible qui vous permet de stocker différents éléments, tels que des contacts et des entrées de calendrier, dans le même dossier ; Toutefois, il peut compliquer la gestion des données renvoyées par un appel à une opération EWS ou une méthode d’API managée EWS.The Exchange data store provides a flexible storage solution that enables you to store different items, such as contacts and calendar entries, in the same folder; however, it can make it difficult to manage the data that is returned from a call to an EWS operation or an EWS managed API method.

Pour faciliter la gestion des données renvoyées par Exchange Online, Exchange Online dans le cadre d’Office 365 ou la version de Excahange à partir d’Exchange 2013, l’API managée EWS utilise des jeux de propriétés et EWS utilise des formes réponse.To make it easier to manage the data that is returned by Exchange Online, Exchange Online as part of Office 365, or version of Excahange starting with Exchange 2013, the EWS Managed API uses property sets, and EWS uses response shapes. Il s’agit de collections prédéfinies qui fournissent les propriétés les plus communes d’un élément Store.These are predefined collections that provide the most common properties of a store item. Le jeu de propriétés renvoyé est déterminé par le type d’élément.The set of properties that is returned is determined by the item type. Cela signifie que lorsque vous liez un élément à l’aide de la méthode Exchange Managed API Item. bind , vous obtenez un ensemble de propriétés différent selon le type d’élément auquel vous vous liez.That means that when you bind an item by using the Exchange Managed API Item.Bind method, you get a different set of properties depending on the type of item to which you bind. La liaison à un élément de calendrier renverra un ensemble de propriétés différent de la liaison à un élément de contact.Binding to a calendar item will return a different set of properties than binding to a contact item. De même, si vous utilisez EWS, l' opération GetItem renvoie un jeu de propriétés différent en fonction du type d’élément renvoyé.Likewise, if you are using EWS, the GetItem operation returns a different set of properties based on the type of item that is returned.

La liaison à un dossier avec la méthode Folder. bind ou l’utilisation de l' opération GetFolder renvoie également différents ensembles de propriétés en fonction du dossier que vous demandez.Binding to a folder with the Folder.Bind method or using the GetFolder operation also returns different sets of properties based on the folder that you request.

Tableau 1. Formes de réponse prédéfiniesTable 1. Predefined response shapes

Forme de la réponseResponse shape Équivalent de l’API managée EWSEWS Managed API equivalent DescriptionDescription
ID uniquementID only
BasePropertySet.IdOnlyBasePropertySet.IdOnly
Renvoie uniquement l’identificateur de l’élément ou du dossier.Returns only the identifier of the item or folder. La plupart des applications doivent utiliser cette forme de réponse et spécifier les propriétés supplémentaires requises.Most applications should use this response shape and specify any additional properties that are required.
Par défautDefault
N/AN/A
Renvoie 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).Returns a predefined set of properties that are the default for the item or folder (EWS only).
Toutes les propriétésAll properties
BasePropertySet.FirstClassPropertiesBasePropertySet.FirstClassProperties
Renvoie les propriétés que les applications clientes utilisent le plus souvent.Returns the properties that client applications use most often. Vous pouvez renvoyer des propriétés supplémentaires à l’aide d’un chemin d’accès à une propriété.You can return additional properties by using a property path.

Formes de réponse par défautDefault response shapes

EWS inclut un ensemble de formes de réponse par défaut pour les dossiers et les éléments.EWS includes a set of default response shapes for folders and for items.

Le tableau suivant répertorie les propriétés par défaut qui sont renvoyées pour chaque dossier par les opérations EWS FindFolder et GetFolder .The following table lists the default properties that are returned for each folder by the FindFolder and GetFolder EWS operations.

Tableau 2. Propriétés de dossier par défautTable 2. Default folder properties

PropertyProperty Boîte de réceptionInbox CalendarCalendar ContactsContacts Éléments supprimésDeleted items BrouillonsDrafts RemarquesNotes Autres dossiersOther folders OutboxOutbox
Nom unique (DN)Display name
XX
XX
XX
XX
XX
XX
XX
XX
Identificateur de dossierFolder ID
XX
XX
XX
XX
XX
XX
XX
XX
Nombre de sous-dossiersSubfolder count
XX
XX
XX
XX
XX
XX
XX
XX
Nombre totalTotal count
XX
XX
XX
XX
XX
XX
XX
Nombre de messages non lusUnread count
XX
XX
XX
XX
XX

Le tableau suivant répertorie les propriétés par défaut qui sont retournées pour chaque type d’élément par les opérations EWS FindItem et GetItem .The following table lists the default properties that are returned for each item type by the FindItem and GetItem EWS operations.

Tableau 3. Propriétés d’élément par défautTable 3. Default item properties

PropertyProperty Élément de calendrierCalendar item ContactContact item Élément de messageMessage item TâcheTask item
CorpsBody
X (1)X(1)
CalendarItemTypeCalendarItemType
xx
CompanyNameCompanyName
xx
CompleteNameCompleteName
xx
DateTimeCreatedDateTimeCreated
xx
DateTimeSentDateTimeSent
xx
Date d’échéanceDueDate
x (2)x(2)
EmailAddressesEmailAddresses
xx
EndEnd
xx
FileAsFileAs
xx
FromFrom
xx
HasAttachmentsHasAttachments
xx
xx
xx
xx
AdressesImAddresses
xx
IsAssociatedIsAssociated
xx
xx
IsDeliveryReceiptRequestedIsDeliveryReceiptRequested
xx
ItemIdItemId
xx
xx
xx
xx
JobTitleJobTitle
xx
LegacyFreeBusyStatusLegacyFreeBusyStatus
xx
EmplacementLocation
xx
OrganisateurOrganizer
xx
PercentCompletePercentComplete
xx
PhoneNumbersPhoneNumbers
xx
PhysicalAddressesPhysicalAddresses
xx
ResponseObjectsResponseObjects
x (1)x(1)
x (1)x(1)
SensititySensitity
xx
TailleSize
xx
StartDateStartDate
x (2)x(2)
ÉtatStatus
xx
SubjectSubject
xx
xx
xx

Remarques :Notes:

  1. Inclus dans la réponse de l’opération GetItem .Included in the response from the GetItem operation. Non inclus dans la réponse de l’opération FindItem .Not included in the response from the FindItem operation.

  2. Inclus uniquement dans la réponse si le champ contient des données.Only included in the response if the field contains data. Non inclus dans la réponse si le champ est vide.Not included in the response if the field is blank.

Toutes les propriétés set and Response ShapeAll properties set and response shape

Le tableau suivant répertorie les propriétés de première classe renvoyées en appelant l’élément de l’API managée EWS . bind et les méthodes de l’API managée EWS FindItems , ainsi que la forme de réponse « All Properties » renvoyées par les opérations EWS FindItem et GetItem .The following table lists the first-class properties that are returned by calling the EWS Managed API Item.Bind and Item.FindItems EWS Managed API methods, and the "all properties" response shape returned by the FindItem and GetItem EWS operations.

Vous pouvez ajouter des propriétés supplémentaires au jeu de propriétés ou inclure des propriétés étendues.You can add additional properties to the property set or include extended properties. Pour plus d’informations, consultez les Propriétés et les propriétés étendues dans EWS dans Exchange.For details, see Properties and extended properties in EWS in Exchange.

Tableau 4. Propriétés de première classeTable 4. First-class properties

PropriétéProperty
Élément de calendrierCalendar item
ContactContact item
Élément de messageMessage item
Élément postPost item
TâcheTask item
ActualWorkActualWork
xx
AdjacentMeetingCountAdjacentMeetingCount
xx
AdjacentMeetingsAdjacentMeetings
xx
AliasAlias
xx
AllowNewTimeProposalAllowNewTimeProposal
xx
AppointmentReplyTimeAppointmentReplyTime
xx
AppointmentSequenceNumberAppointmentSequenceNumber
xx
AppointmentStateAppointmentState
xx
AssignedTimeAssignedTime
xx
AssistantNameAssistantName
xx
BccRecipientsBccRecipients
xx
BillingInformationBillingInformation
xx
CorpsBody
x (1)x(1)
x (1)x(1)
x (1)x(1)
x (1)x(1)
BusinessHomePageBusinessHomePage
xx
xx
CalendarItemTypeCalendarItemType
xx
CatégoriesCategories
xx
xx
xx
xx
CcRecipientsCcRecipients
xx
ChangeCountChangeCount
xx
ChildrenChildren
xx
SociétésCompanies
xx
TerminéCompleteDate
xx
CompleteNameCompleteName
xx
ConferenceTypeConferenceType
xx
ConflictingMeetingCountConflictingMeetingCount
xx
ConflictingMeetingsConflictingMeetings
xx
ContactsContacts
xx
ContactSourceContactSource
xx
ConversationIdConversationId
xx
xx
xx
xx
xx
ConversationIndexConversationIndex
xx
xx
ConversationTopicConversationTopic
xx
xx
CultureCulture
xx
xx
xx
xx
xx
DateTimeCreatedDateTimeCreated
xx
xx
xx
xx
xx
DateTimeReceivedDateTimeReceived
xx
xx
xx
xx
xx
DateTimeSentDateTimeSent
xx
xx
xx
xx
xx
DateTimeStampDateTimeStamp
xx
DelegationStateDelegationState
xx
DelegatorDelegator
xx
DeletedOccurrencesDeletedOccurrences
xx
ServiceDepartment
xx
DirectoryIdDirectoryId
xx
DirectReportsDirectReports
xx
DisplayCcDisplayCc
xx
xx
xx
xx
xx
DisplayNameDisplayName
xx
DisplayToDisplayTo
xx
xx
xx
xx
xx
Date d’échéanceDueDate
xx
DuréeDuration
xx
EffectiveRightsEffectiveRights
xx
xx
xx
xx
xx
EmailAddressesEmailAddresses
xx
EndEnd
xx
EndTimeZoneEndTimeZone
xx
FileAsFileAs
xx
FileAsMappingFileAsMapping
xx
FirstOccurrenceFirstOccurrence
xx
FromFrom
xx
xx
2eGeneration
xx
GivenNameGivenName
xx
HasAttachmentsHasAttachments
xx
xx
xx
xx
xx
HasPictureHasPicture
xx
AdressesImAddresses
xx
ImportanceImportance
xx
xx
xx
xx
xx
InitialesInitials
xx
InReplyToInReplyTo
xx
xx
xx
xx
xx
InternetMessageIdInternetMessageId
xx
xx
InternetMessageHeadersInternetMessageHeaders
xx
xx
xx
xx
xx
IsAllDayEventIsAllDayEvent
xx
IsAssociatedIsAssociated
xx
xx
xx
xx
xx
IsCancelledIsCancelled
xx
IsCompleteIsComplete
xx
IsDeliveryReceiptRequestedIsDeliveryReceiptRequested
xx
IsDraftIsDraft
xx
xx
xx
xx
xx
IsFromMeIsFromMe
xx
xx
xx
xx
xx
IsMeetingIsMeeting
xx
IsOnlineMeetingIsOnlineMeeting
xx
IsReadIsRead
xx
IsReadReceiptRequestedIsReadReceiptRequested
xx
IsRecurringIsRecurring
xx
xx
IsResendIsResend
xx
xx
xx
xx
xx
IsResponseRequestedIsResponseRequested
xx
xx
IsSubmittedIsSubmitted
xx
xx
xx
xx
xx
IsUnmodifiedIsUnmodified
xx
xx
xx
xx
xx
ItemClassItemClass
xx
xx
xx
xx
xx
ItemIdItemId
xx
xx
xx
xx
xx
JobTitleJobTitle
xx
LastModifiedNameLastModifiedName
xx
xx
xx
xx
xx
LastModifiedTimeLastModifiedTime
xx
xx
xx
xx
xx
LastOccurranceLastOccurrance
xx
LegacyFreeBusyStatusLegacyFreeBusyStatus
xx
EmplacementLocation
xx
ResponsableManager
xx
MeetingRequestWasSentMeetingRequestWasSent
xx
MeetingTimeZoneMeetingTimeZone
xx
MeetingWorkspaceUrl,MeetingWorkspaceUrl
xx
MiddleNameMiddleName
xx
MileageMileage
xx
xx
ModifiedOccurrancesModifiedOccurrances
xx
MyResponseTypeMyResponseType
xx
NetShowUrlNetShowUrl
xx
NickNameNickName
xx
NotesNotes
xx
OfficeLocationOfficeLocation
xx
OptionalAttendeesOptionalAttendees
xx
OrganisateurOrganizer
xx
OriginalStartOriginalStart
xx
PropriétaireOwner
xx
ParentFolderIdParentFolderId
xx
xx
xx
xx
xx
PercentCompletePercentComplete
xx
PhoneNumbersPhoneNumbers
xx
PhoneticFirstNamePhoneticFirstName
xx
PhoneticFullNamePhoneticFullName
xx
PhoneticLastNamePhoneticLastName
xx
PhotoPhoto
xx
PhysicalAddressesPhysicalAddresses
xx
PostalAddressIndexPostalAddressIndex
xx
PostedTimePostedTime
xx
ProfessionProfession
xx
ReceivedByReceivedBy
xx
ReceivedRepresentingReceivedRepresenting
xx
ReccurrenceReccurrence
xx
xx
RéférencesReferences
xx
xx
ReminderDueByReminderDueBy
xx
xx
xx
xx
xx
ReminderIsSetReminderIsSet
xx
xx
xx
xx
xx
ReminderMinutesBeforeStartReminderMinutesBeforeStart
xx
xx
xx
xx
xx
ReplyToReplyTo
xx
RequiredAttendeesRequiredAttendees
xx
RessourcesResources
xx
ResponseObjectsResponseObjects
x (1)x(1)
x (1)x(1)
x (1)x(1)
x (1)x(1)
x (1)x(1)
ExpéditeurSender
xx
xx
Niveau de confidentialitéSensitivity
xx
xx
xx
xx
xx
TailleSize
xx
xx
xx
xx
xx
SpouseNameSpouseName
xx
DémarrerStart
xx
StartDateStartDate
xx
StartTimeZoneStartTimeZone
xx
ÉtatStatus
xx
StatusDescriptionStatusDescription
xx
SubjectSubject
xx
xx
xx
xx
SurnameSurname
xx
TimeZoneTimeZone
xx
ToRecipientsToRecipients
xx
TotalWorkTotalWork
xx
WebClientEditFormQueryStringWebClientEditFormQueryString
xx
xx
xx
xx
xx
WebClientReadFormQueryStringWebClientReadFormQueryString
xx
xx
xx
xx
xx

Remarques :Notes:

  1. Incluse lors de la liaison à un élément et dans la réponse de l' opération GetItem.Included when binding to an item and in the response from the GetItem operation. Non inclus dans le résultat de la méthode Item. FindItems ou réponse de l' opération FindItem.Not included in the result of the Item.FindItems method or the response from the FindItem operation.

Voir aussiSee also