Ciclo de vida do item
O fluxo recomendado para a criação de itens na interface do usuário da malha é
- Solicite ao usuário o nome do item.
- Crie um item "vazio".
- Edite e salve o novo item.
Este processo pode ser dividido nas seguintes fases:
Quando o usuário seleciona um botão para criar um item de qualquer tipo, o código do Fabric FE (Portal) precisa carregar o editor de itens correspondente. O Fabric FE faz uma chamada de API para o Fabric BE para buscar as informações necessárias, incluindo a URL de origem, os detalhes do aplicativo Microsoft Entra ID e a URL BE da carga de trabalho, todos correspondentes ao contexto atual. Uma vez que essas informações estejam disponíveis, um item é criado. Normalmente, o item carrega seus recursos estáticos como HTML, JavaScript, CSS e imagens da CDN. Recomendamos usar a implantação de CDN de várias regiões e configurar a resolução de nomes para que a URL de origem seja resolvida para o servidor CDN fisicamente mais próximo do local atual do navegador.
Nota
Normalmente, o editor de itens precisa fazer chamadas para a carga de trabalho BE, possivelmente durante a fase de edição. Isso requer a resolução da carga de trabalho BE URL com base no contexto atual. Atualmente, o código pode usar uma URL BE codificada.
Criar um item vazio
É uma prática comum no Fabric permitir a criação de um item sem entrada do usuário, exceto o nome do item. Não se espera que tais itens façam algo significativo (portanto, "vazios"), mas eles aparecem no espaço de trabalho e podem participar de fluxos e operações básicos. Além disso, em alguns casos, podem até ser funcionais, com base em padrões razoáveis definidos pela carga de trabalho.
Esse fluxo começa solicitando que o usuário forneça um nome para o novo item. Tendo o nome, o iframe faz uma chamada para a API JS do host para iniciar o fluxo de criação do item, passando o objeto JSON opcional como "carga útil de criação", e o host fará uma chamada para o Fabric BE. A autenticação é tratada pelo host. O Fabric BE resolve a URL do BE da carga de trabalho com base no contexto e chama a API da CreateItem carga de trabalho, passando a "carga útil de criação" enviada pelo iframe. Espera-se que o BE da carga de trabalho armazene os metadados do novo item, possivelmente aloque alguns recursos (embora esta etapa possa ser adiada para um ponto posterior) e faça qualquer outro trabalho relevante. Quando a criação do item é concluída da perspetiva do BE da carga de trabalho, ele precisa notificar o Fabric BE sobre a alteração dos metadados do item. O mesmo processo precisa acontecer em qualquer atualização dos metadados do item e, portanto, o token de assunto precisa ser trocado para o público do Fabric BE.
Nota
A API para notificar a atualização de metadados do item não está disponível no momento.
Carregar o item
Para editar um item, o iframe precisa carregar seus metadados. Este processo é o mesmo para carregar itens "vazios" e "inicializados". O iframe faz uma chamada para a API JS do host, que chama Fabric BE, que, por sua vez, chama a API de carga de trabalho GetItemPayload. A carga de trabalho BE pode retornar um objeto JSON, que é então passado de volta para o iframe. A autenticação é tratada pelo host.
Editar o item
Depois que os metadados do item forem carregados, uma sessão de edição poderá ser iniciada. No início ou durante esta sessão, o iframe pode precisar fazer chamadas para o BE da carga de trabalho (por exemplo, para buscar uma configuração, preencher controles de interface do usuário, executar validações e muito mais). Para isso, ele precisa solicitar um token da API JS do host.