Таг за шаблон на Liquid за компоненти на кода

Power Apps component framework дава възможност на професионалните разработчици и създателите на приложения да създават компоненти на кода за управлявани от модели и платно приложения. Тези кодови компоненти могат да осигурят подобрено изживяване за потребителите, работещи с данни във формуляри, изгледи и табла за управление. Повече информация: Използване на компоненти на код в портали

С тази версия въведохме възможността за добавяне на компоненти на кода с помощта на тага на шаблона Liquid на уеб страници и активирахме компоненти с помощта на Web API, които са разрешени за компоненти на ниво поле във формуляри в портали.

Компонентите на кода могат да се добавят с помощта на codecomponent етикет за шаблон на Liquid. Ключът за обозначаване на кодовия компонент, който трябва да бъде зареден, се предава с помощта на name атрибут. Ключът може да бъде GUID (който е идентификаторът на кодовия компонент) или името на компонента на кода, импортиран в Microsoft Dataverse.

Стойностите на свойствата, които компонентът на кода очаква, трябва да бъдат предадени като двойка ключ/стойност, разделени с ":" (знак на двоеточие), където ключът е името на свойството, а стойността е стойността на низа на JSON.

{% codecomponent name: <ID or name> <property1:value> <property2:value> %}

Например, за да добавите компонент на кода, очакващ входен параметър с име controlValue, използвайте следния таг на шаблона Liquid:

{% codecomponent name:abc_SampleNamespace.MapControl controlValue:'Space Needle' controlApiKey:<API Key Value>%}

Можете да използвате примерния контрол на картата и да пакетирате компонента на кода като решение за използване с портали.

Урок: Използвайте компоненти на кода на страници с маркер на шаблон на Liquid

В този урок ще конфигурирате портали на Power Apps, за да добавите компонента към уеб страница. След това ще посетите уеб страницата на порталите и ще взаимодействате с компонента.

Преди да започнете

Ако използвате примерния компонент на кода, използван в този урок, уверете се, че първо импортирате примерните решения в средата, преди да започнете. За да научите за импортирането на решения, отидете на Импортиране на решения.

Предварителни изисквания

За предварителни условия и за да научите повече за поддържаните/неподдържаните компоненти на кода в порталите, отидете на Използване на компоненти на кода в порталите.

Стъпка 1. Добавете компонента на кода към уеб страница от Studio

1. Отворете портала си в Power Apps портали Studio.

2. В горния ляв ъгъл изберете Нова страница.

3. Изберете Празно.

4. В десния панел на свойствата актуализирайте името на уеб страницата. Например „Преглед на карти“.

5. Актуализиране на частичен URL адрес. Например „mapviewer“.

6. Разгънете разрешения.

7. Забранете Страницата е достъпна за всички.

8. Изберете уеб ролите, на които трябва да бъде разрешен достъп до тази страница.

9. Изберете областта за редактиране на страницата, за да редактирате Liquid изходен код.

10. Отворете Редактор на код на студио.

11. Добавете контрола с маркер за Liquid шаблон, като използвате следния синтаксис:

    {% codecomponent name:abc\_SampleNamespace.MapControl controlValue:'Space Needle' controlApiKey:<API Key Value> %}
    

    Съвет

    За да извлечете подробности за всички импортирани компоненти и да потърсите име на компонент, вижте CustomControl Уеб API.

    Например:

    • За да намерите компонент:

      https://contoso.api.crm10.dynamics.com/api/data/v9.2/customcontrols?$select=ContosoCustomControlName

    • За да извлечете входни параметри за компонент:

      https://contoso.api.crm10.dynamics.com/api/data/v9.2/customcontrols?$filter=name eq 'ContosoCustomControlName' &$select=manifest

12. Запишете и затворете редактора на код.

13. В горния десен ъгъл изберете Преглед на уеб сайт.

14. Уеб страницата вече ще показва контролата, добавена към нея.

Следващи стъпки

Общ преглед: Използване на компонентите на код в порталите

Вижте също

Етикет на обекта на Codecomponent Dataverse
Таг за шаблон на Codecomponent
Общ преглед на Power Apps component framework
Създаване на първия ви компонент
Добавяне на компоненти на код към колона или таблица в приложения, управлявани от модел
Внедряване на примерен компонент на уеб API на портал