Параметры сохраняемого приложения в веб-службах Exchange

  • Статья

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

Самый простой способ синхронизации пользовательских клиентских конфигураций для почтового ящика или папок и элементов в почтовом ящике — хранение параметров приложения на сервере Exchange Server. Вы можете убедиться, что эти параметры сохраняются для почтового ящика, используя одно из следующих средств:

  • Объекты конфигурации пользователя

  • Расширенные свойства

  • Пользовательские элементы

Каковы варианты создания параметров постоянных приложений?

Объекты пользовательской конфигурации — это лучший вариант для хранения параметров конфигурации для клиентских приложений EWS. Можно также использовать свойства расширения или пользовательские элементы или сочетание всех трех элементов. Выберите нужный вариант в зависимости от области параметров и того, должны ли они быть доступны другим приложениям.

Таблица 1. Рекомендуемые параметры для создания параметров постоянных приложений на основе области

Настройка области Применение Доступ к:
Элемент
 Расширенное свойство существующего элемента.
Любое приложение EWS. Доступ к расширенному свойству могут получить только клиенты EWS, которые знают идентификатор свойства.
Folder
 Объект конфигурации пользователя в целевой папке. Это хороший способ сохранения параметров представления для папки.
Любое приложение EWS.
Mailbox
 Объект конфигурации пользователя в папке msgrootfolder по умолчанию.
Любое приложение EWS.

Объекты конфигурации пользователя

Объекты конфигурации пользователя — это специальные элементы, связанные с папками в почтовом ящике. Объекты конфигурации пользователя, также называемые элементами, связанными с папками, обычно являются лучшим вариантом для сохранения параметров приложения, особенно если сведения о конфигурации связаны с папкой или почтовым ящиком. Как правило, они не отображаются для конечных пользователей. Так как они изначально могут хранить потоки данных и словари данных, они идеально подходят для хранения сведений о конфигурации. Лучший способ использовать объекты конфигурации пользователя — сохранить набор конфигураций в XML-документе, а затем сохранить эти сведения в одном из свойств потока конфигурации пользователя.

Доступ к объектам конфигурации пользователя отличается от других типов элементов, хранящихся в почтовом ящике. Для поиска всех элементов можно использовать метод Folder.FindItems EWS Managed API или операцию FindItem EWS, но для поиска объектов конфигурации пользователей необходимо использовать параметр Обход связанного поиска. Обход связанного поиска указывает, что результаты поиска должны содержать только объекты конфигурации пользователя. EWS включает набор операций, относящихся к объектам конфигурации пользователя.

Таблица 1. Операции EWS и методы управляемого API EWS для работы с объектами конфигурации пользователей

Задача Используйте эту операцию EWS Используйте этот метод управляемого API EWS
Создание объекта конфигурации пользователя
 Операция CreateUserConfiguration
UserConfiguration.Save
Получение объекта конфигурации пользователя
 Операция GetUserConfiguration
UserConfiguration.Bind
UserConfiguration.Load
Обновление объекта конфигурации пользователя
 Операция UpdateUserConfiguration
UserConfiguration.Update
Удаление объекта конфигурации пользователя
 Операция DeleteUserConfiguration
UserConfiguration.Delete

Примечание.

Объекты пользовательской конфигурации, созданные с помощью EWS, имеют префикс ItemClass , который начинается с "IPM. Конфигурация.". ItemClass объекта конфигурации пользователя — это префикс объекта конфигурации пользователя и имя объекта конфигурации пользователя. Для поиска определенных объектов пользовательской конфигурации можно использовать свойство Item.ItemClass EWS Managed API или элемент ItemClass EWS.

Расширенные свойства

Используйте расширенные свойства , если вы хотите хранить сведения о конфигурации элементов. EWS, в отличие от MAPI, не возвращает контейнер свойств для элементов. Это означает, что клиент EWS должен знать идентификатор расширенного свойства, чтобы найти расширенное свойство и получить доступ к этому расширенному свойству. Если вам нужно хранить сведения о конфигурации для элементов, отличных от объектов конфигурации пользователя, вы можете использовать расширенные свойства для создания пользовательских свойств. Расширенные свойства позволяют получать доступ к свойствам, которые не являются частью стандартного набора свойств элемента, и хранить их.

Важно!

Схема базы данных Exchange имеет ограниченное число свойств. Максимальное число идентификаторов свойств для базы данных Exchange — 32 767. Если вы используете расширенные свойства для хранения множества параметров, рекомендуется использовать одно расширенное свойство для хранения этих параметров, чтобы не превысить этот максимум.

Для задания расширенных свойств объектов конфигурации пользователя можно использовать метод Управляемого API Item.Update EWS или операцию UpdateItem EWS.

Пользовательские элементы

Пользовательские элементы также можно использовать для хранения информации. Существующие свойства элемента могут быть переназначаемы для хранения сведений о конфигурации. Кроме того, можно использовать расширенные свойства, чтобы определить собственные свойства для приложения. Использование пользовательских элементов для хранения конфигурации обеспечивает следующие преимущества:

  • Они работают для всех версий Exchange, поддерживающих EWS.

  • Если вы не используете расширенные свойства для элемента, бюджет свойств Exchange не взимается.

Где следует хранить параметры приложения?

Папки почтовых ящиков и элементы в них находятся в корневой папке сообщений. Эта папка определяется значением WellKnownFolderName.msgfolderroot в управляемом API EWS. С точки зрения MAPI это эквивалент поддереву IPM почтового ящика. Объекты пользовательской конфигурации часто используются для создания параметров на основе пользовательского интерфейса, чтобы приложение давалось отрисовки параметров представления на основе папки, к которую обращается пользователь. Параметры представления на основе папок обычно задаются в объекте конфигурации пользователя, связанном с папкой. Но иногда может потребоваться сделать параметры глобальными для приложения. В этом случае параметры можно сохранить в корневой папке сообщений.

Большинство пользователей не знают о и обычно не обращаются к корневой папке почтового ящика. Эта папка идентифицируется значением WellKnownFolderName.root в управляемом API EWS. С точки зрения MAPI это эквивалент поддереву почтового ящика, отличного от IPM. Сведения, к которым пользователи не обращаются напрямую, хранятся в корневой папке почтового ящика. Возможно, вам потребуется сохранить параметр приложения в этой папке, так как клиентские приложения обычно не получают к нему доступа.

Различия версий

Объекты конфигурации пользователей доступны в Exchange Online, Exchange Online в составе Office 365 и в версиях Exchange, начиная с Exchange 2010.

См. также