Compartilhar via


Classificar um visual por um campo de dados de destino

No Power BI, você pode alterar a aparência de um visual classificando-o por campos de dados diferentes. Ao alterar a forma como você classifica um visual, você pode realçar as informações que deseja transmitir. Se você estiver usando dados numéricos (como números de vendas) ou dados de texto (como nomes de estado), poderá classificar seus visuais conforme desejado. O Power BI oferece muita flexibilidade para classificação e menus rápidos para você usar. Para saber mais, consulte Alterar como um gráfico é classificado em um relatório do Power BI

Captura de tela que mostra um visual do Power B I com o menu de opções aberto e realçado os comandos de classificação.

Você pode usar a API visual.sortBy para alterar a forma como classifica um visual por um de seus campos de dados. Você também pode controlar a direção da classificação.

Como classificar um visual

A classe Do Cliente do Power BI define um método como:

visual.sortBy(request: ISortByVisualRequest): Promise<void>

A interface ISortByVisualRequest inclui uma definição para a solicitação de classificação:

export interface ISortByVisualRequest {
    orderBy: ITarget;
    direction: SortDirection;
}
  • orderBy, o campo de dados de destino da classificação. Os campos de dados pelos quais o visual pode ser classificado são encontrados no menu de opção do visual no comando de menu Classificar por , saiba mais sobre Usar destinos para selecionar qual campo de dados agir em.

    Captura de tela que mostra um visual do Power B I com o menu de opções aberto e o sub menu 'classificar por' é expandido.

  • direção, a direção da classificação. A enumeração SortDirection define a direção de classificação como Ascending ou Descending.

    enum SortDirection {
        Ascending = 1,
        Descending = 2,
    }
    

Exemplo

Para obter as páginas de um relatório, localize a página ativa e obtenha os visuais. O visual é encontrado com o nome exclusivo VisualContainer1 e classificado decrescente Total Category Volume medida na tabela SalesFact:

let pages = await report.getPages();

// Retrieve active page
var activePage = pages.find(function (page) { return page.isActive });

let visuals = await activePage.getVisuals();

// Retrieve target visual (replace "VisualContainer1" with requested visual name)
var visual = visuals.find(function (visual) { return visual.name === "VisualContainer1" });

const request = {
    // Set the target data field of the sort
    orderBy: {
        table: "SalesFact",
        measure: "Total Category Volume"
    },
    direction: models.SortDirection.Descending
};

await visual.sortBy(request);

Para classificar um visual por um destino de coluna:

const request = {
  // Set the target data field of the sort
    orderBy: {
        table: "Store",
        column: "Name"
    },
    direction: models.SortDirection.Ascending
};

await visual.sortBy(request);