Membuat umpan data dari laporan (Pembuat Laporan)

Ekstensi penyajian Atom Reporting Services menghasilkan dokumen layanan Atom yang mencantumkan umpan data yang tersedia dari laporan paginated dan umpan data dari wilayah data dalam laporan. Anda menggunakan ekstensi ini untuk menghasilkan umpan data yang mematuhi Atom yang dapat dibaca dan dapat dipertukarkan dengan aplikasi yang dapat menggunakan umpan data yang dihasilkan dari laporan. Misalnya, Anda dapat menggunakan ekstensi rendering Atom untuk menghasilkan umpan data yang kemudian dapat Anda gunakan di Power Pivot atau Power BI.

Dokumen layanan Atom mencantumkan setidaknya satu umpan data untuk setiap wilayah data dalam laporan. Bergantung pada jenis wilayah data dan data yang ditampilkan wilayah data, Reporting Services mungkin menghasilkan beberapa umpan data dari wilayah data. Misalnya, matriks atau bagan dapat menyediakan beberapa umpan data. Saat ekstensi penyajian Atom membuat dokumen layanan Atom, pengidentifikasi unik dibuat untuk setiap umpan data dan Anda menggunakan pengidentifikasi di URL untuk mengakses konten umpan data.

Cara ekstensi rendering Atom menghasilkan data untuk umpan data mirip dengan cara ekstensi rendering Comma-Separated Value (CSV) merender data ke file CSV. Seperti file CSV, umpan data adalah representasi data laporan yang diratakan. Misalnya, tabel dengan grup baris yang menjumlahkan penjualan dalam grup mengulangi jumlah di setiap baris data dan tidak ada baris terpisah yang hanya berisi jumlah.

Anda dapat membuat dokumen layanan Atom dan umpan data menggunakan portal web Reporting Services, Server Laporan, atau situs SharePoint yang terintegrasi dengan Reporting Services.

Atom berlaku untuk sepasang standar terkait. Dokumen layanan Atom sesuai dengan spesifikasi protokol penerbitan RFC 5023 Atom dan umpan data sesuai dengan spesifikasi protokol format sindikasi RFC 4287 Atom.

Bagian berikut ini menyediakan informasi tambahan tentang cara menggunakan ekstensi penyajian Atom:

Anda dapat membuat dan memodifikasi file definisi laporan yang dipaginasi (.rdl) di Microsoft Report Builder, Power BI Report Builder, dan di Perancang Laporan di SQL Server Data Tools.

Laporan sebagai umpan data

Anda dapat mengekspor laporan produksi sebagai umpan data atau Anda dapat membuat laporan yang tujuan utamanya adalah menyediakan data, dalam bentuk umpan data, ke aplikasi. Dengan menggunakan laporan sebagai umpan data, Anda memiliki cara lain untuk menyediakan data ke aplikasi ketika data tidak mudah diakses melalui penyedia data klien. Atau, Anda dapat menggunakannya sebagai umpan data saat Anda lebih suka menyembunyikan kompleksitas sumber data dan mempermudah penggunaan data. Manfaat lain menggunakan data laporan sebagai umpan data adalah Anda dapat menggunakan fitur Reporting Services. Fitur-fitur ini termasuk keamanan, penjadwalan, dan rekam jepret laporan untuk mengelola laporan yang menyediakan umpan data.

Untuk mendapatkan hasil maksimal dari ekstensi rendering Atom, Anda harus memahami bagaimana laporan dirender ke dalam umpan data. Jika Anda menggunakan laporan yang ada, dapat memprediksi umpan data apa yang dihasilkan laporan berguna. Jika Anda menulis laporan khusus untuk digunakan sebagai umpan data, dapat menyertakan data dan menyempurnakan tata letak laporan untuk memaksimalkan kegunaan umpan data sangat berharga.

Untuk informasi selengkapnya, lihat Membuat umpan data dari laporan (Pembuat Laporan dan SSRS).

Dokumen layanan Atom (file.atomsvc)

Dokumen layanan Atom menentukan koneksi ke satu atau beberapa umpan data. Minimal, koneksi adalah URL sederhana ke layanan data yang menghasilkan umpan.

Saat Anda merender data laporan dengan menggunakan ekstensi penyajian Atom, dokumen layanan Atom mencantumkan umpan data yang tersedia untuk laporan. Dokumen mencantumkan setidaknya satu umpan data untuk setiap wilayah data dalam laporan. Tabel dan pengukur hanya menghasilkan satu umpan data masing-masing, tetapi matriks, daftar, dan bagan mungkin menghasilkan beberapa umpan, tergantung pada data yang ditampilkan.

Diagram berikut menunjukkan laporan yang menggunakan dua tabel dan bagan.

Dokumen layanan Atom yang dihasilkan dari laporan ini mencakup tiga umpan data, satu untuk setiap tabel dan satu untuk bagan.

Wilayah data matriks mungkin memiliki lebih dari satu umpan data, tergantung pada struktur matriks. Diagram berikut menunjukkan laporan yang menggunakan matriks yang menghasilkan dua umpan data.

Dokumen layanan Atom yang dihasilkan dari laporan ini mencakup dua umpan data, satu untuk setiap kolom serekan dinamis: Wilayah dan Tahun. Diagram berikut menunjukkan konten setiap umpan data.

Umpan data

Umpan data adalah file XML yang memiliki format tabular konsisten yang tidak berubah dari waktu ke waktu dan data variabel yang dapat berbeda setiap kali laporan dijalankan. Umpan data yang dihasilkan oleh Reporting Services berada dalam format yang sama dengan umpan yang dihasilkan oleh ADO.NET Data Services tersebut.

Umpan data berisi dua bagian: header dan data. Spesifikasi Atom mendefinisikan elemen di setiap bagian. Header menyertakan informasi seperti skema pengodean karakter untuk digunakan dengan umpan data.

Bagian header

Kode XML berikut menunjukkan bagian header umpan data.

<?xml version="1.0" encoding="utf-8" standalone="yes"?><feed xmlns:d="https://schemas.microsoft.com/ado/2007/08/dataservices" xmlns:m="https://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns="http://www.w3.org/2005/Atom">

<title type="text"></title>

<id>uuid:1795992c-a6f3-40ec-9243-fbfd0b1a5be3;id=166321</id>

<updated>2009-05-08T23:09:58Z</updated>

Bagian data

Bagian data umpan data berisi satu <entry> elemen untuk setiap baris dalam himpunan baris yang diratakan yang dihasilkan oleh ekstensi rendering Atom.

Diagram berikut menunjukkan laporan yang menggunakan grup dan total.

XML berikut ini memperlihatkan <entry> elemen dari laporan tersebut dalam umpan data. Perhatikan bahwa <entry> elemen mencakup total penjualan dan pesanan untuk grup dan total penjualan dan pesanan untuk semua grup. Elemen ini <entry> mencakup semua nilai pada laporan.

<entry><id>uuid:1795992c-a6f3-40ec-9243-fbfd0b1a5be3;id=166322</id><title type="text"></title><updated>2009-05-08T23:09:58Z</updated><author /><content type="application/xml"><m:properties>

<d:ProductCategory_Value>Accessories</d:ProductCategory_Value>

<d:OrderYear_Value m:type="Edm.Int32">2001</d:OrderYear_Value>

<d:SumLineTotal_Value m:type="Edm.Decimal">20235.364608</d:SumLineTotal_Value>

<d:SumOrderQty_Value m:type="Edm.Int32">1003</d:SumOrderQty_Value>

<d:SumLineTotal_Total_2_1 m:type="Edm.Decimal">1272072.883926</d:SumLineTotal_Total_2_1>

<d:SumOrderQty_Total_2_1 m:type="Edm.Double">61932</d:SumOrderQty_Total_2_1>

<d:SumLineTotal_Total_2_2 m:type="Edm.Decimal">109846381.399888</d:SumLineTotal_Total_2_2>

<d:SumOrderQty_Total_2_2 m:type="Edm.Double">274914</d:SumOrderQty_Total_2_2></m:properties></content>

</entry>

Bekerja dengan umpan data

Semua umpan data yang dihasilkan oleh laporan menyertakan item laporan yang berada dalam cakupan induk wilayah data yang menghasilkan umpan data. Bayangkan laporan yang memiliki beberapa tabel dan bagan. Kotak teks di isi laporan menyediakan teks deskriptif dari setiap wilayah data. Setiap entri di setiap umpan data yang dihasilkan laporan menyertakan nilai kotak teks. Misalnya, jika teks adalah "Bagan menampilkan rata-rata penjualan bulanan menurut wilayah penjualan", ketiga umpan data akan menyertakan teks ini pada setiap baris.

Jika tata letak laporan menyertakan hubungan data hierarkis, seperti wilayah data berlapis, hubungan tersebut disertakan dalam kumpulan baris data laporan yang diratakan.

Baris data untuk wilayah data berlapis biasanya lebar, terutama jika tabel dan matriks berlapis mencakup grup dan total. Anda mungkin merasa berguna untuk mengekspor laporan ke umpan data dan melihat umpan data untuk memverifikasi bahwa data yang dihasilkan adalah apa yang Anda harapkan.

Saat ekstensi penyajian Atom membuat dokumen layanan Atom, pengidentifikasi unik dibuat untuk umpan data dan Anda menggunakan pengidentifikasi di URL untuk melihat konten umpan data. Contoh dokumen layanan Atom, yang ditunjukkan sebelumnya, menyertakan URL https://ServerName/ReportServer?%2fProduct+Sales+Summary&rs%3aCommand=Render&rs%3aFormat=ATOM&rc%3aItemPath=Tablix1. URL mengidentifikasi laporan (Ringkasan Penjualan Produk), format penyajian Atom (ATOM), dan nama item laporan (Tablix1).

Nama item laporan default ke nama elemen bahasa definisi laporan (RDL) dari item laporan dan sering kali tidak intuitif atau mudah diingat. Misalnya, nama default matriks pertama yang ditempatkan dalam laporan adalah Tablix1. Umpan data menggunakan nama-nama ini.

Untuk membuat umpan data lebih mudah dikerjakan, Anda dapat menggunakan properti DataElementName dari wilayah data untuk memberikan nama yang mudah diingat. Jika Anda memberikan nilai untuk DataElementName, subelemen <d> umpan data yang digunakan adalah sebagai ganti nama wilayah data default. Misalnya, jika nama default wilayah data adalah dan diatur, maka <d> di umpan data menggunakan SalesByTerritoryYear.SalesByTerritoryYearDataElementNameTablix1 Jika wilayah data memiliki dua umpan data seperti laporan matriks yang dijelaskan sebelumnya, nama yang digunakan dalam umpan data adalah SalesByTerritoryYear _Territory dan SalesByTerritoryYear _Year.

Jika Anda membandingkan data yang ditampilkan pada laporan dan data di umpan data, Anda mungkin melihat beberapa perbedaan. Laporan sering menunjukkan data numerik dan waktu/tanggal yang diformat, sedangkan umpan data berisi data yang tidak diformat.

Umpan data disimpan dengan .atom ekstensi nama file. Anda dapat menggunakan editor teks atau XML seperti Notepad atau Editor XML untuk melihat struktur dan konten file.

Meratakan data laporan

Perender Atom menyediakan data laporan sebagai himpunan baris yang diratakan dalam format XML. Aturan untuk meratakan tabel data sama dengan aturan perender CSV tersebut dengan beberapa pengecualian:

• Item dalam cakupan diratakan ke tingkat detail. Tidak seperti perender CSV, kotak teks di tingkat atas muncul di setiap entri yang ditulis ke umpan data.

• Nilai parameter laporan dirender pada setiap baris output.

Data hierarkis dan yang dikelompokkan harus diratakan agar diwakili dalam format yang sesuai dengan Atom. Ekstensi penyajian meratakan laporan ke dalam struktur pohon yang mewakili grup berlapis dalam wilayah data. Saat Anda meratakan laporan, hasil berikut terjadi:

• Hierarki baris diratakan sebelum hierarki kolom.

• Anggota hierarki baris dirender ke umpan data sebelum anggota hierarki kolom.

• Kolom diurutkan sebagai berikut: kotak teks dalam urutan isi kiri-ke-kanan, atas-ke-bawah diikuti oleh wilayah data yang diurutkan kiri-ke-kanan, atas-ke-bawah.

• Kolom dalam wilayah data diurutkan sebagai berikut: anggota sudut, anggota hierarki baris, anggota hierarki kolom, lalu sel.

• Wilayah data serekan adalah wilayah data atau grup dinamis yang berbagi wilayah data umum atau leluhur dinamis. Data serekan diidentifikasi dengan percabangan pohon yang diratakan.

Untuk informasi selengkapnya, lihat Tabel, matriks, dan daftar (Pembuat Laporan dan SSRS).

Aturan penyajian atom

Ekstensi penyajian Atom mengabaikan informasi berikut saat merender umpan data:

• Pemformatan dan tata letak

• Header halaman

• Footer halaman

• Item laporan kustom

• Persegi panjang

• Garis

• Gambar

• Subtotal otomatis

Item laporan yang tersisa diurutkan, dari atas ke bawah, lalu kiri ke kanan. Setiap item kemudian dirender ke kolom. Jika laporan memiliki item data berlapis seperti daftar atau tabel, item induk diulang pada setiap baris.

Tabel berikut menunjukkan tampilan item laporan saat dirender:

Item	Perilaku penyajian
Tabel	Merender dengan memperluas tabel dan membuat baris dan kolom untuk setiap baris dan kolom pada tingkat detail terendah. Baris dan kolom subtotal tidak memiliki judul kolom atau baris. Laporan penelusuran tidak didukung.
Matrix	Merender dengan memperluas matriks dan membuat baris dan kolom untuk setiap baris dan kolom pada tingkat detail terendah. Baris dan kolom subtotal tidak memiliki judul kolom atau baris.
List	Merender rekaman untuk setiap baris atau instans detail dalam daftar.
Sublaporan	Item induk diulang untuk setiap instans konten.
Grafik	Merender rekaman dengan semua label bagan untuk setiap nilai bagan. Label dari seri dan kategori dalam hierarki diratakan dan disertakan dalam baris untuk nilai bagan.
Bilah data	Merender seperti bagan. Biasanya, bilah data tidak menyertakan hierarki atau label.
Grafik mini	Merender seperti bagan. Biasanya, grafik mini tidak menyertakan hierarki atau label.
Pengukur	Merender sebagai rekaman tunggal dengan nilai minimum dan maksimum skala linier, nilai awal dan akhir rentang, dan nilai penunjuk.
Indikator	Merender sebagai rekaman tunggal dengan nama status aktif, status yang tersedia, dan nilai data.
Peta	Menghasilkan umpan data untuk setiap wilayah data peta. Jika beberapa lapisan peta menggunakan wilayah data yang sama, umpan data menyertakan semuanya. Umpan data menyertakan rekaman dengan label dan nilai untuk setiap anggota peta lapisan peta.

Pengaturan informasi perangkat

Anda dapat mengubah beberapa pengaturan default untuk perender ini, termasuk skema pengodean yang akan digunakan. Untuk informasi selengkapnya, lihat Pengaturan informasi perangkat ATOM.

Konten terkait

• Mengekspor ke file CSV
• Mengekspor laporan

Ada pertanyaan lagi? Coba tanyakan forum Reporting Services.