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 toplanmış 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 rapora bakın.

Dekont

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ını denetleyin apiVersion.

Bir görsel verilerini her yenileyende, görsel 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: (boole) Satırlar alanındaki tüm alanlar için alt toplam verilerinin istenip istenmediğini gösterir.
• rowSubtotalsPerLevel: (boole) Satırın alan kutusunda tek tek alanlar için alt toplam verilerinin değiştirilip değiştirilebileceğini gösterir.
• columnSubtotals: (boole) Sütun alanındaki tüm alanlar için alt toplam verilerinin istenip istenmediğini gösterir.
• columnSubtotalsPerLevel: (boole) Sütun alanındaki 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 veri içeren satırın verilerin geri kalanından önce (top) veya sonra (bottom) alınması gerekip gerekmediğini gösterir. Bu özellik olarak bottomayarlanırsa, toplam yalnızca tüm veriler getirildikten sonra görüntülenebilir. Varsayılan değer: bottom.

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

Alt toplam API'sini kullanma

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

• yukarıdaki anahtarların her birinin eşleyeceğiniz özelliği 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 nesnedeki subTotals özelliği rowSubtotals tarafından etkinleştirildiğini gösterir. özelliğinin varsayılan değeri vardır true.

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) eksiksiz BIR API yapılandırması ö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() İşlev 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ölmesindeki 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 (Toplamlar adlı) yapılan değişiklikleri izleyin.

Dikkat edilecekler 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 geçersiz kılarrowSubtotals. Alt toplamlar, satırlar false olarak ayarlansa rowSubtotalsbile genişletildiğinde görüntülenir.

İlgili içerik

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