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
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
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 .direção, a direção da classificação. A enumeração
SortDirection
define a direção de classificação comoAscending
ouDescending
.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);