Tugas Layanan Web
Berlaku untuk: SQL Server
SSIS Integration Runtime di Azure Data Factory
Tugas Layanan Web menjalankan metode layanan Web. Anda dapat menggunakan tugas Layanan Web untuk tujuan berikut:
Menulis ke variabel nilai yang dikembalikan metode layanan Web. Misalnya, Anda dapat memperoleh suhu tertinggi hari itu dari metode layanan Web, lalu menggunakan nilai tersebut untuk memperbarui variabel yang digunakan dalam ekspresi yang menetapkan nilai kolom.
Menulis ke file nilai yang dikembalikan oleh metode layanan Web. Misalnya, daftar calon pelanggan dapat ditulis ke file dan file kemudian digunakan sebagai sumber data dalam paket yang membersihkan data sebelum ditulis ke database.
WSDL File
Tugas Layanan Web menggunakan manajer koneksi HTTP untuk menyambungkan ke layanan Web. Manajer koneksi HTTP dikonfigurasi secara terpisah dari tugas Layanan Web, dan dirujuk dalam tugas. Manajer koneksi HTTP menentukan pengaturan proksi server seperti URL server, kredensial untuk mengakses server layanan Web, dan panjang waktu habis. Untuk informasi selengkapnya, lihat Pengelola Sambungan HTTP.
Penting
Manajer koneksi HTTP hanya mendukung autentikasi anonim dan autentikasi dasar. Ini tidak mendukung Autentikasi Windows.
Manajer koneksi HTTP dapat menunjuk ke situs Web atau ke file Web Service Description Language (WSDL). URL manajer koneksi HTTP yang menunjuk ke file WSDL menyertakan ?WSDL
parameter: misalnya, https://MyServer/MyWebService/MyPage.asmx?WSDL
.
File WSDL harus tersedia secara lokal untuk mengonfigurasi tugas Layanan Web menggunakan kotak dialog Editor Tugas Layanan Web yang disediakan SSIS Designer.
Jika manajer koneksi HTTP menunjuk ke situs Web, file WSDL harus disalin secara manual ke komputer lokal.
Jika manajer koneksi HTTP menunjuk ke file WSDL, file dapat diunduh dari situs Web ke file lokal oleh tugas Layanan Web.
File WSDL mencantumkan metode yang ditawarkan layanan Web, parameter input yang diperlukan metode, respons yang dikembalikan metode, dan cara berkomunikasi dengan layanan Web.
Jika metode menggunakan parameter input, tugas Layanan Web memerlukan nilai parameter. Misalnya, metode layanan Web yang merekomendasikan panjang ski yang harus Anda beli berdasarkan tinggi Anda mengharuskan tinggi Anda dikirimkan dalam parameter input. Nilai parameter dapat disediakan baik oleh string yang ditentukan dalam tugas, atau oleh variabel yang ditentukan dalam cakupan tugas atau kontainer induk. Keuntungan menggunakan variabel adalah mereka memungkinkan Anda memperbarui nilai parameter secara dinamis dengan menggunakan konfigurasi paket atau skrip. Untuk informasi selengkapnya, lihat Variabel Integration Services (SSIS) dan Konfigurasi Paket.
Banyak metode layanan Web tidak menggunakan parameter input. Misalnya, metode layanan Web yang mendapatkan nama presiden yang lahir pada bulan ini tidak akan memerlukan parameter input karena layanan Web dapat menentukan bulan ini secara lokal.
Hasil metode layanan Web dapat ditulis ke variabel atau ke file. Anda menggunakan manajer koneksi File baik untuk menentukan file atau untuk memberikan nama variabel untuk menulis hasilnya. Untuk informasi selengkapnya, lihat Variabel File Pengelola Sambungan dan Integration Services (SSIS).
Pesan Pengelogan Kustom Tersedia di Tugas Layanan Web
Tabel berikut ini mencantumkan entri log kustom yang bisa Anda aktifkan untuk tugas Layanan Web. Untuk informasi selengkapnya, lihat Pengelogan Integration Services (SSIS).
Entri log | Deskripsi |
---|---|
WSTaskBegin | Tugas mulai mengakses layanan Web. |
WSTaskEnd | Tugas menyelesaikan metode layanan Web. |
WSTaskInfo | Informasi deskriptif tentang tugas. |
Konfigurasi Tugas Layanan Web
Anda dapat mengatur properti melalui SSIS Designer atau secara terprogram.
Untuk informasi selengkapnya tentang properti yang bisa Anda atur di SSIS Designer, klik topik berikut:
Untuk informasi selengkapnya tentang cara mengatur properti ini di SSIS Designer, klik topik berikut:
Konfigurasi Terprogram Tugas Layanan Web
Untuk informasi selengkapnya tentang mengatur properti ini secara terprogram, klik salah satu topik berikut:
Editor Tugas Layanan Web (Halaman Umum)
Gunakan halaman Umum kotak dialog Editor Tugas Layanan Web untuk menentukan manajer koneksi HTTP, tentukan lokasi file Web Services Description Language (WSDL) yang digunakan tugas Layanan Web, jelaskan tugas Layanan Web, dan unduh file WSDL.
Opsi
HTTPConnection
Pilih manajer koneksi dalam daftar, atau klik <Koneksi baru...> untuk membuat pengelola koneksi baru.
Penting
Manajer koneksi HTTP hanya mendukung autentikasi anonim dan autentikasi dasar. Ini tidak mendukung Autentikasi Windows.
Topik Terkait:Pengelola Sambungan HTTP, Editor Pengelola Sambungan HTTP (Halaman Server)
WSDLFile
Ketik jalur yang sepenuhnya memenuhi syarat dari file WSDL yang bersifat lokal ke komputer, atau klik tombol telusuri (...) dan temukan file ini.
Jika Anda telah mengunduh file WSDL secara manual ke komputer, pilih file ini. Namun, jika file WSDL belum diunduh, ikuti langkah-langkah berikut:
Buat file kosong yang memiliki ekstensi nama file ".wsdl".
Pilih file kosong ini untuk opsi WSDLFile .
Atur nilai OverwriteWSDLFile ke True untuk memungkinkan file kosong ditimpa dengan file WSDL yang sebenarnya.
Klik Unduh WSDL untuk mengunduh file WSDL aktual dan timpa file kosong.
Catatan
Opsi Unduh WSDL tidak diaktifkan sampai Anda memberikan nama file lokal yang ada di kotak WSDLFile .
OverwriteWSDLFile
Tunjukkan apakah file WSDL untuk tugas Layanan Web dapat ditimpa.
Jika Anda ingin mengunduh file WSDL dengan menggunakan tombol Unduh WSDL , atur nilai ini ke True.
Nama
Berikan nama unik untuk tugas Layanan Web. Nama ini digunakan sebagai label dalam ikon tugas.
Catatan
Nama tugas harus unik dalam paket.
Keterangan
Ketik deskripsi tugas Layanan Web.
Unduh WSDL
Unduh file WSDL.
Tombol ini tidak diaktifkan sampai Anda memberikan nama file lokal yang ada di kotak WSDLFile .
Editor Tugas Layanan Web (Halaman Input)
Gunakan halaman Input dari kotak dialog Editor Tugas Layanan Web untuk menentukan Layanan Web, metode Web, dan nilai yang akan disediakan ke metode Web sebagai input. Nilai dapat disediakan baik dengan mengetik string langsung di kolom Nilai, atau dengan memilih variabel di kolom Nilai.
Opsi
Layanan
Pilih layanan Web dari daftar yang akan digunakan untuk menjalankan metode Web.
Metode
Pilih metode Web dari daftar untuk tugas yang akan dijalankan.
WebMethodDocumentation
Ketik deskripsi metode Web, atau klik tombol telusuri (...) lalu ketik deskripsi dalam kotak dialog Dokumentasi Metode Web.
Nama
Mencantumkan nama input ke metode Web.
Jenis
Mencantumkan jenis data input.
Catatan
Tugas Layanan Web hanya mendukung parameter dari jenis data berikut: jenis primitif seperti bilangan bulat dan string; array dan urutan jenis primitif; dan enumerasi.
Variabel
Pilih kotak centang untuk menggunakan variabel untuk menyediakan input.
Nilai
Jika kotak centang Variabel dipilih, pilih variabel dalam daftar untuk memberikan input; jika tidak, ketik nilai yang akan digunakan dalam input.
Editor Tugas Layanan Web (Halaman Output)
Gunakan halaman Output dari kotak dialog Editor Tugas Layanan Web untuk menentukan tempat menyimpan hasil yang dikembalikan oleh metode Web.
Opsi Statis
OutputType
Pilih jenis penyimpanan yang akan digunakan saat menyimpan hasilnya. Properti ini memiliki opsi yang tercantum dalam tabel berikut.
Nilai | Deskripsi |
---|---|
Koneksi File | Simpan hasil dalam file. Memilih nilai ini menampilkan opsi dinamis, File. |
Variabel | Simpan hasilnya dalam variabel. Memilih nilai ini menampilkan opsi dinamis, Variabel. |
Opsi Dinamis OutputType
OutputType = Koneksi File
File
Pilih manajer koneksi File dalam daftar atau klik <Koneksi Baru...> untuk membuat pengelola koneksi baru.
Topik Terkait: File Pengelola Sambungan, File Pengelola Sambungan Editor
OutputType = Variabel
Variabel
Pilih variabel dalam daftar atau klik <Variabel Baru...> untuk membuat variabel baru.
Topik Terkait:Variabel Integration Services (SSIS), Tambahkan Variabel
Konten Terkait
Video, Cara: Memanggil Layanan Web dengan Menggunakan Tugas Layanan Web (Video SQL Server), di technet.microsoft.com.