Parameter laporan dalam Power BI Report Builder

BERLAKU UNTUK: Power BI Report Builder Power BI Desktop

Artikel ini menjelaskan penggunaan umum untuk parameter laporan Pembangun Laporan Power BI, properti yang bisa Anda atur, dan banyak lagi. Parameter laporan memungkinkan Anda mengontrol data laporan, menyambungkan laporan terkait bersama-sama, dan memvariasikan presentasi laporan. Anda dapat menggunakan parameter laporan dalam laporan paginasi yang Anda buat di Pembuat Laporan.

Penggunaan umum untuk parameter

Berikut adalah beberapa cara paling umum untuk menggunakan parameter.

Mengontrol data laporan paginasi:

• Filter data laporan paginasi di sumber data dengan menulis kueri himpunan data yang berisi variabel.

• Perbolehkan pengguna menentukan nilai untuk mengkustomisasi data dalam laporan paginated. Misalnya, berikan dua parameter untuk tanggal mulai dan tanggal selesai untuk data penjualan.

Presentasi laporan yang bervariasi:

• Perbolehkan pengguna menentukan nilai untuk membantu mengkustomisasi tampilan laporan. Misalnya, berikan parameter Boolean untuk menunjukkan apakah akan memperluas atau menciutkan semua grup baris berlapis dalam tabel.

• Izinkan pengguna untuk menyesuaikan data dan tampilan laporan dengan menyertakan parameter dalam ekspresi.

Menampilkan laporan dengan parameter

Saat Anda melihat laporan yang memiliki parameter, toolbar penampil laporan menampilkan setiap parameter sehingga Anda dapat menentukan nilai secara interaktif. Ilustrasi berikut menunjukkan area parameter untuk laporan dengan parameter @ReportMonth, @ReportYear, @EmployeeID, @ShowAll, @ExpandTableRows, @CategoryQuota, dan @SalesDate.

1. Panel parameter. Toolbar penampil laporan menampilkan perintah dan nilai default untuk setiap parameter. Anda dapat menyesuaikan tata letak parameter di panel parameter.

2. parameter @SalesDate. Parameter @SalesDate adalah jenis data DateTime. Perintah Pilih Tanggal muncul di samping kotak teks. Untuk mengubah tanggal, ketik tanggal baru di kotak teks, gunakan kontrol kalender, atau pilih Buka hari ini.

3. parameter @ShowAll. Parameter @ShowAll adalah jenis data Boolean. Gunakan tombol radio untuk menentukan Benar atau Salah.

4. Tampilkan atau Sembunyikan handel Area Parameter. Pada toolbar penampil laporan, pilih panah ini untuk memperlihatkan atau menyembunyikan panel parameter.

5. parameter @CategoryQuota. Parameter @CategoryQuota adalah jenis data Float, sehingga membutuhkan nilai numerik. @CategoryQuota diatur untuk mengizinkan beberapa nilai.

6. Lihat Laporan. Setelah Anda memasukkan nilai parameter, pilih Tampilkan Laporan untuk menjalankan laporan. Jika semua parameter memiliki nilai default, laporan berjalan secara otomatis pada tampilan pertama.

Lihat bagaimana pelanggan Anda berinteraksi dengan parameter dalam laporan paginated Anda dalam artikel Melihat parameter untuk laporan paginated di layanan Power BI.

Membuat parameter

Anda dapat membuat parameter laporan dengan beberapa cara yang berbeda.

Catatan

Tidak semua sumber data mendukung parameter.

Kueri himpunan data atau prosedur tersimpan dengan parameter

Tambahkan kueri himpunan data yang berisi variabel atau prosedur tersimpan himpunan data yang berisi parameter input. Parameter himpunan data dibuat untuk setiap variabel atau parameter input, dan parameter laporan dibuat untuk setiap parameter himpunan data.

Gambar dari Report Builder ini menunjukkan:

1. Parameter laporan di panel Data Laporan.

2. Himpunan data dengan parameter.

3. Panel Parameter .

4. Parameter yang tercantum dalam kotak dialog Properti Himpunan Data.

Membuat parameter secara manual

Buat parameter secara manual dari panel Data Laporan. Anda dapat mengonfigurasi parameter laporan sehingga pengguna dapat memasukkan nilai secara interaktif untuk membantu menyesuaikan konten atau tampilan laporan. Anda juga dapat mengonfigurasi parameter laporan sehingga pengguna tidak dapat mengubah nilai yang telah dikonfigurasi sebelumnya.

Catatan

Karena parameter dikelola secara independen di server, menerbitkan ulang laporan utama dengan pengaturan parameter baru tidak menimpa pengaturan parameter yang ada pada laporan.

Pilih nilai parameter

Opsi berikut adalah untuk memilih nilai parameter dalam laporan.

• Pilih nilai parameter tunggal dari daftar drop-down.

• Pilih nilai parameter ganda dari daftar drop-down.

• Pilih nilai dari daftar drop-down untuk satu parameter, yang menentukan nilai yang tersedia di daftar drop-down untuk parameter lain. parameter ini adalah parameter bertingkat. Parameter bertingkat memungkinkan Anda memfilter nilai parameter secara berturut-turut dari ribuan nilai ke angka yang dapat dikelola. Untuk informasi selengkapnya, lihat Menggunakan parameter bertingkat dalam laporan paginasi.

• Jalankan laporan tanpa harus terlebih dahulu memilih nilai parameter karena nilai default dibuat untuk parameter .

Properti parameter laporan

Anda dapat mengubah properti parameter laporan dengan menggunakan kotak dialog Properti Laporan. Tabel berikut ini meringkas properti yang bisa Anda atur untuk setiap parameter:

Properti	Deskripsi
Nama	Ketik nama peka huruf besar/kecil untuk parameter. Nama harus dimulai dengan huruf dan dapat memiliki huruf, angka, atau garis bawah (_). Nama tidak boleh memiliki spasi. Untuk parameter yang dihasilkan secara otomatis, nama cocok dengan parameter dalam kueri himpunan data. Secara default, parameter yang dibuat secara manual mirip dengan ReportParameter1.
Prompt	Teks yang muncul di samping parameter pada toolbar penampil laporan.
Jenis data	Parameter laporan harus merupakan salah satu jenis data berikut: Boolean. Pengguna memilih Benar atau Salah dari tombol radio. DateTime. Pengguna mengetikkan tanggal baru dalam kotak teks, memilih tanggal dari kontrol kalender, atau memilih Buka hari ini. Bilangan bulat. Pengguna mengetikkan nilai dalam kotak teks. Float. Pengguna mengetikkan nilai dalam kotak teks. Teks. Pengguna mengetikkan nilai dalam kotak teks. Saat nilai yang tersedia ditentukan untuk parameter, pengguna memilih nilai dari daftar drop-down, bahkan ketika jenis data adalah DateTime.
Perbolehkan nilai kosong	Pilih opsi ini jika nilai parameter bisa berupa string kosong atau kosong. Jika Anda menentukan nilai yang valid untuk parameter, dan Anda ingin nilai kosong menjadi salah satu nilai yang valid, Anda harus menyertakannya sebagai salah satu nilai yang Anda tentukan. Memilih opsi ini tidak secara otomatis menyertakan kosong untuk nilai yang tersedia.
Perbolehkan nilai null	Pilih opsi ini jika nilai parameter bisa null. Jika Anda menentukan nilai yang valid untuk parameter, dan Anda ingin nilai null menjadi salah satu nilai yang valid, Anda harus menyertakannya sebagai salah satu nilai yang Anda tentukan. Memilih opsi ini tidak secara otomatis menyertakan null untuk nilai yang tersedia.
Izinkan beberapa nilai	Berikan nilai yang tersedia untuk membuat daftar drop-down yang dapat dipilih pengguna Anda. Ini adalah cara yang baik untuk memastikan bahwa hanya nilai yang valid yang dikirimkan dalam kueri himpunan data. Pilih opsi ini jika nilai untuk parameter bisa berupa beberapa nilai yang ditampilkan dalam daftar drop-down. Nilai null tidak diperbolehkan. Saat opsi ini dipilih, kotak centang ditambahkan ke daftar nilai yang tersedia dalam daftar drop-down parameter. Bagian atas daftar menyertakan kotak centang untuk Pilih Semua. Pengguna dapat memeriksa nilai yang mereka inginkan. Jika data yang menyediakan nilai berubah dengan cepat, daftar yang dilihat pengguna mungkin bukan yang terbaru.
Dapat dilihat	Pilih opsi ini untuk menampilkan parameter laporan di bagian atas laporan saat dijalankan. Opsi ini memungkinkan pengguna untuk memilih nilai parameter pada waktu proses.
Tersembunyi	Pilih opsi ini untuk menyembunyikan parameter laporan dalam laporan yang dipublikasikan. Nilai parameter laporan masih dapat diatur pada URL laporan, dalam definisi langganan, atau di server laporan.
Internal	Pilih opsi ini untuk menyembunyikan parameter laporan. Dalam laporan yang diterbitkan, parameter laporan hanya dapat dilihat dalam definisi laporan.
Nilai yang tersedia	Jika Anda telah menentukan nilai yang tersedia untuk parameter, nilai yang valid selalu muncul sebagai daftar drop-down. Misalnya, jika Anda menyediakan nilai yang tersedia untuk parameter DateTime, daftar drop-down untuk tanggal muncul di panel parameter alih-alih kontrol kalender. Untuk memastikan bahwa daftar nilai konsisten di antara laporan dan sublaporan, Anda dapat mengatur opsi pada sumber data untuk menggunakan satu transaksi untuk semua kueri dalam himpunan data yang terkait dengan sumber data. Catatan Keamanan: Dalam laporan apa pun yang menyertakan parameter tipe data Teks, pastikan untuk menggunakan daftar nilai yang tersedia (juga dikenal sebagai daftar nilai yang valid) dan pastikan bahwa setiap pengguna yang menjalankan laporan hanya memiliki izin yang diperlukan untuk melihat data dalam laporan.
Nilai default	Atur nilai default dari kueri atau dari daftar statis. Ketika setiap parameter memiliki nilai default, laporan berjalan secara otomatis pada tampilan pertama.
Lanjutan	Atur atribut definisi laporan UsedInQuery, nilai yang menunjukkan apakah parameter ini secara langsung atau tidak langsung memengaruhi data dalam laporan. Menentukan kapan harus refresh secara otomatis Pilih opsi ini saat Anda ingin prosesor laporan menentukan pengaturan untuk nilai ini. Nilainya Benar jika prosesor laporan mendeteksi kueri himpunan data dengan referensi langsung atau tidak langsung ke parameter ini, atau jika laporan memiliki sublaporan. Selalu refresh Pilih opsi ini saat parameter laporan digunakan secara langsung atau tidak langsung dalam kueri himpunan data atau ekspresi parameter. Opsi ini mengatur UsedInQuery ke Benar. Jangan pernah refresh Pilih opsi ini saat parameter laporan tidak digunakan secara langsung atau tidak langsung dalam kueri himpunan data atau ekspresi parameter. Opsi ini mengatur UsedInQuery ke Salah. Perhatian: Gunakan Jangan Pernah Refresh dengan hati-hati. Di server laporan, UsedInQuery digunakan untuk membantu mengontrol opsi cache untuk data laporan dan untuk laporan yang dirender, dan opsi parameter untuk laporan snapshot. Jika Anda salah mengatur Jangan Pernah Refresh, Anda dapat menyebabkan data laporan atau laporan yang salah di-cache, atau menyebabkan laporan snapshot memiliki data yang tidak konsisten.

Kueri himpunan data

Untuk memfilter data dalam kueri himpunan data, Anda dapat menyertakan klausul pembatasan yang membatasi data yang diambil dengan menentukan nilai untuk disertakan atau dikecualikan dari kumpulan hasil.

Gunakan perancang kueri untuk sumber data untuk membantu menyusun kueri berparameter.

• Untuk kueri transact-SQL, sumber data yang berbeda mendukung sintaks yang berbeda untuk parameter. Rentang dukungan dari parameter yang diidentifikasi dalam kueri berdasarkan posisi atau berdasarkan nama. Di perancang kueri relasional, Anda harus memilih opsi parameter sebagai filter untuk membuat kueri berparameter.

• Untuk kueri yang didasarkan pada sumber data multidimensi seperti Layanan Analisis Microsoft SQL Server, Anda dapat menentukan apakah akan membuat parameter berdasarkan filter yang Anda tentukan di perancang kueri.

Manajemen parameter untuk laporan yang diterbitkan

Saat Anda mendesain laporan, parameter laporan disimpan dalam definisi laporan. Saat Anda menerbitkan laporan, parameter laporan disimpan dan dikelola secara terpisah dari definisi laporan.

Untuk laporan yang diterbitkan, Anda dapat menggunakan parameter berikut:

• Properti parameter laporan. Ubah nilai parameter laporan secara langsung di server laporan secara independen dari definisi laporan.

• Langganan laporan. Anda dapat menentukan nilai parameter untuk memfilter data dan mengirimkan laporan melalui langganan.

Properti parameter untuk laporan yang diterbitkan dipertahankan jika Anda menerbitkan ulang definisi laporan. Jika definisi laporan diterbitkan ulang sebagai laporan yang sama, dan nama parameter dan jenis data tetap sama, pengaturan properti Anda akan dipertahankan. Jika Anda menambahkan atau menghapus parameter dalam definisi laporan, atau mengubah jenis data atau nama parameter yang ada, Anda mungkin perlu mengubah properti parameter dalam laporan yang diterbitkan.

Tidak semua parameter dapat dimodifikasi dalam semua kasus. Jika parameter laporan mendapatkan nilai default dari kueri himpunan data, nilai tersebut tidak dapat dimodifikasi untuk laporan yang diterbitkan dan tidak dapat dimodifikasi di server laporan. Nilai yang digunakan pada waktu proses yang ditentukan saat kueri berjalan, atau dalam kasus parameter berbasis ekspresi, saat ekspresi dievaluasi.

Opsi eksekusi laporan dapat memengaruhi cara parameter diproses. Laporan yang berjalan sebagai rekam jepret tidak dapat menggunakan parameter yang berasal dari kueri kecuali kueri menyertakan nilai default untuk parameter.

Parameter untuk langganan

Anda dapat menentukan langganan untuk laporan sesuai permintaan atau untuk rekam jepret, dan menentukan nilai parameter yang akan digunakan selama pemrosesan langganan.

• Laporan sesuai permintaan. Untuk laporan sesuai permintaan, Anda dapat menentukan nilai parameter yang berbeda dari nilai yang diterbitkan untuk setiap parameter yang tercantum untuk laporan. Misalnya, Anda memiliki laporan Layanan Panggilan yang menggunakan parameter Periode Waktu untuk mengembalikan permintaan layanan pelanggan untuk hari, minggu, atau bulan saat ini. Jika nilai parameter default untuk laporan diatur ke hari ini, langganan Anda dapat menggunakan nilai parameter yang berbeda (seperti minggu atau bulan) untuk menghasilkan laporan yang berisi angka mingguan atau bulanan.

Konten terkait

• Apa itu laporan yang dipaginasi di Power BI?
• Gunakan parameter bertingkat dalam laporan paginasi