Sorteeropties voor Power BI-visuals

In dit artikel worden de verschillende opties beschreven voor het opgeven van de manier waarop een visual items sorteert in Power BI.

Standaard biedt een visual geen ondersteuning voor het wijzigen van de sorteervolgorde, tenzij anders vermeld in het bestand capabilities.json .

Voor de sorteerfunctie zijn ten minste een van de volgende parameters vereist.

Standaardsortering

De default optie is de eenvoudigste vorm. Hiermee kan de gebruiker sorteren op basis van een willekeurig veld en elke richting (oplopend of aflopend). De gebruiker selecteert de richting en het veld in het menu meer opties .

Screenshot of table of US states with default sorting options the context menu.

Als u standaardsortering wilt inschakelen, voegt u de volgende code toe aan uw capabilities.json-bestand:

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

Impliciete sortering

Met impliciete sortering kunt u een sorteermatrix vooraf definiƫren met behulp van een parameter clauses, waarin de sortering voor elke gegevensrol wordt beschreven. De gebruiker kan de sorteervolgorde niet wijzigen, zodat in Power BI geen sorteeropties worden weergegeven in het menu van de visual. Power BI sorteert echter wel gegevens volgens de opgegeven instellingen.

Als u impliciet sorteren wilt inschakelen, kunt u de impliciete clauses parameters voor uw capabilities.json-bestandclauses toevoegen aan verschillende objecten met elk twee parameters:

  • role: Bepaalt DataMapping voor sorteren
  • direction: Bepaalt de sorteerrichting (1 = Oplopend, 2 = Aflopend)
    "sorting": {
        "implicit": {
            "clauses": [
                {
                    "role": "category",
                    "direction": 1
                },
                {
                    "role": "measure",
                    "direction": 2
                }
            ]
        }
    }

Aangepaste sortering

Aangepaste sortering biedt de ontwikkelaar meer flexibiliteit bij het sorteren. De ontwikkelaar kan:

  • Hiermee kan de gebruiker op meerdere velden tegelijk sorteren.
  • Een standaardsorteringsvolgorde instellen voor de gegevens
  • Aangepaste sorteerbewerkingen toestaan tijdens runtime

Aangepaste sortering inschakelen

Als u aangepaste sortering wilt inschakelen, voegt u de volgende code toe aan uw capabilities.json-bestand :

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

Voorbeeld: Aangepaste sorteer-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);