Наборы свойств и ответ с фигурами в веб-служб Exchange в Exchange

  • Статья

Узнайте, как управлять фигурами ответов и наборами свойств, возвращаемыми управляемым API EWS и EWS в Exchange.

Хранилище данных Exchange предоставляет гибкое решение для хранения, которое позволяет хранить различные элементы, например контакты и записи календаря, в одной папке. однако это может затруднить управление данными, возвращаемыми при вызове операции EWS или метода управляемого API EWS.

Чтобы упростить управление данными, возвращаемыми Exchange Online, Exchange Online в составе Office 365 или версии Excahange, начиная с Exchange 2013, управляемый API EWS использует наборы свойств, а EWS — фигуры ответов. Это предопределенные коллекции, которые предоставляют наиболее распространенные свойства элемента хранилища. Возвращаемый набор свойств определяется типом элемента. Это означает, что при привязке элемента с помощью метода Item.Bind управляемого API Exchange вы получаете другой набор свойств в зависимости от типа элемента, к которому выполняется привязка. Привязка к элементу календаря вернет набор свойств, отличный от привязки к элементу контакта. Аналогичным образом, если вы используете EWS, операция GetItem возвращает другой набор свойств в зависимости от типа возвращаемого элемента.

Привязка к папке с помощью метода Folder.Bind или с помощью операции GetFolder также возвращает различные наборы свойств на основе запрашиваемой папки.

Таблица 1. Предопределенные фигуры ответа

Фигура ответа Эквивалент управляемого API EWS Описание
Только идентификатор
 BasePropertySet.IdOnly
Возвращает только идентификатор элемента или папки. Большинство приложений должны использовать эту фигуру ответа и указывать все необходимые дополнительные свойства.
По умолчанию
 Н/Д
 Возвращает предопределенный набор свойств, используемых по умолчанию для элемента или папки (только EWS).
Все свойства
 BasePropertySet.FirstClassProperties
Возвращает свойства, которые клиентские приложения используют чаще всего. Вы можете вернуть дополнительные свойства, используя путь к свойству.

Фигуры ответов по умолчанию

EWS включает набор фигур ответа по умолчанию для папок и элементов.

В следующей таблице перечислены свойства по умолчанию, возвращаемые для каждой папки операциями FindFolder и GetFolder EWS.

Табл. 2. Свойства папки по умолчанию

Свойство Входящие Календарь Контакты Удаленные элементы Проекты Примечания. Другие папки Исходящие
Отображаемое имя
 X
 X
 X
 X
 X
 X
 X
 X
Идентификатор папки
 X
 X
 X
 X
 X
 X
 X
 X
Количество вложенных папок
 X
 X
 X
 X
 X
 X
 X
 X
Общее число
 X
 X
 X
 X
 X
 X
 X
Число непрочитанных
 X
 X
 X
 X
 X

В следующей таблице перечислены свойства по умолчанию, возвращаемые для каждого типа элемента операциями FindItem и GetItem EWS.

Табл. 3. Свойства элемента по умолчанию

Свойство Элемент календаря Элемент "Контакт" Элемент сообщения Элемент "Задача"
Текст
 X(1)
CalendarItemType
 x
CompanyName
 x
CompleteName
 x
DateTimeCreated
 x
DateTimeSent
 x
Дата выполнения
 x(2)
EmailAddresses
 x
Конец
 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
Расположение
 x
Организатор
 x
PercentComplete
 x
PhoneNumbers
 x
PhysicalAddresses
 x
ResponseObjects
 x(1)
 x(1)
Чувствительность
 x
Размер
 x
StartDate
 x(2)
Состояние
 x
Subject
 x
 x
 x

Примечания.

  1. Включается в ответ от операции GetItem . Не включен в ответ от операции FindItem .

  2. Включается в ответ, только если поле содержит данные. Не включено в ответ, если поле пустое.

Набор всех свойств и форма ответа

В следующей таблице перечислены свойства первого класса, возвращаемые путем вызова методов Управляемого API EWS Item.Bind и Item.FindItems управляемого API EWS, а также фигура ответа "все свойства", возвращаемая операциями EWS FindItem и GetItem .

Можно добавить дополнительные свойства в набор свойств или включить расширенные свойства. Дополнительные сведения см. в разделе Свойства и расширенные свойства в EWS в Exchange.

Табл. 4. Свойства первого класса

Property
 Элемент календаря
 Элемент "Контакт"
 Элемент сообщения
 Публикация элемента
 Элемент "Задача"
ActualWork
 x
AdjacentMeetingCount
 x
AdjacentMeetings
 x
Alias
 x
AllowNewTimeProposal
 x
AppointmentReplyTime
 x
AppointmentSequenceNumber
 x
AppointmentState
 x
AssignedTime
 x
AssistantName
 x
BccRecipients
 x
BillingInformation
 x
Текст
 x(1)
 x(1)
 x(1)
 x(1)
BusinessHomePage
 x
 x
CalendarItemType
 x
Категории
 x
 x
 x
 x
CcRecipients
 x
ChangeCount
 x
Дети
 x
Компании
 x
CompleteDate
 x
CompleteName
 x
ConferenceType
 x
ConflictingMeetingCount
 x
ConflictingMeetings
 x
Контакты
 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
Отдел
 x
DirectoryId
 x
DirectReports
 x
DisplayCc
 x
 x
 x
 x
 x
DisplayName
 x
DisplayTo
 x
 x
 x
 x
 x
Дата выполнения
 x
Duration (Длительность)
 x
EffectiveRights
 x
 x
 x
 x
 x
EmailAddresses
 x
Конец
 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
Важность
 x
 x
 x
 x
 x
Инициалы
 x
InReplyTo
 x
 x
 x
 x
 x
InternetMessageId
 x
 x
InternetMessageHeaders
 x
 x
 x
 x
 x
IsAllDayEvent
 x
IsAssociated
 x
 x
 x
 x
 x
Отменено
 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
Расположение
 x
Manager
 x
MeetingRequestWasSent
 x
MeetingTimeZone
 x
MeetingWorkspaceUrl
 x
MiddleName
 x
Расстояние
 x
 x
ModifiedOccurrances
 x
MyResponseType
 x
NetShowUrl
 x
NickName
 x
Примечания
 x
OfficeLocation
 x
OptionalAttendees
 x
Организатор
 x
OriginalStart
 x
Владелец
 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
Профессия
 x
ReceivedBy
 x
ReceivedRepresenting
 x
Повторная
 x
 x
Ссылки
 x
 x
ReminderDueBy
 x
 x
 x
 x
 x
ReminderIsSet
 x
 x
 x
 x
 x
ReminderMinutesBeforeStart
 x
 x
 x
 x
 x
ReplyTo
 x
RequiredAttendees
 x
Ресурсы
 x
ResponseObjects
 x(1)
 x(1)
 x(1)
 x(1)
 x(1)
Sender
 x
 x
Конфиденциальность
 x
 x
 x
 x
 x
Размер
 x
 x
 x
 x
 x
SpouseName
 x
Запуск
 x
StartDate
 x
StartTimeZone
 x
Состояние
 x
StatusDescription
 x
Subject
 x
 x
 x
 x
Surname
 x
TimeZone
 x
ToRecipients
 x
TotalWork
 x
WebClientEditFormQueryString
 x
 x
 x
 x
 x
WebClientReadFormQueryString
 x
 x
 x
 x
 x

Примечания.

  1. Включается при привязке к элементу и в ответе от операции GetItem. Не включено в результат метода Item.FindItems или в ответ операции FindItem.

См. также