Обновление сведений о конфигурации с помощью службы автообнаружения
Узнайте, как и когда обновлять сведения о конфигурации подключения Exchange с помощью автообнаружения.
Когда приложение EWS запускается в первый раз, функция автообнаружения предоставляет отличный способ сбора сведений, необходимых для подключения к почтовому ящику Exchange пользователя. Но автообнаружения используется не только в первый раз. Регулярное использование автообнаружения помогает поддерживать связь с приложением, позволяя ему реагировать на изменения в развертывании Exchange.
Конечная точка автообнаружения кэша и параметры EWS
Хотя рекомендуется регулярно использовать автообнаружения, следует учитывать, как регулярно его использовать. В идеале можно сбалансировать быстрое реагирование на изменения в среде и создание слишком большого количества ненужного сетевого трафика. Когда приложение впервые получает успешный ответ автообнаружения, следует сохранить следующие сведения, чтобы не повторять процесс автообнаружения при каждой отправке запроса EWS.
Таблица 1. Сведения для кэширования запросов автообнаружения
| Настройка кэша | Действителен для... | Сведения |
|---|---|---|
| Конечная точка автообнаружения |
Пока это работает |
При сохранении конечной точки автообнаружения, которая вернула успешный ответ, вам не придется повторять процесс создания списка конечных точек автообнаружения и пробовать их, пока не будет получен успешный ответ. ПРИМЕЧАНИЕ. Управляемый API EWS не поддерживает кэширование конечной точки автообнаружения. |
| URL-адрес EWS и любые другие параметры, полученные из ответа автообнаружения |
Одна неделя |
Сохранив URL-адрес EWS и другие связанные параметры, вам не нужно отправлять новый запрос автообнаружения для каждого запроса EWS или при перезапуске приложения. Однако даже если URL-адрес EWS подходит для пользователя, может быть доступен сервер, который является более оптимальным. Например, почтовый ящик пользователя мог быть перемещен на новый сервер почтовых ящиков, что привело к новой предпочтительной конечной точке EWS. Рекомендуется обновить параметры пользователя, отправив новый запрос автообнаружения через неделю с момента последнего запроса автообнаружения. Это время можно скорректировать в соответствии с требованиями приложения. |
Обновление сведений о конфигурации в кэше
Теперь, когда информация кэширована, давайте рассмотрим, как сохранить этот кэш свежим. Рекомендуется обновлять кэшированные сведения, когда:
Срок действия информации истекает.
Возникает ошибка, связанная с подключением , и кэшированные сведения были обновлены в последний раз более часа назад.
Чтобы обновить кэшированные сведения, отправьте запрос автообнаружения в кэшированную конечную точку автообнаружения и выполните следующие действия.
Если запрос выполнен успешно, сравните конечную точку EWS в ответе с кэшированной конечной точкой EWS и выполните следующие действия.
Если они отличаются, используйте новую конечную точку EWS. Если выполняется обновление для восстановления после ошибки, повторите неудачный запрос с новой конечной точкой.
Если они совпадают, продолжайте использовать исходную конечную точку EWS. Если выполняется обновление для восстановления после ошибки, обработайте ошибку соответствующим образом.
Если запрос завершается ошибкой, запустите процесс автообнаружения с самого начала. После успешного получения ответа замените кэшированную конечную точку автообнаружения успешной конечной точкой автообнаружения и продолжайте использовать новую конечную точку EWS. Если вы не получили успешный ответ, продолжайте использовать исходную конечную точку автообнаружения и конечную точку EWS. Если выполняется обновление для восстановления после ошибки, обработайте ошибку соответствующим образом.
На следующем рисунке представлено визуальное представление этого процесса.
Рис. 1. Процесс обновления сведений о конфигурации с помощью автообнаружения
Ошибки, связанные с подключением
Обновление кэшированных сведений о конфигурации может помочь в устранении некоторых ошибок, но не всех.
Табл. 2. Устранение ошибок путем обновления кэша
| Ошибка | Реализация управляемого API EWS | Примечания. |
|---|---|---|
| Ошибки DNS или сети Пример. Не удалось найти имя узла. |
ServiceRemoteException |
Любая ошибка, указывающая на то, что сервер не найден или недоступен, может быть устранена путем попытки автообнаружения. Кэшированная конечная точка EWS может оказаться недопустимой, а автообнаружитель может указать вам новый сервер. |
| Ошибки состояния HTTP Пример. Служба 503 недоступна |
ServiceRemoteException |
Ошибки состояния HTTP могут возникать по разным причинам. Однако рекомендуется попробовать автообнаружать, чтобы узнать, доступна ли новая конечная точка EWS для пользователя. |
| Коды ошибок EWS Пример: ErrorConnectionFailed |
ResponseCodeType |
Большинство кодов ошибок EWS не требуют обновления сведений о конфигурации. Однако, в частности, указано, что сведения о конфигурации необходимо обновить: - ErrorConnectionFailed - ErrorMailboxMoveInProgress |