Atualizar informações de configuração usando a Descoberta Automática

Saiba como e quando atualizar as informações de configuração para sua conexão do Exchange usando Autodiscover.

Quando seu aplicativo EWS é executado pela primeira vez, o Autodiscover fornece uma ótima maneira de coletar as informações necessárias para se conectar à caixa de correio do Exchange do usuário. Mas Autodiscover não é apenas para uso pela primeira vez. Usar o Autodiscover regularmente pode ajudar a manter seu aplicativo conectado, permitindo que ele responda às alterações na implantação do Exchange.

Cache Configurações de ponto de extremidade e EWS de descoberta automática

Embora seja recomendável usar o Autodiscover regularmente, o quão regularmente você o usa requer alguma consideração. Idealmente, você pode equilibrar a resposta rapidamente às alterações no ambiente em relação à geração de tráfego de rede desnecessário demais. Quando seu aplicativo obtém uma resposta autodiscóver bem-sucedida pela primeira vez, você deve salvar as informações a seguir para que você não precise repetir o processo de Descoberta Automática sempre que enviar uma solicitação EWS.

Tabela 1. Informações para armazenar em cache para solicitações de descoberta automática

Configuração para cache	Válido para...	Detalhes
Ponto de extremidade de descoberta automática	Contanto que funcione	Quando você salva o ponto de extremidade Autodiscover que retornou uma resposta bem-sucedida, você não precisa repetir o processo de gerar uma lista de pontos de extremidade autodiscover e experimentá-los até obter uma resposta bem-sucedida. OBSERVAÇÃO: a API Gerenciada do EWS não dá suporte ao cache do ponto de extremidade de descoberta automática.
URL do EWS e quaisquer outras configurações recuperadas da resposta autodiscover	Uma semana	Ao salvar a URL do EWS e outras configurações relacionadas, você não precisará enviar uma nova solicitação de Descoberta Automática para cada solicitação do EWS ou se o aplicativo for reiniciado. No entanto, mesmo que uma URL do EWS funcione para seu usuário, um servidor poderá estar disponível que seja mais ideal. Por exemplo, a caixa de correio do usuário pode ter se movido para um novo servidor de caixa de correio, resultando em um novo ponto de extremidade EWS preferencial. 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 sua última solicitação de descoberta automática. Esse tempo pode ser ajustado para atender aos requisitos do seu aplicativo.

Atualizar informações de configuração armazenadas em cache

Agora que você tem as informações armazenadas em cache, vamos examinar como você pode manter esse cache fresco. Recomendamos que você atualize suas informações armazenadas em cache quando:

• O período de validade das informações expira.

• Ocorre um erro relacionado à conexão E suas informações armazenadas em cache foram atualizadas pela última vez há mais de uma hora.

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 armazenado em cache e faça o seguinte:

• Se a solicitação for bem-sucedida, compare o ponto de extremidade EWS na resposta com o ponto de extremidade EWS armazenado em cache e faça o seguinte:

  • Se eles forem diferentes, use o novo ponto de extremidade EWS. Se você estiver atualizando para se recuperar de um erro, tente novamente a solicitação com falha com o novo ponto de extremidade.

  • Se forem iguais, continue a usar o ponto de extremidade EWS original. Se você estiver atualizando para se recuperar de um erro, lide com o erro conforme apropriado.

• Se a solicitação falhar, inicie o processo de descoberta automática desde o início. Depois de obter uma resposta bem-sucedida, substitua o ponto de extremidade autodiscover armazenado em cache pelo ponto de extremidade de descoberta automática que teve êxito e continuará a usar o novo ponto de extremidade EWS. Se você não receber uma resposta bem-sucedida, continue a usar o ponto de extremidade de autodiscover original e o ponto de extremidade EWS. Se você estiver atualizando para se recuperar de um erro, lide com o erro conforme apropriado.

A figura a seguir fornece uma representação visual desse processo.

Figura 1. Processo para atualizar informações de configuração usando Autodiscover

Erros relacionados à conexão

Atualizar suas informações de configuração armazenadas em cache pode ajudar com alguns erros, mas não todos.

Tabela 2. Erros resolvidos atualizando seu cache

Erro	Implementação da API Gerenciada do EWS	Observações
Erros de falha de rede ou DNS Exemplo: o nome do host não pôde ser encontrado.	ServiceRemoteException	Qualquer erro que indique que o servidor não pôde ser encontrado ou não pôde ser atingido pode ser resolvido ao tentar Autodiscover. O ponto de extremidade EWS armazenado em cache pode não ser mais válido e o Autodiscover pode ser capaz de apontá-lo para o novo servidor.
Erros de status HTTP Exemplo: 503 Serviço indisponível	ServiceRemoteException	Erros de status HTTP podem acontecer por vários motivos diferentes. No entanto, é uma boa ideia experimentar o Autodiscover para ver se um novo ponto de extremidade EWS está disponível para o usuário.
Códigos de erro EWS Exemplo: ErrorConnectionFailed	ResponseCodeType	A maioria dos códigos de erro do EWS não garante a atualização de suas informações de configuração. No entanto, o seguinte indica especificamente que as informações de configuração precisam ser atualizadas: - ErrorConnectionFailed - ErrorMailboxMoveInProgress

Confira também

• Descoberta Automática do Exchange
• Gerar uma lista de pontos de extremidade de Descoberta Automática
• Obter as configurações de usuário do Exchange usando a Descoberta Automática