¶ 1. Visão Geral
O T6 oferece integração nativa com o Power BI por meio de um embedded service.
Essa funcionalidade permite criar, visualizar e gerenciar relatórios dentro do T6, mantendo a sincronização automática entre as duas plataformas.
A integração entre o T6 e o Power BI garante:
- Relatórios sempre sincronizados entre as plataformas.
- Alterações feitas no Power BI refletidas no T6, e vice-versa.
- Configuração flexível de relatórios por aplicação.
Com essa integração, os dados analíticos ficam centralizados e consistentes, facilitando a tomada de decisão.
¶ 1.1. Pré-requisitos
Para utilizar os relatórios do Power BI no T6, é necessário possuir as seguintes permissões:
-
Gestor
-
Planejador
¶ 2. Configuração
Para configurar a integração dentro do T6, siga os seguintes passos:
- No menu principal do T6, na opção Configurações, acesse Parâmetros;
- Em Parâmetros, na aba Global, expanda as opções de Integração;
-
Para o funcionamento do Power BI dentro do T6, será necessário preencher os seguintes parâmetros:
- Relatório - Client Secret;
- Relatório - ClientID;
- Relatório - GroupID;
- Habilitar o switch Relatório - Integração;
- Relatório - Url da API;
- Relatório - Url de Autorização;
- Relatório - Url dos Recursos;
- Habilitar o switch Relatório - Usar RLS.
O conteúdo para preenchimento dos parâmetros será obtido diretamente pelo administrador do sistema, para mais informações acesse: Integração do Power Bi com T6.
Após preencher os parâmetros, será possível visualizar os relatórios existentes no workspace do Power BI configurado.
Para visualizar a listagem de relatórios, acesse o Explorer, selecione a aba Integração e clique em Relatórios:
Será aberto um painel lateral exibindo todos os relatórios existentes no workspace do Power BI configurado nos parâmetros.
Nessa listagem, haverá uma caixa de seleção ao lado do nome de cada relatório:
- Flag ativa : Relatório existente no workspace do Power BI e sincronizado com o T6.
- Flag inativa : Relatório existente no workspace do Power BI e não sincronizado com o T6.
Esta integração é individual por aplicação. Cada aplicação terá a mesma listagem de relatórios; o que muda é a flag de sincronização, sendo possível sincronizar o mesmo relatório com mais de uma aplicação.
- Será possível selecionar a aplicação através de um dropdown no próprio painel.
- Também será possível selecionar a pasta na qual o relatório será salvo. Ao clicar no ícone da pasta, serão exibidas as pastas disponíveis para seleção.
Após selecionar os relatórios na listagem, ao clicar em Próximo, será exibido um resumo das ações que serão realizadas ao clicar em Salvar.
Ao trabalhar com relatórios sincronizados, toda alteração realizada no Power BI será refletida no T6 e toda ação realizada no T6 será refletida no Power BI.
Assim, se um relatório for criado no Power BI, sincronizado e eventualmente excluído no T6, ele também será removido do workspace no Power BI. O mesmo ocorre no cenário inverso: se criarmos um relatório no T6 e fizermos qualquer alteração no Power BI, a ação será refletida no T6.
Sempre que uma ação envolvendo relatórios (renomear, excluir, criar etc.) for realizada, execute a sincronização pela aba Integração.
¶ 3. Criação
A criação de um relatório através do T6 será feita utilizando os dados existentes nos conjuntos de dados disponíveis no workspace do Power BI configurado anteriormente.
- No menu principal do T6, acesse o Explorer e selecione a opção Navegador.
- Após acessar o navegador, selecione o local para criação do relatório.
- Para criar um relatório do Power BI, em Novo Item na ribbon, selecione a opção Relatório.
Para que o objeto seja exibido, será necessário atualizar a página.
- Abra o objeto criado com um duplo clique ou, na ribbon, pela opção Abrir.
-
Um painel será aberto na lateral, onde será possível selecionar o Conjunto de Dados desejado;
- Os conjuntos de dados exibidos corresponderão ao workspace do Power BI.
Na parte de edição do relatório podemos realizar as mesmas ações que seriam realizadas no Power BI Service, pois trabalhamos com um embedded do Power BI dentro do T6.
¶ 3.1. Área de Relatório
Espaço central onde são construídas as visualizações. Podemos arrastar campos e visuais para esta área e ajustar sua disposição conforme a necessidade, para criar relatórios interativos.
¶ 3.1.1. Painel de Visualizações
Localizado à direita da área de relatório, este painel permite:
- Selecionar tipos de visualizações (elementos visuais).
- Configurar campos de dados para cada visual.
- Personalizar propriedades visuais, como cores, títulos e interações.
No painel de Visualizações, teremos os seguintes elementos visuais para auxiliar na exibição dos dados:
| Elementos Visuais | |||||
|---|---|---|---|---|---|
| Gráfico de Barras Empilhadas | Gráfico de Colunas Empilhadas | Gráfico de Barras Clusterizado | Gráfico de Colunas Clusterizado | Gráfico de Barras 100% Empilhadas | Gráfico de Colunas 100% Empilhadas |
| Gráfico de Linhas | Gráfico de Área | Gráfico de Área Empilhada | Gráfico de Área 100% Empilhada | Gráfico de Colunas Empilhadas e Linhas | Gráfico de Colunas Agrupadas e Linha |
| Gráfico de Faixas | Gráfico de Cascata | Funil | Gráfico de Dispersão | Gráfico de Pizza | Gráfico de Rosca |
| Treemap | Map | Mapa Coroplético | Mapa do Azure | Indicador | Cartão |
| Cartão de Linha Múltipla | KPI | Segmentação de Dados | Tabela | Matriz | Principais Influenciadores |
| Árvore Hierárquica | P & R | Narrativa | Metas (Versão Prévia) | Relatório Paginado | Power Apps for Power BI |
Os elementos visuais dependem dos dados para serem exibidos, permitindo selecionar um ou mais itens para interação com o objeto de visualização, alterando assim sua exibição.
Também é possível aplicar filtros. Cada objeto visual tem diferentes opções de filtragem.
¶ 3.1.2. Painel de Filtros
Situado ao lado dos painéis de visualizações e dados, este painel permite:
- Aplicar filtros a visualizações específicas, páginas ou ao relatório inteiro.
- Adicionar campos para refinar os dados exibidos.
- Configurar interações entre filtros e visuais.
A filtragem pode ser realizada de diferentes formas: em um visual, em uma página específica ou em todas as páginas.
¶ 3.1.3. Painel de Dados
Também à direita, ao lado do Painel de Visualizações, exibe:
- Tabelas e campos disponíveis no modelo de dados.
- Permite arrastar (ou selecionar) campos para a área de relatório ou para as áreas de valores, eixos e legendas nos visuais.
¶ 3.1.4. Navegação entre Páginas
Na parte inferior da interface:
- Exibe as páginas existentes no relatório.
- Permite adicionar novas páginas, renomear, duplicar ou excluir páginas existentes.
- Permite alterar o modo de visualização do relatório, podendo alternar para a visualização em dispositivos móveis.
¶ 3.2. Ribbon
¶ 3.2.1. Salvar
Salva as informações do relatório dentro do T6.
Toda alteração realizada em um relatório dentro do T6 é refletida diretamente no ambiente do Power BI. Ao salvar um relatório gerado via T6, ele será exibido no workspace do Power BI, assim como as alterações realizadas dentro do T6 em relatórios criados no próprio Power BI.
¶ 3.2.2. Criar
Permite criar um novo relatório sem a necessidade de acessar outra tela.
Ao clicar em Criar, será aberto um painel lateral onde será possível definir o nome e o conjunto de dados do novo relatório. Clique em Salvar para abrir a página de edição.
Após concluir, ao acessar o Explorer do T6 ou o workspace do Power BI, será possível visualizar o novo relatório criado.
Atenção: Qualquer alteração não salva no relatório atual será perdida ao finalizar o processo de Criar.
¶ 3.2.3. Salvar Como
Permite criar uma cópia exata do relatório no momento atual sem a necessidade de trocar de tela.
Ao clicar em Salvar Como, será aberto um painel lateral para inserir o nome do novo relatório. Após clicar em Salvar, a tela será atualizada e a cópia criada será exibida.
Após concluir, ao acessar o Explorer do T6 ou o workspace do Power BI, será possível visualizar o novo relatório criado.
Atenção: Qualquer alteração não salva no relatório atual será perdida ao finalizar o processo de Salvar Como.
¶ 3.2.4. Editar/Visualizar
Editar/Visualizar: Botão que nos permite alternar entre os modos de edição e visualização sem a necessidade de troca de tela ou recarregamento de página. No modo de edição podemors realizar alterações no relatório, enquanto no modo de Visualização poderemos apenas iteragir com os dados já constantes no relatório.
←→
¶ 3.2.5. Filtros
A filtragem através da Ribbon somente será possível caso tenham sido habilitadas opções de filtragem no painel de filtros do relatório.
Para realizar a filtragem dos dados, clique em Filtros na ribbon;
Teremos as opções: Filtragem básica e Filtragem avançada;
Filtragem básica:
Será exibida uma listagem com todos os itens do dado selecionado, sendo possível a seleção através de uma checkbox .
Somente os itens selecionados serão exibidos naquele conjunto de dados.
Filtragem avançada:
-
Através dos filtros, o usuário pode utilizar filtros compostos com dois critérios, conectados por operadores lógicos:
- E: ambas as condições devem ser verdadeiras;
- Ou: pelo menos uma das condições deve ser verdadeira;
-
Cada campo de filtro possui:
- Um operador de comparação (ex: “contém”, “não contém”, "começa com" etc.);
- Um campo de valor a ser preenchido com base no tipo de dado da coluna.
Clique para visualizar os Tipos de Operadores
| Operador | Descrição |
|---|---|
| Contém | Retorna os registros cujo valor do campo possui a sequência de caracteres informada em qualquer posição. |
| não contém | Retorna os registros cujo valor do campo não possui a sequência de caracteres informada em nenhuma posição. |
| começa com | Retorna os registros cujo valor do campo inicia exatamente com a sequência de caracteres especificada. |
| não começa com | Retorna os registros cujo valor do campo não inicia com a sequência de caracteres especificada. |
| é | Retorna os registros cujo valor do campo corresponde exatamente ao valor especificado. |
| não está | Retorna os registros cujo valor do campo é diferente do valor especificado. |
| está em branco | Retorna os registros cujo valor do campo é nulo (sem informação). |
| não está em branco | Retorna os registros cujo valor do campo não é nulo. |
| está vazio | Retorna os registros cujo valor do campo é uma string vazia. |
| não está vazio | Retorna os registros cujo valor do campo não é uma string vazia. |
- Ao clicar em Aplicar, os dados serão exibidos conforme os filtros aplicados;
¶ 3.2.6. Indicadores (Bookmarks)
Exibe um novo painel na tela de edição do relatório:
- Permite salvar estados específicos do relatório.
- Facilita a navegação entre diferentes visualizações e interações.
¶ 3.2.7. Modo de Tela Cheia
Disponível na guia "Exibir", esta opção:
- Expande o relatório para ocupar toda a tela.
- Ideal para apresentações e exibições em tempo real.
- Para sair do modo "tela cheia", basta pressionar ESC.
¶ 3.2.8. Imprimir
Abre a tela de impressão do relatório, exibindo somente o conteúdo adicionado.
¶ 3.2.9. Recarregar
Retorna o relatório ao seu último estado salvo.
Ao clicar em Recarregar, todas as alterações não salvas serão perdidas.
¶ 3.2.10. Atualizar
Ao clicar em Atualizar, será feita uma verificação no conjunto de dados do Power BI em busca de alterações.
Caso haja novos dados, o formulário será atualizado refletindo os valores conforme o workspace do Power BI.
Caso não haja novos dados, o formulário não sofrerá alterações.
¶ 3.2.11. Exportar
A ferramenta Exportar permite exportar e realizar o download de relatórios de diferentes formas e em diferentes formatos de arquivo.
Ao clicar em Exportar, um dropdown será aberto para a seleção do formato do arquivo. As opções disponíveis são: PDF, PPT e PNG.
Ao selecionar o formato do arquivo, uma janela será exibida para escolha da forma de exportação com as seguintes opções:
- Valores Atuais: Ao selecionarmos esta opção, a exportação irá fornecer os dados conforme estão sendo visualizados, caso tenha aplicado filtros para visualização, estes serão respeitados;
- Valores Padrão: Ao selecionarmos esta opção, a exportação irá ignorar a aplicação de filtros realizados através do T6, trazendo os dados conforme definidos no relatório original;
É possível selecionar apenas um dos tipos de valor, ao escolher uma das opções a outra será automáticamente desabilitada.
- Excluir abas de relatório ocultas: Botão switch que ao habilitarmos fará a exportação somente das páginas visíveis ao usuário. Caso desabilitado, exporta todas as páginas, inclusive as páginas ocultas existentes no relatório;
- Exportar apenas a página atual: Botão switch que ao habilitarmos fará a exportação somente da página aberta no momento da exportação. Caso desabilitado, todas as páginas existentes no formulário serão exportadas.
É possível habilitar apenas um dos botões switch por vez, ao habilitar um deles o outro será desabilitado. Por outro lado se necessário podemos manter os dois botões desabilitados.
Ao clicar em Exportar, uma notificação será gerada no sistema, permitindo acompanhar o andamento da exportação.
Caso queira interromper a exportação do relatório, basta clicar em
, a seguinte notificação será exibida:
Em caso de sucesso teremos a seguinte notificação:
Após a conclusão, através da própria notificação poderemos realizar o download do relatório exportado clicando no botão
.
Caso opte por exportar um relatório com mais de uma página em formato
PNG, ao efetuar o download, será gerado um arquivo para cada página. Esses arquivos serão armazenados em uma pasta compactada (.zip) com o nome do relatório exportado.
¶ 3.3. Remoção de um Relatório
É possível fazer com que um relatório deixe de ser exibido no T6 sem removê-lo do Power BI.
- Acesse a aba Integração na ribbon e selecione a opção Relatório.
- Com a listagem de relatórios exibida, desmarque a caixa de seleção do relatório que deseja ocultar do T6 e clique em Próximo.
- Confirme a ação a ser realizada e clique em Salvar.
É importante realizar esta ação caso queira remover um formulário do T6 e mantê-lo no Power BI. Se a exclusão for feita diretamente no T6, o relatório também será removido do Power BI.
¶ 4. Utilização de RLS
Para configurar o RLS nos relatórios do Power BI será necessário utilizar o Power BI Desktop.
No T6, precisaremos criar uma tabela de dados vinculando o usuário (coduser) com uma chave de filtro (sk_cenario, sk_entidade, etc...) que será utilizada para a configuração do RLS.
Após criar a tabela, será necessário criar um formulário de dados apontando para a tabela criada, precisaremos adicionar dados neste formulário para utilizar o RLS.
¶ 4.1. Criando Relacionamento entre as tabelas
- Dentro do Power BI Desktop após acessar seu conjunto de dados, na aba Modelagem selecione a opção Gerenciar Relações;
- Será aberta a janela Gerenciar Relações na qual faremos o mapeamento das colunas;
- Clique em Novo Relacionamento
; - Será aberta uma nova janela onde iremos definir as relações entre as colunas.
- Clique em Novo Relacionamento
- No primeiro dropdown, Da tabela:
- Selecione a tabela de dados criada no T6 onde foram adicionados o usuário e a chave de filtro;
- Será exibida uma prévia das colunas existentes na tabela, onde iremos selecionar a coluna "chave filtro" adicionada anteriormente clicando em seu nome no cabeçalho.
- No segundo dropdown, Para a tabela:
- Selecione a tabela que faz referência à aplicação ou a dimensão que será utilizada no relatório;
- Será exibida uma prévia das colunas existentes na tabela, onde iremos selecionar a coluna que desejamos filtrar clicando em seu nome no cabeçalho.
- No dropdown Cardinalidade selecione a opção Muitos para Muitos (* : *).
- No dropdown Direção do filtro cruzado selecione a opção Ambos.
- Mantenha a checkbox Ativar este relacionamento habilitada .
- Habilite a checkbox Aplicar filtro de segurança em ambos os sentidos .
- Após concluir a configuração clique em Salvar
O relacionamento criado será exibido na listagem da janela Gerenciar Relações.
¶ 4.2. Gerenciando Funções
- No Power BI Desktop na aba Modelagem selecione a opção Gerenciar Funções, onde iremos configurar o RLS.
- Será aberta a janela Gerenciar as funções de segurança onde faremos as restrições dos dados em nível de linha.
- Abaixo de Funções clique em
;
- Será exibida uma nova função Sem título a qual iremos renomear para ServiceRole;
- Ao lado, temos a exibição das tabelas, onde iremos selecionar a tabela criada para configuração do RLS (onde temos o usuário e a chave de filtro) e clicar em abaixo de Regras;
- Serão exibidos 3 dropdowns, Coluna, Condição e Valor. Clique no dropdown Coluna e selecione o "usuário" da tabela de segurança;
- Clique em
, onde utilizaremos a função DAX USERNAME()para realizar o filtro pelo usuário na tabela de segurança;
Em nosso exemplo a coluna de usuários na tabela de segurança está nomeada como usuário, sendo assim, teremos a seguinte expressão:
[usuario] == USERNAME().
- Clique em Salvar para finalizar a criação da função;
Ainda na página Gerenciar as Funções de Segurança, vamos criar uma nova função que terá como finalidade identificar os usuários que não serão afetados pela restrição de segurança, por exemplo, usuários administradores.
- Abaixo de Funções clique em ;
- Será exibida uma nova função Sem título a qual iremos renomear para AdminServiceRole;
- A função AdminServiceRole não terá nenhum filtro aplicado, sua utilização se dará diretamente no banco de dados.
- Clique em Salvar para finalizar a criação da função;
Para que o filtro de RLS não seja aplicado a usuários específicos, estes devem ter a linha
SendAdminRolecom valortruena tabelaREP_USER_CONFIGURATION→
Caso o valor esteja definido comofalseos filtros de RLS serão aplicados ao usuário.