Compartilhar via


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.

captura de tela da Localização das configurações do locatário dos 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:

Visuais do AppSource ou de um arquivo

Gerencie o acesso organizacional para os seguintes tipos de visuais do Power BI:

  • Visuais personalizados que os desenvolvedores criam usando o SDK do Power BI e salvam como um arquivo .pbiviz .

  • Visuais que você baixa 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:

  1. Expanda as configurações Permitir os visuais criados usando o SDK do Power BI.

  2. Selecione Habilitado.

  3. 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 carregamento 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.

  4. 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 verificam se o visual não acessa serviços ou recursos externos. No entanto, a Microsoft não é a autora de visuais que não são da Microsoft, portanto, contate o autor diretamente para verificar a funcionalidade desses visuais.

Quando você habilita essa configuração, apenas visuais certificados do Power BI sã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.

  1. Do portal do administrador, selecione Adicionar e usar apenas visuais certificados.

  2. Selecione Habilitado.

  3. 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 você habilita essa configuração, 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. Essa configuração é desabilitada por padrão e se aplica a todos os visuais, incluindo os visuais gerenciados por seu repositório organizacional, Área de Trabalho e Web.

Observação

Quando você habilita essa configuração, um visual personalizado pode exportar para arquivos dos seguintes tipos:

  • .txt
  • .csv
  • .json
  • .tmplt
  • .xml
  • .pdf
  • .xlsx
  1. Expanda as configurações Permitir downloads de visuais personalizados.

  2. Selecione Habilitado.

  3. 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.
  4. 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 está 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 os visuais gerenciados por seu repositório organizacional, Área de Trabalho e Web.

Captura de tela da opção de administração das configurações de armazenamento local.

Para habilitar a configuração de armazenamento local, siga estas etapas:

  1. Expanda as configurações de Armazenamento local.

  2. Selecione Habilitado.

  3. 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.
  4. Escolha Aplicar.

SSO de Visuais Personalizados do AppSource

Quando você habilita essa configuração, os Visuais Personalizados do AppSource podem obter tokens de acesso do Microsoft Entra ID (anteriormente conhecido como Azure Active Directory) com públicos restritos para usuários conectados usando a API de Autenticação. Esses tokens incluem informações pessoais, como o nome do usuário e o endereço de email. Os visuais personalizados podem enviar esses tokens entre várias regiões e limites de conformidade, e são totalmente responsáveis por gerenciar os tokens que possuem. A configuração é desabilitada por padrão e se aplica a todos os Visuais Personalizados do AppSource, incluindo os visuais gerenciados pelo repositório organizacional.

Captura de tela da opção de autenticação encontrada nas configurações do locatário.

  1. Expanda as configurações Permitir visuais personalizados para obter tokens de acesso do Microsoft Entra do usuário.

  2. Selecione Habilitado.

  3. Escolha quem pode renderizar essa API:

    • Selecione a opção Toda a organização para permitir que os visuais obtenham tokens de acesso do Microsoft Entra para todos os usuários da 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.
  4. 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 e decidir quais sã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 no Power BI Desktop.

Observação

O Servidor de Relatórios do Power BI não dá suporte a visuais organizacionais.

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.

  1. Selecione Adicionar visual>De um arquivo.

    Captura de tela mostrando o menu de visuais organizacionais nas configurações de administrador do Power BI. A opção adicionar visual é expandida e a opção

  2. 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 – Carregar 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 – Selecione se os usuários em sua organização podem acessar esse visual. Essa configuração é habilitada por padrão.

    Captura de tela do menu pop-up visual de adição com as opções descritas na etapa 2.

  3. Selecione Adicionar para iniciar a solicitação de upload. Depois que ele é carregado, o visual aparece 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 têm a versão mais recente do visual.

  1. Selecione Adicionar visual>Do AppSource.

    Captura de tela exibindo o menu de visuais organizacionais nas configurações de administração do Power BI. A opção Adicionar visual é expandida, e a opção Do AppSource é selecionada.

  2. Na janela Visuais do Power BI, localize o visual do AppSource que você deseja adicionar e selecione Adicionar. Depois que ele é 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.

  1. Selecione o visual que você deseja adicionar.

  2. Selecione Habilitar para Painel de Visualização.

    Captura de tela mostrando o botão Habilitar para Visualização do Painel.

Excluir um visual carregado de um arquivo

Para excluir permanentemente um visual, selecione o visual e selecione Excluir.

Importante

A exclusão é irreversível. Após o visual ser excluído, ele interrompe imediatamente a renderização em relatórios existentes. Mesmo se você carregar o mesmo visual novamente, ele não substituirá o 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.

  1. Selecione o visual .pbiviz que você deseja desabilitar e selecione Configurações.

  2. Na seção Acesso, desabilite a configuração: Os usuários na organização podem acessar, exibir, compartilhar e interagir com esse visual.

Depois de desabilitar o visual .pbiviz , o visual não será renderizado em relatórios existentes e exibirá a seguinte mensagem de erro:

This custom visual is no longer available. Contact your administrator for details.

Observação

Os visuais .pbiviz que estão salvos nos favoritos continuam funcionando mesmo depois de desabilitados.

Atualizar um elemento visual

Os visuais do AppSource são atualizados automaticamente. Depois que uma nova versão estiver disponível no 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.

  1. Selecione o visual que você deseja adicionar e selecione Configurações.

  2. Selecione Procurar e selecione o arquivo .pbiviz que você deseja usar para substituir o visual atual.

  3. 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:

  1. Adicione um visual do AppSource ao repositório organizacional.

  2. 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.

  3. 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.

  4. Conclua a etapa 3 em todos os relatórios com visuais em sua organização.

  5. Exclua o visual que você carregou de um arquivo.