Power BI Rapor Oluşturucusu'de rapor parametreleri

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

Bu makalede Power BI Rapor Oluşturucusu rapor parametrelerinin yaygın kullanımları, ayarlayabileceğiniz özellikler ve çok daha fazlası açıklanmaktadır. Rapor parametreleri rapor verilerini denetlemenize, ilgili raporları birbirine bağlamanıza ve rapor sunusunun değişmesine olanak sağlar. Rapor parametrelerini, Rapor Oluşturucusu oluşturduğunuz sayfalandırılmış raporlarda kullanabilirsiniz.

Parametreler için yaygın kullanımlar

Parametreleri kullanmanın en yaygın yollarından bazıları aşağıdadır.

Sayfalandırılmış rapor verilerini denetleme:

• Değişken içeren veri kümesi sorguları yazarak veri kaynağındaki sayfalandırılmış rapor verilerini filtreleyin.

• Kullanıcıların sayfalandırılmış rapordaki verileri özelleştirmek için değerler belirtmesine izin verin. Örneğin, satış verileri için başlangıç tarihi ve bitiş tarihi için iki parametre sağlayın.

Rapor sunusunun değişmesi:

• Kullanıcıların bir raporun görünümünü özelleştirmeye yardımcı olacak değerler belirtmesine izin verin. Örneğin, tablodaki tüm iç içe satır gruplarının genişletilip genişletilip genişletmeyeceğini veya daraltılmayacağını belirten bir Boole parametresi sağlayın.

• Kullanıcıların ifadeye parametreler ekleyerek rapor verilerini ve görünümünü özelleştirmesine izin verin.

Parametreleri olan bir raporu görüntüleme

Parametreleri olan bir raporu görüntülediğinizde, rapor görüntüleyici araç çubuğu her parametreyi görüntüler, böylece değerleri etkileşimli olarak belirtebilirsiniz. Aşağıdaki çizimde, @ShowAll@ReportYear@EmployeeID@ExpandTableRows@CategoryQuotave @SalesDateparametrelerine sahip bir raporun parametre alanı gösterilmektedir.@ReportMonth

1. Parametreler bölmesi. Rapor görüntüleyici araç çubuğu, her parametre için bir istem ve varsayılan değer görüntüler. Parametreler bölmesinde parametrelerin düzenini özelleştirebilirsiniz.

2. @SalesDate parametresi. @SalesDate parametresi DateTime veri türüdür. Metin kutusunun yanında Tarih Seçin istemi görüntülenir. Tarihi değiştirmek için metin kutusuna yeni bir tarih yazın, takvim denetimini kullanın veya Bugüne git'i seçin.

3. @ShowAll parametresi. @ShowAll parametresi Boole veri türüdür. Doğru veya Yanlış belirtmek için radyo düğmelerini kullanın.

4. Parametre Alanı tutamacını gösterin veya gizleyin. Parametreler bölmesini göstermek veya gizlemek için rapor görüntüleyici araç çubuğunda bu oku seçin.

5. @CategoryQuota parametresi. parametre @CategoryQuota Float veri türüdür, bu nedenle sayısal bir değer alır. @CategoryQuota birden çok değere izin verecek şekilde ayarlanır.

6. Raporu Görüntüle'yi seçin. Parametre değerlerini girdikten sonra raporu çalıştırmak için Raporu Görüntüle'yi seçin. Tüm parametreler varsayılan değerlere sahipse, rapor ilk görünümde otomatik olarak çalışır.

Power BI hizmeti sayfalandırılmış raporlar için parametreleri görüntüleme makalesinde müşterilerinizin sayfalandırılmış raporlarınızdaki parametrelerle nasıl etkileşime geçtiğini görün.

Parametre oluşturma

Rapor parametrelerini birkaç farklı yolla oluşturabilirsiniz.

Not

Tüm veri kaynakları parametreleri desteklemez.

Parametrelerle veri kümesi sorgusu veya saklı yordam

Değişkenleri içeren bir veri kümesi sorgusu veya giriş parametrelerini içeren bir veri kümesi saklı yordamı ekleyin. Her değişken veya giriş parametresi için bir veri kümesi parametresi ve her veri kümesi parametresi için bir rapor parametresi oluşturulur.

Rapor Oluşturucusu bu görüntü şunları gösterir:

1. Rapor Verileri bölmesindeki rapor parametreleri.

2. Parametreleri içeren veri kümesi.

3. Parametreler bölmesi.

4. Veri Kümesi Özellikleri iletişim kutusunda listelenen parametreler.

El ile parametre oluşturma

Rapor Verileri bölmesinden el ile bir parametre oluşturun. Bir kullanıcının raporun içeriğini veya görünümünü özelleştirmeye yardımcı olmak için etkileşimli olarak değer girebilmesi için rapor parametrelerini yapılandırabilirsiniz. Ayrıca, bir kullanıcının önceden yapılandırılmış değerleri değiştirebilmesi için rapor parametrelerini yapılandırabilirsiniz.

Not

Parametreler sunucuda bağımsız olarak yönetildiğinden, ana raporu yeni parametre ayarlarıyla yeniden yayımlamak rapordaki mevcut parametre ayarlarının üzerine yazmaz.

Parametre değerlerini seçme

Aşağıdaki seçenekler rapordaki parametre değerlerini seçmek için geçerlidir.

• Açılan listeden tek bir parametre değeri seçin.

• Açılan listeden birden çok parametre değeri seçin.

• Bir parametre için açılan listeden bir değer seçin. Bu değer, açılan listede başka bir parametre için kullanılabilir olan değerleri belirler. Bunlar basamaklı parametrelerdir. Basamaklı parametreler, parametre değerlerini binlerce değerden yönetilebilir bir sayıya art arda filtrelemenizi sağlar. Daha fazla bilgi için bkz . Sayfalandırılmış raporlarda basamaklı parametreleri kullanma.

• Parametre için varsayılan bir değer oluşturulduğundan, önce parametre değeri seçmek zorunda kalmadan raporu çalıştırın.

Rapor parametresi özellikleri

Rapor Özellikleri iletişim kutusunu kullanarak rapor parametresi özelliklerini değiştirebilirsiniz. Aşağıdaki tabloda her parametre için ayarlayabileceğiniz özellikler özetlemektedir:

Özellik	Açıklama
Ad	Parametresi için büyük/küçük harfe duyarlı bir ad yazın. Ad bir harfle başlamalıdır ve harf, sayı veya alt çizgi (_) içerebilir. Adında boşluk olamaz. Otomatik olarak oluşturulan parametreler için ad, veri kümesi sorgusundaki parametreyle eşleşir. Varsayılan olarak, el ile oluşturulan parametreler ReportParameter1'e benzer.
İstem	Rapor görüntüleyici araç çubuğunda parametresinin yanında görünen metin.
Veri türü	Rapor parametresi aşağıdaki veri türlerinden biri olmalıdır: Boole dili. Kullanıcı bir radyo düğmesinden Doğru veya Yanlış'ı seçer. DateTime. Kullanıcı metin kutusuna yeni bir tarih yazar, takvim denetiminden bir tarih seçer veya Bugüne git'i seçer. Tamsayı. Kullanıcı bir metin kutusuna değerler yazın. Kayan. Kullanıcı bir metin kutusuna değerler yazın. Metin. Kullanıcı bir metin kutusuna değerler yazın. Bir parametre için kullanılabilir değerler tanımlandığında, veri türü DateTime olsa bile kullanıcı açılan listeden değerleri seçer.
Boş değere izin ver	Parametrenin değeri boş bir dize veya boş olabilirse bu seçeneği belirleyin. Bir parametre için geçerli değerler belirtirseniz ve boş bir değerin geçerli değerlerden biri olmasını istiyorsanız, bunu belirttiğiniz değerlerden biri olarak eklemeniz gerekir. Bu seçeneğin seçilmesi, kullanılabilir değerler için otomatik olarak boş değer içermez.
Null değere izin ver	Parametrenin değeri null olabilirse bu seçeneği belirleyin. Bir parametre için geçerli değerler belirtirseniz ve null değerinin geçerli değerlerden biri olmasını istiyorsanız, belirttiğiniz değerlerden biri olarak null değerini eklemeniz gerekir. Bu seçeneğin seçilmesi, kullanılabilir değerler için otomatik olarak null içermez.
Birden fazla değere izin ver	Kullanıcılarınızın aralarından seçim yapabilecekleri bir açılan liste oluşturmak için kullanılabilir değerler sağlayın. Bu, veri kümesi sorgusunda yalnızca geçerli değerlerin gönderilmesini sağlamanın iyi bir yoludur. Parametrenin değeri açılan listede görüntülenen birden çok değer olabilirse bu seçeneği belirleyin. Null değerlere izin verilmez. Bu seçenek belirlendiğinde, parametre açılan listesindeki kullanılabilir değerler listesine onay kutuları eklenir. Listenin en üstünde Tümünü Seç onay kutusu bulunur. Kullanıcılar istedikleri değerleri denetleyebiliyor. Değer sağlayan veriler hızla değişirse, kullanıcının gördüğü liste en güncel liste olmayabilir.
Görünür	Rapor çalıştırıldığında raporun üst kısmında rapor parametresini görüntülemek için bu seçeneği belirleyin. Bu seçenek kullanıcıların çalışma zamanında parametre değerlerini seçmesine olanak tanır.
Gizlendi	Yayımlanan raporda rapor parametresini gizlemek için bu seçeneği belirleyin. Rapor parametresi değerleri yine bir rapor URL'sinde, abonelik tanımında veya rapor sunucusunda ayarlanabilir.
Şirket İçi	Rapor parametresini gizlemek için bu seçeneği belirleyin. Yayımlanan raporda rapor parametresi yalnızca rapor tanımında görüntülenebilir.
Kullanılabilir değerler	Bir parametre için kullanılabilir değerler belirttiyseniz, geçerli değerler her zaman açılan liste olarak görünür. Örneğin, bir DateTime parametresi için kullanılabilir değerler sağlarsanız, takvim denetimi yerine parametre bölmesinde tarihler için açılan liste görüntülenir. Bir değer listesinin rapor ve alt raporlar arasında tutarlı olduğundan emin olmak için, veri kaynağında bir veri kaynağıyla ilişkili veri kümelerindeki tüm sorgular için tek bir işlem kullanmak üzere bir seçenek ayarlayabilirsiniz. Güvenlik Notu: Metin veri türünde bir parametre içeren herhangi bir raporda, kullanılabilir değerler listesini (geçerli değerler listesi olarak da bilinir) kullandığınızdan ve raporu çalıştıran tüm kullanıcıların yalnızca rapordaki verileri görüntülemek için gerekli izinlere sahip olduğundan emin olun.
Varsayılan değerler	Bir sorgudan veya statik listeden varsayılan değerleri ayarlayın. Her parametrenin varsayılan değeri olduğunda, rapor ilk görünümde otomatik olarak çalışır.
Gelişmiş	Bu parametrenin rapordaki verileri doğrudan mı yoksa dolaylı olarak mı etkilediğini gösteren bir değer olan UsedInQuery rapor tanımı özniteliğini ayarlayın. Ne zaman yenileneceğini otomatik olarak belirleme Rapor işlemcisinin bu değer için bir ayar belirlemesini istediğinizde bu seçeneği belirleyin. Rapor işlemcisi bu parametreye doğrudan veya dolaylı başvuru içeren bir veri kümesi sorgusu algılarsa veya raporun alt raporları varsa değer True olur. Her zaman yenile Rapor parametresi bir veri kümesi sorgusunda veya parametre ifadesinde doğrudan veya dolaylı olarak kullanıldığında bu seçeneği belirleyin. Bu seçenek UsedInQuery değerini True olarak ayarlar. Hiçbir zaman yenileme Rapor parametresi bir veri kümesi sorgusunda veya parametre ifadesinde doğrudan veya dolaylı olarak kullanılmadığında bu seçeneği belirleyin. Bu seçenek UsedInQuery'yi False olarak ayarlar. Dikkat: Hiçbir Zaman Yenileme'yi dikkatli kullanın. Rapor sunucusunda UsedInQuery, rapor verileri ve işlenmiş raporlar için önbellek seçeneklerini ve anlık görüntü raporları için parametre seçeneklerini denetlemeye yardımcı olmak için kullanılır. Hiçbir Zaman Yenileme'yi yanlış ayarlarsanız, yanlış rapor verilerinin veya raporlarının önbelleğe alınmasına veya anlık görüntü raporunun tutarsız verilere sahip olmasına neden olabilirsiniz.

Veri kümesi sorgusu

Veri kümesi sorgusundaki verileri filtrelemek için, sonuç kümesine eklenecek veya çıkarılacak değerleri belirterek alınan verileri sınırlayan bir kısıtlama yan tümcesi ekleyebilirsiniz.

Parametreli sorgu oluşturmaya yardımcı olması için veri kaynağı için sorgu tasarımcısını kullanın.

• Transact-SQL sorguları için, farklı veri kaynakları parametreler için farklı söz dizimlerini destekler. Sorguda konuma veya ada göre tanımlanan parametrelerden gelen destek aralıkları. İlişkisel sorgu tasarımcısında parametreli sorgu oluşturmak için filtrenin parametre seçeneğini belirlemeniz gerekir.

• Microsoft SQL Server Analysis Services gibi çok boyutlu bir veri kaynağını temel alan sorgular için, sorgu tasarımcısında belirttiğiniz filtreyi temel alan bir parametre oluşturulup oluşturulmayacağını belirtebilirsiniz.

Yayımlanan rapor için parametre yönetimi

Rapor tasarlarken rapor parametreleri rapor tanımına kaydedilir. Bir raporu yayımladığınızda rapor parametreleri rapor tanımından ayrı olarak kaydedilir ve yönetilir.

Yayımlanan bir rapor için aşağıdaki parametreleri kullanabilirsiniz:

• Rapor parametresi özellikleri. Rapor parametresi değerlerini rapor tanımından bağımsız olarak doğrudan rapor sunucusunda değiştirin.

• Rapor abonelikleri. Verileri filtrelemek ve abonelikler aracılığıyla rapor teslim etmek için parametre değerleri belirtebilirsiniz.

Yayımlanan raporun parametre özellikleri, rapor tanımını yeniden yayımladığınızda korunur. Rapor tanımı aynı raporla yeniden yayımlanırsa ve parametre adları ve veri türleri aynı kalırsa özellik ayarlarınız korunur. Rapor tanımına parametre ekler veya silerseniz ya da var olan bir parametrenin veri türünü veya adını değiştirirseniz, yayımlanan rapordaki parametre özelliklerini değiştirmeniz gerekebilir.

Tüm parametreler her durumda değiştirilemez. Rapor parametresi bir veri kümesi sorgusundan varsayılan bir değer alırsa, yayımlanan rapor için bu değer değiştirilemez ve rapor sunucusunda değiştirilemez. Çalışma zamanında kullanılan değer, sorgu çalıştırıldığında veya ifadenin değerlendirildiğinde ifade tabanlı parametreler söz konusu olduğunda belirlenir.

Rapor yürütme seçenekleri, parametrelerin nasıl işlendiğini etkileyebilir. Anlık görüntü olarak çalışan bir rapor, sorgu parametreler için varsayılan değerler içermediği sürece sorgudan türetilen parametreleri kullanamaz.

Abonelik parametreleri

İsteğe bağlı rapor veya anlık görüntü için abonelik tanımlayabilir ve abonelik işleme sırasında kullanılacak parametre değerlerini belirtebilirsiniz.

• İsteğe bağlı rapor. İsteğe bağlı bir rapor için, rapor için listelenen her parametre için yayımlanan değerden farklı bir parametre değeri belirtebilirsiniz. Örneğin, geçerli gün, hafta veya ay için müşteri hizmetleri isteklerini döndürmek için Zaman Aralığı parametresi kullanan bir Çağrı Hizmeti raporunuz olduğunu varsayalım. Raporun varsayılan parametre değeri bugün olarak ayarlandıysa, aboneliğiniz haftalık veya aylık rakamları içeren bir rapor oluşturmak için farklı bir parametre değeri (hafta veya ay gibi) kullanabilir.

İlgili içerik

• Power BI'da sayfalandırılmış raporlar nedir?
• Sayfalandırılmış raporlarda basamaklı parametreleri kullanma