Delen via


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 capabilities.json-bestand .

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 .

Schermopname van de tabel met amerikaanse statussen met standaard sorteeropties in het contextmenu.

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 toevoegen aan uw capabilities.json bestand clauses meerdere objecten met elk twee parameters bevatten:

  • 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);