Power BI Rapor Oluşturucusu ifadeleri

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

İfadeler, verileri almak, hesaplamak, görüntülemek, gruplandırmak, sıralamak, filtrelemek, parametreleştirmek ve biçimlendirmek için Power BI Rapor Oluşturucusu sayfalandırılmış raporlar genelinde yaygın olarak kullanılır.

Birçok rapor öğesi özelliği bir ifadeye ayarlanabilir. İfadeler raporunuzun içeriğini, tasarımını ve etkileşimini denetlemenize yardımcı olur. İfadeler Microsoft Visual Basic'te yazılır, rapor tanımına kaydedilir ve raporu çalıştırdığınızda rapor işlemcisi tarafından değerlendirilir.

Doğrudan çalışma sayfasında verilerle çalıştığınız Microsoft Excel gibi uygulamalardan farklı olarak, raporda veri yer tutucusu olan ifadelerle çalışırsınız. Değerlendirilen ifadelerdeki gerçek verileri görmek için raporun önizlemesini görmeniz gerekir. Raporu çalıştırdığınızda, rapor işlemcisi rapor verilerini ve tablolar ve grafikler gibi rapor düzeni öğelerini birleştirdiğinden her ifadeyi değerlendirir.

Bir raporu tasarladığınızda, rapor öğeleri için birçok ifade sizin için ayarlanır. Örneğin, veri bölmesindeki bir alanı rapor tasarım yüzeyindeki bir tablo hücresine sürüklediğinizde, metin kutusu değeri alan için basit bir ifadeye ayarlanır. Aşağıdaki şekilde, Rapor Verileri bölmesinde id, Name, SalesTerritory, Code ve Sales veri kümesi alanları görüntülenir. Tabloya üç alan eklendi: [Name], [Code]ve [Sales]. Tasarım yüzeyindeki gösterimi [Name] , temel alınan ifadeyi =Fields!Name.Valuetemsil eder.

Screenshot of Report Builder Design View.

Raporun önizlemesini görüntülendiğinde, rapor işlemcisi tablo veri bölgesini veri bağlantısındaki gerçek verilerle birleştirir ve sonuç kümesindeki her satır için tabloda bir satır görüntüler.

İfadeleri el ile girmek için tasarım yüzeyinde bir öğe seçin ve öğenin özelliklerini ayarlamak için kısayol menülerini ve iletişim kutularını kullanın. Açılan listede (fx) düğmesini veya değeri <Expression> gördüğünüzde, özelliğini bir ifade olarak ayarlayabileceğinizi bilirsiniz.

Basit ve karmaşık ifadeleri anlama

İfadeler eşittir işaretiyle (=) başlar ve Microsoft Visual Basic'te yazılır. İfadeler, yerleşik değerlere (alanlar, koleksiyonlar ve işlevler) ve dış veya özel koda yönelik sabitlerin, işleçlerin ve başvuruların bir bileşimini içerebilir.

İfadeleri kullanarak birçok rapor öğesi özelliğinin değerini belirtebilirsiniz. En yaygın özellikler metin kutuları ve yer tutucu metin değerleridir. Genellikle, bir metin kutusu yalnızca bir ifade içeriyorsa, ifade metin kutusu özelliğinin değeridir. Bir metin kutusu birden çok ifade içeriyorsa, her ifade metin kutusundaki yer tutucu metnin değeridir.

Varsayılan olarak, ifadeler rapor tasarımı yüzeyinde basit veya karmaşık ifadeler olarak görünür.

  • Basit: Basit ifade, yerleşik koleksiyondaki tek bir öğeye (örneğin, veri kümesi alanı, parametre veya yerleşik alan) başvuru içerir. Tasarım yüzeyinde köşeli ayraç içinde basit bir ifade görünür. Örneğin, [FieldName] temel alınan ifadeye =Fields!FieldName.Valuekarşılık gelir. Rapor düzenini oluştururken ve öğeleri Rapor Verileri bölmesinden tasarım yüzeyine sürüklerken basit ifadeler sizin için otomatik olarak oluşturulur. Farklı yerleşik koleksiyonları temsil eden simgeler hakkında daha fazla bilgi için bkz . Basit ifadeler için ön ek simgelerini anlama.

  • Karmaşık: Karmaşık bir ifade birden çok yerleşik başvuruya, işleçlere ve işlev çağrılarına başvurular içerir. Karmaşık bir ifade, ifade değeri basit bir başvurudan fazlasını içerdiğinde olduğu gibi <<Expr>> görünür. İfadeyi görüntülemek için üzerine gelin ve araç ipucu nu kullanın. İfadeyi düzenlemek için İfade iletişim kutusunda açın.

Aşağıdaki şekilde hem metin kutuları hem de yer tutucu metinler için tipik basit ve karmaşık ifadeler gösterilmektedir.

Screenshot of the expression default format.

İfadelerin metni yerine örnek değerleri görüntülemek için, metin kutusuna veya yer tutucu metne biçimlendirme uygulayın. Aşağıdaki şekilde örnek değerleri gösterecek şekilde geçiş yapılan rapor tasarım yüzeyi gösterilmektedir:

Screenshot of expression sample values.

Basit ifadelerdeki ön ek simgelerini anlama

Basit ifadeler, başvurunun bir alana mı, parametreye mi, yerleşik koleksiyona mı yoksa ReportItems koleksiyonuna mı olduğunu göstermek için simgeler kullanır. Aşağıdaki tabloda görüntüleme ve ifade metni örnekleri gösterilmektedir:

Madde Görüntüleme metni örneği İfade metni örneği
Veri kümesi alanları [Sales]

[SUM(Sales)]

[FIRST(Store)]
=Fields!Sales.Value

=Sum(Fields!Sales.Value)

=First(Fields!Store.Value)
Rapor parametreleri [@Param]

[@Param.Label]
=Parameters!Param.Value

=Parameters!Param.Label
Yerleşik alanlar [&ReportName] =Globals!ReportName.Value
Metin görüntüleme için kullanılan değişmez karakterler \[Sales\] [Sales]

Karmaşık ifadeler yazma

İfadeler işlevlere, işleçlere, sabitlere, alanlara, parametrelere, yerleşik koleksiyonlardaki öğelere ve ekli özel kodlara veya özel derlemelere başvurular içerebilir.

Aşağıdaki tabloda, bir ifadeye ekleyebileceğiniz başvuru türleri listelenmiştir:

Başvurular Açıklama Örnek
Sabitler Yazı tipi renkleri gibi sabit değerler gerektiren özellikler için etkileşimli olarak erişebileceğiniz sabitleri açıklar. ="Blue"
İşleçler bir ifadedeki başvuruları birleştirmek için kullanabileceğiniz işleçleri açıklar. Örneğin, dizeleri birleştirmek için & işleci kullanılır. ="The report ran at: " & Globals!ExecutionTime & "."
Yerleşik koleksiyonlar , ve Variablesgibi FieldsParametersbir ifadeye ekleyebileceğiniz yerleşik koleksiyonları açıklar. =Fields!Sales.Value

=Parameters!Store.Value

=Variables!MyCalculation.Value
Yerleşik rapor ve toplama işlevleri bir ifadeden erişebileceğiniz veya Previousgibi Sum yerleşik işlevleri açıklar. =Previous(Sum(Fields!Sales.Value))
Rapor Oluşturucusu ifadelerinde özel kod ve derleme başvuruları Yerleşik CLR sınıflarına ve xref:System.Convert, diğer CLR sınıflarınaxref:System.Math, Visual Basic çalışma zamanı kitaplığı işlevlerine veya bir dış derlemeden yöntemlere nasıl erişebileceğinizi açıklar.

Raporunuza eklenmiş özel koda nasıl erişebileceğinizi veya hem rapor istemcisine hem de rapor sunucusuna özel bir derleme olarak derleyip yüklediğinizi açıklar.
=Sum(Fields!Sales.Value)

=CDate(Fields!SalesDate.Value)

=DateAdd("d",3,Fields!BirthDate.Value)

=Code.ToUSD(Fields!StandardCost.Value)

İfadeleri doğrulama

Belirli bir rapor öğesi özelliği için ifade oluşturduğunuzda, ifadeye ekleyebileceğiniz başvurular, rapor öğesi özelliğinin kabul edebildiği değerlere ve özelliğin değerlendirildiği kapsama bağlıdır. Örneğin:

  • Varsayılan olarak ifade, ifade [Sum] değerlendirildiğinde kapsamdaki verilerin toplamını hesaplar. Tablo hücresi için kapsam, satır ve sütun grubu üyeliklerine bağlıdır.

  • Font özelliğinin değeri için değerin yazı tipinin adını değerlendirmesi gerekir.

  • İfade söz dizimi tasarım zamanında doğrulanır. İfade kapsamı doğrulaması, raporu yayımladığınızda gerçekleşir. Gerçek verilere bağlı doğrulama için hatalar yalnızca çalışma zamanında algılanabilir. Bu ifadelerden bazıları, işlenen raporda hata iletisi olarak #Error oluşturur.

Sonraki adımlar