Dela via

kontrollelement

Definierar komponentens namnområde, version och visningsinformation.

Tillgänglig för

Modelldrivna appar och appar för arbetsytor

Parameterar

Namn Description Typ Krävs Tillgänglig för
namespace Definierar objektprototypen för komponenten Endast bokstäver eller siffror Yes Modelldrivna appar och appar för arbetsytor
constructor En metod för att initiera objektet Endast bokstäver eller siffror Yes Modelldrivna appar och appar för arbetsytor
control-type Om kontrollen är en standardkontroll eller en React-kontroll. Värdet för anger en React-kontroll med hjälp av virtual plattformen React-biblioteket. Virtuella kontroller är en funktion i offentlig förhandsversion. Mer information: React-kontroller och plattformsbibliotek standard|virtual Nej Modelldrivna appar och appar för arbetsytor
description-key Definierar beskrivningen av komponenten som visas i användargränssnittet. string Nej Modelldrivna appar och appar för arbetsytor
display-name-key Definierar namnet på kontrollen som visas i användargränssnittet. string Yes Modelldrivna appar och appar för arbetsytor
preview-image Bild som används på anpassningsskärmarna för att visa en förhandsgranskning av komponenten. string Nej Modellbaserade appar
version Definierar versionen av komponenten som definierats i semantisk versionshantering string Yes Modelldrivna appar och appar för arbetsytor

Överordnade element

Komponent Description
manifestera Manifestet är den metadatafil som definierar en komponent. Det är en XML fil som beskriver:
  • Komponentens namnområde.
  • Den typ av data som kan konfigureras, antingen ett fält eller en datauppsättning.
  • Alla egenskaper som kan konfigureras i programmet när komponenten läggs till.
  • En lista över resursfiler som komponenten behöver.
    • En av dem måste vara en TypeScript-webbresurs. TypeScript måste innehålla en funktion som instansierar ett objekt. Detta implementerar ett gränssnitt som exponerar metoder som krävs för att komponenten ska fungera. Detta kallas för komponentimplementeringsbiblioteket.
  • Namnet på en TypeScript-funktion i komponentimplementeringsbiblioteket som returnerar ett objekt som tillämpar det nödvändiga komponentgränssnittet.
När användaren konfigurerar en anpassad komponent i en arbetsyteapp eller en modelldriven app filtrerar data i manifestet bort de tillgängliga komponenterna så att endast de giltiga komponenterna för kontexten är tillgängliga för konfiguration. Egenskaperna som definieras i manifestet för en komponent återges som konfigurationsfält så att användaren som konfigurerar komponenten kan ange värden. Dessa egenskapsvärden är sedan tillgängliga för komponentfunktionen vid körning.

Underordnade element

Komponent Description Händelser
datauppsättning Datamängdsnoden i komponentmanifestet representerar en specifik, konfigurerbar representation av en uppsättning tabellposter. 0 eller fler
external-service-usage Anger om den här kontrollen använder extern tjänst eller inte. Om den är det anger du den aktiverade attributflaggan som true och lägger till den externa tjänstdomänen i <domain> egenskapen. En kontroll som använder en extern tjänst är en premiumkontroll och slutanvändaren behöver en Power Apps-licens för att öppna en app med en Premium-kontroll. Mer information: Licensiering 0 eller 1
egenskap Egenskapsnoden definierar en specifik, konfigurerbar datamängd som komponenten förväntar sig av Microsoft Dataverse. 0 eller fler
Resurser Resursnoden i komponentmanifestet refererar till de resursfiler som komponenten kräver för att implementera visualiseringen. 1
type-group Noden type-group definierar en uppsättning typer som identifieras med ett enda namn. Den här informationen kan användas för att identifiera de datatyper som stöds av en specifik egenskap. 0 eller fler
egenskapsberoenden Definierar en grupp med egenskapsberoenden. 0 eller fler
plattformsåtgärd Används för att ange att kontrollberoenden ska läsas in på begäran i stället för när kontrollen läses in. 0 eller 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>

Referens för manifestschema för Power Apps-komponentramverket
Api-referens för Power Apps-komponentramverket
Översikt över Power Apps-komponentramverk

  • Last updated on