Ferramentas e recursos para a solução de problemas de aplicativos do EWS para ExchangeTools and resources for troubleshooting EWS applications for Exchange

Encontre recursos para ajudá-lo a solucionar problemas de sua API gerenciada EWS ou aplicativo EWS.Find resources to help you troubleshoot your EWS Managed API or EWS application.

As coisas nem sempre vão tão planejadas.Things don't always go as planned. Às vezes, as solicitações de EWS falham ou fornecem resultados inesperados.Sometimes EWS requests fail, or provide unexpected results. Isso pode ser frustrante, especialmente se a razão não é óbvia.This can be frustrating, especially if the reason isn't obvious. Espero que isso nunca aconteça, mas se o fizer, este artigo fornecerá informações sobre ferramentas e recursos que você pode usar para ajudar a solucionar o problema.Hopefully this never happens to you, but if it does, this article provides information about tools and resources that you can use to help troubleshoot your problem.

Observação

Este artigo fornece orientações e fontes de solução de problemas gerais para a solução de problemas de informações.This article provides general troubleshooting advice and sources for troubleshooting information. Infelizmente, não é possível fornecer etapas detalhadas de solução de problemas.Unfortunately it isn't possible to give detailed troubleshooting steps. Para obter ajuda para solucionar problemas de erro específico, consulte próximas etapas.For assistance troubleshooting your specific error, see Next steps.

Examinar as solicitações e respostas SOAPExamine the SOAP requests and responses

Quando as coisas não estão funcionando corretamente, ela realmente ajuda a ver o que está acontecendo.When things aren't working correctly, it really helps to be able to see what's going on. A primeira linha da 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.The first line of inquiry when investigating a problem with EWS or the EWS Managed API is to examine the requests that your application is sending over the network and the responses that the server is sending back.

A API gerenciada do EWS torna fácil a análise de solicitações e respostas SOAP com sua funcionalidade de rastreamento interna.The EWS Managed API makes examining SOAP requests and responses easy with its built in tracing functionality. Se você estiver usando o EWS, talvez ou não tenha acesso a funcionalidades de rastreamento semelhantes, dependendo de qual plataforma ou classes você usa para enviar suas solicitações.If you are using EWS, you might or might not have access to similar tracing functionality, depending on what platform or classes you use to send your requests. No entanto, você sempre pode usar uma ferramenta de rastreamento de rede como o Monitor de rede ou o Fiddler para examinar o tráfego de rede e exibir as cargas de solicitação e resposta.However, you can always use a network tracing tool like Network Monitor or Fiddler to examine the network traffic and view the request and response payloads.

Além disso, você pode instrumentar suas solicitações de cliente para aprimorar as informações disponíveis em solicitações e respostas.Additionally, you can instrument your client requests to enhance the information available in requests and responses.

Após ter as solicitações e respostas, pergunte-se o seguinte: eles estão corretos?After you have the requests and responses, ask yourself the following: Do they look correct? Os valores que seu aplicativo está enviando devem ser esperados?Are the values that your application is sending expected? As respostas fazem sentido?Do the responses make sense?

Examinar códigos de erroExamine error codes

Às vezes, o código de erro pode ser muito longo para indicar o problema, mesmo se a primeira vista não parecer fazer sentido.Sometimes the error code can go a long way toward pinpointing the problem, even if at first glance it doesn't seem to make sense. O erro indica que o cliente está sendo limitado?Does the error indicate that your client is being throttled? Talvez uma chamada para a descoberta automática para atualizar as informações de configuração está em ordem?Perhaps a call to Autodiscover to refresh configuration information is in order?

Para obter mais informações sobre como lidar com erros específicos, consulte os seguintes artigos:For more information about handling specific errors, see the following articles:

Verificar versõesVerify versions

Há vários componentes diferentes envolvidos nas operações do EWS, e as versões desses componentes podem influenciar os resultados.There are a number of different components involved in EWS operations, and the versions of those components can influence the results.

Tabela 1. Componentes com controle de versão que podem afetar processos EWSTable 1. Versioned components that can affect EWS processes

ComponenteComponent API gerenciada do EWSEWS Managed API EWSEWS AnotaçõesNotes
Versão de servidor solicitadaRequested server version
Propriedade ExchangeServiceBase. RequestedServerVersionExchangeServiceBase.RequestedServerVersion property
Elemento RequestServerVersionRequestServerVersion element
Esse valor controla qual versão do esquema EWS é usada para processar a solicitação EWS.This value controls which version of the EWS schema is used to process the EWS request. Verifique se a versão do esquema especificada aqui faz sentido para a solicitação que você está enviando.Make sure that the schema version specified here makes sense for the request you are sending. Algumas propriedades e operações não estão disponíveis em versões anteriores do esquema.Some properties and operations are not available in earlier versions of the schema.
A versão do servidorThe server version
Propriedade ExchangeServiceBase. ServerInfoExchangeServiceBase.ServerInfo property
Elemento ServerVersionInfoServerVersionInfo element
Esse valor é retornado pelo servidor nas respostas do EWS e indica a versão do servidor que processou a resposta.This value is returned by the server in EWS responses, and indicates the version of the server that processed the response. Certifique-se de que esse valor é o que você espera.Make sure this value is what you expect. Se possível, verifique se o servidor do Exchange está executando a atualização mais recente para sua versão principal do Exchange.If possible, make sure that the Exchange server is running the most recent update for your major version of Exchange.
A versão da API gerenciada do EWSThe EWS Managed API version
A propriedade da versão do produto do arquivo Microsoft. Exchange. WebServices. dll.The Product version property of the Microsoft.Exchange.WebServices.dll file.
Não aplicávelNot applicable
Se você estiver usando a API gerenciada do EWS, verifique se está usando a versão mais recente.If you're using the EWS Managed API, make sure that you are using the most recent version.

Verificar o acessoVerify access

O EWS está habilitado por padrão, mas os padrões podem ser alterados.EWS is enabled by default, but defaults can be changed. Use o cmdlet Get-OrganizationConfig para certificar-se de que o EWS está habilitado no servidor e o cmdlet Get-CASMailbox para garantir que o EWS esteja habilitado para a caixa de correio do usuário.Use the Get-OrganizationConfig cmdlet to make sure that EWS is enabled on the server, and the Get-CASMailbox cmdlet to make sure that EWS is enabled for the user's mailbox. Além disso, verifique as respostas de cmdlet de uma lista de permissões ou bloqueios do EWS e certifique-se de que o aplicativo não está bloqueado de usar o EWS.Also check both cmdlet responses for an EWS allow or block list, and make sure that your application isn't blocked from using 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.You should also verify that the default authentication settings on the EWS virtual directory have not been modified.

Tente outro cliente do EWSTry another EWS client

Às vezes, é útil tentar a mesma solicitação de outro cliente e comparar os resultados.Sometimes it is helpful to try the same request from another client and compare results. Se outro cliente obtiver resultados diferentes, o que é diferente?If another client gets different results, what is different? 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.Figuring out what is different between a successful request and a failed request can help explain why a particular request is failing.

Embora você possa, certamente, escrever outro cliente para testar, não é necessário!While you can certainly write another client to test with, you don't have to! EWSEditor é um cliente de exemplo que usa a API gerenciada do EWS e o EWS.EWSEditor is a sample client that uses the EWS Managed API and EWS. Você pode baixar o cliente (incluindo o código-fonte) e usá-lo para testar as mesmas solicitações que estão falhando em seu aplicativo.You can download the client (including the source code) and use it to try the same requests that are failing in your application.

Examinar os logs do IISExamine IIS logs

Se você tiver acesso ao servidor Exchange, a funcionalidade de registro em log fornecida pelos serviços de informações da Internet (IIS) nos servidores de acesso para cliente poderá fornecer mais informações sobre falhas.If you have access to the Exchange server, the logging functionality provided by Internet Information Services (IIS) on the Client Access servers can provide more information about failures. No entanto, tenha em mente que os logs do IIS só serão úteis se você estiver recebendo um erro de HTTP.However, keep in mind that IIS logs will only be helpful if you are receiving an HTTP error.

O IIS fornece dois métodos de log diferentes: rastreamento de log do IIS e de solicitações com falha.IIS provides two different logging methods: IIS logging and failed requests tracing. Para trabalhar com os logs do IIS, você pode usar o Log Parser Studio, que inclui várias consultas do EWS internas.To work with IIS logs, you can use Log Parser Studio, which includes a number of built-in EWS queries.

Próximas etapasNext steps

Agora que você aprendeu sobre as ferramentas e os recursos que você pode usar para solucionar problemas, talvez precise de ajuda para entender as informações fornecidas por essas ferramentas.Now that you've learned about the tools and resources that you can use to troubleshoot, you might need help understanding the information provided by those tools. Veja a seguir algumas opções para obter ajuda:The following are some options for getting help:

Confira tambémSee also

Confira os seguintes artigos:See the following articles:

Baixe o seguinte:Download the following: