Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Este artigo descreve a arquitetura do Microsoft Fabric Extensibility Toolkit e como cargas de trabalho personalizadas se integram à plataforma Fabric. Ele explica os componentes de tempo de execução, os fluxos entre o front-end do Fabric, sua carga de trabalho e os serviços do Fabric e como o manifesto e o modelo de item fazem com que as cargas de trabalho pareçam nativas no Fabric.
Componentes arquitetónicos
Frontend de Fabric (host)
O frontend do Fabric é o ambiente do host. Ele renderiza sua carga de trabalho como um iFrame e expõe uma API de host segura ao iFrame para que a carga de trabalho possa interagir com o Fabric enquanto permanece isolada. O host é responsável por inicializar a carga de trabalho de acordo com seu manifesto (pontos de entrada, rotas e recursos), gerenciar tokens de autenticação por meio do Microsoft Entra ID e mediar chamadas da carga de trabalho para APIs públicas e serviços de plataforma do Fabric.
Aplicação Web de carga de trabalho
Sua carga de trabalho é um aplicativo Web (por exemplo, React ou Angular) que você hospeda em sua nuvem. O Fabric carrega-o em um iFrame e fornece APIs de host para integração com a plataforma. A aplicação implementa as rotas e camadas de UI que declara no seu manifesto, utiliza tokens de ID do Microsoft Entra (fornecidos pelo host) para chamar APIs públicas do Fabric e, se necessário, os seus próprios serviços de back-end, e segue os princípios do Fabric UX para que pareça e se comporte como uma experiência nativa.
Serviço de malha e APIs públicas
O serviço Fabric expõe APIs públicas para ler e gravar metadados e conteúdo, gerenciar itens e integrar com recursos da plataforma. As cargas de trabalho chamam essas APIs usando tokens com escopo emitidos por meio do Microsoft Entra ID — por exemplo, para executar operações CRUD de item e ações de ciclo de vida, acessar dados e conteúdo armazenados no OneLake e participar de recursos de espaço de trabalho, como pesquisa e descoberta. Para pontos de extremidade, escopos e diretrizes de identidade, siga as Fabric Public REST APIs.
Microsoft Entra (autenticação)
A autenticação e a autorização são tratadas pelo Microsoft Entra ID. O manifesto da carga de trabalho declara as permissões necessárias; o host Fabric obtém os tokens apropriados e impõe o consentimento e o acesso de acordo com essas declarações.
Modelo e manifesto da carga de trabalho
As cargas de trabalho são definidas por um manifesto que descreve sua identidade, recursos, rotas, pontos de entrada da interface do usuário e permissões necessárias. O manifesto é o contrato entre seu aplicativo Web e o Fabric. Para obter o esquema, exemplos e diretrizes de validação, consulte Visão geral do manifesto.
Itens e participação nativa
As cargas de trabalho normalmente contribuem com um ou mais tipos de itens. Os itens criados pela sua carga de trabalho aparecem em espaços de trabalho e se comportam como itens nativos do Fabric. Eles participam da colaboração e do compartilhamento, são detetáveis na pesquisa, seguem as operações e a governança do ciclo de vida e armazenam dados via OneLake enquanto usam APIs públicas do Fabric para CRUD.
Fluxo de ponta a ponta
- Um usuário abre um espaço de trabalho e navega até um item ou ponto de entrada fornecido pela sua carga de trabalho.
- O front-end do Fabric carrega seu aplicativo Web em um iFrame com base no manifesto.
- O host adquire tokens Microsoft Entra com os escopos que sua carga de trabalho requer e expõe uma API de host ao iFrame.
- A carga de trabalho chama APIs públicas do Fabric (e, se aplicável, seus próprios serviços) usando esses tokens.
- Os dados do item são armazenados no OneLake e os metadados do item são gerenciados por meio de APIs de malha para que se comportem como qualquer outro item de malha.
Próximos passos
Para desenvolver localmente e publicar sua carga de trabalho, consulte Publicar sua carga de trabalho. Para obter diretrizes de esquema de manifesto e desenvolvimento local, consulte Visão geral de manifesto, DevServer e DevGateway. Para obter pontos de extremidade, escopos e diretrizes de identidade da API, consulte as Fabric Public REST APIs.