Controlo Mosaico do Power BI no Power Apps
Um controlo que mostra um mosaico do Power BI dentro de uma aplicação.
Não tem o Power BI? Inscrição.
Descrição
Tire partido da sua análise de dados e produção de relatórios, apresentando os Power BI mosaicos dentro das suas aplicações. Especifique o mosaico que pretende mostrar, definindo as respetivas propriedades Workspace, Dashboard e Tile no separador Data do painel de opções.
Nota
- O controlo do mosaico do Power BI não está disponível em ambientes GCC High e DoD.
- O controlo Mosaico do Power BI não está disponível na China.
- Para obter requisitos de licenciamento ao incorporar mosaicos Power BI, consulte Licenciamento.
Partilha e segurança
Quando partilha uma aplicação que contém conteúdos do Power BI, tem de partilhar a aplicação em si mas também o dashboard no qual tem origem o mosaico. Caso contrário, os conteúdos do Power BI não serão apresentados nem para os utilizadores que abram a aplicação. As aplicações com conteúdos do Power BI respeitam as permissões para esses conteúdos.
Desempenho
Não é recomendado ter mais do que três mosaicos do Power BI carregados ao mesmo tempo numa aplicação. Pode controlar o carregamento e descarregamento de mosaicos definindo a propriedade LoadPowerBIContent.
A incorporar pções
A incorporação é diferente entre versões de Power BI API. Devido ao novo regime de autenticação Power BI API, o seu mosaico pode não estar acessível em dispositivos móveis ou noutros cenários incorporados (Teams ou SharePoint).
Pode controlar a utilização da versão API utilizando a propriedade AllowNewAPI. Para obter mais informações, veja as Propriedades principais.
| Valor da propriedade AllowNewAPI | Comportamento |
|---|---|
| Verdadeiro | Pode incorporar um dashboard, relatório ou mosaico, retirando o URL incorporado de Power BI e tornando-o o valor TileUrl. |
| Falso | Pode incorporar um mosaico dashboard por URL incorporado e tornando-o o valor TileUrl ou usando a interface gráfica proporcionada. |
Nota
A incorporação de um URL do Power BI (por exemplo, num iFrame) não é suportada no Power Apps móvel, uma vez que o pedido de URL do Power BI não é suportado pelo leitor móvel.
Filtragem
A filtragem difere entre as versões de Power BI API. Consulte as secções apropriadas abaixo, dependendo da configuração do controlo.
Ao utilizar a nova API para ligar para o serviço Power BI
Quando a propriedade AllowNewAPI estiver definida como "Verdadeiro", está a utilizar a nova API para chamar o serviço Power BI. para obter mais informações, consulte Filtrar um relatório utilizando parâmetros de cadeia de consulta no URL.
Ao utilizar a API original para ligar para o serviço Power BI
Quando a propriedade AllowNewAPI estiver definida como "Falso", está a utilizar a API original para chamar o serviço Power BI. Neste caso, ao passar um único parâmetro da aplicação, pode filtrar os resultados que aparecem num mosaico Power BI. No entanto, apenas os valores de cadeias de caracteres e o operador Equals são suportados e o filtro poderá não funcionar se o nome da tabela ou o nome da coluna contiverem 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 lista:
"&$filter=Store/Territory eq '" & ListBox1.Selected.Abbr & "'"
O parâmetro irá filtrar um valor no conjunto de dados do relatório de onde o mosaico provém. No entanto, a funcionalidade de filtragem tem as seguintes limitações:
- Só é possível aplicar um filtro.
- Só é suportado o operador do
eq. - O tipo de campo tem de ser cadeia.
- A filtragem só está disponível em mosaicos visualização afixados. Não é suportado para relatórios afixados.
- Não é possível filtrar os elementos visuais de script R e Python.
Pode utilizar campos computados no relatório do Power BI para converter outros tipos de valor em cadeias de caracteres ou combinar vários campos num só.
Propriedades principais
AllowNewAPI – Se utilizar a nova API ao chamar o serviço Power BI. A definição do valor como Verdadeiro permitirá a utilização da nova API do Power BI (que não é suportada em dispositivos móveis e alguns cenários incorporados, mas permite alguma filtragem mais avançada). Com Falso irá utilizar a API original. O valor predefinido é falso.
Dashboard – o dashboard do Power BI de onde provém o mosaico.
LoadPowerBIContent – quando definido como Verdadeiro, os conteúdos do Power BI são carregados e apresentados. Quando definido como Falso, os conteúdos do Power BI são descarregados, o que liberta memória e otimiza o desempenho.
PowerBIInteractions - Quando definido para Verdadeiro, é possível interagir com o conteúdo do Power BI, mas o evento Power Apps OnSelect não será acionado. Quando definido para Falso, não é possível interagir com o mosaico, mas o evento Power Apps OnSelect será acionado quando o mosaico for selecionado.
Tile – o nome do mosaico do Power BI que pretende apresentar.
Workspace – a área de trabalho do Power BI de onde provém o mosaico.
Propriedades adicionais
BorderColor – a cor do limite de um controlo.
BorderStyle – se o limite do controlo é Sólido, Tracejado, Com pontos ou Nenhum.
BorderThickness – a espessura do limite de um controlo.
DisplayMode – se o controlo permite a intervenção do utilizador (Editar), apenas apresenta os dados (Visualizar), ou está desativado (Desativado).
Height – a distância entre as margens superiores e inferiores de um controlo.
OnSelect– Ações a efetuar quando o utilizador toca ou seleciona um controlo. Por predefinição, o relatório do Power BI associado ao mosaico é aberto.
TileUrl – o URL através do qual o mosaico é pedido ao serviço do Power BI. Para adicionar filtro de cadeia de consulta ao seu URL, consulte a secção de filtragem acima.
Visible – se um controlo é apresentado ou está oculto.
Width – a distância entre as margens esquerda e direita de um controlo.
X – a distância entre o limite esquerdo de um controlo e o limite esquerdo do respetivo recipiente principal (do ecrã—se não existir um recipiente principal).
Y – a distância entre o limite superior de um controlo e o limite superior do recipiente principal (do ecrã—se não existir um recipiente principal).
Exemplo
No separador Inserir, abra o menu Gráficos e, em seguida, adicione um controlo Mosaico do Power BI.
Não sabe como adicionar e configurar um controlo?
No separador Dados do painel de opções, selecione A Minha Área de Trabalho na definição Área de Trabalho.
Selecione um dashboard da lista de dashboards e, em seguida, selecione um mosaico da lista de mosaicos.
O controlo processa o mosaico Power BI.
Diretrizes de acessibilidade
O Mosaico do Power BI é simplesmente um recipiente para conteúdo do Power BI. Saiba como criar conteúdo acessível com estas Sugestões de acessibilidade do Power BI.
Se os conteúdos do Power BI não tiverem um título, pondere adicionar um cabeçalho com o controlo Etiqueta para suportar leitores de ecrã. Pode posicionar a etiqueta imediatamente antes do mosaico do Power BI.
Nota
Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)
O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).