Bagikan melalui

Meneruskan parameter laporan dalam URL untuk laporan paginasi Power BI

  • Artikel

BERLAKU UNTUK: Power BI Report Builder Power BI Desktop

Anda dapat meneruskan parameter laporan ke laporan dengan menyertakannya dalam URL laporan untuk Laporan Paginated. Parameter URL ini tidak diawali karena diteruskan langsung ke mesin pemrosesan laporan.

Semua parameter kueri dapat memiliki parameter laporan yang sesuai. Anda meneruskan parameter kueri ke laporan dengan meneruskan parameter laporan yang sesuai. Untuk informasi selengkapnya, lihat Membuat Kueri di Desainer Kueri Relasional (Pembangun Laporan Power BI).

Aturan parameter laporan yang dipaginasi

Parameter laporan peka huruf besar/kecil dan menggunakan karakter khusus berikut:

  • Setiap karakter spasi dalam string URL diganti dengan karakter "%20," sesuai dengan standar pengodean URL.
  • Karakter spasi dalam bagian parameter URL diganti dengan karakter plus (+).
  • Titik koma dalam bagian mana pun dari string diganti dengan karakter "%3A."
  • Browser harus secara otomatis melakukan pengodean URL yang tepat. Anda tidak perlu mengodekan karakter apa pun secara manual.
  • Jika Anda tidak menyertakan sintaks proksi, maka awali parameter dengan rp:.

Contoh parameter laporan yang dipaginasi

Untuk mengatur parameter laporan dalam URL, gunakan sintaks berikut:

  
rp:parameter=value

Misalnya, untuk menentukan dua parameter, "Salesperson" dan "State", yang ditentukan dalam laporan di My Workspace, Anda akan menggunakan URL berikut:

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:Salesperson=Tie+Bear&rp:State=Utah

Untuk menentukan dua parameter yang sama yang ditentukan dalam laporan di aplikasi, Anda akan menggunakan URL berikut:

https://app.powerbi.com/groups/me/apps/xxxxxxx-c4c4-4217-afd9-3920a0d1e2b0/rdlreports/xxxxxxx-639e-41d0-b733-05d2bca9853c?rp:Salesperson=Tiggee&rp:State=Utah

Untuk meneruskan nilai null untuk parameter, gunakan sintaks berikut:

  
parameter:isnull=true

Contohnya,

rp:SalesOrderNumber:isnull=true

Untuk meneruskan nilai Boolean , gunakan 0 untuk false dan 1 untuk true. Untuk meneruskan nilai Float , sertakan pemisah desimal lokal server.

Catatan

Jika laporan Anda berisi parameter laporan yang memiliki nilai default dan nilai properti Prompt adalah false (yaitu, properti Prompt User tidak dipilih di Report Manager), maka Anda tidak dapat meneruskan nilai untuk parameter laporan tersebut dalam URL. Ini memberi administrator opsi untuk mencegah pengguna akhir menambahkan atau memodifikasi nilai parameter laporan tertentu.

Contoh tambahan

Contoh URL berikut menyertakan parameter multinilai "Salesperson". Format untuk parameter multinilai adalah mengulangi nama parameter untuk setiap nilai.

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:Salesperson=Tie+Bear&rp:Salesperson=Mickey

Contoh URL berikut meneruskan satu parameter SellStartDate dengan nilai "7/1/2005".

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:SellStartDate=7/1/2005

Pertimbangan dan batasan

  • Jika laporan Anda berisi parameter laporan yang memiliki nilai default, dan nilai properti Prompt adalah false (yaitu, properti Prompt User tidak dipilih di Power BI Report Builder), maka Anda tidak dapat meneruskan nilai untuk parameter laporan tersebut dalam URL. Ini memberi administrator opsi untuk mencegah pengguna akhir menambahkan atau memodifikasi nilai parameter laporan tertentu.
  • Power BI tidak mendukung string kueri lebih dari 2.000 karakter. Anda mungkin secara tidak sengaja melebihi nilai ini jika Anda menggunakan parameter URL untuk melihat laporan paginasi Anda, terutama jika string kueri Anda berisi beberapa nilai parameter. Untuk memuat laporan dengan benar, kurangi jumlah karakter menjadi di bawah 2.000.
  • Batas dalam string kueri dievaluasi setelah Anda masuk ke Power BI. Jika Anda membuka laporan sebelum masuk, batasnya berkurang.

Konten terkait