Gerenciar configurações de administrador de visuais do Power BI
Como administrador do Fabric na sua organização, você pode controlar o tipo de visuais do Power BI que os usuários podem acessar em toda a organização e limitar as ações que os usuários podem executar.
Para gerenciar visuais do Power BI, você deve ser um administrador do Fabric. Para obter mais informações sobre a função de administrador do Fabric, consulte Noções básicas sobre as funções de administrador do Microsoft Fabric.
Configurações de locatário de visuais do Power BI
Para gerenciar as configurações de locatário para visuais do Power BI no portal de administração, acesse Configurações de locatário e role para baixo até Visuais do Power BI.
As configurações de locatário da interface do usuário afetam apenas o serviço do Power BI. Se você quiser que essas configurações entrem em vigor no Power BI Desktop, use as políticas de grupo. Uma tabela no final de cada seção fornece detalhes para habilitar a configuração no Power BI Desktop.
Essas configurações permitem que você controle as seguintes ações para visuais do Power BI em sua organização:
- Permitir os visuais criados utilizando o SDK do Power BI.
- Permitir acesso apenas a visuais certificados do Power BI
- Permitir downloads de visuais personalizados para seu dispositivo de armazenamento
- Permitir que elementos visuais personalizados armazenem dados na máquina local do usuário
- Obter o token de acesso do Microsoft Entra
Visuais do AppSource ou de um arquivo
Gerencie o acesso organizacional para o seguinte tipo de visuais do Power BI:
Os desenvolvedores de visuais personalizado criam usando o SDK do Power BI e salvam como um arquivo .pbiviz.
Visuais baixados do AppSource.
Essa configuração é desabilitada por padrão e não afeta os elementos visuais no store organizacional.
Use as seguintes instruções para permitir que os usuários em sua organização carreguem arquivos .pbiviz e adicionem visuais do AppSource aos próprios relatórios e dashboards:
Expanda as configurações Permitir os visuais criados usando o SDK do Power BI.
Selecione Habilitado.
Escolha quem pode carregar os visuais em .pbiviz e do AppSource:
Selecione a opção Toda a organização para permitir que todos em sua organização carreguem arquivos .pbiviz e adicionem visuais do AppSource.
Selecione a opção Grupos de segurança específicos para gerenciar o upload de arquivos .pbiviz e a adição de visuais do AppSource usando grupos de segurança. Adicione os grupos de segurança que você deseja gerenciar à barra de texto Inserir grupos de segurança. Os grupos de segurança especificados são excluídos por padrão. Se você quiser incluir esses grupos de segurança e excluir todos os outros na organização, selecione a opção Exceto grupos de segurança específicos.
Escolha Aplicar.
As alterações de interface do usuário nas configurações de locatário se aplicam somente ao serviço do Power BI. Para permitir que os usuários em sua organização carreguem arquivos .pbiviz e adicionem visuais do AppSource aos próprios painéis de visualização no Power BI Desktop, use a Política de Grupo do AD.
| Chave | Nome do valor | Valor |
|---|---|---|
| Software\Políticas\Microsoft\Power BI Desktop\ | EnableCustomVisuals | 0 – Desabilitar 1 – Habilitar (padrão) |
Visuais do Power BI certificados
Os visuais certificados do Power BI são visuais que atendem aos requisitos de código e teste da equipe do Microsoft Power BI. Os testes executados foram criados para verificar se o visual não acessa serviços ou recursos externos. Porém, a Microsoft não é a autora de visuais personalizados de terceiros e recomenda aos clientes contatar o autor diretamente para verificar a funcionalidade destes recursos visuais.
Quando essa configuração estiver habilitada, somente visuais certificados do Power BI serão renderizados nos relatórios e painéis da sua organização. Os visuais do Power BI do AppSource ou arquivos que não são certificados retornam uma mensagem de erro. Essa configuração é desabilitada por padrão e não se aplica aos elementos visuais no seu store organizacional.
Do portal do administrador, selecione Adicionar e usar apenas visuais certificados.
Selecione Habilitado.
Escolha Aplicar.
As alterações de interface do usuário nas configurações de locatário se aplicam somente ao serviço do Power BI. Para gerenciar a configuração de locatário de visuais certificados no Power BI Desktop, use a Política de Grupo do AD.
| Chave | Nome do valor | Valor |
|---|---|---|
| Software\Políticas\Microsoft\Power BI Desktop\ | EnableUncertifiedVisuals | 0 – Desabilitar 1 – Habilitar (padrão) |
Exportar dados para o arquivo
Quando essa configuração está habilitada, os usuários podem baixar dados de um visual personalizado em um arquivo em seu dispositivo de armazenamento. Essa configuração é separada e não é afetada pelas restrições de download aplicadas nas configurações de locatário de exportação e compartilhamento da organização. A configuração é desabilitada por padrão e se aplica a todos os visuais, incluindo aqueles gerenciados pelo seu repositório organizacional, área de trabalho e web.
Observação
Quando essa configuração estiver habilitada, um visual personalizado pode exportar para arquivos dos seguintes tipos:
- .txt
- .csv
- .json
- .tmplt
- .xml
- .xlsx
Expanda as configurações Permitir downloads de visuais personalizados.
Selecione Habilitado.
Escolha quem pode baixar os arquivos:
- Selecione a opção Toda a organização para permitir que todos em sua organização baixem os dados de um visual em um arquivo.
- Selecione a opção Grupos de segurança específicos para limitar o download de arquivos para grupos de segurança específicos. Insira os grupos de segurança que você deseja na barra de texto Inserir grupos de segurança. Os grupos de segurança que você especificou são incluídos por padrão. Se você quiser excluir esses grupos de segurança e incluir todos os outros na organização, selecione a opção Exceto grupos de segurança específicos.
Escolha Aplicar.
As alterações de interface do usuário nas configurações de locatário se aplicam somente ao serviço do Power BI. Para permitir que os usuários em sua organização baixem dados de visuais personalizados no Power BI Desktop, use Política de Grupo do AD.
| Chave | Nome do valor | Valor |
|---|---|---|
| Software\Políticas\Microsoft\Power BI Desktop\ | AllowCVToExportDataToFile | 0 – Desabilitar 1 – Habilitar (padrão) |
Quando AllowCVToExportDataToFile for definido como 1, o visual personalizado poderá exportar dados para um arquivo somente se:
- A opção de recurso no portal de administração estiver habilitada.
- O usuário estiver conectado.
Armazenamento local
Essa configuração permite que os elementos visuais armazenem dados no armazenamento local do navegador, o que ajuda a melhorar o desempenho. Essa configuração é separada e não é afetada pelas restrições de download aplicadas nas configurações de locatário de exportação e compartilhamento da organização. A configuração é habilitada por padrão e se aplica a todos os visuais, incluindo aqueles gerenciados pelo seu repositório organizacional, área de trabalho e web.
Para habilitar a configuração de armazenamento local, siga estas etapas:
Expanda as configurações de Armazenamento local.
Selecione Habilitado.
Escolha quem pode renderizar essa API:
- Selecione a opção A organização inteira para permitir que os visuais armazenem dados na máquina local para todos os usuários em sua organização.
- Selecione a opção Grupos de segurança específicos para limitar o privilégio para grupos de segurança específicos. Insira os grupos de segurança que você deseja na barra de texto Inserir grupos de segurança. Os grupos de segurança que você especificou são incluídos por padrão. Se você quiser excluir esses grupos de segurança e incluir todos os outros na organização, selecione a opção Exceto grupos de segurança específicos. Somente um usuário listado no grupo de segurança permitido pode renderizar a API.
Escolha Aplicar.
AppSource Custom Visuals SSO
Quando essa configuração o AppSource Custom Visuals pode obter tokens de acesso do Microsoft Entra ID (anteriormente conhecido como Azure Active Directory) com públicos restritos para os usuários conectados usando a API de Autenticação. Esses tokens contêm informações pessoais, como o nome e o endereço de e-mail do usuário. O Custom Visuals pode enviar esses tokens entre diferentes regiões e limites de conformidade, e é de sua total responsabilidade lidar com os tokens que possuem. A configuração é desabilitada por padrão e se aplica a todos os visuais personalizados do Appsource, incluindo aqueles gerenciados pelo seu repositório organizacional.
Expanda as configurações Permitir visuais personalizados para obter tokens de acesso do Microsoft Entra do usuário.
Selecione Habilitado.
Escolha quem pode renderizar essa API:
- Selecione a opção A organização inteira para permitir que os visuais obtenham tokens de acesso ao Microsoft Entra para cada usuário em sua organização.
- Selecione a opção Grupos de segurança específicos para limitar a obtenção de tokens de acesso a grupos de segurança específicos. Insira os grupos de segurança que você deseja na barra de texto Inserir grupos de segurança. Os grupos de segurança que você especificou são incluídos por padrão. Se você quiser excluir esses grupos de segurança e incluir todos os outros na organização, selecione a opção Exceto grupos de segurança específicos. Somente um usuário listado no grupo de segurança permitido pode renderizar a API.
Escolha Aplicar.
Elementos visuais organizacionais
Como administrador do Fabric, você pode gerenciar a lista de visuais do Power BI disponíveis no repositório organizacional da sua organização. A guia Visuais organizacionais no Portal de administração permite adicionar e remover visuais, bem como decidir quais visuais serão exibidos automaticamente no painel de visualização dos usuários da sua organização. É possível adicionar qualquer tipo de visual à lista, incluindo visuais não certificados e visuais do .pbiviz, mesmo que eles contradigam as configurações de locatário da sua organização.
As configurações de visuais organizacionais são implantadas automaticamente para o Power BI Desktop.
Observação
Os visuais organizacionais não são compatíveis com o Servidor de Relatórios do Power BI.
Adicionar um visual de um arquivo
Use este método para adicionar um novo visual do Power BI de um arquivo .pbiviz.
Aviso
Um visual do Power BI atualizado a partir de um arquivo pode conter código com riscos de segurança ou de privacidade. É importante confiar no autor e na origem do elemento visual personalizado antes de implantá-lo no repositório da organização.
Selecione Adicionar visual>De um arquivo.
Preencha os campos a seguir:
Escolha um arquivo .pbiviz – selecione um arquivo do visual para carregar.
Nomeie seu visual – forneça um título curto para o visual, para que os autores de relatório possam entender facilmente o que ele faz.
Ícone – carregue um arquivo de ícone a ser exibido no painel de visualização.
Descrição – forneça uma descrição breve do elemento visual para fornecer mais contexto para o usuário.
Acesso – essa seção tem duas opções:
Selecione se os usuários em sua organização podem acessar este visual. Essa configuração é habilitada por padrão.
Selecione se este visual será exibido no painel de visualização dos usuários em sua organização. Essa configuração é desabilitada por padrão. Para obter mais informações, consule Adicionar um visual ao painel de visualização.
Para iniciar a solicitação de carregamento, selecione Adicionar. Depois de carregado, o visual é exibido na lista de visuais organizacionais.
Adicionar um visual do AppSource
Use esse método para adicionar um novo visual do Power BI do AppSource.
Os visuais do Power BI do AppSource são atualizados automaticamente. Os usuários em sua organização sempre terão a versão mais recente do visual.
Selecione Adicionar visual>Do AppSource.
Na janela Visuais do Power BI, localize o visual do AppSource que você deseja adicionar e selecione Adicionar. Depois de carregado, o visual é exibido na lista de visuais organizacionais.
Adicionar um visual ao painel de visualização
É possível escolher visuais da página de visuais organizacionais para serem exibidos automaticamente no painel de visualização de todos os usuários em sua organização.
Na linha do visual que você deseja adicionar, selecione configurações.
Habilite a configuração do painel de visualização e selecione Atualizar.
Excluir um visual carregado de um arquivo
Para excluir permanentemente o visual, selecione o ícone de lixeira para o visual no repositório.
Importante
A exclusão é irreversível. Após o visual ser excluído, ele interrompe imediatamente a renderização em relatórios existentes. Mesmo que você carregue o mesmo visual novamente, ele não substituirá aquele que foi excluído. No entanto, os usuários podem importar o novo elemento visual novamente e substituir a instância que eles têm em seus relatórios.
Desabilitar um visual do .pbiviz
É possível desabilitar um visual do .pbiviz deixando-o indisponível no repositório organizacional, mas mantendo-o na lista de visuais da organização.
Na linha do visual do .pbiviz que você deseja desabilitar, selecione configurações.
Na seção Acesso, desabilite a configuração: Os usuários na organização podem acessar, exibir, compartilhar e interagir com esse visual.
Depois que você desabilitar o visual do .pbiviz, ele não será renderizado em relatórios existentes e exibirá a seguinte mensagem de erro:
Este visual personalizado não está mais disponível. Entre em contato com o administrador para obter detalhes.
Observação
Visuais do .pbiviz que forem marcados permanecem funcionando mesmo após terem sido desabilitados.
Atualizar um elemento visual
Os visuais do AppSource são atualizados automaticamente. Depois que uma nova versão esta disponível por meio do AppSource, ela substituirá uma versão mais antiga implantada por meio da lista de visuais organizacionais.
Para atualizar e substituir um visual do .pbiviz, siga estas etapas.
Na linha do visual que você deseja adicionar, selecione configurações.
Selecione Procurar e selecione o .pbiviz com o qual você deseja substituir o visual atual.
Selecione Atualizar.
Substituir um visual de um arquivo por um visual do AppSource
Às vezes, uma organização cria um visual do Power BI e o distribui de modo interno. Após algum tempo, a organização talvez decida tornar esse visual público executando um upload dele no AppSource. Para substituir o visual carregado de um arquivo pelo do AppSource, use as seguintes etapas:
Adicione um visual do AppSource ao repositório organizacional.
Abra o relatório que contém esse visual. O visual carregado de um arquivo e o visual do AppSource serão exibidos no painel de visualização.
No relatório, realce o visual carregado de um arquivo, depois selecione o visual do AppSource no painel de visualização para substituí-lo. Os visuais serão trocados de modo automático. Para verificar se você está usando o visual do AppSource, clique com o botão direito do mouse no visual e selecione Sobre no painel de visualização.
Conclua a etapa 3 em todos os relatórios com visuais em sua organização.
Exclua o visual carregado de um arquivo.