Engadir compoñentes de código a unha páxina personalizada para a súa aplicación controlada por modelos

Artigo
06/10/2024

Este artigo describe o uso de compoñentes de código creados por programadores profesionais que usan Power Apps component framework dentro dunha páxina personalizada. Para ver a extensibilidade da experiencia de usuario personalizada sen apenas código, consulte engadir compoñentes de lenzo a unha páxina personalizada para a súa aplicación baseada en modelos.

Importante

As páxinas personalizadas son unha nova característica con cambios significativos no produto e actualmente teñen unha serie de limitacións coñecidas descritas en Problemas coñecidos das páxinas personalizadas.

Nota

As páxinas personalizadas admiten todas as API do marco de compoñentes que actualmente son compatibles con aplicacións de lenzo.
Algunhas API específicas de aplicacións baseadas en modelos como WebAPI e Navigation teñen compatibilidade de aplicacións publicadas para páxinas personalizadas. Estas API pódense usar no compoñente de código para páxinas personalizadas e funcionan na aplicación publicada final.
Para ver o estado de compatibilidade da API individual en cada plataforma, consulte a referencia da API de Power Apps component framework

Os compoñentes de código proporcionan aos programadores profesionais a posibilidade de crear compoñentes de código personalizados para o seu uso nunha aplicación. Este mecanismo de extensibilidade pro-código proporciona unha xestión do ciclo de vida de aplicacións (ALM) de primeira clase para estender sen problemas os compoñentes dispoñibles a todos os fabricantes de aplicacións de toda a organización. Os compoñentes do código pódense reutilizar en páxinas personalizadas e aplicacións baseadas en modelos e de lenzo. Pódense actualizar, comprimir e mover de xeito centralizado usando as solucións estándar de Microsoft Dataverse. Máis información: Visión xeral de Power Apps component framework

Habilitar Power Apps component framework para páxinas personalizadas

Para usar compoñentes de código dentro dunha páxina personalizada, cómpre habilitar a característica de Power Apps component framework. Máis información: Activar a característica de Power Apps component framework

Crear compoñentes de código para usar nunha páxina personalizada

Esta sección describe como crear, importar e probar compoñentes de código.

Creación e importación de compoñentes de código en Dataverse

Os compoñentes de código para páxinas personalizadas seguen o mesmo padrón que coa aplicación de lenzo. Os compoñentes do código deben implantarse primeiro antes de poder engadilos a unha páxina personalizada. Para crear un compoñente de código, consulte Crear o seu primeiro compoñente.

Tamén pode probar os compoñentes de mostra listos para usar para comezar máis rápido. Unha vez que remate de implantar o seu compoñente de código, pódese comprimir nunha solución e engadir a Dataverse, facéndoo dispoñible para o seu uso en todas as páxinas personalizadas en liña coas aplicacións baseadas en modelos e de lenzo. Máis información: Xestión do ciclo de vida da aplicación de compoñentes de código (ALM).

Importación e uso de compoñentes de código nunha páxina personalizada

Nun ambiente, as páxinas personalizadas poden usar todos os compoñentes de código importados previamente a Dataverse empregando solucións. No panel esquerdo, seleccione Engadir (+) e, a continuación, seleccione Obter máis compoñentes na parte inferior da páxina. Verá unha pestana de código no panel Importar compoñentes que mostra todos os compoñentes de código presentes no contorno.

Nota

Se a pestana de código non aparece no panel Importar compoñente, verifique que a configuración das funcións de Power Apps component framework para aplicacións de lenzo está habilitada. Máis información: Activar a característica de Power Apps component framework
Asegúrese tamén de que está a traballar na última versión de creación do estudo de aplicacións de lenzo.

Os compoñentes de código recentemente engadidos xa están dispoñibles na sección Compoñentes do código. Pódese engadir a unha páxina personalizada.

Probar o compoñente de código dentro do estudo e da aplicación publicada

Do mesmo xeito que as aplicacións de lenzo, os compoñentes de código son interactivos e pódense probar no ambiente de creación do estudo de páxinas personalizadas. Non obstante, as API específicas como Web APIs e Navigation, que só teñen a compatibilidade do tempo de execución da páxina personalizada cando se invoca, mostrará a mensaxe de erro "Método non implantado".

Pode ignorar este erro e publicar a páxina personalizada. A continuación, engada esta páxina personalizada á aplicación baseada en modelos e publíquea para ver a API web da páxina personalizada en acción.

A imaxe seguinte mostra o Control de mostra da API web estándar e o Control da API de navegación engadidos á páxina personalizada que traballa dentro dunha aplicación publicada baseada en modelos.