Элементы XML веб-служб Exchange в Exchange
Справочные сведения об элементах XML веб-служб Exchange в Exchange.
Веб-службы Exchange (EWS) — это веб-служба на основе протокола SOAP, что означает, что сообщения запроса и ответа, отправленные между клиентом и сервером, состоят из элементов XML. Документация в этом разделе основана на экземплярах XML, которые отправляются между клиентом и сервером. Экземпляры XML определяются в файлах языка WSDL и файлах схемы, расположенных в виртуальном каталоге, в котором размещены веб-службы Exchange. Если вы являетесь пользователем, прошедшим проверку подлинности, вы можете перейти к файлам WSDL и схемы, используя следующие URL-адреса, где <yourclientaccessserver> — это имя сервера клиентского доступа:
<http:// yourclientaccessserver.com>/ews/services.wsdl — расположение WSDL-файла.
<http:// yourclientaccessserver.com>/ews/messages.xsd — расположение схемы сообщений.
<http:// yourclientaccessserver.com>/ews/types.xsd — расположение схемы типов.
Файлы схемы, описывающие элементы XML веб-службы Exchange, предоставляют общую дорожную карту структуры XML, которая возможна для взаимодействий сообщений запроса и ответа. Фактическая структура XML, которая отправляется между клиентом и сервером, зависит от вызванной операции, запрашиваемой информации и параметров на стороне сервера.
Файл языка WSDL веб-служб Exchange — services.wsdl — не полностью соответствует стандарту языка WSDL, так как не содержит определения службы WSDL. Это происходит из-за того, что веб-службы Exchange не предназначены для размещения на компьютере с предварительно определенным адресом. Вы можете использовать службу автообнаружения для получения адреса конечной точки веб-служб Exchange. Некоторые генераторы клиентской объектной модели проводят синтаксический анализ языка WSDL и могут столкнуться с состоянием ошибки, так как файл языка WSDL не содержит определения службы WSDL. Если генератор объектной модели сталкивается с ошибкой, можно вставить заполнитель определения службы WSDL.
Совет
Если вы используете для разработки приложения платформу .NET Framework, вместо генератора объектной модели рекомендуется использовать управляемый API веб-служб Exchange. Управляемый API веб-служб Exchange предоставляет простую в использовании объектную модель для обработки сериализации и десериализации XML веб-служб Exchange. Дополнительные сведения см. в статье Get started with EWS Managed API client applications.
Файл схемы messages.xsd содержит определения элементов верхнего уровня в тексте SOAP. За исключением кодов ответов на ошибки, большинство определений в файле messages.xsd являются специфическими для операции. Схема types.xsd содержит определения для заголовков SOAP и все стандартные определения, общие для операций.