Conjuntos de propiedades y formas de respuestas de EWS en Exchange

Artículo
03/29/2023

Aprenda a administrar las formas de respuesta y los conjuntos de propiedades devueltos por la API administrada de EWS y EWS en Exchange.

El almacén de datos de Exchange proporciona una solución de almacenamiento flexible que le 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 de una llamada a una operación EWS o a un método de API administrada de EWS.

Para facilitar la administración de los datos devueltos por Exchange Online, Exchange Online como parte de Office 365 o versión de Excahange a partir de Exchange 2013, la API administrada de EWS usa conjuntos de propiedades y EWS usa formas de respuesta. Se trata de colecciones predefinidas que proporcionan las propiedades más comunes de un elemento de almacén. El tipo de elemento determina el conjunto de propiedades que se devuelve. Esto significa que al enlazar un elemento mediante el método Item.Bind de la API administrada de Exchange, se obtiene un conjunto diferente de propiedades en función del tipo de elemento al que se enlace. El enlace a un elemento de calendario devolverá un conjunto diferente de propiedades que el enlace a un elemento de contacto. Del mismo modo, si usa EWS, la operación GetItem devuelve un conjunto diferente de propiedades en función del tipo de elemento que se devuelve.

El enlace a una carpeta con el método Folder.Bind o la operación GetFolder también devuelve diferentes conjuntos de propiedades en función de la carpeta que solicite.

Tabla 1. Formas de respuesta predefinidas

Forma de respuesta	Api administrada de EWS equivalente	Descripción
Solo identificador	BasePropertySet.IdOnly	Devuelve solo el identificador del elemento o carpeta. La mayoría de las aplicaciones deben usar esta forma de respuesta y especificar las propiedades adicionales necesarias.
Predeterminada	N/D	Devuelve un conjunto predefinido de propiedades que son el valor predeterminado para el elemento o carpeta (solo EWS).
Todas las propiedades	BasePropertySet.FirstClassProperties	Devuelve las propiedades que las aplicaciones cliente usan con más frecuencia. Puede devolver propiedades adicionales mediante una ruta de acceso de propiedad.

Formas de respuesta predeterminadas

EWS incluye un conjunto de formas de respuesta predeterminadas para carpetas y elementos.

En la tabla siguiente se enumeran las propiedades predeterminadas devueltas para cada carpeta por las operaciones EWS FindFolder y GetFolder .

Tabla 2. Propiedades de carpeta predeterminadas

Propiedad	Bandeja de entrada	Calendario	Contactos	Elementos eliminados	Bosquejos	Notas	Otras carpetas	Bandeja de salida
Nombre para mostrar	X	X	X	X	X	X	X	X
Id. de carpeta	X	X	X	X	X	X	X	X
Recuento de subcarpetas	X	X	X	X	X	X	X	X
Recuento total	X		X	X	X	X	X	X
Recuento no leído	X			X	X		X	X

En la tabla siguiente se enumeran las propiedades predeterminadas devueltas para cada tipo de elemento por las operaciones EWS FindItem y GetItem .

Tabla 3. Propiedades de elementos predeterminadas

Propiedad	Elemento de calendario	Elemento de contacto	Elemento de mensaje	Elemento de tarea
Cuerpo			X(1)
CalendarItemType	x
CompanyName		x
CompleteName		x
DateTimeCreated			x
DateTimeSent			x
DueDate				x(2)
EmailAddresses		x
End	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
Ubicación	x
Organizador	x
PercentComplete				x
PhoneNumbers		x
PhysicalAddresses		x
ResponseObjects	x(1)		x(1)
Sensibilidad			x
Size			x
StartDate				x(2)
Estado				x
Asunto	x		x	x

Notas:

Se incluye en la respuesta de la operación GetItem . No se incluye en la respuesta de la operación FindItem .
Solo se incluye en la respuesta si el campo contiene datos. No se incluye en la respuesta si el campo está en blanco.

Todas las propiedades establecidas y la forma de respuesta

En la tabla siguiente se enumeran las propiedades de primera clase que se devuelven llamando a los métodos de API administrada de EWS Item.Bind y Item.FindItems EWS Managed API, y la forma de respuesta "todas las propiedades" devuelta por las operaciones EWS FindItem y GetItem .

Puede agregar propiedades adicionales al conjunto de propiedades o incluir propiedades extendidas. Para obtener más información, vea Propiedades y propiedades extendidas en EWS en Exchange.

Tabla 4. Propiedades de primera clase

Propiedad	Elemento de calendario	Elemento de contacto	Elemento de mensaje	Publicar elemento	Elemento de tarea
ActualWork					x
AdjacentMeetingCount	x
AdjacentMeetings	x
Alias		x
AllowNewTimeProposal	x
AppointmentReplyTime	x
AppointmentSequenceNumber	x
AppointmentState	x
AssignedTime					x
AssistantName		x
BccRecipients			x
BillingInformation					x
Cuerpo	x(1)	x(1)	x(1)		x(1)
BusinessHomePage		x	x
CalendarItemType	x
Categories	x		x	x	x
CcRecipients			x
ChangeCount					x
Children		x
Companies					x
CompleteDate					x
CompleteName		x
ConferenceType	x
ConflictingMeetingCount	x
ConflictingMeetings	x
Contactos					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
Departamento		x
DirectoryId		x
DirectReports		x
DisplayCc	x	x	x	x	x
DisplayName		x
DisplayTo	x	x	x	x	x
DueDate					x
Duración	x
EffectiveRights	x	x	x	x	x
EmailAddresses		x
End	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
Importancia	x	x	x	x	x
Initials		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
Ubicación	x
Administrador		x
MeetingRequestWasSent	x
MeetingTimeZone	x
MeetingWorkspaceUrl	x
MiddleName		x
Mileage		x			x
ModifiedOccurrances	x
MyResponseType	x
NetShowUrl	x
NickName		x
Notas		x
OfficeLocation		x
OptionalAttendees	x
Organizador	x
OriginalStart	x
Owner					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
Reccurrence	x				x
Referencias			x	x
ReminderDueBy	x	x	x	x	x
ReminderIsSet	x	x	x	x	x
ReminderMinutesBeforeStart	x	x	x	x	x
ReplyTo			x
RequiredAttendees	x
Recursos	x
ResponseObjects	x(1)	x(1)	x(1)	x(1)	x(1)
Remitente			x	x
Sensibilidad	x	x	x	x	x
Size	x	x	x	x	x
SpouseName		x
Inicio	x
StartDate					x
StartTimeZone	x
Estado					x
StatusDescription					x
Asunto	x	x	x		x
Surname		x
TimeZone	x
ToRecipients			x
TotalWork					x
WebClientEditFormQueryString	x	x	x	x	x
WebClientReadFormQueryString	x	x	x	x	x

Notas:

Se incluye al enlazar a un elemento y en la respuesta de la operación GetItem. No se incluye en el resultado del método Item.FindItems ni en la respuesta de la operación FindItem.

Conjuntos de propiedades y formas de respuestas de EWS en Exchange

Formas de respuesta predeterminadas

Todas las propiedades establecidas y la forma de respuesta

Vea también

Comentarios

Comentarios

Recursos adicionales