Éléments XML de EWS dans Exchange

Recherchez des informations de référence pour les éléments XML de EWS dans Exchange.

Exchange Web Services (EWS) est un service web SOAP, ce qui signifie que les messages de demande et de réponse envoyés entre le client et le serveur sont composés d’éléments XML. La documentation de cette section est basée sur les instances XML envoyées entre le client et le serveur. Les instances XML sont définies dans le fichier WSDL et les fichiers de schéma situés dans le répertoire virtuel qui héberge EWS. Si vous êtes un utilisateur authentifié, vous pouvez accéder aux fichiers WSDL et de schéma à l’aide des URL suivantes, où <yourclientaccessserver> est le nom de votre serveur d’accès au client :

  • <http:// votreclientaccessserver.com>/ews/services.wsdl : emplacement du fichier WSDL.

  • <http:// votreclientaccessserver.com>/ews/messages.xsd : emplacement du schéma des messages.

  • <http:// votreclientaccessserver.com>/ews/types.xsd : emplacement du schéma des types.

Les fichiers de schéma qui décrivent les éléments XML de EWS fournissent une feuille de route générale de la structure XML qui est possible pour les interactions de message de demande-réponse. La structure XML réelle qui est envoyée entre le client et le serveur varie en fonction de l’opération appelée, des informations demandées et des paramètres côté serveur.

Le fichier WSDL de EWS, services.wsdl, n’est pas entièrement conforme à la norme WSDL, car il n’inclut pas de définition de service WSDL. Cela est dû au fait qu’EWS n’est pas conçu pour être hébergé sur un ordinateur disposant d’une adresse prédéfinie. Vous pouvez utiliser le service de découverte automatique pour obtenir l’adresse du point de terminaison EWS. Certains générateurs de modèle objet côté client analysent le WSDL et peuvent rencontrer une condition d’erreur, car le fichier WSDL ne contient pas de définition de service WSDL. Si votre générateur de modèle objet rencontre une erreur, vous pouvez insérer une définition de service WSDL d’espace réservé.

Conseil

Si vous utilisez .NET Framework pour développer votre application, nous vous recommandons d’utiliser l’API managée EWS, plutôt qu’un générateur de modèle objet. L’API managée EWS fournit un modèle objet facile à utiliser pour gérer la sérialisation et la désérialisation du XML de EWS. Pour plus d’informations, consultez Démarrage avec les applications clientes de l’API managée EWS.

Le fichier de schéma messages.xsd contient les définitions d’éléments pour les éléments de niveau supérieur dans le corps SOAP. À l’exception des codes de réponse d’erreur, la plupart des définitions dans messages.xsd sont spécifiques à une opération. Le schéma types.xsd contient les définitions des en-têtes SOAP et toutes les définitions communes partagées entre les opérations.

Voir aussi