Bagikan melalui


Membuat Kelas Proksi Layanan Web Master Data Manager

Berlaku untuk:SQL Server di Windows Azure SQL Managed Instance

Penting

Master Data Services (MDS) dihapus di SQL Server 2025 (17.x). Kami terus mendukung MDS di SQL Server 2022 (16.x) dan versi yang lebih lama.

Layanan web Master Data Manager memungkinkan Anda menggunakan fitur Master Data Services secara terprogram dari komputer apa pun yang dapat mengakses situs web Master Data Manager Anda. Sebelum Anda dapat mulai menulis kode untuk mengakses layanan web, Anda harus membuat kelas proksi. Kelas proksi utama yang Anda gunakan untuk melakukan operasi layanan web adalah ServiceClient kelas , yang mengimplementasikan IService antarmuka.

Mengaktifkan Penerbitan Metadata Layanan Web

Sebelum dapat membuat kelas proksi, Anda harus mengaktifkan penerbitan metadata layanan web. Ikuti langkah-langkah berikut untuk melakukan ini:

  1. Buka file Master Data Services Web.config di editor teks. File ini berada di folder WebApplication dari jalur penginstalan Master Data Services.

  2. Temukan bagian mdsWsHttpBehavior di bawah <serviceBehaviors>. <Untuk elemen serviceMetadata>, atur httpGetEnabled ke true.

    Catatan

    Jika Anda ingin mengaktifkan layanan Web melalui Keamanan Lapisan Transportasi (TLS), sebelumnya dikenal sebagai Secure Sockets Layer (SSL), atur httpsGetEnabled ke true di bagian mdsWsHttpBehavior dari file web.config. Anda juga perlu mengubah mdsWsHTTPBinding sehingga dikonfigurasi untuk TLS, juga, dan mengomentari bagian non-TLS.

  3. Simpan perubahan pada file .

  4. Uji penerbitan metadata dengan menelusuri KE URL layanan, misalnya: https://yourserver/MDS/service/service.svc. Jika penerbitan metadata diaktifkan, halaman ditampilkan yang dimulai dengan
    "Anda telah membuat layanan."

Membuat Kelas Proksi dengan Menggunakan Visual Studio

Jika Anda telah menginstal Visual Studio 2010, cara paling sederhana untuk menghasilkan kelas proksi adalah dengan menambahkan Referensi Layanan ke proyek Anda. Alamat referensi layanan adalah URL aplikasi web Master Data Manager, ditambahkan dengan /service/service.svc. Misalnya: https://yourserver/MDS/service/service.svc. Untuk informasi selengkapnya, lihat Cara: Menambahkan, Memperbarui, atau Menghapus Referensi Layanan.

Membuat Kelas Proksi dengan Menggunakan Svcutil.exe

Anda harus menginstal Microsoft Visual Studio atau Microsoft Windows SDK agar dapat memiliki Svcutil.exe di komputer Anda. Jika Anda menggunakan Visual Studio, Anda harus menggunakan perintah Visual Studio untuk menjalankan perintah. Untuk informasi selengkapnya, lihat Alat Utilitas Metadata ServiceModel (Svcutil.exe) dan Membuat Klien WCF dari Metadata Layanan.

Untuk membuat sekumpulan kelas proksi C# dengan menggunakan Svcutil.exe, gunakan perintah seperti berikut ini:

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  

Mana:

  • servername:port adalah nama komputer dan nomor port komputer yang menghosting Master Data Manager.

  • virtual_path adalah jalur virtual Master Data Manager di Layanan Informasi Internet (IIS).

  • proxy_name adalah nama untuk file proksi yang dihasilkan.

Lihat Juga

Operasi Layanan Web Terkategori (Layanan Data Master)