Jenis Koneksi xml (SSRS)

Untuk menyertakan data dari sumber data XML dalam laporan, Anda harus memiliki himpunan data yang didasarkan pada sumber data laporan jenis XML. Jenis sumber data bawaan ini didasarkan pada ekstensi data XML. Gunakan jenis sumber data ini untuk menyambungkan dan mengambil data dari dokumen XML, layanan Web, atau XML yang disematkan dalam kueri.

Ekstensi data ini mendukung parameter dan kredensial yang dikelola secara terpisah dari string koneksi.

Gunakan informasi dalam topik ini untuk membangun sumber data. Untuk instruksi langkah demi langkah, lihat Menambahkan dan Memverifikasi Koneksi data (Pembuat Laporan dan SSRS).

String Koneksi

string koneksi harus berupa URL yang menunjuk ke layanan Web, aplikasi berbasis Web, atau dokumen XML yang tersedia melalui HTTP. Dokumen XML harus memiliki ekstensi XML. Anda juga bisa menggunakan string koneksi kosong untuk data XML yang disematkan dalam kueri himpunan data.

Contoh berikut mengilustrasikan sintaks string koneksi untuk layanan Web dan dokumen XML. Protokol file:// tidak didukung.

Jenis dokumen XML	Contoh String Koneksi ion
Layanan web	https://adventure-works.com/results.aspx
Dokumen XML	https://localhost/XML/Customers.xml
Dokumen XML yang disematkan	Kosong

Untuk contoh string koneksi lainnya, lihat String Koneksi data, Sumber Data, dan Koneksi ion di Pembuat Laporan.

Kredensial

Kredensial diperlukan untuk menjalankan kueri, untuk mempratinjau laporan secara lokal, dan untuk mempratinjau laporan dari server laporan.

Setelah menerbitkan laporan, Anda mungkin perlu mengubah kredensial untuk sumber data sehingga ketika laporan berjalan di server laporan, izin untuk mengambil data valid.

Dari klien penulisan laporan, opsi berikut tersedia untuk menentukan kredensial:

• Pengguna Windows saat ini (juga dikenal sebagai keamanan terintegrasi).

• Tidak diperlukan kredensial. Jika Anda tidak memilih kredensial, akses Anonim akan digunakan. Pastikan Anda telah menentukan akun eksekusi yang tidak dijaga agar server laporan tersambung ke sumber data eksternal. Ekstensi pemrosesan data XML tidak meneruskan kredensial ke URL target atau layanan Web; koneksi tidak akan berhasil kecuali Anda telah menentukan akun eksekusi yang tidak diawasi. Untuk informasi selengkapnya, lihat Mengonfigurasi Akun Eksekusi Tanpa Pengawas (Manajer Konfigurasi Server Laporan).

Kredensial yang disimpan dan diminta tidak didukung. Ingatlah bahwa jika Anda menonaktifkan keamanan terintegrasi Windows, Anda tidak dapat menggunakannya untuk mengambil data. Jika Anda menentukan kredensial yang disimpan atau diminta, kesalahan akan terjadi pada waktu proses.

Untuk informasi selengkapnya, lihat Membuat string koneksi data - Pembuat Laporan & SSRS atau Menentukan Informasi Kredensial dan Koneksi untuk Sumber Data Laporan.

Kueri

Kueri menentukan data mana yang akan diambil untuk himpunan data laporan. Kolom dalam kumpulan hasil untuk kueri mengisi kumpulan bidang untuk himpunan data. Laporan hanya memproses kumpulan hasil pertama yang diambil oleh kueri.

Anda harus menggunakan perancang kueri berbasis teks untuk membuat kueri. Kueri harus mengembalikan data XML.

Untuk informasi selengkapnya tentang perancang kueri berbasis teks, lihat Antarmuka Pengguna Desainer Kueri berbasis teks (Pembuat Laporan).

Nilai yang mungkin untuk kueri himpunan data untuk sumber data yang merupakan jenis XML diperlihatkan di bawah ini.

• Kosong

  Gunakan kueri kosong untuk membuat tataan hasil default. Kueri default dibuat dengan membaca sumber data dan melintas hierarki simpul XML ke koleksi daun pertama. Tataan hasil mencakup semua simpul dengan nilai teks dan semua atribut simpul di sepanjang jalur tersebut. Kolom dalam kumpulan hasil dipetakan ke bidang untuk himpunan data.

• Jalur elemen

  Menentukan urutan simpul yang akan digunakan saat mengambil data XML dari sumber data.

• Elemen Kueri XML

  Spesifikasi kueri XML dengan elemen opsional berikut:

  • Sumber data XML adalah layanan Web

    Elemen XML yang diperlukan:

    <Method Namespace="namespace"Name="MethodName" />

    -- or --

    <SoapAction>tindakan sabun</SoapAction>

    Elemen XML Opsional:

    <ElementPath>jalur elemen</ElementPath>

    <Method Namespace="namespace"Name="MethodName" />

    -- or --

    <SoapAction>tindakan sabun</SoapAction>

  • Sumber data XML adalah dokumen XML

    Elemen XML yang diperlukan: Tidak ada

    Elemen XML Opsional:

    <ElementPath>jalur elemen</ElementPath>

  • Sumber data XML adalah dokumen XML yang disematkan

    Elemen XML yang diperlukan:

    <XmlData> XML dalam </XmlData>

    Elemen XML Opsional:

    <ElementPath>jalur elemen</ElementPath>

    -- or --

    <ElementPath IgnoreNamespaces="true">jalur elemen</ElementPath>

Untuk informasi selengkapnya tentang sintaks kueri, lihat Sintaks Kueri XML untuk Data Laporan XML (SSRS).

Misalnya, lihat Layanan Pelaporan: Menggunakan XML dan Sumber Data Layanan Web.

Persyaratan untuk Mengambil Data Layanan Web XML

Ekstensi pemrosesan data XML tidak mendeteksi skema untuk Anda. Oleh karena itu, Anda harus memiliki beberapa cara untuk menemukan metode SOAP mana yang akan mengambil data yang Anda inginkan. Anda juga harus memahami skema alamat atau namespace layanan Web yang digunakan untuk datanya.

Untuk layanan Web, Anda bisa menyediakan <elemen Kueri> yang menentukan metode untuk memanggil atau tindakan SOAP. Anda bisa membiarkan kueri kosong dan menggunakan kueri default jika sumber data XML memiliki struktur hierarkis yang menghasilkan data yang ingin Anda gunakan untuk laporan Anda. Nilai dan atribut simpul elemen XML yang diambil saat kueri menjalankan peta ke bidang himpunan data yang Anda gunakan dalam laporan Anda.

Persyaratan untuk Mengambil Data Dokumen XML

Dengan menggunakan protokol http, server harus mengembalikan data XML atau data XML harus disematkan dalam elemen Kueri XML. Jika Anda merujuk ke dokumen XML secara langsung menggunakan protokol http, ekstensi harus .xml.

Anda harus tahu cara membuat kueri XML yang mengambil semua data yang Anda butuhkan. Jika Anda tidak menentukan jalur elemen, perilaku default untuk mengurai dokumen XML adalah memilih jalur pertama yang tersedia ke kumpulan simpul daun di dokumen XML. Jika dokumen XML menyertakan jalur tambahan ke koleksi simpul daun saudara lainnya, simpul tersebut akan diabaikan kecuali Anda menentukan jalur dalam kueri Anda.

Anda dapat menyediakan jalur elemen menggunakan sintaks XML yang mirip dengan XQuery.

Untuk informasi selengkapnya, lihat Sintaks Jalur Elemen untuk Data Laporan XML (SSRS).

Parameter

Kueri tidak dianalisis untuk mengidentifikasi parameter.

Untuk menambahkan parameter, Anda harus membuatnya secara manual melalui halaman Parameter pada kotak dialog Properti Himpunan Data.

Keterangan

Ekstensi data XML mendukung pelaporan dari data XML yang bersifat tabular dan tidak hierarkis. Untuk informasi selengkapnya, lihat Menambahkan Data dari Sumber Data Eksternal (SSRS).

Tidak ada dukungan bawaan untuk mengambil dokumen XML dari database SQL Server.

Topik Cara Penggunaan

Bagian ini berisi instruksi langkah demi langkah untuk bekerja dengan koneksi data, sumber data, dan himpunan data.

Menambahkan dan Memverifikasi Koneksi data (Pembuat Laporan dan SSRS)

Membuat Himpunan Data Bersama atau Himpunan Data Tersemat (Pembuat Laporan dan SSRS)

Menambahkan Filter ke Himpunan Data (Pembuat Laporan dan SSRS)

Bagian Terkait

Bagian dokumentasi ini memberikan informasi konseptual mendalam tentang data laporan, serta informasi prosedural tentang cara menentukan, menyesuaikan, dan menggunakan bagian dari laporan yang terkait dengan data.

Himpunan Data Laporan (SSRS)
Memberikan gambaran umum tentang mengakses data untuk laporan Anda.

Membuat string koneksi data - Pembuat Laporan & SSRS
Menyediakan informasi tentang koneksi data dan sumber data.

Melaporkan Himpunan Data tersemat dan Himpunan Data Bersama (Pembuat Laporan dan SSRS)
Menyediakan informasi tentang himpunan data yang disematkan dan dibagikan.

Pengumpulan Bidang Himpunan Data (Pembuat Laporan dan SSRS)
Menyediakan informasi tentang kumpulan bidang himpunan data yang dihasilkan oleh kueri.

Sumber Data Didukung oleh Reporting Services (SSRS).
Menyediakan informasi mendalam tentang dukungan platform dan versi untuk setiap ekstensi data.

Lihat Juga

Parameter Laporan (Pembuat Laporan dan Perancang Laporan)
Filter, Grup, dan Urutkan Data (Pembuat Laporan dan SSRS)
Ekspresi (Pembuat Laporan dan SSRS)