Atualizar as informações de configuração usando a Descoberta AutomáticaRefresh configuration information by using Autodiscover

Saiba como e quando atualizar as informações de configuração para sua conexão do Exchange usando a descoberta automática.Learn how and when to refresh configuration information for your Exchange connection by using Autodiscover.

Quando o aplicativo EWS é executado pela primeira vez, a descoberta automática oferece uma ótima maneira de coletar as informações necessárias para se conectar à caixa de correio do Exchange do usuário.When your EWS application runs for the first time, Autodiscover provides a great way for you to collect the information you need in order to connect to your user's Exchange mailbox. Mas a descoberta automática não é apenas para uso pela primeira vez.But Autodiscover isn't just for first time use. O uso da descoberta automática em uma base regular pode ajudar a manter seu aplicativo conectado, permitindo que ele responda às alterações na implantação do Exchange.Using Autodiscover on a regular basis can help keep your application connected by enabling it to respond to changes in the Exchange deployment.

Configurações de ponto de extremidade de descoberta automática de cache e EWSCache Autodiscover endpoint and EWS settings

Embora seja recomendável que você use a descoberta automática regularmente, o quão regularmente você usa isso requer alguma consideração.While we recommend that you use Autodiscover regularly, how regularly you use it requires some consideration. O ideal é que você Equilibre a resposta rapidamente às alterações no ambiente em relação à geração de tráfego de rede muito desnecessário.Ideally you can balance responding quickly to changes in the environment against generating too much unnecessary network traffic. Quando o aplicativo recebe uma resposta de descoberta automática bem-sucedida pela primeira vez, você deve salvar as seguintes informações para não precisar repetir o processo de descoberta automática sempre que enviar uma solicitação do EWS.When your application gets a successful Autodiscover response for the first time, you should save the following information so that you do not have to repeat the Autodiscover process every time you send an EWS request.

Tabela 1. Informações para armazenar em cache as solicitações de descoberta automáticaTable 1. Information to cache for Autodiscover requests

Configuração para cacheSetting to cache Válido para...Valid for… DetalhesDetails
Ponto de extremidade de descoberta automáticaAutodiscover endpoint
Contanto que funcioneAs long as it works
Quando você salva o ponto de extremidade de descoberta automática que retornou uma resposta bem-sucedida, não é necessário repetir o processo de geração de uma lista de pontos de extremidade de descoberta automática e experimentá-los até obter uma resposta bem-sucedida.When you save the Autodiscover endpoint that returned a successful response, you do not have to repeat the process of generating a list of Autodiscover endpoints and trying them until you get a successful response.

Observação: a API gerenciada do EWS não dá suporte ao armazenamento em cache do ponto de extremidade de descoberta automática.NOTE: The EWS Managed API does not support caching the Autodiscover endpoint.
URL do EWS e quaisquer outras configurações recuperadas da resposta de descoberta automáticaEWS URL and any other settings retrieved from the Autodiscover response
Uma semanaOne week
Ao salvar a URL do EWS e outras configurações relacionadas, não é necessário Enviar uma nova solicitação de descoberta automática para cada solicitação do EWS ou se o aplicativo for reiniciado.By saving the EWS URL and other related settings, you do not have to send a new Autodiscover request for each EWS request or if your application restarts. No entanto, mesmo que uma URL do EWS funcione para o seu usuário, pode haver um servidor disponível que seja mais adequado.However, even if an EWS URL works for your user, a server might be available that is more optimal.

Por exemplo, a caixa de correio do usuário pode ter sido movida para um novo servidor de caixa de correio, resultando em um novo ponto de extremidade do EWS preferencial.For example, the user's mailbox might have moved to a new mailbox server, resulting in a new preferred EWS endpoint. Recomendamos que você atualize suas configurações de usuário enviando uma nova solicitação de descoberta automática depois que uma semana tiver passado desde a última solicitação de descoberta automática.We recommend that you refresh your user settings by sending a new Autodiscover request after one week has passed since your last Autodiscover request. Esse tempo pode ser ajustado para atender aos requisitos do seu aplicativo.This time can be adjusted to meet the requirements of your application.

Atualizar informações de configuração armazenadas em cacheRefresh cached configuration information

Agora que você tem as informações armazenadas em cache, vamos examinar como você pode manter o cache atualizado.Now that you have the information cached, let's examine how you can keep that cache fresh. Recomendamos que você atualize suas informações armazenadas em cache quando:We recommend that you refresh your cached information when:

  • O período de validade das informações expira.The information's validity period expires.

  • Ocorre um erro relacionado à conexão , e suas informações em cache foram atualizadas pela última vez em uma hora atrás.A Connection-related error occurs AND your cached information was last refreshed over an hour ago.

Para atualizar suas informações armazenadas em cache, envie uma solicitação de descoberta automática para um ponto de extremidade de descoberta automática em cache e faça o seguinte:To refresh your cached information, send an Autodiscover request to a cached Autodiscover endpoint, and do the following:

  • Se a solicitação for bem-sucedida, compare o ponto de extremidade do EWS na resposta com o ponto de extremidade do EWS armazenado em cache e faça o seguinte:If the request succeeds, compare the EWS endpoint in the response with the cached EWS endpoint, and do the following:

    • Se forem diferentes, use o ponto de extremidade novo EWS.If they are different, use the new EWS endpoint. Se você estiver atualizando para se recuperar de um erro, repita a solicitação com falha com o novo ponto de extremidade.If you're refreshing to recover from an error, retry the failed request with the new endpoint.

    • Se forem iguais, continue a usar o ponto de extremidade do EWS original.If they are the same, continue to use the original EWS endpoint. Se você estiver atualizando para se recuperar de um erro, manipule o erro conforme apropriado.If you're refreshing to recover from an error, handle the error as appropriate.

  • Se a solicitação falhar, inicie o processo de descoberta automática desde o início.If the request fails, start the Autodiscover process from the beginning. Após obter uma resposta bem-sucedida, substitua o ponto de extremidade de descoberta automática em cache pelo ponto de extremidade de descoberta automática com êxito e continue a usar o novo ponto de extremidade do EWS.After you get a successful response, replace the cached Autodiscover endpoint with the Autodiscover endpoint that succeeded and continue to use the new EWS endpoint. Se você não receber uma resposta bem-sucedida, continue a usar o ponto de extremidade de descoberta automática e o ponto de extremidade do EWS originais.If you do not get a successful response, continue to use the original Autodiscover endpoint and EWS endpoint. Se você estiver atualizando para se recuperar de um erro, manipule o erro conforme apropriado.If you're refreshing to recover from an error, handle the error as appropriate.

A figura a seguir fornece uma representação visual desse processo.The following figure provides a visual representation of this process.

Figura 1. Processo de atualização de informações de configuração usando a descoberta automáticaFigure 1. Process for refreshing configuration information by using Autodiscover

Diagrama esquemático mostrando como a Descoberta Automática atualiza informações de configuração.

A atualização de suas informações de configuração em cache pode ajudar com alguns erros, mas não todos.Refreshing your cached configuration information can help with some errors, but not all.

Tabela 2. Erros resolvidos pela atualização do cacheTable 2. Errors addressed by refreshing your cache

ErrorError Implementação da API gerenciada do EWSEWS Managed API implementation AnotaçõesNotes
Erros de DNS ou de falha de redeDNS or network failure errors

Exemplo: não foi possível encontrar o nome do host.Example: Host name could not be found.
OnremoteexceptionServiceRemoteException
Qualquer erro que indique que o servidor não pôde ser encontrado ou não pôde ser alcançado pode ser resolvido tentando a descoberta automática.Any error that indicates that the server could not be found or could not be reached might be resolved by trying Autodiscover.

O ponto de extremidade do EWS em cache pode não ser mais válido e a descoberta automática pode ser capaz de apontar para o novo servidor.Your cached EWS endpoint might no longer be valid, and Autodiscover might be able to point you to the new server.
Erros de status HTTPHTTP status errors

Exemplo: serviço 503 indisponívelExample: 503 Service Unavailable
OnremoteexceptionServiceRemoteException
Os erros de status HTTP podem ocorrer por vários motivos diferentes.HTTP status errors can happen for many different reasons.

No entanto, é uma boa ideia tentar a descoberta automática para ver se um novo ponto de extremidade do EWS está disponível para o usuário.However, it's a good idea to try Autodiscover to see if a new EWS endpoint is available for the user.
Códigos de erro do EWSEWS error codes

Exemplo: ErrorConnectionFailedExample: ErrorConnectionFailed
ResponseCodeTypeResponseCodeType
A maioria dos códigos de erro do EWS não garante a atualização de suas informações de configuração.Most EWS error codes don't warrant refreshing your configuration information.

No entanto, o seguinte indica especificamente que as informações de configuração precisam ser atualizadas:However, the following specifically indicate that the configuration information needs to be updated:
- ErrorConnectionFailed- ErrorConnectionFailed
- ErrorMailboxMoveInProgress- ErrorMailboxMoveInProgress

Confira tambémSee also