Adicione componentes de código a uma página personalizada para a sua aplicação condicionada por modelo

Artigo
04/18/2023

Este artigo descreve a utilização de componentes de código construídos por programadores profissionais utilizando o Power Apps component framework dentro de uma página personalizada. Para obter a extensibilidade personalizada de pouco código UX, consulte adicionar componentes de tela a uma página personalizada para a sua aplicação condicionada por modelo.

Importante

As páginas personalizadas são uma nova funcionalidade com alterações significativas do produto e têm atualmente uma série de limitações conhecidas delineadas em Problemas conhecidos da página personalizada.

Nota

As páginas personalizadas suportam todas as APIs da estrutura de componentes que são atualmente suportadas para aplicações de tela.
Algumas APIs específicas de aplicações condicionadas por modelo como a WebAPI e Navegação, publicaram suporte de aplicações para páginas personalizadas. Estas APIs podem ser utilizadas no componente de código para páginas personalizadas e funcionam na aplicação publicada final.
Para o estado de suporte individual da API em cada plataforma, consulte a referência API do Power Apps component framework

Os componentes de código fornecem aos programadores profissionais a capacidade de criar componentes de código personalizados para usar dentro de uma aplicação. Este mecanismo de extensibilidade pró-código fornece uma gestão de primeira classe do ciclo de vida da aplicação (ALM) para alargar sem problemas os componentes disponíveis a todos os fabricantes de aplicações na organização. Os componentes de código podem ser reutilizados em páginas personalizadas, telas e aplicações condicionadas por modelos. Podem ser centralmente atualizados, embalados e movidos utilizando soluções Microsoft Dataverse standard. Mais informações: Descrição geral do Power Apps component framework

Ativar o Power Apps component framework para páginas personalizadas

Para utilizar componentes de código dentro de uma página personalizada, é necessário ativar a funcionalidade Power Apps component framework. Mais informações: Ativar a funcionalidade Power Apps component framework

Crie componentes de código para usar numa página personalizada

Esta secção descreve como criar, importar e testar componentes do código.

Criação e importação de componentes de código no Dataverse

Os componentes de código para páginas personalizadas seguem um padrão igual nas aplicações de tela. Os componentes de código devem ser implementados primeiro antes de poderem ser adicionados a uma página personalizada. Para criar um componente de código, consulte Criar o seu primeiro componente.

Também pode experimentar componentes da amostra OOB para iniciar o arranque. Uma vez terminada a implementação do seu componente de código, pode ser incorporado numa solução e adicionado ao Dataverse, disponibilizando-o para uso em todas as páginas personalizadas em linha com as aplicações condicionadas por modelos e tela. Mais informações: Gestão do ciclo de vida da aplicação de componentes de código (ALM).

Importar e usar um componente de tela numa página personalizada

Num ambiente, as páginas personalizadas podem utilizar todos os componentes de código previamente importados para Dataverse utilizando soluções. No painel esquerdo, selecione Adicionar (+) e, em seguida, selecione Obter mais componentes na parte inferior da página. Verá um separador de código no painel Importar componentes mostrando todos os componentes de código presentes no ambiente.

Nota

Se o separador de código não aparecer no painel Importar componentes, verifique se a definição da funcionalidade Power Apps component framework para aplicações de tela está ativada. Mais informações: Ativar funcionalidade Power Apps component framework
Além disso, certifique-se de que está a trabalhar na versão de criação mais recente da aplicação de tela.

Os novos componentes de código adicionados estão agora disponíveis na secção Componentes do Código. Pode ser adicionado a uma página personalizada.

Testar o componente de código dentro do estúdio e aplicação publicada

Tal como as aplicações de tela, os componentes de código são interativos e podem ser testados no ambiente de criação de estúdio de página personalizada. No entanto, APIs específicos como Web APIs e Navigation, que só têm o suporte de runtime da página personalizada quando invocados, mostrarão a mensagem de erro "Método não implementado".

Pode dispensar este erro e publicar a página personalizada. Em seguida, adicione esta página personalizada à aplicação condicionada por modelo e publique a aplicação para ver a página personalizada da API em ação.

A imagem abaixo mostra o comando de exemplo da Web API standard e o comando API de navegação adicionados à página personalizada que funciona dentro de uma aplicação condicionada por modelos publicada.