Skapa Master Data Manager-webbtjänstproxyklasser

Gäller för:SQL Server i Windows Azure SQL Managed Instance

Viktigt!

Master Data Services (MDS) tas bort i SQL Server 2025 (17.x). Vi fortsätter att stödja MDS i SQL Server 2022 (16.x) och tidigare versioner.

Med Master Data Manager-webbtjänsten kan du använda funktionerna i Master Data Services programmatiskt från alla datorer som har åtkomst till masterdatahanterarens webbplats. Innan du kan börja skriva kod för att få åtkomst till webbtjänsten måste du generera proxyklasser. Huvudproxyklassen som du använder för att utföra webbtjänståtgärder är ServiceClient klassen som implementerar IService gränssnittet.

Aktivera publicering av webbtjänstmetadata

Innan du kan generera proxyklasser måste du aktivera publicering av webbtjänstmetadata. Följ dessa steg för att göra detta:

  1. Öppna filen Master Data Services Web.config i en textredigerare. Den här filen finns i mappen WebApplication i installationssökvägen för Master Data Services.

  2. Hitta avsnittet mdsWsHttpBehavior under <serviceBehaviors>. <För serviceMetadata-elementet> anger du httpGetEnabled till true.

    Anmärkning

    Om du vill aktivera webbtjänster via TLS (Transport Layer Security), som tidigare kallades Secure Sockets Layer (SSL), anger du httpsGetEnabled till true i avsnittet mdsWsHttpBehavior i web.config-filen. Du måste också ändra mdsWsHTTPBinding så att det även är konfigurerat för TLS och kommentera ut avsnittet som inte är TLS.

  3. Spara ändringar i filen.

  4. Testa metadatapublicering genom att bläddra till tjänstens URL, till exempel: https://yourserver/MDS/service/service.svc. Om metadatapublicering är aktiverat visas en sida som börjar med
    "Du har skapat en tjänst."

Skapa proxyklasser med hjälp av Visual Studio

Om du har Visual Studio 2010 installerat är det enklaste sättet att generera proxyklasser att lägga till en tjänstreferens i projektet. Adressen till tjänstreferensen är URL:en för Master Data Manager-webbprogrammet, som läggs till med /service/service.svc. Till exempel: https://yourserver/MDS/service/service.svc. Mer information finns i Så här lägger du till, uppdaterar eller tar bort en tjänstreferens.

Skapa proxyklasser med hjälp av Svcutil.exe

Du måste ha antingen Microsoft Visual Studio eller Microsoft Windows SDK installerat för att ha Svcutil.exe på datorn. Om du använder Visual Studio måste du använda Kommandotolken i Visual Studio för att köra kommandot. Mer information finns i Verktyg för ServiceModel-metadataverktyg (Svcutil.exe) och Generera en WCF-klient från tjänstmetadata.

Om du vill skapa en uppsättning C#-proxyklasser med hjälp av Svcutil.exeanvänder du ett kommando, till exempel följande:

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  

Var:

  • servername:port är datornamnet och portnumret för den dator som är värd för Master Data Manager.

  • virtual_path är den virtuella sökvägen för Master Data Manager i Internet Information Services (IIS).

  • proxy_name är namnet på den genererade proxyfilen.

Se även

Kategoriserade webbtjänståtgärder (Master Data Services)