Compartilhar via


Controle Bloco do Power BI no Power Apps

Um controle que mostra um bloco do Power BI em um aplicativo.

Não tem Power BI? Inscrever-se.

Descrição

Aproveite a análise de dados e os relatórios existentes exibindo os blocos do Power BI em seus aplicativos. Especifique o bloco que você deseja mostrar definindo suas propriedades Workspace, Dashboard e Tile na guia Dados do painel de opções.

Observação

  • O controle bloco do Power BI não está disponível nos ambientes GCC High e DoD.
  • O controle Bloco do Power BI não está disponível na China.
  • Para requisitos de licenciamento ao incorporar o Bloco do Power BI, consulte Licenciamento.

Compartilhamento e segurança

Quando você compartilha um aplicativo que inclui o conteúdo do Power BI, não deve compartilhar apenas o próprio aplicativo, mas também o painel do qual o bloco é proveniente. Caso contrário, o conteúdo do Power BI não será exibido até mesmo para os usuários que abrirem o aplicativo. Os aplicativos que contêm o conteúdo do Power BI respeitam as permissões para esse conteúdo.

Desempenho

Não é recomendável carregar mais de três blocos do Power BI ao mesmo tempo em um aplicativo. Você pode controlar o carregamento e o descarregamento de bloco definindo a propriedade LoadPowerBIContent.

Opções de inserção

A inserção é diferente entre as versões da API do Power BI. Por causa do novo esquema de autenticação de API do Power BI, o bloco pode não estar acessível no dispositivo móvel ou em outros cenários incorporados (Teams ou SharePoint).

Você pode controlar o uso da versão da API usando a propriedade AllowNewAPI. Para obter mais informações, consulte Propriedades principais.

Valor da propriedade AllowNewAPI Comportamento
Verdadeiro Você pode inserir um painel, um relatório ou um bloco usando a URL de Inserção do Power BI e torná-lo o valor TileUrl.
Falso Você pode inserir um bloco de painel por meio da URL de Inserção e torná-lo o valor TileUrl ou usar a interface gráfica fornecida.

Observação

A inserção de uma URL do Power BI (por exemplo, em um IFrame) não é aceita no Power Apps Mobile, uma vez que a autenticação de uma solicitação de URL do Power BI não é processada pelo player móvel.

Filtragem

A filtragem difere entre as versões da API do Power BI. Consulte as seções apropriadas abaixo, dependendo de como você configura o controle.

Ao usar a nova API para chamar o serviço do Power BI

Quando a propriedade AllowNewAPI está definida como "True", você está usando uma nova API para chamar o serviço do Power BI. Para obter mais informações, consulte Filtrar um relatório usando parâmetros de cadeia de caracteres de consulta na URL.

Ao usar a API original para chamar o serviço do Power BI

Quando a propriedade AllowNewAPI está definida como "False", você está usando uma API original para chamar o serviço do Power BI. Nesse caso, ao passar um único parâmetro do aplicativo, você pode filtrar os resultados que aparecem em um bloco do Power BI. No entanto, apenas os valores de sequência e o operador igual são suportados, e o filtro pode não funcionar se o nome da tabela ou o nome da coluna contiver espaços.

Para passar um único valor de filtro, modifique o valor da propriedade TileURL, que segue esta sintaxe:

"https://app.powerbi.com/embed?dashboardId=<DashboardID>&tileId=<TileID>&config=<SomeHash>"

Para esse valor, acrescente esta sintaxe:

&$filter=<TableName>/<ColumnName> eq '<Value>'

Por exemplo, usando um valor de uma caixa de listagem:

"&$filter=Store/Territory eq '" & ListBox1.Selected.Abbr & "'"

O parâmetro filtrará um valor no conjunto de dados do relatório de onde o bloco se origina. No entanto, o recurso de filtragem tem as seguintes limitações:

  • Somente um filtro pode ser aplicado.
  • Somente há suporte para o operador eq.
  • O tipo de campo deve ser cadeia de caracteres.
  • A filtragem está disponível apenas em blocos de visualização fixos. Não é compatível com relatórios com marcações.
  • Os visuais de script R e Python não podem ser filtrados.

Você pode usar campos computados no relatório do Power BI para converter outros tipos de valor em cadeia de caracteres ou combinar vários campos em um.

Principais propriedades

AllowNewAPI - Se deve usar a nova API ao chamar o serviço do Power BI. Definir o valor como Verdadeiro permitirá o uso da nova API do Power BI (que não é compatível com dispositivos móveis e alguns cenários incorporados, mas permite alguma filtragem mais avançada). Falso usará a API original. Valor padrão é falso.

Dashboard – O painel do Power BI de origem do bloco.

LoadPowerBIContent – quando definida como Verdadeira, o conteúdo do Power BI é carregado e mostrado. Quando definido como Falso, o conteúdo do Power BI é descarregado, o que libera memória e otimiza o desempenho.

PowerBIInteractions - Quando definido como Verdadeiro, o conteúdo do Power BI pode ser interagido, mas o evento OnSelect do Power Apps não será acionado. Quando definido como Falso, o bloco não pode ser interagido, mas o evento OnSelect do Power Apps será acionado quando o bloco for selecionado.

Tile – O nome do bloco do Power BI que você deseja exibir.

Workspace – O espaço de trabalho do Power BI de origem do bloco.

Propriedades adicionais

BorderColor – a cor da borda do controle.

BorderStyle – se a borda do controle é Sólida, Tracejada, Pontilhada ou Nenhuma.

BorderThickness – a espessura da borda do controle.

DisplayMode – se o controle permite entrada do usuário (Edição), apenas exibe dados (Exibição), ou está desabilitado (Desabilitado).

Height – a distância entre a parte superior do controle e as bordas inferiores.

OnSelect – Ações a serem executadas quando o usuário seleciona um controle. Por padrão, o relatório do Power BI associado ao bloco é aberto.

TileUrl – A URL pela qual o bloco é solicitado do serviço do Power BI. Para adicionar filtragem da cadeia de caracteres de consulta à URL, consulte a seção filtragem acima.

Visible – se um controle é exibido ou está oculto.

Width – a distância entre as bordas esquerda e direita de um controle.

X: a distância entre a borda esquerda de um controle e a borda esquerda de seu contêiner pai (ou a tela — se não houver contêiner pai).

Y: a distância entre a borda superior de um controle e a borda superior de seu contêiner pai (ou a tela — se não houver contêiner pai).

Exemplo

  1. Na guia Inserir, abra o menu Gráficos e, em seguida, adicione um controle Bloco do Power BI.

    Não sabe como adicionar e configurar um controle?

  2. Na guia Dados do painel de opções, selecione Meu Workspace na configuração Workspace.

  3. Selecione um painel na lista de painéis e, em seguida, selecione um bloco na lista de blocos.

    O controle processa o Bloco do Power BI.

Diretrizes de acessibilidade

O Bloco do Power BI é simplesmente um contêiner para o conteúdo do Power BI. Aprenda a criar conteúdo acessível com estas dicas de acessibilidade do Power BI.

Se o conteúdo do Power BI não tiver um título, considere a possibilidade de adicionar um cabeçalho usando um controle Rótulo que dê suporte a leitores de tela. Você pode posicionar o rótulo imediatamente antes do bloco do Power BI.

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).