Tugas Layanan Web

Berlaku untuk: SQL Server (semua versi yang didukung) Integration Runtime SSIS di Azure Data Factory

Tugas Layanan Web menjalankan metode layanan Web. Anda bisa menggunakan tugas Layanan Web untuk tujuan berikut:

  • Menulis ke variabel nilai yang dikembalikan metode layanan Web. Misalnya, Anda bisa mendapatkan 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 metode layanan Web. Misalnya, daftar pelanggan potensial 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 lingkup tugas atau kontainer induk. Keuntungan menggunakan variabel adalah memungkinkan Anda memperbarui nilai parameter secara dinamis dengan menggunakan konfigurasi atau skrip paket. 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-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 pengelola 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 ini:

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 pengelola 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 yang sebenarnya dan timpa file kosong.

    Catatan

    Opsi Unduh WSDL tidak diaktifkan sampai Anda memberikan nama file lokal yang ada di kotak WSDLFile .

OverwriteWSDLFile
Menunjukkan 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.

Deskripsi
Ketik deskripsi tugas Layanan Web.

Unduh WSDL
Unduh file WSDL.

Tombol ini tidak diaktifkan sampai Anda memberikan nama file lokal yang ada dalam 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 memberikan 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 ini.

Nilai Deskripsi
Koneksi File Simpan hasilnya 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:Pengelola Sambungan File, Editor Pengelola Sambungan File

OutputType = Variabel

Variabel
Pilih variabel dalam daftar atau klik <Variabel Baru...> untuk membuat variabel baru.

Topik Terkait:Variabel Integration Services (SSIS),Tambahkan Variabel

Video, Cara: Memanggil Layanan Web dengan Menggunakan Tugas Layanan Web (SQL Server Video), di technet.microsoft.com.