Elementos XML do EWS no Exchange

  • Artigo

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