Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Bagian ini menyediakan informasi tentang cara menggunakan Add-in Proyek BizTalk Consume Adapter Service, Add Adapter Metadata Wizard, dan Add Adapter Service Reference Visual Studio Plug-in. Dengan menggunakan komponen Visual Studio ini, Anda dapat:
Telusuri operasi untuk mengambil metadata.
Cari operasi untuk mengambil metadata.
Tambahkan skema pesan untuk operasi yang dipilih dan file konfigurasi pengikatan port ke proyek BizTalk Server saat menggunakan Add-in Gunakan Layanan Adapter.
Tambahkan kelas klien WCF atau kontrak layanan WCF (antarmuka) untuk operasi yang dipilih dan file konfigurasi (app.config) ke proyek pemrograman non-BizTalk saat menggunakan Plug-in Tambahkan Referensi Layanan Adapter.
Catatan
Add-in Layanan Konsumsi Adapter, Wizard Tambahkan Metadata Adapter, dan Plug-in Tambahkan Referensi Layanan Adapter hadir pada dasarnya antarmuka yang sama saat Anda menelusuri dan mencari operasi, sehingga ketiga komponen tercakup dalam topik yang sama.
Prasyarat
Anda harus tersambung ke SQL Server sebelum dapat menelusuri, mencari, atau mengambil metadata untuk operasi target. Untuk informasi tentang cara menyambungkan ke SQL Server saat Anda menggunakan Add-in Gunakan Layanan Adaptor, Wizard Tambahkan Metadata Adapter, atau Plug-in Tambahkan Referensi Layanan Adapter, lihat Menyambungkan ke SQL Server di Visual Studio menggunakan Add-in Gunakan Layanan Adaptor.
Penjelajahan untuk Operasi
Anda dapat menggunakan Add-in Gunakan Layanan Adapter, Wizard Tambahkan Metadata Adapter, atau Add Adapter Service Reference Plug-in untuk menelusuri operasi keluar dan masuk yang dapat dilakukan pada SQL Server menggunakan adaptor SQL.
Operasi Keluar
Adaptor SQL memungkinkan klien untuk melakukan operasi keluar berikut.
Sisipkan, Pilih, Perbarui, dan Hapus operasi pada tabel dan tampilan.
Atur<operasi column_name> pada tabel dan tampilan. Operasi ini diekspos pada tabel yang memiliki kolom varchar(max), nvarchar(max), atau varbinary(max). Operasi tersebut memungkinkan streaming objek besar.
Prosedur tersimpan, baik yang lemah maupun dititik dengan kuat sebagai operasi.
Fungsi bernilai skalar dan tabel sebagai operasi.
Adaptor juga mengekspos operasi keluar generik seperti ExecuteReader, ExecuteScalar, dan ExecuteNonQuery di tingkat akar.
Operasi Masuk
Adaptor SQL memungkinkan klien untuk melakukan operasi masuk berikut.
Operasi polling untuk menerima pesan perubahan data berbasis polling dari SQL Server. Pesan yang diterima untuk operasi ini tidak ditik dengan kuat.
Operasi TypedPolling untuk menerima pesan perubahan data berbasis polling dari SQL Server. Pesan yang diterima untuk operasi ini ditik dengan kuat.
Operasi pemberitahuan untuk menerima pemberitahuan kueri dari SQL Server.
Catatan
Adaptor juga mendukung operasi masuk XmlPolling untuk mengaktifkan polling pada database SQL Server menggunakan pernyataan SELECT dan prosedur tersimpan yang berisi klausul FOR XML. Namun, adaptor tidak mengekspos operasi masuk tertentu untuk ini. Untuk informasi selengkapnya tentang XmlPolling, lihat Menerima pesan polling menggunakan pernyataan SELECT dengan Klausul FOR XML dari SQL menggunakan BizTalk Server.
Untuk informasi selengkapnya tentang operasi ini, lihat Menyambungkan ke sistem SAP menggunakan adaptor.
Catatan
Dengan menggunakan Add-in Layanan Adapter Konsumsi atau Add Adapter Service Reference Plug-in, Anda dapat menelusuri kategori dan simpul operasi menggunakan antarmuka Windows.
Untuk informasi selengkapnya tentang metadata penjelajahan, lihat Mendapatkan metadata untuk operasi SQL Server di Visual Studio menggunakan adaptor SQL.
Untuk menelusuri operasi keluar di SQL Server
Sambungkan ke SQL Server menggunakan Add-in Gunakan Layanan Adaptor, Tambahkan Wizard Metadata Adapter, atau Plug-in Tambahkan Referensi Layanan Adapter. Lihat Menyambungkan ke SQL Server di Visual Studio menggunakan Add-in Gunakan Layanan Adaptor untuk instruksi.
Dari daftar Pilih jenis kontrak , untuk operasi keluar pilih Klien (Operasi keluar).
Kotak Pilih kategori mencantumkan artefak yang tersedia di database SQL Server yang Anda sambungkan. Klik artefak untuk melihat operasi yang tersedia untuk artefak tersebut di kotak Kategori dan operasi yang tersedia .
Tip
Anda dapat langsung masuk ke simpul kategori "langsung" atau simpul subkategori di pohon, dengan mengetik nama artefak, sementara fokusnya ada pada tampilan pohon dalam kotak Pilih kategori . Misalnya, untuk melompat ke simpul tabel Karyawan , pertahankan fokus pada simpul Tabel , lalu ketik
Employee.Gambar berikut menunjukkan Add-in Konsumsi Layanan Adapter. Simpul akar (/) dipilih, dan simpul kategori umum yang tersedia di bawah simpul akar tercantum dalam kotak Kategori dan operasi yang tersedia .
Catatan
Operasi SQL Server standar seperti ExecuteReader, ExecuteScalar, dan ExecuteNonQuery juga tersedia di tingkat root. Untuk informasi selengkapnya tentang operasi ini, lihat Dukungan untuk ExecuteNonQuery, ExecuteReader, dan ExecuteScalar Operations.
Untuk melihat prosedur yang tersedia di database SQL Server, klik simpul Prosedur. Dalam gambar berikut, simpul Prosedur dipilih dalam kotak Pilih kategori , dan prosedur terkait tercantum dalam kotak Kategori dan operasi yang tersedia.
Catatan
Serangkaian prosedur yang sama yang tercantum di bawah simpul Prosedur juga tersedia di bawah simpul Prosedur yang Sangat Ditik . Perbedaannya adalah cara skema dihasilkan. Untuk prosedur di bawah simpul Prosedur , skema diketik dengan lemah. Namun, untuk prosedur di bawah simpul Prosedur Yang Diketik Kuat , skema sangat diketik. Skema yang sangat diketik berguna jika Anda ingin memetakan skema satu operasi ke operasi lain menggunakan pemeta BizTalk karena skema tersedia untuk Anda pada waktu desain saat membuat proyek BizTalk. Untuk prosedur yang diketik dengan lemah, skema untuk prosedur diterima pada durasi sebagai bagian dari pesan respons.
Untuk melihat tabel dalam database SQL Server, klik simpul Tabel. Atau, perluas simpul Tabel .
Untuk melihat operasi yang didukung pada tabel, klik nama tabel.
Gambar berikut ini memperlihatkan daftar tabel dalam kotak Pilih kategori . Kotak Kategori dan operasi yang tersedia mencantumkan operasi yang didukung untuk tabel yang dipilih.
Catatan
Jika tabel SQL Server berisi kolom jenis varchar(max), nvarchar(max), dan varbinary(max), adaptor juga mengekspos operasi tertentu untuk memperbarui data di kolom tersebut. Nama operasi ini adalah Set<column_name>. Misalnya, jika tabel memiliki kolom "Job_Description" jenis varchar(MAX), nama operasi adalah "SetJob_Description".
Untuk melihat tampilan di database SQL Server, klik simpul Tampilan. Atau, perluas simpul Tampilan .
Untuk melihat operasi yang didukung pada tampilan, klik nama tampilan.
Gambar berikut ini memperlihatkan daftar tampilan dalam kotak Pilih kategori . Kotak Kategori dan operasi yang tersedia mencantumkan operasi yang didukung untuk tampilan yang dipilih.
Catatan
Jika tampilan berisi kolom jenis varchar(max), nvarchar(max), dan varbinary(max), adaptor juga mengekspos operasi tertentu untuk memperbarui data di kolom tersebut. Nama operasi ini adalah Set<column_name>. Misalnya, jika tabel memiliki kolom "Job_Description" jenis varchar(max), nama operasinya adalah "SetJob_Description".
Untuk melihat daftar fungsi skalar yang ditentukan dalam database SQL Server dalam kotak Kategori dan operasi yang tersedia, klik simpul Fungsi Skalar.
Dalam gambar berikut, simpul Fungsi Skalar dipilih dalam kotak Pilih kategori , dan fungsi terkait tercantum dalam kotak Kategori dan operasi yang tersedia .
Untuk melihat daftar fungsi bernilai tabel yang ditentukan dalam database SQL Server dalam kotak Kategori dan operasi yang tersedia, klik simpul Fungsi Bernilai Tabel.
Dalam gambar berikut, simpul Fungsi Bernilai Tabel dipilih dalam kotak Pilih kategori , dan fungsi terkait tercantum dalam kotak Kategori dan operasi yang tersedia .
Untuk menelusuri operasi masuk pada SQL Server
Sambungkan ke SQL Server menggunakan Add-in Gunakan Layanan Adaptor, Wizard Tambahkan Metadata Adapter, atau Plug-in Tambahkan Referensi Layanan Adapter. Lihat Menyambungkan ke SQL Server di Visual Studio menggunakan Add-in Gunakan Layanan Adaptor untuk instruksi.
Dari daftar Pilih jenis kontrak , untuk operasi masuk, pilih Layanan (Operasi masuk).
Semua operasi masuk yang didukung oleh adaptor SQL tersedia di simpul akar. Klik simpul akar (/) untuk melihat operasi masuk yang tersedia.
Mencari Operasi
Anda dapat menggunakan Add-in Gunakan Layanan Adapter, Wizard Tambahkan Metadata Adapter, atau Add Adapter Service Reference Plug-in untuk mencari artefak tertentu dalam database SQL Server. Saat mencari metadata SQL Server, adaptor SQL:
Mendukung karakter kartubebas dan karakter escape dalam ekspresi pencarian.
Memungkinkan pencarian segera di bawah simpul tempat operasi pencarian dilakukan. Misalnya, untuk mencari tabel, Anda harus mencari di bawah \Table. Pencarian multi-tingkat tidak didukung.
Tabel berikut mencantumkan karakter khusus yang dapat digunakan untuk mencari artefak dan interpretasinya oleh adaptor SQL.
| Karakter khusus | Interpretasi | Contoh |
|---|---|---|
| _ (garis bawah) | Cocok persis dengan satu karakter | "A_" cocok dengan AB, AC, AD. |
| % | Cocok dengan nol atau lebih karakter | "A%" cocok dengan A, AB, AC. |
| [ ] | - Lolos arti khusus dari % dan _ - Menentukan rentang atau sekumpulan karakter yang akan ada |
- %[%]% cocok dengan semua nama yang menyertakan simbol %. - [a-f] cocok dengan semua nama yang memiliki karakter antara (dan termasuk) 'a' dan 'f'. - [abc] cocok dengan semua nama yang memiliki karakter 'a', 'b', dan 'c'. |
| [^] | Menentukan rentang atau sekumpulan karakter yang tidak akan ada | - [^a-f] cocok dengan semua nama yang tidak memiliki karakter antara (dan termasuk) 'a' dan 'f'. - [^abc] cocok dengan semua nama yang tidak memiliki karakter 'a', 'b', dan 'c'. |
Catatan
Karakter Escape adalah karakter yang diletakkan di depan karakter kartubebas untuk menunjukkan bahwa kartubebas harus ditafsirkan sebagai karakter biasa dan bukan sebagai kartubebas.
Untuk informasi selengkapnya, lihat Mendapatkan metadata untuk operasi SQL Server di Visual Studio menggunakan adaptor SQL.
Untuk mencari metadata di SQL Server menggunakan Add-in Consume Adapter Service, lakukan langkah-langkah berikut.
Untuk mencari metadata di SQL Server
Sambungkan ke SQL Server menggunakan Add-in Gunakan Layanan Adaptor, Wizard Tambahkan Metadata Adapter, atau Plug-in Tambahkan Referensi Layanan Adapter. Lihat Menyambungkan ke SQL Server di Visual Studio menggunakan Add-in Gunakan Layanan Adaptor untuk instruksi.
Dari daftar Pilih jenis kontrak , pilih jenis kontrak berdasarkan apakah Anda mencari operasi masuk atau keluar.
Dalam kotak Pilih kategori , klik simpul kategori tempat Anda ingin mencari artefak tertentu. Misalnya, untuk mencari tabel, klik simpul Tabel .
Dalam kotak Cari dalam kategori , ketik ekspresi pencarian untuk mencari artefak tertentu. Misalnya, untuk mencari tabel yang memiliki "Pelanggan" dalam namanya, ketik
%Customer%.Catatan
String pencarian peka huruf besar/kecil.
Untuk memulai pencarian, klik tombol dengan ikon panah kanan. Setelah pencarian selesai, kotak Kategori dan operasi yang tersedia mencantumkan artefak yang memenuhi kriteria pencarian.
Gambar berikut menunjukkan tabel SQL Server yang berisi "Pelanggan" dalam namanya.
Menghasilkan Skema untuk Proyek BizTalk
Anda dapat menggunakan Add-in Layanan Adapter Konsumsi atau Wizard Tambahkan Metadata Adapter untuk menghasilkan skema untuk artefak SQL Server yang dipilih. Setelah menelusuri dan mencari artefak yang ingin Anda panggil, Anda dapat menghasilkan skema untuk artefak tersebut dan mengirim pesan, sesuai dengan skema, untuk SQL Server.
Catatan
Anda dapat memilih simpul kategori untuk mengembalikan semua operasi di sub-pohon kategori tersebut—misalnya, Anda dapat memilih seluruh tabel (untuk menghasilkan skema untuk semua operasi dalam tabel) atau memilih operasi tertentu pada tabel (misalnya, Sisipkan dan Hapus) untuk menghasilkan skema hanya untuk operasi tersebut pada tabel. Untuk informasi selengkapnya tentang simpul, lihat ID Simpul Metadata.
Untuk menghasilkan skema untuk artefak SQL Server
Sambungkan ke SQL Server menggunakan Add-in Gunakan Layanan Adaptor atau Wizard Tambahkan Metadata Adapter. Lihat Menyambungkan ke SQL Server di Visual Studio menggunakan Add-in Gunakan Layanan Adaptor untuk instruksi.
Penting
Untuk menghasilkan skema untuk melakukan operasi menggunakan BizTalk Server, Anda harus mengatur properti pengikatan EnableBizTalkCompatibilityMode ke True. Anda harus mengatur properti pengikatan ini saat membuat koneksi ke database SQL Server.
Dari daftar Pilih jenis kontrak , pilih jenis kontrak berdasarkan apakah Anda menghasilkan skema untuk operasi masuk atau keluar.
Klik simpul kategori yang ingin Anda hasilkan metadatanya. Misalnya, jika Anda ingin membuat metadata untuk tabel, klik Tabel.
Perluas simpul kategori, dan pilih item tertentu dalam simpul yang ingin Anda hasilkan metadatanya. Misalnya, untuk menghasilkan metadata untuk operasi pada tabel "CustomerTable", perluas simpul Tabel , lalu klik CustomerTable.
Dalam kotak Kategori dan operasi yang tersedia, pilih operasi yang ingin Anda lakukan pada SQL Server, lalu klik Tambahkan. Operasi yang dipilih tercantum dalam kotak Kategori dan operasi yang ditambahkan . Misalnya, untuk melakukan operasi Sisipkan dan Pilih pada tabel "CustomerTable", klik nama operasi, lalu klik Tambahkan.
Gambar berikut menunjukkan Add-in Konsumsi Layanan Adapter, yang mencantumkan operasi yang dipilih.
Jika Anda ingin menghasilkan skema untuk beberapa operasi, mungkin ada beberapa definisi elemen duplikat di antara skema ini yang dapat menyebabkan kegagalan dalam mengkompilasi proyek BizTalk. Misalnya, pertimbangkan skenario di mana Anda menghasilkan skema untuk operasi "Op1". Skema untuk "Op1" berisi parameter jenis data "CT1". Setelah membuat skema untuk "Op1" Anda menutup Add-in Layanan Konsumsi Adaptor dan membukanya kembali untuk menghasilkan skema untuk operasi lain "Op2". Asumsikan bahwa "Op2" juga berisi parameter jenis data "CT1". Setelah Anda keluar dari Add-in Consume Adapter Service dan mengkompilasi proyek, Anda akan mendapatkan kesalahan kompilasi karena jenis data kompleks "CT1" didefinisikan dua kali dalam file XSD yang berbeda. Dalam situasi seperti itu, kami merekomendasikan hal-hal berikut:
Hasilkan skema untuk semua operasi dalam satu proses Add-in Konsumsi Layanan Adapter. Ini memastikan bahwa Add-in Consume Adapter Service hanya menghasilkan satu definisi untuk jenis data kompleks "CT1".
Jika Anda ingin menghasilkan skema untuk beberapa operasi di berbagai eksekusi Add-in Gunakan Layanan Adapter, pastikan Anda memilih kotak centang Hasilkan jenis skema unik , sehingga file XSD yang dihasilkan berisi namespace layanan unik untuk jenis data kompleks "CT1".
Klik OK. File skema disimpan dengan ekstensi .xsd di lokasi yang sama dengan proyek BizTalk.
Catatan
Jika Anda menggunakan Add-in Consume Adapter Service untuk menghasilkan metadata untuk artefak SQL Server, secara default file dibuat dengan konvensi penamaan tertentu. WSDL yang dihasilkan berisi tag anotasi fileNameHint yang menyertakan nama yang harus ditetapkan ke file XSD. Misalnya, petunjuk nama file untuk file skema untuk operasi tabel mengikuti konvensi TableOperation.<skema>.<nama> tabel. Jika Anda ingin mengkustomisasi nama file XSD yang dihasilkan, Anda dapat memberikan awalan dalam kotak Awalan nama file . Akhirnya, nama file XSD tiba sebagai awalan Nama file + fileNameHint + bilangan bulat unik (jika diperlukan, untuk memastikan bahwa nama file unik).
Catatan
Add-in Consume Adapter Service juga membuat file pengikatan (file XML) yang berisi properti pengikatan yang Anda tentukan saat membuat skema untuk operasi dan tindakan SOAP untuk memanggil operasi. Anda dapat mengimpor file pengikatan ini di konsol Administrasi BizTalk Server untuk membuat port WCF-Custom atau port adaptor BizTalk SQL dengan URI koneksi, properti pengikatan, dan set tindakan SOAP. Untuk informasi selengkapnya, lihat Mengonfigurasi pengikatan port fisik menggunakan file pengikatan port untuk menggunakan adaptor SQL.
Anda telah berhasil menghasilkan metadata untuk artefak SQL Server. Anda dapat menggunakan metadata untuk mengirim pesan ke SQL Server untuk melakukan operasi tertentu. Lihat Mengembangkan aplikasi BizTalk menggunakan adaptor SQL untuk informasi selengkapnya tentang cara melakukan operasi ini.
Membuat Klien WCF atau Kontrak Layanan WCF Menggunakan Plug-in Tambahkan Referensi Layanan Adapter
Anda dapat menggunakan Add Adapter Service Reference Plug-in untuk menghasilkan kode klien WCF untuk operasi keluar atau kode layanan WCF untuk operasi masuk.
Untuk menghasilkan kelas klien WCF atau kontrak layanan untuk operasi SQL Server
Di Plug-in Tambahkan Referensi Layanan Adapter, dari daftar drop-down Pilih jenis kontrak , pilih jenis kontrak berdasarkan apakah Anda akan melakukan operasi masuk atau keluar.
Telusuri atau cari kategori (seperti tabel database) atau untuk operasi tertentu yang ingin Anda buat klien WCF (atau kontrak layanan WCF).
Misalnya, untuk menelusuri operasi dalam tabel Karyawan, dalam kotak Pilih kategori :Perluas simpul akar (/) untuk melihat kategori di mana operasi muncul untuk database SQL Server.
Di bawah simpul akar, perluas simpul Tabel untuk melihat tabel yang tersedia.
Klik simpul tabel Karyawan , dan dalam kotak Kategori dan operasi yang tersedia , pilih operasi atau kategori yang ingin Anda buat klien WCF (atau kontrak layanan WCF), lalu klik Tambahkan. Operasi yang dipilih tercantum dalam kotak Kategori dan operasi yang ditambahkan .
Gambar berikut menunjukkan Plug-in Tambahkan Referensi Layanan Adapter dengan operasi Sisipkan dan Pilih untuk tabel Karyawan yang dipilih.
Penting
Bergantung pada operasi keluar (atau kategori) yang Anda pilih, lebih dari satu kelas klien WCF dapat dihasilkan. Untuk detail selengkapnya, lihat Membuat Klien WCF atau Kontrak Layanan WCF untuk Artefak SQL Server.
Untuk sebagian besar skenario, opsi serialisasi default sudah cukup; namun, jika diperlukan, Anda dapat mengontrol beberapa aspek tentang kode yang dihasilkan dan jenis serializer yang digunakan. Untuk mengatur opsi ini:
Klik Opsi Tingkat Lanjut untuk membuka kotak Opsi Tingkat Lanjut .
Dalam kotak Opsi Tingkat Lanjut di bawah Pilih opsi untuk proksi yang dihasilkan, pilih opsi yang Anda inginkan. Misalnya, Anda dapat memilih apakah metode asinkron dihasilkan untuk klien WCF atau menonaktifkan pembuatan file konfigurasi.
Di bawah Serializer pilih serializer yang harus digunakan.
Gambar berikut menunjukkan kotak Opsi Tingkat Lanjut dengan pilihan default (Otomatis dipilih untuk serializer dan tidak ada opsi lain yang dipilih).
Opsi yang dapat Anda konfigurasi dalam kotak Opsi Tingkat Lanjut setara dengan beberapa opsi yang tersedia saat Anda menggunakan Alat Utilitas Metadata ServiceModel (svcutil.exe). Untuk informasi selengkapnya tentang opsi ini, lihat Alat Utilitas Metadata ServiceModel (Svcutil.exe).
Klik OK. Plug-in Tambahkan Referensi Layanan Adapter menyimpan kelas klien WCF (atau antarmuka layanan WCF) dan kode pembantu untuk operasi dan kategori yang telah Anda pilih di direktori proyek Anda. Secara default, file konfigurasi juga disimpan. File yang sedikit berbeda dihasilkan untuk operasi masuk dan keluar; untuk informasi selengkapnya, lihat Membuat Klien WCF atau Kontrak Layanan WCF untuk Artefak SQL Server.
Anda dapat memilih simpul apa pun yang tercantum dalam kotak Kategori dan operasi yang tersedia . Jika Anda memilih simpul kategori, semua operasi yang tersedia di bawah simpul tersebut dan sub-simpulnya akan dipilih. Misalnya, untuk menghasilkan klien WCF untuk semua operasi yang muncul untuk tabel Karyawan, Anda dapat memilih simpul Karyawan.
Lihat juga
Mendapatkan metadata untuk operasi SQL Server di Visual Studio menggunakan adaptor SQL