Afegir components de codi a una pàgina personalitzada per a una aplicació basada en models

Article
03/14/2023

En aquest article es mostra l'ús dels components de codi creats pels desenvolupadors professionals que utilitzen el marc de treball del component de Power Apps dins d'una pàgina personalitzada. Per obtenir una capacitat d'ampliació de l'experiència d'usuari personalitzada amb un codi baix, vegeu Afegir components del llenç a una pàgina personalitzada de l'aplicació basada en models.

Important

Les pàgines personalitzades són una característica nova amb canvis importants de productes i actualment tenen diverses limitacions conegudes destacades a Problemes coneguts de la pàgina personalitzada.

Nota

Les pàgines personalitzades admeten totes les API de marc de components a les aplicacions del llenç actualment admeses.
Algunes API específiques d'aplicacions basades en models com ara WebAPI i Navigation han publicat suport per a aplicacions per a pàgines personalitzades. Aquestes API es poden utilitzar al component de codi per a les pàgines personalitzades i funciona a l'aplicació publicada final.
Per veure l'estat de compatibilitat de l'API individual a cada plataforma, vegeu la referència d'API de Power Apps component framework

Els components de codi proporcionen als desenvolupadors professionals la capacitat de crear components de codi personalitzats per utilitzar-se dins d'una aplicació. Aquest mecanisme d'ampliació de codi proporciona administració del cicle de vida de l'aplicació de primera classe (ALM) per ampliar sense cost els components disponibles per a tots els responsables de l'aplicació a tota l'organització. Els components de codi es poden reutilitzar en pàgines, llenç i aplicacions controlades per models. Es poden actualitzar, empaquetar i desplaçar centralment mitjançant solucions estàndard de Microsoft Dataverse. Més informació: Descripció general del Power Apps component framework

Habilitar el component de Power Apps component framework per a les pàgines personalitzades

Per utilitzar components de codi dins d'una pàgina personalitzada, heu d'habilitar la característica del component de Power Apps component framework. Més informació: Habilitar la característica del component de Power Apps component framework

Crear components de codi per utilitzar en una pàgina personalitzada

Aquesta secció explica com es creen, importen i proven els components del codi.

Crear i importar components de codi a Dataverse

Els components de codi de les pàgines personalitzades segueixen el mateix patró que l'aplicació del llenç. Abans d'afegirlos a una pàgina personalitzada, s'han d'implementar primer els components de codi. Per crear un component de codi, vegeu Crear el primer component.

També podeu provar els components d'exemple de l'OOB per començar. Un cop hàgiu acabat d'implementar el component de codi, es pot empaquetar en una solució i afegir-la a la Dataverse, la qual cosa el pot fer disponible per utilitzar a totes les pàgines personalitzades en línia amb les aplicacions controlades per models i llenç. Més informació: Gestió del cicle de vida de l'aplicació dels components de codi (ALM).

Importar i utilitzar el component de codi en una pàgina personalitzada

En un entorn, les pàgines personalitzades poden utilitzar tots els components de codi importats anteriorment per Dataverse utilitzant solucions. A la subfinestra esquerra, seleccioneu Afegeix (+) i, a continuació, seleccioneu Obtén més components al final de la pàgina. Veureu una pestanya de codi a la subfinestra Importa els components que mostra tots els components de codi que hi ha a l'entorn.

Nota

Si la pestanya de codi no es mostra a la subfinestra Importa el component, comproveu que l'opció de configuració de la característica de les aplicacions del llenç de Power Apps component framework estigui habilitada. Més informació: Habilitar la característica de Power Apps component framework
Assegureu-vos també que treballeu amb la versió de creació de l'aplicació del llenç més recent.

Els components de codi que s'han afegit recentment estan disponibles a la secció Components de codi. Es pot afegir a una pàgina personalitzada.

Provar el component de codi a l'interior de l'estudi i l'aplicació publicada

Igual que les aplicacions del llenç, els components de codi són interactius i es poden provar a l'entorn de creació de pàgines personalitzat. Tanmateix, API específiques com Web APIs i Navigation, que només tenen la compatibilitat amb el temps d'execució de la pàgina personalitzada quan s'invoquen, mostraran el missatge d'error "El mètode no s'ha implementat".

Podeu descartar aquest error i publicar la pàgina personalitzada. A continuació, afegiu aquesta pàgina personalitzada a l'aplicació basada en el model i publiqueu l'aplicació per veure en acció l'API web de pàgina personalitzada.

A la imatge següent es mostra el control d'exemple de l'API web estàndard i el control de mostra i control a l'API de navegació afegit a la pàgina personalitzada que treballa en una aplicació basada en models.