Создание классов-посредников веб-службы диспетчера основных данных

Статья
05/08/2013

Веб-служба Диспетчер основных данных позволяет программно использовать функции Master Data Services с любого компьютера, имеющего доступ к веб-сайту Диспетчер основных данных. Перед тем как писать код для доступа к веб-службе, необходимо создать классы-посредники. Основным классом-посредником, который используется для выполнения операций веб-службы, является класс Microsoft.MasterDataServices.ServiceClient, реализующий интерфейс Microsoft.MasterDataServices.IService.

Включение публикации метаданных веб-службы

Перед созданием классов-посредников необходимо включить публикацию метаданных веб-службы. Для этого выполните следующие шаги.

Откройте файл Web.config Master Data Services в текстовом редакторе. Этот файл находится в папке WebApplication каталога пути установки Master Data Services.

Найдите раздел mdsWsHttpBehavior в разделе <serviceBehaviors>. Задайте для свойства httpGetEnabled элемента <serviceMetadata> значение true.

Примечание
Чтобы включить веб-службы по протоколу SSL, задайте свойству httpsGetEnabled значение true в секции mdsWsHttpBehavior файла web.config. Необходимо также настроить mdsWsHTTPBinding на протокол SSL и закомментировать секцию не SSL.

Сохраните изменения в файле.
Для проверки публикации метаданных перейдите по URL-адресу службы, например: http://yourserver/MDS/service/service.svc. Если публикация метаданных включена, то на экране появится страница, которая начинается со слов «Вы создали службу».

Создание классов-посредников с помощью Visual Studio

Если установлена программа Visual Studio 2010, то самый простой способ создания классов-посредников заключается в добавлении в проект Ссылки на службу. Адресом ссылки на службу является URL-адрес веб-приложения Диспетчер основных данных, к которому добавлено /service/service.svc. Например. http://yourserver/MDS/service/service.svc. Дополнительные сведения см. в разделе Как Добавление, обновление и удаление ссылки на службу.

Создание классов-посредников с помощью Svcutil.exe

Средство Svcutil.exe устанавливается на компьютере при установке среды Microsoft Visual Studio или пакета Microsoft Windows SDK. При использовании среды Visual Studio для выполнения команды необходимо использовать командную строку Visual Studio. Дополнительные сведения см. в статьях ServiceModel Metadata Utility Tool (Svcutil.exe) и Generating a WCF Client from Service Metadata (на английском языке).

Для создания набора классов-посредников C# с помощью Svcutil.exe используйте команду наподобие следующей:

svcutil.exe http://<server_name:port>/<virtual_path>/Service/Service.svc 
/out:<proxy_name>.cs /messageContract /tcv:Version35 
/noconfig /ct:System.Collections.ObjectModel.Collection`1 
/namespace:*,Microsoft.MasterDataServices

где:

servername:port — это имя компьютера и номер порта компьютера, на котором размещаются Диспетчер основных данных.
virtual_path — это виртуальный путь к Диспетчер основных данных в службах Internet Information Services (IIS).
proxy_name ― это имя создаваемого файла посредника.

См. также

Основные понятия

Операции веб-службы по категориям (службы Master Data Services)

Поделиться через