елемент за управление

Определя пространството на имената, версията и показваната информация на компонента.

Налично за

Приложения, управлявани от модел, и приложения за платно

Параметри

Име Описание Вид Необходимо Налично за
namespace Определя прототипа на обекта на компонента Само букви или цифри Да Приложения, управлявани от модел, и приложения за платно
constructor Метод за инициализиране на обекта Само букви или цифри Да Приложения, управлявани от модел, и приложения за платно
control-type Дали контролата е стандартна контрола, или контрола за реакция. Стойността на virtual показва react control using platform React library. Виртуалните контроли са функция в публичен предварителен преглед. Повече информация: React controls &platform libraries standard|virtual Не Приложения, управлявани от модел, и приложения за платно
description-key Определя описанието на компонента, видим в потребителския интерфейс. string Не Приложения, управлявани от модел, и приложения за платно
display-name-key Определя името на контролата, видима в потребителския интерфейс. string Да Приложения, управлявани от модел, и приложения за платно
preview-image Изображение, използвано на екраните за персонализиране, за да се покаже визуализация на компонента. string Не Управлявани от модел приложения
version Определя версията на компонента, дефиниран в семантичното създаване на версии string Да Приложения, управлявани от модел, и приложения за платно

Родителски елементи

Елемент Описание
манифест Манифест е файлът с метаданни, който дефинира компонент. Това е XML файл, който описва:
  • Пространството на имената на компонента.
  • Видът на данните, които могат да бъдат конфигурирани – поле или набор от данни.
  • Всички свойства, които могат да бъдат конфигурирани в приложението, когато се добави компонентът.
  • Списък с ресурсни файлове, от които се нуждае компонентът.
    • Един от тях трябва да бъде уеб ресурс на TypeScript. Този TypeScript трябва да включва функция, която ще създаде екземпляр на обект. Това реализира интерфейс, който показва методи, които са необходими за работата на компонента. Това се нарича библиотека за реализация на компоненти.
  • Името на функция TypeScript в библиотеката за реализация на компоненти, която ще върне обект, който прилага интерфейса на необходимия компонент.
Когато потребителят конфигурира персонализиран компонент в приложение за платно или базирано на модел приложение, данните в манифеста филтрират наличните компоненти, така че само валидните компоненти за контекста да са налични за конфигуриране. Свойствата, дефинирани в манифеста за компонент, се рендират като конфигурационни полета, така че потребителят, конфигуриращ компонента, да може да задава стойности. Тези стойности на свойствата след това са налични за функцията на компонента по време на изпълнение.

Дъщерни елементи

Елемент Описание Събития
набор от данни Възелът на набора от данни в манифеста на компонента представлява конкретно, конфигурируемо представяне на набор от записи на таблица. 0 или повече
използване на външни услуги Показва дали тази контрола използва външна услуга, или не. Ако е така, задайте флага на атрибута enabled като true и добавете домейна на външната услуга към свойството <domain> . Контрола, която използва всяка външна услуга, е premium контрола и крайният потребител ще се нуждае от лиценз за Power Apps, за да отвори приложение с премийно управление. Повече информация: Лицензиране 0 или 1
свойство Възелът на свойството дефинира конкретна, конфигурируема част от данните, които компонентът очаква от Microsoft Dataverse. 0 или повече
ресурси Възелът на ресурсите в манифеста на компонента се отнася за ресурсните файлове, които компонентът изисква, за да реализира визуализацията. 1
type-group Възелът type-group дефинира набор от типове, идентифицирани с едно име. Тази информация може да се използва за идентифициране на типовете данни, поддържани от конкретно свойство. 0 или повече
зависимости на свойство Определя група от зависимости на свойство. 0 или повече
платформа за действие Използва се за задаване на това, че контролите на зависимостите се зареждат при поискване, вместо когато контролата е заредена. 0 или 1

Пример

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

Препратка към схемата на манифеста на рамката на компонента на Power Apps
Препратка към API на платформа за компоненти на Power Apps
Общ преглед на рамката на компонентите на Power Apps