Elementos XML de EWS en Exchange

Buscar información de referencia para los elementos XML de EWS en Exchange.

Servicios Web Exchange (EWS) es un servicio web basado en SOAP, lo que significa que los mensajes de solicitud y respuesta que se envían entre el cliente y el servidor se componen de elementos XML. La documentación de esta sección se basa en las instancias XML que se envían entre el cliente y el servidor. Las instancias XML se definen en los archivos WSDL y de esquema que se encuentran en el directorio virtual que hospeda EWS. Si es un usuario autenticado, puede ir a los archivos WSDL y de esquema mediante las siguientes direcciones URL, donde <suclientaccessserver> es el nombre del servidor de acceso de cliente:

  • <http:// yourclientaccessserver.com>/ews/services.wsdl: ubicación del archivo WSDL.

  • <http:// yourclientaccessserver.com>/ews/messages.xsd: ubicación del esquema de mensajes.

  • <http:// yourclientaccessserver.com>/ews/types.xsd: ubicación del esquema de tipos.

Los archivos de esquema que describen los elementos XML de EWS proporcionan una hoja de ruta general de la estructura XML que es posible para las interacciones de mensajes de solicitud-respuesta. La estructura XML real que se envía entre el cliente y el servidor varía según la operación a la que se llama, la información solicitada y la configuración del lado servidor.

El archivo WSDL de EWS, services.wsdl, no se ajusta totalmente al estándar WSDL porque no incluye una definición de servicio WSDL. Esto se debe a que EWS no está diseñado para hospedarse en un equipo que tiene una dirección predefinida. Puede usar el servicio Detección automática para obtener la dirección del punto de conexión de EWS. Algunos generadores de modelos de objetos del lado cliente analizan WSDL y pueden encontrar una condición de error porque el archivo WSDL no contiene una definición de servicio WSDL. Si el generador de modelos de objetos encuentra un error, puede insertar una definición de servicio WSDL de marcador de posición.

Sugerencia

Si usa el .NET Framework para desarrollar la aplicación, se recomienda usar la API administrada EWS, en lugar de un generador de modelos de objetos. La API administrada EWS proporciona un modelo de objetos fácil de usar para controlar la serialización y deserialización del XML de EWS. Para obtener más información, vea Introducción a las aplicaciones cliente de la API administrada EWS.

El archivo de esquema messages.xsd contiene las definiciones de elemento para los elementos de nivel superior en el cuerpo SOAP. A excepción de los códigos de respuesta de error, la mayoría de las definiciones de messages.xsd son específicas de una operación. El esquema types.xsd contiene las definiciones de los encabezados SOAP y todas las definiciones comunes que se comparten entre las operaciones.

Recursos adicionales