Power BI sayfalandırılmış raporun URL'sinde rapor parametresi geçirme

  • Makale

ŞUNLAR IÇIN GEÇERLIDIR: Power BI Rapor Oluşturucusu Power BI Desktop

Rapor parametrelerini Sayfalandırılmış Raporlar için bir rapor URL'sine ekleyerek rapora geçirebilirsiniz. Bu URL parametreleri doğrudan rapor işleme altyapısına geçirildiğinden ön eklenmez.

Tüm sorgu parametrelerine karşılık gelen rapor parametreleri olabilir. İlgili rapor parametresini geçirerek bir sorgu parametresini rapora geçirirsiniz. Daha fazla bilgi için bkz. İlişkisel Sorgu Tasarım Aracı Sorgu Oluşturma (Power BI Rapor Oluşturucusu).

Sayfalandırılmış rapor parametre kuralları

Rapor parametreleri büyük/küçük harfe duyarlıdır ve aşağıdaki özel karakterleri kullanır:

  • URL dizesindeki tüm boşluk karakterleri, URL kodlama standartlarına göre "%20" karakterleriyle değiştirilir.
  • URL'nin parametre bölümündeki bir boşluk karakteri, artı karakteri (+) ile değiştirilir.
  • Dizenin herhangi bir bölümündeki noktalı virgül "%3A" karakterleriyle değiştirilir.
  • Tarayıcılar, doğru URL kodlamasını otomatik olarak gerçekleştirmelidir. Karakterlerin hiçbirini el ile kodlamanız gerekmez.
  • Ara sunucu söz dizimini eklemezseniz, parametresine rp: ön eki ekleyin.

Sayfalandırılmış rapor parametresi örnekleri

BIR URL içinde rapor parametresi ayarlamak için aşağıdaki söz dizimini kullanın:

  
rp:parameter=value

Örneğin, Çalışma Alanım'daki bir raporda tanımlanan "Satış Temsilcisi" ve "Durum" olmak üzere iki parametre belirtmek için aşağıdaki URL'yi kullanırsınız:

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

Bir uygulamadaki raporda tanımlanan iki parametrenin aynısını belirtmek için aşağıdaki URL'yi kullanırsınız:

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

Bir parametre için null değer geçirmek için aşağıdaki söz dizimini kullanın:

  
parameter:isnull=true

Örneğin,

rp:SalesOrderNumber:isnull=true

Boole değeri geçirmek için false için 0 ve true için 1 kullanın. Float değerini geçirmek için sunucu yerel ayarının ondalık ayırıcısını ekleyin.

Not

Raporunuz varsayılan değere sahip bir rapor parametresi içeriyorsa ve prompt özelliğinin değeri false ise (yani, Kullanıcı İste özelliği Rapor Yöneticisi'nde seçili değilse), bu rapor parametresi için bir değeri URL içinde geçiremezsiniz. Bu, yöneticilere son kullanıcıların belirli rapor parametrelerinin değerlerini eklemesini veya değiştirmesini engelleme seçeneği sağlar.

Ek örnekler

Aşağıdaki URL örneği, "Salesperson" adlı çok değerli bir parametre içerir. Çok değerli parametrenin biçimi, her değer için parametre adını yinelemektir.

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

Aşağıdaki URL örneği, "1/7/2005" değeriyle tek bir SellStartDate parametresi geçirir.

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

Dikkat edilecekler ve sınırlamalar

  • Raporunuz varsayılan değere sahip bir rapor parametresi içeriyorsa ve prompt özelliğinin değeri false ise (yani, Kullanıcı İste özelliği Power BI Rapor Oluşturucusu'de seçili değilse), bu rapor parametresi için bir değeri URL içinde geçiremezsiniz. Bu, yöneticilere son kullanıcıların belirli rapor parametrelerinin değerlerini eklemesini veya değiştirmesini engelleme seçeneği sağlar.
  • Power BI, 2.000'den fazla karakterden oluşan bir sorgu dizesini desteklemez. Sayfalandırılmış raporunuzu görüntülemek için URL parametreleri kullanıyorsanız, özellikle sorgu dizeniz birden çok parametre değeri içeriyorsa, bu değeri yanlışlıkla aşabilirsiniz. Raporu düzgün yüklemek için karakter sayısını 2.000'in altına düşürün.
  • Sorgu dizesindeki sınır, Power BI'da oturum açtıktan sonra değerlendirilir. Oturum açmadan önce raporu açarsanız sınır azalır.

İlgili içerik