Conjuntos de propriedades e formas de resposta no EWS no Exchange

Aprenda a gerenciar as formas de resposta e os conjuntos de propriedades que são retornados pela API gerenciada pelo EWS e pelo EWS no Exchange.

O repositório de dados do Exchange fornece uma solução de armazenamento flexível que permite armazenar itens diferentes, como contatos e entradas de calendário, na mesma pasta; no entanto, pode dificultar o gerenciamento dos dados retornados de uma chamada para uma operação EWS ou um método de API gerenciada pelo EWS.

Para facilitar o gerenciamento dos dados retornados por Exchange Online, Exchange Online como parte de Office 365 ou versão do Excahange a partir do Exchange 2013, a API Gerenciada do EWS usa conjuntos de propriedades e o EWS usa formas de resposta. São coleções predefinidas que fornecem as propriedades mais comuns de um item de repositório. O conjunto de propriedades retornadas é determinado pelo tipo de item. Isso significa que, ao associar um item usando o método Item.Bind da API Gerenciada do Exchange, você obtém um conjunto diferente de propriedades, dependendo do tipo de item ao qual você associa. A associação a um item de calendário retornará um conjunto diferente de propriedades do que associar a um item de contato. Da mesma forma, se você estiver usando o EWS, a operação GetItem retornará um conjunto diferente de propriedades com base no tipo de item retornado.

Associar a uma pasta com o método Folder.Bind ou usar a operação GetFolder também retorna diferentes conjuntos de propriedades com base na pasta solicitada.

Tabela 1. Formas de resposta predefinidas

Forma de resposta	Equivalente à API Gerenciada do EWS	Descrição
Somente ID	BasePropertySet.IdOnly	Retorna apenas o identificador do item ou pasta. A maioria dos aplicativos deve usar essa forma de resposta e especificar quaisquer propriedades adicionais necessárias.
Padrão	N/D	Retorna um conjunto predefinido de propriedades que são o padrão para o item ou pasta (somente EWS).
Todas as propriedades	BasePropertySet.FirstClassProperties	Retorna as propriedades que os aplicativos cliente usam com mais frequência. Você pode retornar propriedades adicionais usando um caminho de propriedade.

Formas de resposta padrão

O EWS inclui um conjunto de formas de resposta padrão para pastas e para itens.

A tabela a seguir lista as propriedades padrão retornadas para cada pasta pelas operações FindFolder e GetFolder EWS.

Tabela 2. Propriedades de pasta padrão

Propriedade	Caixa de Entrada	Calendar	Contatos	Itens excluídos	Rascunhos	Anotações	Outras pastas	Caixa de saída
Nome de exibição	X	X	X	X	X	X	X	X
ID da pasta	X	X	X	X	X	X	X	X
Contagem de subpastas	X	X	X	X	X	X	X	X
Contagem total	X		X	X	X	X	X	X
Contagem não lida	X			X	X		X	X

A tabela a seguir lista as propriedades padrão retornadas para cada tipo de item pelas operações FindItem e GetItem EWS.

Tabela 3. Propriedades de item padrão

Propriedade	Item calendário	Item de Contato	Item de mensagem	Item de Tarefa
Corpo			X(1)
CalendarItemType	x
CompanyName		x
CompleteName		x
DateTimeCreated			x
DateTimeSent			x
Data de Conclusão				x(2)
EndereçosEmail		x
Final	x
FileAs		x
De			x
HasAttachments	x	x	x	x
ImAddresses		x
IsAssociated	x		x
IsDeliveryReceiptRequested			x
ItemId	x	x	x	x
JobTitle		x
LegacyFreeBusyStatus	x
Localização	x
Organizador	x
PercentComplete				x
PhoneNumbers		x
PhysicalAddresses		x
ResponseObjects	x(1)		x(1)
Sensibilização			x
Tamanho			x
StartDate				x(2)
Status				x
Assunto	x		x	x

Observações:

1. Incluído na resposta da operação GetItem . Não incluído na resposta da operação FindItem .

2. Incluído somente na resposta se o campo contiver dados. Não está incluído na resposta se o campo estiver em branco.

Todas as propriedades definidas e a forma de resposta

A tabela a seguir lista as propriedades de primeira classe retornadas chamando os métodos de API Gerenciada do EWS Item.Bind e Item.FindItems EWS Managed API e a forma de resposta "todas as propriedades" retornadas pelas operações FindItem e GetItem EWS.

Você pode adicionar propriedades adicionais ao conjunto de propriedades ou incluir propriedades estendidas. Para obter detalhes, consulte Propriedades e propriedades estendidas no EWS no Exchange.

Tabela 4. Propriedades de primeira classe

Propriedade	Item calendário	Item de Contato	Item de mensagem	Postar item	Item de Tarefa
ActualWork					x
AdjacentMeetingCount	x
AdjacentMeetings	x
Alias		x
AllowNewTimeProposal	x
AppointmentReplyTime	x
AppointmentSequenceNumber	x
AppointmentState	x
AssignedTime					x
AssistantName		x
BccRecipients			x
BillingInformation					x
Corpo	x(1)	x(1)	x(1)		x(1)
BusinessHomePage		x	x
CalendarItemType	x
Categorias	x		x	x	x
CcRecipients			x
ChangeCount					x
Crianças		x
Empresas					x
CompleteDate					x
CompleteName		x
ConferenceType	x
ConflictingMeetingCount	x
ConflictingMeetings	x
Contatos					x
ContactSource		x
ConversationId	x	x	x	x	x
ConversationIndex			x	x
ConversationTopic			x	x
Cultura	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
Data de Conclusão					x
Duração	x
EffectiveRights	x	x	x	x	x
EndereçosEmail		x
Final	x
EndTimeZone	x
FileAs		x
FileAsMapping		x
FirstOccurrence	x
De			x	x
Generation		x
GivenName		x
HasAttachments	x	x	x	x	x
HasPicture		x
ImAddresses		x
Importance	x	x	x	x	x
Iniciais		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
Localização	x
Manager		x
MeetingRequestWasSent	x
MeetingTimeZone	x
MeetingWorkspaceUrl	x
MiddleName		x
Quilometragem		x			x
ModifiedOccurrances	x
MyResponseType	x
NetShowUrl	x
NickName		x
Observações		x
OfficeLocation		x
OptionalAttendees	x
Organizador	x
OriginalStart	x
Proprietário					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
Referências			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)
Remetente			x	x
Confidencialidade	x	x	x	x	x
Tamanho	x	x	x	x	x
SpouseName		x
Iniciar	x
StartDate					x
StartTimeZone	x
Status					x
StatusDescription					x
Assunto	x	x	x		x
Surname		x
TimeZone	x
ToRecipients			x
TotalWork					x
WebClientEditFormQueryString	x	x	x	x	x
WebClientReadFormQueryString	x	x	x	x	x

Observações:

1. Incluído ao associar a um item e na resposta da operação GetItem. Não incluído no resultado do método Item.FindItems ou na resposta da operação FindItem.

Confira também

• Desenvolver clientes do serviço web para o Exchange

• Operação FindItem

• Operação GetItem

• Operação FindFolder

• Operação GetFolder