Como criar um visual personalizado no Microsoft Power BI

Editado 6 dias atrás por ExtremeHow Equipe Editorial

Microsoft Power BIVisuais personalizadosVisualização de dadosJanelasMacPythonRAvançadoInteligência empresarialDesenvolvimentoPersonalização

O Microsoft Power BI é uma ferramenta poderosa para visualizar dados e criar relatórios. Ele oferece uma ampla gama de visuais padrão, mas em alguns casos, você pode querer ajustar seus visuais para atender às suas necessidades. Criar visuais personalizados no Power BI permite que você vá além do conjunto padrão de visuais e personalize a representação visual de seus dados. Este guia o orienta no processo de criação de visuais personalizados no Power BI de forma passo a passo.

Lançamento

Antes de criar um visual personalizado, vamos entender os pré-requisitos necessários para o processo de configuração. Os visuais personalizados do Power BI são construídos usando um conjunto de tecnologias que inclui TypeScript, D3.js, Node.js e outras ferramentas relacionadas. Aqui estão os passos e requisitos que você precisa seguir:

Pré-requisitos

• Instalar Node.js: Os visuais personalizados do Power BI são construídos usando Node.js, então certifique-se de ter Node.js (versão 10 ou posterior) instalado em sua máquina.
• Instalar Power BI Visuals Tools: Esta é a interface de linha de comando (CLI) que ajuda você a criar e gerenciar visuais do Power BI. Você pode instalá-lo executando o comando npm install -g powerbi-visuals-tools no seu prompt de comando ou terminal.
• Compreensão básica de TypeScript e D3.js: Estas são as principais tecnologias usadas na construção de visuais personalizados do Power BI. Estar familiarizado com elas será útil para entender e personalizar seus visuais.
• Power BI Desktop instalado: É aqui que você testará e publicará seus visuais personalizados.

Instalar o ambiente de desenvolvimento

Para começar, você precisará configurar seu ambiente de desenvolvimento. Abra um shell de comando no seu computador e crie um diretório onde você planeja criar seus visuais personalizados. Navegue até esse diretório usando o comando cd. Assim que estiver em seu diretório, você criará um novo projeto de visual personalizado usando o Power BI Visuals Tools:

pbiviz new <seu-nome-do-visual>

Este comando cria um novo projeto de visual personalizado do Power BI com a estrutura padrão. Ele cria os arquivos e diretórios necessários para o seu visual personalizado.

Entendendo a estrutura do projeto

O projeto recém-criado vem com um conjunto de arquivos e pastas. Aqui está uma descrição básica do que você pode esperar:

• Visual.ts: Este arquivo contém a lógica principal do seu visual personalizado. Aqui você escreverá o código TypeScript para criar a visualização.
• Capabilities.json: Este arquivo JSON define as capacidades do seu visual personalizado, incluindo funções de dados, mapeamentos de exibição de dados e opções de formatação.
• VisualSettings.ts: Este arquivo define as configurações e propriedades que estarão acessíveis para os usuários ao configurar seu visual.
• Package.json: Este arquivo rastreia a configuração do projeto e as dependências.
• Resources: Esta pasta contém ativos como ícones e arquivos de localização.

Criar um visual personalizado

Agora que seu projeto está configurado, vamos prosseguir para criar visuais personalizados. O desenvolvimento de visuais personalizados envolve várias etapas principais:

1. Definir capacidades

O arquivo capabilities.json é muito importante porque define o que seu visual pode fazer. Aqui está um exemplo muito simples de como esse arquivo pode parecer:

{ "dataRoles": [ { "name": "category", "kind": "Grouping" }, { "name": "measure", "kind": "Measure" } ], "dataViewMappings": [ { "conditions": [ { "category": { "max": 1 }, "measure": { "max": 1 } } ], "categorical": { "categories": { "for": { "in": "category" } }, "values": { "for": { "in": "measure" } } } } ], "objects": { "general": { "displayName": "General", "properties": { "formatString": { "type": { "formatting": { "formatString": true } } } } } } }

Neste exemplo, o visual personalizado está configurado para usar uma categoria e uma medida, e o mapeamento hierárquico é usado para vinculá-los. Personalizar este arquivo permite que você defina os campos e formatos que o visual irá compreender.

2. Escrever a lógica de visualização

O maior trabalho ocorre no Visual.ts. Aqui está um template muito básico de como sua classe TypeScript pode parecer:

export class Visual implements IVisual { private target: HTMLElement; constructor(options: VisualConstructorOptions) { this.target = options.element; this.target.innerHTML = '<div>Este é meu visual personalizado!</div>'; } public update(options: VisualUpdateOptions) { // Sua lógica de processamento de dados e renderização vai aqui } }

No constructor, inicializamos o elemento HTML de nosso visual. O método update é onde você lida com a lógica relacionada a obter novos dados e plotá-los no visual. Use D3.js ou qualquer outra biblioteca de sua escolha para criar seu visual.

3. Estilizar seus visuais

Os estilos para o seu visual personalizado vão em um arquivo CSS, geralmente chamado visual.less. Por exemplo:

.myVisual { color: #333; background-color: #f5f5f5; padding: 10px; }

Isso aplicará estilo CSS ao seu visual personalizado. Você pode importar esse estilo como um módulo no seu Visual.ts ou aplicá-lo diretamente através do código.

4. Configurações personalizáveis

Você pode adicionar opções de personalização ao seu visual, que aparecem no painel de Formato dentro do Power BI. Isso envolve editar VisualSettings.ts e o arquivo capabilities.

class VisualSettings extends DataViewObjectsParser { public general: GeneralSettings = new GeneralSettings(); } class GeneralSettings { public transparency: number = 70; }

"general": { "displayName": "Configurações Gerais", "properties": { "transparency": { "displayName": "Transparência", "type": { "numeric": true } } } }

Isso inclui vincular uma propriedade personalizada (como transparência) e defini-la também no capabilities.json.

Testando e depurando

Depois de desenvolver seu visual para um estado estável, é hora de testar e depurar. Execute o comando:

pbiviz start

Isso iniciará um servidor local e abrirá uma ferramenta de teste ao vivo em seu navegador padrão. Você pode testar seu visual com o conjunto de dados para ver como ele se comporta. O recurso de recarregamento automático atualizará automaticamente a visualização quando você salvar suas alterações.

Para depurar, use as ferramentas de depuração do navegador da web (por exemplo, Console, Rede e guias de Origem) para isolar e corrigir problemas no seu código.

Empacotamento e implantação

Depois de se sentir satisfeito com seu visual personalizado, é hora de empacotá-lo para uso no Power BI Desktop ou compartilhamento com outros em uma organização. Use o seguinte comando:

pbiviz package

O comando acima cria um arquivo .pbiviz, que é um visual empacotado. Para usar este visual no Power BI Desktop, vá para a guia Desenvolvedor e selecione "Importar Visual Personalizado" para carregar seu arquivo .pbiviz.

Compartilhamento e publicação

Para compartilhar dentro de uma organização, publique no repositório de visuais organizacional no Power BI. Isso torna o visual acessível aos usuários de sua organização a partir de sua interface do Power BI. Gestão, distribuição e controle de versão podem ser tratados de forma consistente aqui.

Pensamentos finais

Criar visuais personalizados no Power BI pode melhorar muito a forma como você comunica e interpreta dados em seus relatórios. Abre um vasto caminho de personalização que pode ajudar a tornar suas percepções mais intuitivas e envolventes. Embora a jornada do conceito à implementação envolva a compreensão de alguns conceitos de desenvolvimento, os visuais resultantes podem proporcionar um valor substancial ao representar cenários complexos de dados de maneira única.

Comece pequeno e gradualmente explore gráficos e gráficos mais complexos. Use os fóruns da comunidade e a galeria de visuais do Power BI como recursos adicionais e inspirações. Aproveite a visualização!

  Compartilhe Este Artigo

Se você encontrar algo errado com o conteúdo do artigo, você pode solicitar uma atualização