Configurar a incorporação do Microsoft Fabric para itens de painel em tempo real

Configure Microsoft Fabric Embed antes de incorporar um item Real-Time Dashboard numa aplicação web JavaScript ou TypeScript. Deve ter um espaço de trabalho atribuído a uma capacidade do Microsoft Fabric, acesso de utilizador ao item Painel em Tempo Real, um registo de aplicação do Microsoft Entra ID com permissões delegadas e ferramentas de desenvolvimento locais.

O Microsoft Fabric Embed é uma capacidade de pré-visualização pública para incorporar itens Microsoft Fabric suportados.

Note

O Microsoft Fabric Embed está em pré-visualização pública. Para tipos de itens suportados, autenticação e limitações de contratos de pré-visualização, consulte Limitações para Microsoft Fabric Embed.

Pré-requisitos para a configuração do Microsoft Fabric Embed

Para uma lista de pré-requisitos, veja O que preciso para usar o Microsoft Fabric Embed?

Configure o seu espaço de trabalho Fabric

O Microsoft Fabric Embed suporta acesso delegado de utilizadores. O utilizador do Microsoft Entra ID com sessão iniciada tem de conseguir abrir o item Real-Time Dashboard no Microsoft Fabric antes de o mesmo item poder ser apresentado numa aplicação incorporada.

  1. Abra Microsoft Fabric.
  2. Abra o espaço de trabalho que contém o item Real-Time Dashboard.
  3. Confirme que o espaço de trabalho está atribuído a uma capacidade ativa do Microsoft Fabric.
  4. Confirme que os utilizadores que visualizam o item Real-Time Dashboard incorporado têm acesso Visualizador ou superior ao espaço de trabalho e ao item Real-Time Dashboard.

Verificação de sucesso: o espaço de trabalho mostra uma atribuição ativa de capacidade, e o utilizador pode abrir o item Real-Time Dashboard diretamente no portal Microsoft Fabric.

Captura de ecrã de um espaço de trabalho com um Real-Time Dashboard.

Importante

Se um utilizador com sessão iniciada não tiver acesso ao espaço de trabalho ou ao item Real-Time Dashboard no Microsoft Fabric, o Microsoft Fabric Embed não apresenta o item na aplicação incorporada.

Registe uma aplicação Microsoft Entra ID para iniciar sessão de utilizador

A sua aplicação JavaScript ou TypeScript precisa de um registo da aplicação Microsoft Entra ID para iniciar sessão nos utilizadores e solicitar tokens de acesso delegados para o Microsoft Fabric Embed.

  1. Inicie sessão no portal Azure.

  2. Selecione o seu inquilino Microsoft Entra selecionando a sua conta no canto superior direito da página.

  3. Selecione Registos de aplicações. Se não vires esta opção, procura por ela.

  4. Em Registos de aplicações, selecione Nova inscrição.

  5. Preencha os seguintes campos:

    • Nome - Dê um nome à sua candidatura.
    • Tipo de conta suportado - Selecione quem pode usar a aplicação. Selecione Contas apenas neste diretório organizacional para aplicações de locatário único, ou Contas em qualquer diretório organizacional para cenários entre locatários.

  6. (Opcional) Na caixa de URI de Redirecionamento , adicione um URL de redirecionamento.

  7. Selecione Registar. Depois de registar a sua aplicação, é encaminhado para a página de descrição geral da sua aplicação, onde pode obter o ID da Aplicação. Copie e guarde o ID da Aplicação e toda a informação na caixa de Resumo para uso posterior. O seu ambiente Microsoft Fabric Embed está pronto para usar. Captura de ecrã do registo da nova aplicação no Entra ID.

Verificação de sucesso: a visão geral do registo da aplicação mostra o ID do cliente e o ID do inquilino que a sua aplicação utiliza para a autenticação do Biblioteca de Autenticação da Microsoft (MSAL).

Note

Mantenha estes valores disponíveis. Utiliza-os quando configura a autenticação na sua aplicação.

Adicionar permissões delegadas de API para o Microsoft Fabric Embed

A sua aplicação deve pedir permissões delegadas da API para incorporação do Fabric, acesso à leitura de itens e descoberta opcional do espaço de trabalho. Use permissões de utilizador delegadas para o Microsoft Fabric Embed.

  1. No registo da sua aplicação, abra as permissões da API.

  2. Selecione Adicionar uma permissão.

  3. Adicione as permissões delegadas que correspondam ao seu cenário.

  4. Se a sua organização exigir consentimento do administrador, peça a um administrador inquilino para conceder o consentimento.

    Captura de ecrã das permissões da API.

Note

Peça as permissões delegadas menos privilegiadas para o seu cenário:

Permission Quando usar Purpose
Fabric.Embed Necessário para o Microsoft Fabric Embed. Permite que a sua aplicação incorpore itens Microsoft Fabric suportados.
KQLDashboard.Read.All Permissão de leitura preferida para itens do painel em tempo real. Permite que a sua aplicação leia os itens do Painel em Tempo Real aos quais o utilizador com sessão iniciada pode aceder.
Item.Read.All Utilize apenas se o seu cenário exigir acesso de leitura mais abrangente aos itens do Fabric. Permite que a sua aplicação leia itens do Fabric a que o utilizador iniciado pode aceder.
Workspace.Read.All Necessário apenas quando a sua aplicação utiliza APIs REST do Microsoft Fabric para descobrir os IDs da área de trabalho ou dos itens. Permite a deteção de áreas de trabalho só de leitura para o utilizador com sessão iniciada.

Verificação de sucesso: o registo da aplicação inclui Fabric.Embed, uma permissão de leitura de item, e Workspace.Read.All apenas se a sua aplicação usar APIs Microsoft Fabric REST para descobrir IDs.

Instale ferramentas de desenvolvimento local para a sua aplicação web

Instale estas ferramentas e bibliotecas para a aplicação JavaScript ou TypeScript que aloja o item Real-Time Dashboard incorporado:

Instala o pacote Fabric Embed SDK na tua aplicação web

Instale o pacote Fabric Embed SDK em pré-visualização pública na aplicação web que aloja o item incorporado do Real-Time Dashboard. O nome e a versão do pacote podem mudar durante a pré-visualização. Utilize o nome do pacote que a sua versão de pré-lançamento disponibiliza.

npm install @microsoft/fabric-embed

Verificação bem-sucedida: o pacote Fabric Embed SDK aparece nas dependências da sua package.json aplicação.

Recolher os IDs dos espaços de trabalho e dos painéis em tempo real

Também pode obter o ID do espaço de trabalho e o ID do item do Dashboard em Tempo Real programaticamente, utilizando as APIs REST do Microsoft Fabric. Use APIs REST do Microsoft Fabric quando o seu script de configuração ou aplicação precisar de descobrir IDs em vez de os copiar do portal Microsoft Fabric.

  1. Obtenha o ID do espaço de trabalho com a API List Workspaces:

    GET https://api.fabric.microsoft.com/v1/workspaces

    Localize o espaço de trabalho através do respetivo displayName e copie o valor de id.

  2. Obtenha o ID do item do Real-Time Dashboard com a API de Itens da Lista:

    GET https://api.fabric.microsoft.com/v1/workspaces/<workspaceId>/items?type=KQLDashboard

    Substitua <workspaceId> pelo ID do espaço de trabalho do passo anterior. Na resposta, encontre o item Real-Time Dashboard pelo respetivo displayName e copie o valor de id. Use esse valor como ID do item na sua configuração de embed.

Note

Na API REST do Microsoft Fabric, o valor do tipo de item de um item de Dashboard em Tempo Real é KQLDashboard.

Opcionalmente, valide o ID do item chamando:

GET https://api.fabric.microsoft.com/v1/workspaces/<workspaceId>/items/<itemId>

Utilize a API Get Item para confirmar que o ID do espaço de trabalho e o ID do item identificam o item esperado do Real-Time Dashboard.

Verificação de sucesso: a resposta dos itens da lista inclui o painel esperado displayName, um valor id para o ID do item e o valor do tipo de item KqlDashboard.

Passos seguintes

  • Last updated on