Toplanan alt toplam verilerini isteme

Toplam ve Alt Toplam API'si, matris veri görünümüne sahip özel görsellerin Power BI konağından toplanan alt toplam verileri istemesine olanak tanır. Alt toplamlar matris semantik modelinin tamamı için hesaplanır veya matris veri hiyerarşisinin tek tek düzeyleri için belirtilir. Power BI görselindeki Toplam ve Alt Toplam API'sinin bir örneği için örnek rapor bakın.

Not

Alt toplam verilerinin istenilmesi 2.6.0 ve sonraki sürümlerde desteklenir. rowSubtotalType özelliği 5.1.0 ve sonraki sürümlerde kullanılabilir. Hangi sürümü kullandığınızı öğrenmek için pbiviz.json dosyasındaki apiVersion denetleyin.

Görsel, verilerini her yenileyende Power BI arka ucuna bir veri getirme isteği gönderir. Bu veri istekleri genellikle kullanıcının görselin alan kuyularına sürüklemiş olduğu alanların değerlerine yöneliktir. Bazen görselin alan kuyularına başka toplamalar veya alt toplamlar (örneğin, toplam veya sayı) uygulanması gerekir. Toplam ve Alt Toplam API'si, daha fazla toplama veya alt toplam verisi istemek için giden veri sorgusunu özelleştirmenize olanak tanır.

Alt toplamlar API'si

API, her veri görünümü türü için aşağıdaki özelleştirmeyi sunar (şu anda yalnızca matris veri görünümleri).

• rowSubtotals: (boolean) Satırlar alanında bulunan tüm alanlar için alt toplam verilerinin istenip istenmediğini belirtir.
• rowSubtotalsPerLevel: (mantıksal) Alt toplam verilerinin satırın alan kuyusunda tek tek alanlar için değiştirilebilir olup olmadığını gösterir.
• columnSubtotals: (boolean) Sütun alanı kuyusunda tüm alanlar için alt toplam verilerinin istenip istenmediğini gösterir.
• columnSubtotalsPerLevel: (boole) Sütun alanı kutusunda tek tek alanlar için alt toplam verilerinin değiştirilip değiştirilebileceğini gösterir.
• levelSubtotalEnabled: (boole) Satır veya sütun için alt toplamların istenip istenmediğini gösterir. Diğer tüm özelliklerden farklı olarak, bu özellik tek tek satırlara veya sütunlara uygulanır.
• rowSubtotalsType: ("Üst" veya "Alt") toplam verisine sahip satırın, verilerin geri kalanından önce (top) veya sonra (bottom) alınması gerekip gerekmediğini belirtir. Bu özellik bottomolarak ayarlanırsa, toplam yalnızca tüm veriler getirildikten sonra görüntülenebilir. Varsayılan değer bottom.

Bu anahtarların her birine, özellik bölmesindeki ilgili özelliklere ve varsayılanlara göre bir değer atanır.

Alt toplam API'sini nasıl kullanılır

Görselin capabilities.json dosyası aşağıdakileri yapmak zorunda:

• Her anahtarının hangi özelliğine karşılık geldiğini belirtin.
• özelliği tanımlanmamışsa kullanılacak varsayılan değeri belirtin.

Anahtarlar aşağıdaki örneğe benzer bir biçim kullanır:

    "rowSubtotals": { 
                "propertyIdentifier": { 
                    "objectName": "subTotals", 
                    "propertyName": "rowSubtotals" 
                }, 
                "defaultValue": true 
            },

Yukarıdaki kod, satır alt toplamlarının subTotals nesnesindeki özellik rowSubtotals tarafından etkinleştirildiğini gösterir. özelliği varsayılan truedeğerine sahiptir.

Api, alt toplam yapısı ve tüm anahtar eşlemeleri capabilities.json dosyasında tanımlandığında görsel için otomatik olarak etkinleştirilir.

Aşağıdaki kod, capabilities.json dosyasındaki (API örnek görselinden kopyalanan) tam API yapılandırmasının bir örneğidir:

"subtotals": { 
        "matrix": { 
            "rowSubtotals": { 
                "propertyIdentifier": { 
                    "objectName": "subTotals", 
                    "propertyName": "rowSubtotals" 
                }, 
                "defaultValue": true 
            }, 
            "rowSubtotalsPerLevel": { 
                "propertyIdentifier": { 
                    "objectName": "subTotals", 
                    "propertyName": "perRowLevel" 
                }, 
                "defaultValue": false 
            }, 
            "columnSubtotals": { 
                "propertyIdentifier": { 
                    "objectName": "subTotals", 
                    "propertyName": "columnSubtotals" 
                }, 
                "defaultValue": true 
            }, 
            "columnSubtotalsPerLevel": { 
                "propertyIdentifier": { 
                    "objectName": "subTotals", 
                    "propertyName": "perColumnLevel" 
                }, 
                "defaultValue": false 
            }, 
            "levelSubtotalEnabled": { 
                "propertyIdentifier": { 
                    "objectName": "subTotals", 
                    "propertyName": "levelSubtotalEnabled" 
                }, 
                "defaultValue": true 
            },
            "rowSubtotalsType": {
                "propertyIdentifier": {
                    "objectName": "subtotals",
                    "propertyName": "rowSubtotalsType"
                },
                "defaultValue": "Bottom"
            }
        } 
    }

Görselin enumerateProperties() işlevinin capabilities.json dosyasında belirtilen varsayılan değerlerle uyumlu olması önemlidir. Özelleştirme mantığı belirtilen varsayılan değerlere göre çalışır. enumerateProperties() işlevi ve varsayılanlar hizalanmamışsa, gerçek alt toplam özelleştirmeleri kullanıcı beklentilerinden farklı olabilir.

enum RowSubtotalType {
        Top = "Top",
        Bottom = "Bottom",
   }

Kullanılabilir özelleştirmeleri gözden geçirmek için Biçim özellik bölmesinde Alt Toplamlar açılan menüsünü genişletin. Alt toplamlar ayarlarını değiştirin ve Görselleştirmeler bölmesindeki alt toplamlar sunusunda (Toplamlaradlı) değişiklikleri izleyin.

Dikkat edilmesi gerekenler ve sınırlamalar

• rowSubtotalsType özelliği yalnızca satırlar için kullanılabilir. Sütun alt toplamlarını sütunun başına ayarlayamazsınız.

• genişletme ve daraltma özelliği rowSubtotalsgeçersiz kılar. rowSubtotals falseolarak ayarlansa bile, satırlar genişletildiğinde alt toplamlar görüntülenir.

İlgili içerik

Power BI görsel seçimlerini kullanarak görsele etkileşim ekleme