Создание прокси-классов веб-службы Master Data Manager

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

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

Прежде чем создавать классы прокси-сервера, необходимо включить публикацию метаданных веб-службы. Выполните следующие действия, чтобы сделать следующее:

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

  2. Найдите раздел в mdsWsHttpBehavior<serviceBehaviors>. <Для элемента serviceMetadata> задайте значение httpGetEnabledtrue.

    Замечание

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

  3. Сохраните изменения в файле .

  4. Проверьте публикацию метаданных, перейдя по URL-адресу службы, например: http://yourserver/MDS/service/service.svc. Если публикация метаданных включена, отображается страница, которая начинается с
    "Вы создали службу".

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

Если вы установили Visual Studio 2010, самый простой способ создания прокси-классов — добавить ссылку на службу в проект. Адрес ссылки на службу — это URL-адрес веб-приложения Master Data Manager, добавленного с помощью /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) и создание клиента WCF из метаданных службы.

Чтобы создать набор классов прокси-сервера 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 — это виртуальный путь диспетчера master Data Manager в службах IIS.

  • proxy_name — это имя созданного прокси-файла.

См. также

Классифицированные операции веб-службы (службы Master Data Services)