Comparteix via

Element de control

Defineix l'espai de noms, la versió i la informació de visualització del component.

Disponible per a

Aplicacions basades en models i llenç

Paràmetres

Nom Descripció Tipus Necessari Disponible per a
namespace Defineix el prototip d'objecte del component Només lletres o números Sí Aplicacions basades en models i llenç
constructor Un mètode per inicialitzar l'objecte Només lletres o números Sí Aplicacions basades en models i llenç
control-type Si el control és un control estàndard o un control React. El valor de virtual indica un control React utilitzant la biblioteca React de la plataforma. Els controls virtuals són una característica de la visualització prèvia pública. Més informació: Controls de React i biblioteques de plataforma standard|virtual No Aplicacions basades en models i llenç
description-key Defineix la descripció del component visible a la interfície d'usuari. string No Aplicacions basades en models i llenç
display-name-key Defineix el nom del control visible a la interfície d'usuari. string Sí Aplicacions basades en models i llenç
preview-image Imatge utilitzada a les pantalles de personalització per mostrar una vista prèvia del component. string No Aplicacions basades en models
version Defineix la versió del component definit en el control de versions semàntic string Sí Aplicacions basades en models i llenç

Elements principals

Element Descripció
manifestar Manifest és el fitxer de metadades que defineix un component. És un XML fitxer que descriu:
  • L'espai de noms del component.
  • El tipus de dades que es pot configurar, ja sigui un camp o un conjunt de dades.
  • Qualsevol propietat que es pugui configurar a l'aplicació quan s'afegeix el component.
  • Una llista dels fitxers de recursos que necessita el component.
    • Un d'ells ha de ser un recurs web de TypeScript. Aquest TypeScript ha d'incloure una funció que crearà una instància d'un objecte. Això implementa una interfície que exposa els mètodes necessaris perquè el component funcioni. Això s'anomena biblioteca d'implementació de components.
  • El nom d'una funció TypeScript a la biblioteca d'implementació de components que retornarà un objecte que aplica la interfície de component necessària.
Quan l'usuari configura un component personalitzat en una aplicació de llenç o una aplicació basada en models, les dades del manifest filtren els components disponibles de manera que només els components vàlids per al context estiguin disponibles per a la configuració. Les propietats definides al manifest d'un component es representen com a camps de configuració perquè l'usuari que configura el component pugui especificar valors. Aquests valors de propietat estan disponibles per a la funció component en temps d'execució.

Elements secundaris

Element Descripció Aparicions
conjunt de dades El node del conjunt de dades del manifest del component representa una representació específica i configurable d'un conjunt de registres de taula. 0 o més
ús de serveis externs Indica si aquest control utilitza un servei extern o no. Si és així, definiu l'indicador d'atribut habilitat com a true i afegiu el domini de servei extern a la <domain> propietat. Un control que utilitza qualsevol servei extern és un control premium i l'usuari final necessitarà una llicència del Power Apps per obrir una aplicació amb un control premium. Més informació: Llicències 0 o 1
propietat El node de propietats defineix una peça de dades específica i configurable que el component espera del Microsoft Dataverse. 0 o més
Recursos El node de recursos del manifest del component fa referència als fitxers de recursos que el component requereix per implementar la seva visualització. 1
grup-tipus El node type-group defineix un conjunt de tipus identificats per un sol nom. Aquesta informació es pot utilitzar per identificar els tipus de dades admesos per una propietat específica. 0 o més
dependències de propietats Defineix un grup de dependències de propietats. 0 o més
plataforma-acció S'utilitza per especificar que les dependències de control es carreguen sota demanda en lloc de quan es carrega el control. 0 o 1

Exemple

<control namespace="MyNameSpace"
   constructor="JSHelloWorldControl"
   version="1.0.0"
   display-name-key="JS_HelloWorldControl_Display_Key"
   description-key="JS_HelloWorldControl_Desc_Key"
   control-type="standard"
   preview-image="img/preview.png">
</control>

Referència de l'esquema de manifest del marc de components del Power Apps
Referència de l'API del marc de components del Power Apps
Informació general del marc de components del Power Apps

  • Last updated on