Freigeben über


Sortieroptionen für Power Bi-Visuals

In diesem Artikel werden die verschiedenen Optionen zum Festlegen der Art und Weise beschrieben, wie Elemente von einem visuellen Element in Power BI sortiert werden.

Die Änderung der Sortierreihenfolge wird von einem Visual standardmäßig nicht unterstützt, es sei denn, dies wurde explizit in der capabilities.json-Datei angegeben.

Die Sortierfunktion erfordert mindestens einen der folgenden Parameter:

Standardsortierung

Die default-Option ist die einfachste Form. Sie ermöglicht dem Benutzer, nach einem beliebigen Feld und in einer beliebigen Richtung (aufsteigend oder absteigend) zu sortieren. Der Benutzer wählt die Richtung und das Feld im Menü Weitere Optionen aus.

Screenshot: Tabelle der US-Bundesstaaten mit Standardoptionen für die Sortierung im Kontextmenü

Um die Standardsortierung zu aktivieren, fügen Sie der Datei „capabilities.json“ den folgenden Code hinzu:

    "sorting": {
        "default": {   }
    }

Implizite Sortierung

Die implizite Sortierung ermöglicht die Vorabdefinition eines Sortierarrays mithilfe des Parameters clauses, der die Sortierung für jede Datenrolle beschreibt. Der Benutzer kann die Sortierreihenfolge nicht ändern. Daher zeigt Power BI keine Sortieroptionen im Menü des visuellen Elements an. Allerdings werden Daten von Power BI gemäß den festgelegten Einstellungen sortiert.

Zum Aktivieren der impliziten Sortierung fügen Sie die implizite clauses zu Ihrer capabilities.json-Datei hinzu. clauses-Parameter können mehrere Objekte mit jeweils zwei Parametern enthalten:

  • role: Bestimmt DataMapping für die Sortierung
  • direction: Bestimmt die Sortierrichtung (1 = aufsteigend, 2 = absteigend)
    "sorting": {
        "implicit": {
            "clauses": [
                {
                    "role": "category",
                    "direction": 1
                },
                {
                    "role": "measure",
                    "direction": 2
                }
            ]
        }
    }

Benutzerdefinierte Sortierung

Die benutzerdefinierte Sortierung bietet dem Entwickler mehr Flexibilität beim Sortieren. Der Entwickler hat folgende Möglichkeiten:

  • Er kann dem Benutzer gestatten, jeweils nach mehreren Feldern zu sortieren.
  • Er kann eine Standardsortierreihenfolge für die Daten festlegen.
  • Er kann benutzerdefinierte Sortiervorgänge während der Laufzeit zulassen.

Aktivieren der benutzerdefinierten Sortierung

Zum Aktivieren der benutzerdefinierten Sortierung fügen Sie der Datei capabilities.json den folgenden Code hinzu:

    "sorting": {
        "custom": {} 
    }

Beispiel: Benutzerdefinierte Sortier-API

let queryName1 = this.dataView.matrix.columns.levels[0].sources[0].queryName;
let queryName2 = this.dataView.matrix.columns.levels[1].sources[0].queryName;
let args: CustomVisualApplyCustomSortArgs = {
    sortDescriptors: [
        {
            queryName: queryName1,
            sortDirection: powerbi.SortDirection.Ascending
        },
        {
            queryName: queryName2,
            sortDirection: powerbi.SortDirection.Descending
        },
    ]
};
this.host.applyCustomSort(args);