Peran SOAP dalam layanan pelaporan

Layanan Web Server Laporan menggunakan pesan Simple Object Access Protocol (SOAP) untuk mengirim perintah berbasis teks melalui jaringan. Perintah ini mengambil bentuk teks XML yang dikirim melalui World Wide Web menggunakan HTTP. Dengan menggunakan SOAP sebagai protokol komunikasinya, layanan Web Server Laporan memungkinkan aplikasi dan komponen untuk bertukar data dengan server laporan menggunakan infrastruktur yang terbuka dan diterima secara luas. Standar SOAP didefinisikan pada www.w3.org/TR/SOAP.

Aplikasi klien apa pun dapat bertindak sebagai klien SOAP selama itu sadar SOAP dan dapat mengirim permintaan SOAP. Manajer Laporan adalah salah satu klien SOAP tersebut. Ini menyediakan antarmuka ke database server laporan tempat semua laporan dan konten terkait laporan disimpan. Pengguna akhir dapat menggunakan aplikasi untuk menelusuri dan mengelola laporan dan folder di namespace server laporan. Manajer Laporan dibangun di atas infrastruktur layanan Web Server Laporan.

Server laporan bertindak sebagai server SOAP, layanan sadar SOAP yang dapat menerima permintaan dari klien SOAP dan membuat respons yang sesuai. Server menangani permintaan dan mengirim respons yang dikodekan kembali ke klien.

Pesan SOAP di Reporting Services mengambil berbagai bentuk, tergantung pada jenis permintaan yang dibuat oleh klien. Contoh berikut mewakili permintaan klien SOAP sederhana untuk menghapus item dari database server laporan.

<soap:Envelope xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">  
    <soap:Body>  
        <DeleteItem xmlns="http://www.microsoft.com/sql/ReportingServer">  
            <item>/Samples/Report1</item>  
        </DeleteItem>  
    </soap:Body>  
</soap:Envelope>  

SOAP itu sendiri mengharuskan pesan dimasukkan ke dalam elemen Amplop , dengan sebagian besar pesan di dalam elemen Isi . Dalam contoh ini, isi berisi panggilan ke DeleteItem metode , yang mengambil parameter string yang mewakili jalur item untuk dihapus. Anda dapat membuat kelas proksi klien Microsoft .NET Framework yang merangkum semua operasi SOAP ke dalam metode. Metode Microsoft C# berikut mewakili contoh SOAP yang diberikan sebelumnya.

public void DeleteItem(string item);  

Respons dari server mungkin terlihat seperti contoh berikut:

<soap:Envelope xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">  
    <soap:Body>  
        <DeleteItemResponse xmlns="http://www.microsoft.com/sql/ReportingServer" />  
    </soap:Body>  
</soap:Envelope>  

Metode DeleteItem ini tidak memiliki nilai pengembalian, sehingga respons kosong dikembalikan.

Konten terkait

Mengakses SOAP API
Manajer Laporan (Mode Asli SSRS)
Server Laporan Reporting Services
Layanan Web Server Laporan