Elementos XML do EWS no Exchange

Localizar informações de referência para os elementos XML do EWS no Exchange.

Os Serviços Web do Exchange (EWS) são um serviço Web baseado em SOAP, o que significa que as mensagens de solicitação e réplicas enviadas entre o cliente e o servidor são compostas por elementos XML. A documentação nesta seção é baseada nas instâncias XML enviadas entre o cliente e o servidor. As instâncias XML são definidas na WSDL e nos arquivos esquema localizados no diretório virtual que hospeda o EWS. Se você for um usuário autenticado, poderá navegar até os arquivos WSDL e esquema usando as seguintes URLs, em que <yourclientaccessserver> é o nome do servidor de Acesso ao Cliente:

  • <http:// yourclientaccessserver.com>/ews/services.wsdl — o local do arquivo WSDL.

  • <http:// yourclientaccessserver.com>/ews/messages.xsd — O local do esquema de mensagens.

  • <http:// yourclientaccessserver.com>/ews/types.xsd — O local do esquema de tipos.

Os arquivos de esquemas que descrevem os elementos XML do EWS fornecem um roteiro geral da estrutura XML que é possível para interações de mensagem de solicitação-resposta. A estrutura XML real que é enviada entre o cliente e o servidor varia de acordo com a operação que é chamada, as informações solicitadas e as configurações do lado do servidor.

O arquivo de WSDL do EWS, services.wsdl, não está totalmente em conformidade com o padrão de WSDL porque não inclui uma definição do serviço de linguagem WSDL. Isto ocorre porque o EWS não foi projetado para ser hospedado em um computador com um endereço predefinido. Você pode usar o serviço de Descoberta Automática para obter o endereço do ponto de extremidade do EWS. Alguns geradores do modelo de objeto do lado do cliente analisam a linguagem WSDL e podem encontrar uma condição de erro porque o arquivo da WSDL não contém uma definição do serviço de WSDL. Se o gerador do modelo de objeto encontrar um erro, você poderá inserir uma definição do serviço de WSDL de espaço reservado.

Dica

Se você estiver usando o .NET Framework para desenvolver seu aplicativo, recomendamos que utilize a API Gerenciada do EWS, em vez de um gerador de modelo de objeto. A API Gerenciada do EWS fornece um modelo de objeto fácil de utilizar para lidar com a serialização e a desserialização do XML do EWS. Para obter mais informações, consulte Introdução aos aplicativos clientes da API Gerenciada do EWS.

O arquivo de esquema messages.xsd contém as definições de elementos para os elementos de nível superior no corpo do SOAP. Com exceção dos códigos de réplica a erros, a maioria das definições em messages.xsd são específicas para uma operação. O esquema types.xsd contém as definições para os cabeçalhos do SOAP e todas as definições comuns que são compartilhadas entre as operações.

Confira também