Opções de classificação para visuais do Power BI

  • Artigo

Este artigo descreve as diferentes opções disponíveis para especificar a maneira como um visual classifica itens no Power BI.

Por padrão, um visual não dá suporte à modificação de sua ordem de classificação, a menos que declarado de outra forma no arquivo capabilities.json.

A funcionalidade de classificação requer pelo menos um dos parâmetros a seguir.

Classificação padrão

A opção default é a forma mais simples. Ele permite que o usuário classifique de acordo com qualquer campo e direção (crescente ou decrescente). O usuário seleciona a direção e o campo no menu mais opções.

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

Para habilitar a classificação padrão, adicione o seguinte código ao arquivo capabilities.json:

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

Classificação implícita

A classificação implícita permite que você predefina uma matriz de classificação usando o parâmetro clauses, que descreve a classificação para cada função de dados. O usuário não pode alterar a ordem de classificação, portanto, o Power BI não exibe opções de classificação no menu do visual. No entanto, o Power BI classifica os dados de acordo com as configurações especificadas.

Para habilitar a classificação implícita, adicione as clauses implícitas ao seu arquivo capabilities.json. Os parâmetros clauses podem conter vários objetos com dois parâmetros cada um:

  • role: Determina DataMapping para classificação
  • direction: Determina a direção da classificação (1 = crescente, 2 = decrescente)
    "sorting": {
        "implicit": {
            "clauses": [
                {
                    "role": "category",
                    "direction": 1
                },
                {
                    "role": "measure",
                    "direction": 2
                }
            ]
        }
    }

Classificação personalizada

A classificação personalizada dá ao desenvolvedor mais flexibilidade ao classificar. O desenvolvedor pode:

  • Permitir que o usuário classifique por vários campos de uma vez.
  • Definir uma ordem de classificação padrão para os dados
  • Permitir operações de classificação personalizadas durante o runtime

Habilitar a classificação personalizada

Para habilitar a classificação personalizada, adicione o seguinte código ao seu arquivo capabilities.json:

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

Exemplo: API de classificação personalizada

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

Conteúdo relacionado