Compartir a través de

Elemento control

  • Artículo

Define el espacio de nombres, la versión y la información para mostrar del componente.

Disponible para

Aplicaciones de lienzo y basadas en modelos

Parámetros

Nombre. Descripción Tipo Necesario Disponible para
namespace Define el prototipo de objeto del componente Solo letras o números Sí Aplicaciones de lienzo y basadas en modelos
constructor Un método para inicializar el objeto Solo letras o números Sí Aplicaciones de lienzo y basadas en modelos
control-type Si el control es un control estándar o un control React. El valor de virtual indica un control React que usa la biblioteca React de la plataforma. Los controles virtuales son una característica en versión preliminar pública. Más información: Controles React y bibliotecas de plataforma standard|virtual No Aplicaciones de lienzo y basadas en modelos
description-key Define la descripción del componente que se verá en la interfaz de usuario. string No Aplicaciones de lienzo y basadas en modelo
display-name-key Define el nombre del control que se muestra en la interfaz de usuario. string Sí Aplicaciones de lienzo y basadas en modelo
preview-image Imagen que se usará en las pantallas de personalización para mostrar una vista previa del componente. string No Aplicaciones basadas en modelos
version Define la versión del componente definido en Control de versiones semántico string Sí Aplicaciones de lienzo y basadas en modelos

Elementos primarios

Elemento Description
manifest El manifiesto es el archivo de metadatos que define un componente. Es un archivo XML que describe:
  • El espacio de nombres del componente.
  • El tipo de datos que se puede configurar, un campo o un conjunto de datos.
  • Las propiedades que se pueden configurar en la aplicación cuando se agrega el componente.
  • Una lista de archivos de recursos que el componente necesita.
    • Uno de ellos debe ser un recurso web de TypeScript. Este TypeScript debe incluir una función que creará instancias de un objeto. Esto implementa una interfaz que expone métodos que son necesarios para que funcione el componente. Esto se llama la biblioteca de implementación de componentes.
  • El nombre de una función TypeScript en la biblioteca de implementación del componente que devolverá un objeto que aplica la interfaz del componente necesario.
Cuando el usuario configura un componente personalizado en una aplicación de lienzo o una aplicación basada en modelo, los datos del manifiesto filtran los componentes disponibles para que solo los componentes válidos para el contexto estén disponibles para la configuración. Las propiedades definidas en el manifiesto para un componente se generan como campos de configuración para que el usuario que configura el componente pueda especificar valores. Estos valores de propiedad están disponibles entonces para la función de componente en tiempo de ejecución.

Elementos secundarios

Elemento Description Repeticiones
data-set El nodo de conjunto de datos del manifiesto del componente es una representación específica configurable de un conjunto de registros de tabla. 0 o más
external-service-usage Indica si este control está usando un servicio externo o no. Si es así, establezca el indicador de atributo habilitado como verdadero y agregue el dominio de servicio externo a la propiedad <domain>. Un control que utiliza cualquier servicio externo es un control premium y el usuario final necesitará una licencia de Power Apps para abrir una aplicación con un control premium. Más información: Licencias 0 o 1
property El nodo property define un dato específico y configurable que el componente espera de Microsoft Dataverse. 0 o más
resources El nodo de recursos en el manifiesto de componente hace referencia a los archivos de recursos que el componente requiere para implementar su visualización. 1
type-group El nodo de type-group define un conjunto de tipos identificados por un solo nombre. Esta información se puede usar para identificar los tipos de datos compatibles con una propiedad específica. 0 o más
property-dependencies Define un grupo de propiedades-dependencias. 0 o más

Ejemplo

<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>

Referencia de esquema de manifiesto de Power Apps component framework
Referencia de la API de Power Apps component framework
Información general sobre Power Apps component framework