Partilhar via

elemento de controlo

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

Disponível para

Aplicativos orientados a modelos e de tela

Parâmetros

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

Elementos pai

Elemento Description
manifesto Manifesto é o arquivo de metadados que define um componente. É um XML ficheiro que descreve:
  • O namespace do componente.
  • O tipo de dados que pode ser configurado, seja 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 recursos que o componente precisa.
    • Um deles deve ser um recurso da Web TypeScript. Este TypeScript deve incluir uma função que irá instanciar um objeto. Isso implementa uma interface que expõe 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 um aplicativo controlado por modelo, 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 para 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 ficam 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ços externos Indica se esse controle está usando serviço externo ou não. Se estiver, defina o sinalizador de atributo enabled 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. Para obter mais informações: Licenciamento 0 ou 1
propriedade O nó de propriedade define uma parte específica e configurável de dados que o componente espera do Microsoft Dataverse. 0 ou mais
Recursos O nó de recursos no manifesto do componente refere-se aos arquivos de recursos que o componente requer para implementar sua visualização. 1
tipo-grupo O nó tipo-grupo define um conjunto de tipos identificados por um único nome. Essas informações podem ser usadas para identificar os tipos de dados suportados por uma propriedade específica. 0 ou mais
dependências de propriedade Define um grupo de dependências de propriedade. 0 ou mais
plataforma-ação 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 do componente Power Apps
Referência da API da estrutura do componente Power Apps
Visão geral da estrutura do componente Power Apps

  • Last updated on