Ferramentas e recursos para solucionar problemas de aplicativos EWS para Exchange

  • Artigo

Encontre recursos para ajudá-lo a solucionar problemas da API Gerenciada do EWS ou do aplicativo EWS.

As coisas nem sempre são conforme o planejado. Às vezes, as solicitações EWS falham ou fornecem resultados inesperados. Isso pode ser frustrante, especialmente se o motivo não for óbvio. Esperamos que isso nunca aconteça com você, mas se isso acontecer, este artigo fornecerá informações sobre ferramentas e recursos que você pode usar para ajudar a solucionar o problema.

Observação

Este artigo fornece orientações gerais sobre solução de problemas e fontes para informações de solução de problemas. Infelizmente, não é possível fornecer etapas detalhadas de solução de problemas. Para obter assistência para solucionar o erro específico, consulte Próximas etapas.

Examinar as solicitações e respostas SOAP

Quando as coisas não estão funcionando corretamente, é realmente útil poder ver o que está acontecendo. A primeira linha de consulta ao investigar um problema com o EWS ou a API Gerenciada do EWS é examinar as solicitações que seu aplicativo está enviando pela rede e as respostas que o servidor está enviando de volta.

A API Gerenciada do EWS facilita o exame de solicitações e respostas SOAP com sua funcionalidade de rastreamento. Se você estiver usando o EWS, poderá ou não ter acesso à funcionalidade de rastreamento semelhante, dependendo da plataforma ou das classes usadas para enviar suas solicitações. No entanto, você sempre pode usar uma ferramenta de rastreamento de rede como Monitor de Rede ou Fiddler para examinar o tráfego de rede e exibir os conteúdos de solicitação e resposta.

Além disso, você pode instrumentar as solicitações de seu cliente para aprimorar as informações disponíveis em solicitações e respostas.

Depois que você tiver as solicitações e respostas, pergunte a si mesmo o seguinte: Elas parecem corretas? Os valores que seu aplicativo está enviando são esperados? As respostas fazem sentido?

Examinar códigos de erro

Às vezes, o código de erro pode facilitar muito na identificação do problema, mesmo que à primeira vista não pareça fazer sentido. O erro indica que o cliente está sendo limitado? Talvez uma chamada à Descoberta Automática para atualizar informações de configuração é necessária?

Para obter mais informações sobre como lidar com erros específicos, consulte os seguintes artigos:

Verificar versões

Há vários componentes diferentes envolvidos em operações do EWS, e as versões desses componentes podem influenciar os resultados.

Tabela 1. Componentes com versão que podem afetar processos EWS

Componente API Gerenciada do EWS EWS Anotações
Versão do servidor solicitada
 propriedade ExchangeServiceBase.RequestedServerVersion
 elemento RequestServerVersion
 Esse valor controla qual versão do esquema EWS é usada para processar a solicitação do EWS. Verifique se a versão do esquema especificada aqui faz sentido para a solicitação que você está enviando. Algumas propriedades e operações não estão disponíveis em versões anteriores do esquema.
A versão do servidor
 propriedade ExchangeServiceBase.ServerInfo
 elemento ServerVersionInfo
 Esse valor é retornado pelo servidor em respostas EWS e indica a versão do servidor que processou a resposta. Verifique se esse valor é o que você espera. Se possível, verifique se o servidor Exchange está executando a atualização mais recente para sua versão principal do Exchange.
A versão da API Gerenciada do EWS
 A propriedade Product version do arquivo Microsoft.Exchange.WebServices.dll.
Não aplicável
 Se você estiver usando a API Gerenciada do EWS, verifique se está usando a versão mais recente.

Verificar o acesso

O EWS está habilitado por padrão, mas padrões podem ser alterados. Use o cmdlet Get-OrganizationConfig para garantir que o EWS esteja habilitado no servidor, e o cmdlet Get-CASMailbox para garantir que o EWS esteja habilitado para a caixa de correio do usuário. Verifique também as duas respostas de cmdlet para uma lista de permissões ou bloqueios do EWS e verifique se o aplicativo não está impedido de usar o EWS.

Você também deve verificar se as configurações de autenticação padrão no diretório virtual do EWS não foram modificadas.

Tentar outro cliente EWS

Às vezes, é útil tentar a mesma solicitação de outro cliente e comparar os resultados. Se outro cliente obtiver resultados diferentes, o que será diferente? Descobrir o que é diferente entre uma solicitação bem-sucedida e uma solicitação com falha pode ajudar a explicar por que uma solicitação específica está falhando.

Embora você possa certamente escrever outro cliente com o qual testar, você não precisa fazer isso! EWSEditor é um cliente de exemplo que usa a API Gerenciada do EWS e o EWS. Você pode baixar o cliente (incluindo o código-fonte) e usá-lo para tentar as mesmas solicitações que estão falhando em seu aplicativo.

Examinar logs do IIS

Se você tiver acesso ao servidor Exchange, a funcionalidade de log fornecida pelo Serviços de Informações da Internet (IIS) nos servidores de Acesso para Cliente poderá fornecer mais informações sobre falhas. No entanto, tenha em mente que os logs do IIS só serão úteis se você estiver recebendo um erro HTTP.

O IIS fornece dois métodos de registro em log diferentes: registro em log do IIS e rastreamento de solicitações com falha. Para trabalhar com logs do IIS, você pode usar o Log Parser Studio, que inclui várias consultas EWS internas.

Próximas etapas

Agora que você aprendeu sobre as ferramentas e os recursos que pode usar para solucionar problemas, talvez precise de ajuda para entender as informações fornecidas por essas ferramentas. A seguir estão algumas opções para obter ajuda:

Confira também

Confira os seguintes artigos:

Baixe o seguinte: