Conjuntos de propiedades y formas de respuestas de EWS en ExchangeProperty sets and response shapes in EWS in Exchange

Aprenda a administrar las formas de respuesta y los conjuntos de propiedades que devuelven la API administrada de EWS y EWS en Exchange.Learn to manage the response shapes and property sets that are returned by the EWS managed API and EWS in Exchange.

El almacén de datos de Exchange proporciona una solución de almacenamiento flexible que permite almacenar diferentes elementos, como contactos y entradas de calendario, en la misma carpeta; sin embargo, puede dificultar la administración de los datos que se devuelven desde una llamada a una operación de EWS o un método de la API administrada de 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.

Para que sea más fácil administrar los datos devueltos por Exchange Online, Exchange online como parte de Office 365 o la versión de Excahange a partir de Exchange 2013, la API administrada de EWS usa conjuntos de propiedades y EWS usa formas de respuesta.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. Estas son colecciones predefinidas que proporcionan las propiedades más comunes de un elemento de almacenamiento.These are predefined collections that provide the most common properties of a store item. El conjunto de propiedades que se devuelve está determinado por el tipo de elemento.The set of properties that is returned is determined by the item type. Esto significa que, cuando se enlaza un elemento mediante el método Item. bind de la API administrada de Exchange, se obtiene un conjunto de propiedades diferente según el tipo de elemento al que se enlace.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. El enlace a un elemento de calendario devolverá un conjunto diferente de propiedades que enlazar a un elemento de contacto.Binding to a calendar item will return a different set of properties than binding to a contact item. Del mismo modo, si está usando EWS, la operación GetItem devuelve un conjunto de propiedades diferente según el tipo de elemento que se devuelve.Likewise, if you are using EWS, the GetItem operation returns a different set of properties based on the type of item that is returned.

Si se enlaza a una carpeta con el método Folder. bind o mediante la operación GetFolder , también se devolverán distintos conjuntos de propiedades en función de la carpeta que se solicite.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.

Tabla 1. Formas de respuesta predefinidasTable 1. Predefined response shapes

Forma respuestaResponse shape Equivalente de API administrada de EWSEWS Managed API equivalent DescripciónDescription
Solo identificadorID only
BasePropertySet.IdOnlyBasePropertySet.IdOnly
Devuelve sólo el identificador del elemento o carpeta.Returns only the identifier of the item or folder. La mayoría de las aplicaciones deben usar esta forma de respuesta y especificar las propiedades adicionales necesarias.Most applications should use this response shape and specify any additional properties that are required.
PredeterminadoDefault
N/DN/A
Devuelve un conjunto predefinido de propiedades que son el valor predeterminado para el elemento o carpeta (solo EWS).Returns a predefined set of properties that are the default for the item or folder (EWS only).
Todas las propiedadesAll properties
BasePropertySet.FirstClassPropertiesBasePropertySet.FirstClassProperties
Devuelve las propiedades que usan las aplicaciones cliente con más frecuencia.Returns the properties that client applications use most often. Puede devolver propiedades adicionales mediante una ruta de acceso de propiedad.You can return additional properties by using a property path.

Formas de respuesta predeterminadasDefault response shapes

EWS incluye un conjunto de formas de respuesta predeterminadas para las carpetas y los elementos.EWS includes a set of default response shapes for folders and for items.

En la siguiente tabla se enumeran las propiedades predeterminadas que se devuelven para cada carpeta en las operaciones EWS FindFolder y GetFolder .The following table lists the default properties that are returned for each folder by the FindFolder and GetFolder EWS operations.

Tabla 2. Propiedades de carpeta predeterminadasTable 2. Default folder properties

PropiedadProperty Bandeja de entradaInbox CalendarioCalendar ContactosContacts Elementos eliminadosDeleted items BorradoresDrafts NotasNotes Otras carpetasOther folders SalienteOutbox
Nombre completo (DN)Display name
XX
XX
XX
XX
XX
XX
XX
XX
Id. de carpetaFolder ID
XX
XX
XX
XX
XX
XX
XX
XX
Número de subcarpetasSubfolder count
XX
XX
XX
XX
XX
XX
XX
XX
Recuento totalTotal count
XX
XX
XX
XX
XX
XX
XX
Número de no leídosUnread count
XX
XX
XX
XX
XX

En la siguiente tabla se enumeran las propiedades predeterminadas que se devuelven para cada tipo de elemento mediante las operaciones EWS de FindItem y GetItem .The following table lists the default properties that are returned for each item type by the FindItem and GetItem EWS operations.

Tabla 3. Propiedades de elemento predeterminadasTable 3. Default item properties

PropiedadProperty Elemento de calendarioCalendar item Elemento de contactoContact item Elemento de mensajeMessage item Elemento de tareaTask item
CuerpoBody
X (1)X(1)
CalendarItemTypeCalendarItemType
xx
CompanyNameCompanyName
xx
CompleteNameCompleteName
xx
DateTimeCreatedDateTimeCreated
xx
DateTimeSentDateTimeSent
xx
DueDateDueDate
x (2)x(2)
EmailAddressesEmailAddresses
xx
EndEnd
xx
FileAsFileAs
xx
FromFrom
xx
HasAttachmentsHasAttachments
xx
xx
xx
xx
IndireccionesImAddresses
xx
IsAssociatedIsAssociated
xx
xx
IsDeliveryReceiptRequestedIsDeliveryReceiptRequested
xx
ItemIdItemId
xx
xx
xx
xx
JobTitleJobTitle
xx
LegacyFreeBusyStatusLegacyFreeBusyStatus
xx
UbicaciónLocation
xx
OrganizadorOrganizer
xx
PercentCompletePercentComplete
xx
PhoneNumbersPhoneNumbers
xx
PhysicalAddressesPhysicalAddresses
xx
ResponseObjectsResponseObjects
x (1)x(1)
x (1)x(1)
SensititySensitity
xx
SizeSize
xx
StartDateStartDate
x (2)x(2)
EstadoStatus
xx
SubjectSubject
xx
xx
xx

Notas:Notes:

  1. Se incluye en la respuesta de la operación GetItem .Included in the response from the GetItem operation. No se incluye en la respuesta de la operación FindItem .Not included in the response from the FindItem operation.

  2. Solo se incluye en la respuesta si el campo contiene datos.Only included in the response if the field contains data. No se incluye en la respuesta si el campo está en blanco.Not included in the response if the field is blank.

Todas las propiedades set y Response ShapeAll properties set and response shape

En la siguiente tabla se enumeran las propiedades de primera clase que se devuelven al llamar a los métodos de la API administrada Item. bind y Item. FINDITEMS de la API administrada EWS y la forma de respuesta "todas las propiedades" devueltas por las operaciones EWS de FindItem y 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.

Puede Agregar propiedades adicionales al conjunto de propiedades o incluir propiedades extendidas.You can add additional properties to the property set or include extended properties. Para obtener más información, consulte propiedades y propiedades extendidas de EWS en Exchange.For details, see Properties and extended properties in EWS in Exchange.

Tabla 4. Propiedades de primera claseTable 4. First-class properties

PropiedadProperty
Elemento de calendarioCalendar item
Elemento de contactoContact item
Elemento de mensajeMessage item
Elemento de exposiciónPost item
Elemento de tareaTask 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
CuerpoBody
x (1)x(1)
x (1)x(1)
x (1)x(1)
x (1)x(1)
BusinessHomePageBusinessHomePage
xx
xx
CalendarItemTypeCalendarItemType
xx
CategoríasCategories
xx
xx
xx
xx
CcRecipientsCcRecipients
xx
ChangeCountChangeCount
xx
ChildrenChildren
xx
EmpresasCompanies
xx
CompleteDateCompleteDate
xx
CompleteNameCompleteName
xx
ConferenceTypeConferenceType
xx
ConflictingMeetingCountConflictingMeetingCount
xx
ConflictingMeetingsConflictingMeetings
xx
ContactosContacts
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
DepartamentoDepartment
xx
DirectoryIdDirectoryId
xx
DirectReportsDirectReports
xx
DisplayCcDisplayCc
xx
xx
xx
xx
xx
DisplayNameDisplayName
xx
DisplayToDisplayTo
xx
xx
xx
xx
xx
DueDateDueDate
xx
DuraciónDuration
xx
EffectiveRightsEffectiveRights
xx
xx
xx
xx
xx
EmailAddressesEmailAddresses
xx
EndEnd
xx
EndTimeZoneEndTimeZone
xx
FileAsFileAs
xx
FileAsMappingFileAsMapping
xx
FirstOccurrenceFirstOccurrence
xx
FromFrom
xx
xx
GeneraciónGeneration
xx
GivenNameGivenName
xx
HasAttachmentsHasAttachments
xx
xx
xx
xx
xx
HasPictureHasPicture
xx
IndireccionesImAddresses
xx
ImportanciaImportance
xx
xx
xx
xx
xx
InicialesInitials
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
UbicaciónLocation
xx
ManagerManager
xx
MeetingRequestWasSentMeetingRequestWasSent
xx
MeetingTimeZoneMeetingTimeZone
xx
MeetingWorkspaceUrlMeetingWorkspaceUrl
xx
MiddleNameMiddleName
xx
KilometrajeMileage
xx
xx
ModifiedOccurrancesModifiedOccurrances
xx
MyResponseTypeMyResponseType
xx
NetShowUrlNetShowUrl
xx
NickNameNickName
xx
NotasNotes
xx
OfficeLocationOfficeLocation
xx
OptionalAttendeesOptionalAttendees
xx
OrganizadorOrganizer
xx
OriginalStartOriginalStart
xx
OwnerOwner
xx
ParentFolderIdParentFolderId
xx
xx
xx
xx
xx
PercentCompletePercentComplete
xx
PhoneNumbersPhoneNumbers
xx
PhoneticFirstNamePhoneticFirstName
xx
PhoneticFullNamePhoneticFullName
xx
PhoneticLastNamePhoneticLastName
xx
FotoPhoto
xx
PhysicalAddressesPhysicalAddresses
xx
PostalAddressIndexPostalAddressIndex
xx
PostedTimePostedTime
xx
ProfesiónProfession
xx
ReceivedByReceivedBy
xx
ReceivedRepresentingReceivedRepresenting
xx
ReccurrenceReccurrence
xx
xx
ReferenciasReferences
xx
xx
ReminderDueByReminderDueBy
xx
xx
xx
xx
xx
ReminderIsSetReminderIsSet
xx
xx
xx
xx
xx
ReminderMinutesBeforeStartReminderMinutesBeforeStart
xx
xx
xx
xx
xx
ReplyToReplyTo
xx
RequiredAttendeesRequiredAttendees
xx
RecursosResources
xx
ResponseObjectsResponseObjects
x (1)x(1)
x (1)x(1)
x (1)x(1)
x (1)x(1)
x (1)x(1)
RemitenteSender
xx
xx
ConfidencialidadSensitivity
xx
xx
xx
xx
xx
SizeSize
xx
xx
xx
xx
xx
SpouseNameSpouseName
xx
IniciarStart
xx
StartDateStartDate
xx
StartTimeZoneStartTimeZone
xx
EstadoStatus
xx
StatusDescriptionStatusDescription
xx
SubjectSubject
xx
xx
xx
xx
ApellidoSurname
xx
TimeZoneTimeZone
xx
ToRecipientsToRecipients
xx
TotalWorkTotalWork
xx
WebClientEditFormQueryStringWebClientEditFormQueryString
xx
xx
xx
xx
xx
WebClientReadFormQueryStringWebClientReadFormQueryString
xx
xx
xx
xx
xx

Notas:Notes:

  1. Se incluye al enlazar a un elemento y en la respuesta de la operación GetItem.Included when binding to an item and in the response from the GetItem operation. No se incluye en el resultado del método Item. FindItems o la respuesta de la operación FindItem.Not included in the result of the Item.FindItems method or the response from the FindItem operation.

Vea tambiénSee also