Toplama İşlevi (Rapor Oluşturucusu ve SSRS)

Belirtilen ifadenin, veri sağlayıcısı tarafından sağlanan özel toplamasını döndürür.

[!NOT]

SQL Server Data Tools'daki Rapor Oluşturucusu ve Rapor Tasarımcısı ile rapor tanımları (.rdl) oluşturabilir ve bunları değiştirebilirsiniz. Her yazma ortamı raporları ve ilişkili öğeleri oluşturmak, açmak ve kaydetmek için farklı yollar sağlar. Daha fazla bilgi için, Web'de microsoft.com sitesinde Rapor Tasarımcısı'nda ve Oluşturucusu'nda Rapor Tasarlama makalesine bakın.

Sözdizimi

Aggregate(expression, scope)

Parametreler

• expression
  Toplama işleminin gerçekleştirileceği ifade. İfadenin basit bir alan başvurusu olması gerekir.

• scope
  (String) Toplama işlevinin uygulanacağı rapor öğelerini içeren veri kümesinin, grubun veya veri bölgesinin adı. Scope değeri bir dize sabiti olmalıdır vebir ifade olamaz. scope belirtilmezse, geçerli kapsam kullanılır.

Dönüş Türü

Dönüş türü, veri sağlayıcısı tarafından belirlenir. Veri sağlayıcısı bu işlevi desteklemiyorsa veya veriler kullanılamıyorsa Nothing değerini döndürür.

Açıklamalar

Aggregate işlevi dış veri kaynağı üzerinde hesaplanan toplamları kullanmanın bir yolunu sağlar. Bu özellikle ilgili destek veri uzantısına göre belirlenir. Örneğin, SQL Server Analysis Services veri işleme uzantısı bir MDX sorgusundan düzleştirilmiş satır kümeleri alır. Sonuç kümesindeki bazı satırlar, veri kaynağı sunucusunda hesaplanan toplam değerleri içerebilir. Bunlar sunucu toplamları olarak da bilinir. Sunucu toplamlarını Analysis Services için grafik sorgu tasarımcısında görüntülemek için, araç çubuğundaki Toplamı Göster düğmesini kullanabilirsiniz. Daha fazla bilgi için bkz. Analysis Services MDX Sorgu Tasarımcısı Kullanıcı Arabirimi (Rapor Oluşturucusu).

Bir Tablix veri bölgesinin ayrıntı satırlarındaki toplu ve ayrıntı veri kümesi değerlerinin birleşimini görüntülerken, sunucu toplamaları ayrıntı verisi olmadıklarından eklenmezler. Ancak, veri kümesi için alınan tüm değerleri görüntülemek ve toplama verilerinin hesaplanma ve görüntülenme biçimini özelleştirmek isteyebilirsiniz.

Reporting Services, ayrıntı satırlarında sunucu toplamalarının görüntülenip görüntülenmeyeceğini belirlemek üzere raporunuzdaki ifadelerde Aggregate işlevinin kullanımını saptar. Bir veri bölgesindeki bir ifadeye Aggregate işlevini eklerseniz, sunucu toplamaları ayrıntı satırlarında değil, yalnızca grup toplamı veya genel toplam satırlarında görüntülenebilir. Ayrıntı satırlarında sunucu toplamalarını görüntülemek istiyorsanız, Aggregate işlevini kullanmayın.

Bu varsayılan davranışı, Veri Kümesi Özellikleri iletişim kutusunda Alt toplamları ayrıntı olarak yorumla değerini değiştirerek değiştirebilirsiniz. Bu seçenek True olarak ayarlandığında, sunucu toplamaları dahil tüm veriler ayrıntı verileri olarak görüntülenir. False olarak ayarlandığında, sunucu toplamaları toplamlar olarak görüntülenir. Bu özelliğin ayarı, bu veri kümesiyle bağlantılı tüm veri bölgelerini etkiler.

[!NOT]

Rapor öğesi için, Aggregate işlevine başvuru yapan tüm içeren grupların grup ifadeleri için, [FieldName] gibi basit alan başvurularının olması gerekir. Karmaşık grup ifadeleri kullanan bir veri bölgesinde Aggregate işlevini kullanamazsınız. SQL Server Analysis Services veri işleme uzantısı için sorgunuzun, toplamayı Aggregate işlevini kullanarak desteklemek için LevelProperty türünde MDX alanlarını içermesi gerekir (MemberProperty değil).

Expression, aşağıdaki özel durumlar ve koşullarla iç içe toplama işlevlerine yönelik çağrılar içerebilir:

• İç içe toplamalar için Scope dış toplamanın kapsamıyla aynı olmalı veya onun içinde olmalıdır. İfadedeki tüm ayrık kapsamlar için, bir kapsamında diğer tüm kapsamlarla bir alt ilişkisi olması gerekir.

• İç içe toplamalar için Scope bir veri kümesinin adı olamaz.

• Expression First, Last, Previous veya RunningValue işlevlerini içeremez.

• Expression, recursive belirten iç içe toplamalar içeremez.

Daha fazla bilgi için bkz. Toplama İşlevleri Başvurusu (Rapor Oluşturucusu ve SSRS) ve Toplamlar, Toplamalar ve Yerleşik Koleksiyonlar İçin İfade Kapsamı (Rapor Oluşturucusu ve SSRS).

Özyinelemeli toplamalar hakkında daha fazla bilgi için bkz. Yinelemeli Hiyerarşi Grupları Oluşturma (Rapor Oluşturucusu ve SSRS).

Aggregate ve Sum İşlevlerini Karşılaştırma

Aggregate işlevi, veri sağlayıcısı veya veri işleme uzantısı tarafından hesaplanan bir değer döndürmesi ile Sum gibi sayısal toplama işlevlerinden ayrılır. Sum gibi sayısal toplama işlevleri, scope parametresi tarafından belirlenen veri kümesindeki bir dizi veri üzerinde rapor işlemcisi tarafından hesaplanan bir değer döndürür. Daha fazla bilgi için, Toplama İşlevleri Başvurusu (Rapor Oluşturucusu ve SSRS) konusunda listelenen toplama işlevlerine bakın.

Örnek

Aşağıdaki kod örneğinde, LineTotal alanı için bir sunucu toplaması alan bir ifade görüntülenir. Bu ifade GroupbyOrder grubuna ait olan satırdaki bir hücreye eklenir.

=Aggregate(Fields!LineTotal.Value, "GroupbyOrder")

Ayrıca bkz.

Başvuru

İfade Örnekleri (Rapor Oluşturucusu ve SSRS)

Kavramlar

Raporlarda İfade Kullanımı (Rapor Oluşturucusu ve SSRS)

İfadelerdeki Veri Türleri (Rapor Oluşturucusu ve SSRS)

Toplamlar, Toplamalar ve Yerleşik Koleksiyonlar İçin İfade Kapsamı (Rapor Oluşturucusu ve SSRS)