Αίτηση για συγκεντρωτικά δεδομένα μερικών αθροισμάτων

Το API συνόλου και μερικών αθροισμάτων επιτρέπει στις προσαρμοσμένες απεικονίσεις με προβολή δεδομένων μήτρας να ζητούν συγκεντρωτικά δεδομένα μερικών αθροισμάτων από τον κεντρικό υπολογιστή Power BI. Τα μερικά αθροίσματα υπολογίζονται για ολόκληρο το σημασιολογικό μοντέλο μήτρας ή καθορίζονται για μεμονωμένα επίπεδα της ιεραρχίας δεδομένων μήτρας. Ανατρέξτε στο δείγμα αναφοράς για ένα παράδειγμα του API συνόλου και μερικών αθροισμάτων σε μια απεικόνιση Power BI.

Κάθε φορά που μια απεικόνιση ανανεώνει τα δεδομένα της, η απεικόνιση εκδίδει μια αίτηση λήψης δεδομένων στο παρασκήνιο του Power BI. Αυτές οι αιτήσεις δεδομένων αφορούν συνήθως τιμές των πεδίων που έχει σύρει ο χρήστης στους χώρους συγκέντρωσης πεδίων της απεικόνισης. Μερικές φορές η απεικόνιση χρειάζεται άλλες συναθροίσεις ή μερικά αθροίσματα (για παράδειγμα, άθροισμα ή πλήθος) που εφαρμόζονται στους χώρους συγκέντρωσης πεδίων. Το API συνόλου και μερικών αθροισμάτων σάς επιτρέπει να προσαρμόσετε το εξερχόμενο ερώτημα δεδομένων για να ζητήσετε περισσότερα δεδομένα συνάθροισης ή μερικών αθροισμάτων.

Το API μερικών αθροισμάτων

Το API προσφέρει την ακόλουθη προσαρμογή για κάθε τύπο προβολής δεδομένων (προς το παρόν, μόνο προβολές δεδομένων μήτρας).

• rowSubtotals: (δυαδική τιμή) Υποδεικνύει εάν τα δεδομένα μερικών αθροισμάτων πρέπει να ζητηθούν για όλα τα πεδία στον χώρο συγκέντρωσης πεδίων γραμμών.
• rowSubtotalsPerLevel: (δυαδική τιμή) Υποδεικνύει εάν τα δεδομένα μερικών αθροισμάτων μπορούν να εναλλάσσονται για μεμονωμένα πεδία στον χώρο συγκέντρωσης πεδίων της γραμμής.
• columnSubtotals: (δυαδική τιμή) Υποδεικνύει εάν πρέπει να ζητηθούν τα δεδομένα μερικό άθροισμα για όλα τα πεδία στον χώρο συγκέντρωσης πεδίων στηλών.
• columnSubtotalsPerLevel: (δυαδική τιμή) Υποδεικνύει εάν οι δεδομένα μερικό άθροισμα μπορούν να εναλλάσσονται για μεμονωμένα πεδία στην ομάδα πεδίων στηλών.
• levelSubtotalEnabled: (δυαδική τιμή) Υποδεικνύει εάν τα μερικά αθροίσματα ζητούνται για τη γραμμή ή τη στήλη. Σε αντίθεση με όλες τις άλλες ιδιότητες, αυτή η ιδιότητα εφαρμόζεται σε μεμονωμένες γραμμές ή στήλες.
• rowSubtotalsType: ("Top" ή "Bottom") Υποδεικνύει εάν η γραμμή με τα συνολικά δεδομένα πρέπει να ανακτηθεί πριν (top) ή μετά το (bottom) τα υπόλοιπα δεδομένα. Εάν αυτή η ιδιότητα έχει οριστεί σε bottom, το σύνολο μπορεί να εμφανιστεί μόνο μετά τη λήψη όλων των δεδομένων. Η προεπιλογή είναι bottom.

Σε κάθε έναν από αυτούς τους διακόπτες ανατίθεται μια τιμή με βάση τις σχετικές ιδιότητες στο τμήμα παραθύρου ιδιοτήτων και τις προεπιλογές.

Τρόπος χρήσης του API μερικών αθροισμάτων

Το αρχείο capabilities.json της απεικόνισης πρέπει να:

• καθορίστε την ιδιότητα στην οποία κάνουν εναλλαγή αντιστοιχίζονται κάθε .
• Εισαγάγετε την προεπιλεγμένη τιμή που θα χρησιμοποιηθεί εάν η ιδιότητα δεν έχει οριστεί.

Οι διακόπτες χρησιμοποιούν μια μορφή όπως το παρακάτω παράδειγμα:

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

Ο προηγούμενος κώδικας υποδεικνύει ότι τα μερικά αθροίσματα γραμμών ενεργοποιούνται από την ιδιότητα rowSubtotals στο αντικείμενο subTotals. Η ιδιότητα έχει μια προεπιλεγμένη τιμή true.

Το API ενεργοποιείται αυτόματα για μια απεικόνιση κάθε φορά που η δομή των μερικών αθροισμάτων και όλες οι αντιστοιχίσεις εναλλαγής ορίζονται στο αρχείο capabilities.json.

Ο ακόλουθος κώδικας είναι ένα παράδειγμα της πλήρους ρύθμισης παραμέτρων API στο αρχείο capabilities.json (έχει αντιγραφεί από το δείγμα απεικόνισης API):

"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"
            }
        } 
    }

Είναι σημαντικό η λειτουργία enumerateProperties() της απεικόνισης να ευθυγραμμίζεται με τις προεπιλογές που καθορίζονται στο αρχείο capabilities.json. Η λογική προσαρμογής λειτουργεί σύμφωνα με τις καθορισμένες προεπιλογές. Εάν η συνάρτηση enumerateProperties() και οι προεπιλογές δεν είναι στοιχισμένες, οι πραγματικές προσαρμογές μερικών αθροισμάτων μπορεί να διαφέρουν από τις προσδοκίες του χρήστη.

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

Για να εξετάσετε τις διαθέσιμες προσαρμογές, αναπτύξτε το αναπτυσσόμενο μενού Μερικά αθροίσματα στο τμήμα παραθύρου ιδιοτήτων Μορφοποίηση. Τροποποιήστε τις ρυθμίσεις μερικών αθροισμάτων και παρακολουθήστε τις αλλαγές στην παρουσίαση μερικών αθροισμάτων (με το όνομα Totals) στο τμήμα παραθύρου Απεικονίσεις.

Ζητήματα και περιορισμοί

• Η ιδιότητα rowSubtotalsType είναι διαθέσιμη μόνο για γραμμές. Δεν μπορείτε να ορίσετε μερικά αθροίσματα στηλών στην αρχή μιας στήλης.

• Η δυνατότητα ανάπτυξης και σύμπτυξης παρακάμπτει . Τα μερικά αθροίσματα εμφανίζονται όταν αναπτύσσονται οι γραμμές, ακόμα και αν rowSubtotals έχει οριστεί σε false.

Σχετικό περιεχόμενο

Προσθήκη αλληλεπίδρασης σε απεικόνιση με χρήση επιλογών απεικονίσεων Power BI