Bagikan melalui

Parameter URL dalam laporan paginasi di Power BI

  • Artikel

BERLAKU UNTUK: Power BI Report Builder Power BI Desktop

Anda dapat mengirim perintah ke laporan terpaginasi di Power BI dengan menambahkan parameter ke URL. Misalnya, Anda mungkin telah melihat laporan menggunakan sekumpulan nilai parameter laporan tertentu. Anda merangkum informasi ini di URL dengan menggunakan parameter akses URL yang telah ditentukan sebelumnya. Anda kemudian menyesuaikan cara Power BI memproses laporan dengan menyematkan parameter untuk format perenderan, atau untuk tampilan dan nuansa toolbar laporan. Anda kemudian menempelkan URL ini langsung ke email atau halaman Web sehingga orang lain menikmati laporan Anda dengan cara yang sama di browser.

Berikut beberapa tindakan yang dapat dilakukan melalui parameter akses URL:

  • Mengirim parameter laporan ke laporan.
  • Memulai ekspor konten laporan dalam format file yang didukung.
  • Menyembunyikan atau menampilkan panel parameter.
  • Tentukan pengaturan DeviceInfo .

Untuk daftar lengkap perintah dan pengaturan yang tersedia melalui akses URL, lihat Referensi parameter akses URL di artikel ini.

Konsep akses URL

Permintaan URL ke Power BI berisi parameter yang diproses oleh layanan. Cara layanan menangani permintaan URL bergantung pada parameter, awalan parameter, dan jenis item yang disertakan dalam URL. Fungsionalitas URL laporan terpaginasi kompatibel dengan sebagian besar browser dan aplikasi yang mendukung alamat URL standar.

Sintaks akses URL

Permintaan URL dapat berisi beberapa parameter, yang dicantumkan dalam urutan apa pun. Parameter dipisahkan oleh ampersand (&). Pasangan nama dan nilai dipisahkan oleh tanda sama dengan (=). Misalnya:

powerbiservicereporturl?rp:parameter=value&rdl:parameter=value

Deskripsi sintaks

powerbiservicereporturl

URL layanan Power BI laporan paginasi Anda. Misalnya:

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-c4c4-4217-afd9-3920a0d1e2b0

?

Digunakan untuk memisahkan powerbiservicereporturl dan parameter akses URL.

&

Digunakan untuk memisahkan pasangan nama dan nilai parameter akses URL.

awalan

Awalan untuk parameter URL yang menentukan tindakan dalam layanan Power BI. Misalnya, rp: atau rdl:.

parameter

Nama parameternya.

value

Teks URL yang sesuai dengan nilai parameter yang digunakan.

Referensi parameter laporan URL

Anda dapat meneruskan parameter laporan ke laporan dengan menyertakannya dalam URL laporan paginasi.

Parameter laporan (rp:)

Untuk contoh meneruskan parameter laporan dalam URL, lihat Meneruskan parameter laporan dalam URL.

Catatan

Parameter laporan memerlukan awalan rp: parameter dan peka huruf besar/kecil.

Referensi parameter akses URL

Anda dapat menggunakan parameter berikut sebagai bagian dari URL untuk mengonfigurasi tampilan dan nuansa laporan terpaginasi Anda di Power BI. Parameter yang paling umum tercantum di bagian ini. Parameter tidak peka huruf besar/kecil dan dimulai dengan awalan parameter rdl: jika terkait dengan format output.

Perintah laporan (rdl:)

Format ekspor

Menentukan format untuk merender dan mengekspor laporan.

  • Misalnya: rdl:format=PDF

Nilai yang tersedia:

  • PPTX (PowerPoint)
  • MHTML
  • GAMBAR
  • EXCELOPENXML (EXCEL)
  • WORDOPENXML (WORD)
  • CSV
  • PDF
  • ACCESSIBLEPDF (PDF)
  • XML

Tampilan laporan

Menentukan tipe tampilan yang digunakan untuk menampilkan laporan.

  • rdl:reportView

Nilai yang tersedia:

  • interaktif (default): memuat laporan dalam mode interaktif.
  • pageView: memuat laporan dalam mode tampilan halaman.

Panel parameter

Menentukan apakah panel parameter ditutup atau terbuka saat laporan dimuat, atau disembunyikan sama sekali.

  • rdl:parameterPanel

Nilai yang tersedia:

  • diciutkan: memuat laporan dengan panel parameter tertutup. Tombol parameter diaktifkan sehingga pengguna dapat memilih tombol untuk diperluas.
  • tersembunyi: memuat laporan dengan panel parameter tertutup dan tombol parameter dinonaktifkan.
  • diperluas (default): memuat laporan dengan panel parameter terbuka dan tombol parameter diaktifkan.

Info perangkat

Anda dapat menentukan parameter output tambahan untuk format ekspor berikut.

  • PDF / ACCESSIBLEPDF:

    • rdl:AccessiblePDF=true/false
    • rdl:Columns=integer
    • rdl:ColumnSpacing=decimal(in)
    • rdl:DpiX=integer
    • rdl:DpiY=integer
    • rdl:EndPage=integer
    • rdl:HumanReadablePDF=true/false
    • rdl:MarginBottom=decimal(in)
    • rdl:MarginLeft=decimal(in)
    • rdl:MarginRight=decimal(in)
    • rdl:MarginTop=decimal(in)
    • rdl:PageHeight=decimal(in)
    • rdl:PageWidth=decimal(in)
    • rdl:StartPage=integer

  • CSV:

    Catatan

    Untuk nilai string ini, referensikan pengaturan informasi perangkat CSV.

    • rdl:Encoding=string
    • rdl:ExcelMode=true/false
    • rdl:FieldDelimiter=string
    • rdl:NoHeader=true/false
    • rdl:Qualifier=string
    • rdl:RecordDelimiter=string
    • rdl:SuppressLineBreaks=true/false
    • rdl:UseFormattedValues=true/false

  • WORDOPENXML (WORD):

    • rdl:AutoFit=string -> True/False/Never/Default
    • rdl:ExpandToggles=true/false
    • rdl:FixedPageWidth=true/false
    • rdl:OmitDrillthroughs=true/false
    • rdl:OmitHyperlinks=true/false

  • EXCELOPENXML (EXCEL):

    • rdl:OmitDocumentMap=true/false
    • rdl:OmitFormulas=true/false
    • rdl:SimplePageHeaders=true/false

  • PPTX (PowerPoint):

    • rdl:Columns=integer
    • rdl:ColumnSpacing=decimal(in)
    • rdl:DpiX=integer
    • rdl:DpiY=integer
    • rdl:EndPage=integer
    • rdl:MarginBottom=decimal(in)
    • rdl:MarginLeft=decimal(in)
    • rdl:MarginRight=decimal(in)
    • rdl:MarginTop=decimal(in)
    • rdl:PageHeight=decimal(in)
    • rdl:PageWidth=decimal(in)
    • rdl:StartPage=integer
    • rdl:UseReportPageSize=true/false

  • XML:

    • rdl:Encoding=string
    • rdl:Indented=true/false
    • rdl:OmitNamespace=true/false
    • rdl:OmitSchema=true/false
    • rdl:Schema=true/false
    • rdl:UseFormattedValues=true/false

Anda bisa menambahkan rdl:targetSameWindow=true ke URL hyperlink dalam laporan Anda untuk membuat Power BI membuka hyperlink ini di jendela browser yang sama. Untuk informasi tentang menambahkan hyperlink ke laporan, lihat Menambahkan hyperlink ke URL.

Konten terkait