Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Configure a incorporação do Microsoft Fabric antes de incorporar um item de painel em tempo real em um aplicativo Web em JavaScript ou TypeScript. Você deve ter um espaço de trabalho atribuído a uma capacidade do Microsoft Fabric, acesso do usuário ao item Painel em Tempo Real, um registro de aplicativo no Microsoft Entra ID com permissões delegadas e ferramentas de desenvolvimento locais.
Microsoft Fabric Embed é um recurso em versão prévia pública para incorporar itens compatíveis do Microsoft Fabric.
Note
Microsoft Fabric Embed está em prévia pública. Para ver os tipos de item compatíveis, a autenticação e as limitações do contrato de preview, consulte Limitações do Microsoft Fabric Embed.
Pré-requisitos para a configuração de incorporação do Microsoft Fabric
Para obter uma lista de pré-requisitos, consulte O que preciso para usar o Microsoft Fabric Embed?
Configurar seu espaço de trabalho do Fabric
A incorporação no Microsoft Fabric dá suporte a acesso delegado do usuário. O usuário conectado do Microsoft Entra ID deve ser capaz de abrir o item Painel em Tempo Real no Microsoft Fabric antes que esse mesmo item possa ser exibido em um aplicativo incorporado.
- Abra Microsoft Fabric.
- Abra o espaço de trabalho que contém o item Painel em Tempo Real.
- Confirme se o workspace está atribuído a uma capacidade de Microsoft Fabric ativa.
- Confirme que os usuários que visualizam o item de Painel em Tempo Real incorporado têm acesso de Visualizador ou superior ao espaço de trabalho e ao item de Painel em Tempo Real.
Verificação de sucesso: o workspace mostra uma atribuição de capacidade ativa, e o usuário pode abrir diretamente o item Painel em Tempo Real no portal do Microsoft Fabric.
Importante
Se um usuário autenticado não tiver acesso ao workspace ou ao item do painel em tempo real no Microsoft Fabric, o Microsoft Fabric Embed não renderiza o item no aplicativo incorporado.
Registrar um aplicativo Microsoft Entra ID para entrada do usuário
Seu aplicativo JavaScript ou TypeScript precisa de um registro de aplicativo do Microsoft Entra ID para autenticar os usuários e solicitar tokens de acesso delegados para o Microsoft Fabric Embed.
Entre no portal do Azure.
Selecione seu locatário Microsoft Entra selecionando sua conta no canto superior direito da página.
Selecione Registros do Aplicativo. Se você não vir essa opção, pesquise-a.
Em Registros de aplicativo, selecione Novo registro.
Preencha os seguintes campos:
- Nome – dê um nome ao aplicativo.
- Tipo de conta com suporte – selecione quem pode usar o aplicativo. Selecione Contas somente neste diretório organizacional para aplicativos de locatário único, ou Contas em qualquer diretório organizacional para cenários entre locatários.
(Opcional) Na caixa URI de redirecionamento , adicione uma URL de redirecionamento.
Selecione Registrar. Depois que seu aplicativo for registrado, você será direcionado para a página de visão geral do aplicativo, na qual poderá obter a ID do aplicativo. Copie e salve a ID do aplicativo e todas as informações na caixa Resumo para uso posterior. Seu ambiente de inserção de Microsoft Fabric está pronto para uso.
Verificação de êxito: a visão geral do registro do aplicativo mostra a ID do cliente e a ID do locatário que seu aplicativo usa para autenticação de Biblioteca do Microsoft Authenticator (MSAL).
Note
Mantenha esses valores disponíveis. Você os usa quando configura a autenticação em seu aplicativo.
Adicionar permissões delegadas de API para incorporação no Microsoft Fabric
Seu aplicativo deve solicitar permissões de API delegadas para incorporação no Fabric, acesso de leitura a itens e descoberta opcional de workspace. Use permissões delegadas de usuário para incorporação no Microsoft Fabric.
No registro do aplicativo, abra as permissões de API.
Selecione Adicionar uma permissão.
Adicione as permissões delegadas que correspondem ao seu cenário.
Se sua organização exigir consentimento do administrador, peça a um administrador de locatários que conceda consentimento.
Note
Solicite as permissões delegadas menos privilegiadas para seu cenário:
| Permissão | Quando usar isso | Purpose |
|---|---|---|
Fabric.Embed |
Necessário para a incorporação do Microsoft Fabric. | Permite que seu aplicativo insira itens de Microsoft Fabric com suporte. |
KQLDashboard.Read.All |
Permissão de leitura preferencial para itens do Painel em Tempo Real. | Permite que seu aplicativo leia os itens do painel em tempo real aos quais o usuário conectado tem acesso. |
Item.Read.All |
Use apenas se o seu cenário exigir um acesso de leitura mais amplo a itens do Fabric. | Permite que seu aplicativo leia os itens do Fabric aos quais o usuário conectado pode acessar. |
Workspace.Read.All |
Necessário somente quando seu aplicativo usa as APIs REST do Microsoft Fabric para descobrir os IDs do espaço de trabalho ou do item. | Permite descoberta somente para leitura de espaços de trabalho para o usuário conectado. |
Verificação de sucesso: o registro do aplicativo inclui Fabric.Embed, uma permissão de leitura para um item e Workspace.Read.All somente se o seu aplicativo usar as APIs REST do Microsoft Fabric para descobrir IDs.
Instalar ferramentas de desenvolvimento locais para seu aplicativo Web
Instale estas ferramentas e bibliotecas para a aplicação em JavaScript ou TypeScript que hospeda o item incorporado do Painel em Tempo Real:
- Node.js e npm para instalar o pacote do SDK de Inserção Fabric
- Um editor de códigos, como o Visual Studio Code
- A Biblioteca do Microsoft Authenticator (MSAL) para JavaScript para autenticação do Microsoft Entra ID
Instalar o pacote do SDK de Inserção Fabric em seu aplicativo Web
Instale o pacote de versão prévia pública Fabric Embed SDK no aplicativo web que hospeda o item de Painel em Tempo Real incorporado. O nome e a versão do pacote podem ser alterados durante a visualização. Use o nome do pacote fornecido pela versão prévia.
npm install @microsoft/fabric-embed
Verificação bem-sucedida: o pacote do SDK de incorporação do Fabric aparece nas dependências do seu aplicativo package.json.
Coletar os IDs do workspace e do painel em tempo real
Você também pode obter o ID do workspace e o ID do item do Dashboard em Tempo Real de forma programática usando as APIs REST do Microsoft Fabric. Use Microsoft Fabric APIs REST quando seu script de instalação ou aplicativo precisar descobrir IDs em vez de copiá-las do portal Microsoft Fabric.
Obtenha o ID do espaço de trabalho com a API List Workspaces:
GET https://api.fabric.microsoft.com/v1/workspacesLocalize o espaço de trabalho pelo seu
displayNamee copie o valor deid.Obtenha o ID do item do painel em tempo real com a API List Items:
GET https://api.fabric.microsoft.com/v1/workspaces/<workspaceId>/items?type=KQLDashboardSubstitua
<workspaceId>pela ID do workspace da etapa anterior. Na resposta, localize o item Dashboard em tempo real pelo seudisplayNamee copie o valor deid. Use esse valor como a ID do item na configuração de inserção.
Note
Na API REST do Microsoft Fabric, o valor do tipo de item para um item de Painel em Tempo Real é KQLDashboard.
Opcionalmente, valide a ID do item chamando:
GET https://api.fabric.microsoft.com/v1/workspaces/<workspaceId>/items/<itemId>
Use a Get Item API para confirmar que o ID do workspace e o ID do item identificam o item esperado do painel em tempo real.
Verificação bem-sucedida: a resposta de Itens de Lista inclui o painel displayName esperado, um valor id para o ID do item e o valor do tipo de item KqlDashboard.