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

Мақала
08/21/2023

Область применения: SQL Server — Только Управляемый экземпляр SQL Azure Windows

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

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

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

Откройте файл Web.config служб Master Data Services в текстовом редакторе. Этот файл находится в папке WebApplication пути установки Служб Master Data Services.
Найдите раздел mdsWsHttpBehavior в <разделе serviceBehaviors>. <Для элемента serviceMetadata> задайте значение true httpGetEnabled.

Примечание.

Если вы хотите включить веб-службы по протоколу TLS, ранее известному как ПРОТОКОЛ SSL, задайте для httpsGetEnabled значение true в разделе mdsWsHttpBehavior в файле конфигурации web.config. Кроме того, необходимо изменить mdsWsHTTPBinding , чтобы он был настроен для TLS, а также закомментировать раздел, отличный от TLS.
Сохраните изменения в файле .
Для проверки публикации метаданных перейдите по URL-адресу службы, например: https://yourserver/MDS/service/service.svc. Если публикация метаданных включена, то на экране появится страница, которая начинается со слов
"Вы создали службу".

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

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

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

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

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

svcutil.exe https://<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 — это виртуальный путь диспетчера основных данных в службы IIS (IIS).
proxy_name ― это имя создаваемого прокси-файла.

См. также

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

Бөлісу құралы: