Compartilhar via

elemento control

Define o namespace, a versão e as informações de exibição do componente.

Disponível para

Aplicativos baseados em modelo e tela

Parâmetros

Nome Description Tipo Obrigatório Disponível para
namespace Define o protótipo do objeto do componente Somente letras ou números Yes Aplicativos baseados em modelo e tela
constructor Um método para inicializar o objeto Somente letras ou números Yes Aplicativos baseados em modelo e tela
control-type Se o controle é um controle padrão ou um controle React. O valor indica virtual um controle React usando a biblioteca react da plataforma. Os controles virtuais são um recurso em versão prévia pública. Mais informações: Controles do React > bibliotecas de plataforma standard|virtual Não Aplicativos baseados em modelo e tela
description-key Define a descrição do componente visível na interface do usuário. string Não Aplicativos baseados em modelo e tela
display-name-key Define o nome do controle visível na interface do usuário. string Yes Aplicativos baseados em modelo e tela
preview-image Imagem usada nas telas de personalização para mostrar uma visualização do componente. string Não Aplicativos baseados em modelos
version Define a versão do componente definida no Controle de Versão Semântico string Yes Aplicativos baseados em modelo e tela

Elementos pai

Elemento Description
manifesto Manifesto é o arquivo de metadados que define um componente. É um XML arquivo que descreve:
  • O namespace do componente.
  • O tipo de dados que ele pode ser configurado, um campo ou um conjunto de dados.
  • Todas as propriedades que podem ser configuradas no aplicativo quando o componente é adicionado.
  • Uma lista de arquivos de recurso de que o componente precisa.
    • Um deles deve ser um recurso Da Web TypeScript. Esse TypeScript deve incluir uma função que criará uma instância de um objeto. Isso implementa uma interface que expõe os métodos necessários para que o componente funcione. Isso é chamado de biblioteca de implementação de componentes.
  • O nome de uma função TypeScript na biblioteca de implementação de componentes que retornará um objeto que aplica a interface de componente necessária.
Quando o usuário configura um componente personalizado em um aplicativo de tela ou em um aplicativo controlado por modelos, os dados no manifesto filtram os componentes disponíveis para que apenas os componentes válidos para o contexto estejam disponíveis para configuração. As propriedades definidas no manifesto de um componente são renderizadas como campos de configuração para que o usuário que configura o componente possa especificar valores. Esses valores de propriedade estão disponíveis para a função de componente em tempo de execução.

Elementos filho

Elemento Description Ocorrências
conjunto de dados O nó do conjunto de dados no manifesto do componente representa uma representação específica e configurável de um conjunto de registros de tabela. 0 ou mais
uso de serviço externo Indica se esse controle está usando o serviço externo ou não. Se for, defina o sinalizador de atributo habilitado como true e adicione o domínio de serviço externo à <domain> propriedade. Um controle que usa qualquer serviço externo é um controle premium e o usuário final precisará de uma licença do Power Apps para abrir um aplicativo com um controle premium. Mais informações: Licenciamento 0 ou 1
propriedade O nó de propriedade define um dado específico e configurável que o componente espera do Microsoft Dataverse. 0 ou mais
recursos O nó de recursos no manifesto do componente refere-se aos arquivos de recurso que o componente requer para implementar sua visualização. 1
type-group O nó de grupo de tipos define um conjunto de tipos identificados por um único nome. Essas informações podem ser usadas para identificar os tipos de dados compatíveis com uma propriedade específica. 0 ou mais
propriedade-dependências Define um grupo de dependências de propriedade. 0 ou mais
platform-action Usado para especificar que as dependências de controle são carregadas sob demanda em vez de quando o controle é carregado. 0 ou 1

Example

<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 esquema de manifesto da estrutura de componentes do Power Apps
Referência da API da estrutura de componentes do Power Apps
Visão geral da estrutura de componentes do Power Apps

  • Last updated on