Позначка шаблону Liquid для компонентів коду

Примітка

З 12 жовтня 2022 року портали Power Apps перейменовано на Power Pages. Додаткова інформація: Microsoft Power Pages тепер у загальному доступі (блоґ)
Незабаром документацію порталів Power Apps буде перенесено та об’єднано з документацією Power Pages.

Power Apps component framework дозволяє професійним розробникам і розробникам програм створювати компоненти коду для компонованих ы модельних програм. Ці компоненти коду дають змогу користувачам вдосконалити роботу з даними у формах, поданнях і приладних дошках. Додаткова інформація: Використання компонентів кодів на порталах

Важливо

Позначка шаблону Liquid для компонентів коду потребує використання порталів версії 9.3.10.х або пізніших версій.

У цьому випуску ми запровадили можливість додавання компонентів коду на вебсторінки за допомогою позначки шаблону Liquid і ввімкнутих компонентів за допомогою веб-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>%}

Підказка

У цьому прикладі використовуються параметри, які називаються controlvalue та controlApiKey, проте для використання компонента можуть знадобитися різні імена параметрів.

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

Примітка

Ресурси, створені спільнотою, не підтримуються Microsoft. У разі запитань і проблем із ресурсами спільноти зверніться до видавця ресурсу. Перед використанням цих ресурсів необхідно переконатися, що вони відповідають принципам роботи з Power Apps component framework, і їх слід використовувати лише з метою довідки.

Посібник: використання компонентів коду на сторінках із позначкою шаблону Liquid

У цьому посібнику ви настроюватимете портали Power Apps, щоб додати компонент на вебсторінку. Після цього ви відвідаєте веб-сторінку порталів і будете взаємодіяти з компонентом.

Перед початком

Якщо використовується приклад компонента коду, що наведено в цьому посібнику, перш ніж почати слід імпортувати зразки рішень до середовища. Для отримання відомостей про імпортування рішень, перейдіть до розділу Імпорт рішень.

вимоги

Щоб дізнатися про підтримувані та непідтримувані компоненти коду на порталах, перейдіть до розділу Використання компонентів коду на порталах.

Примітка

У цьому посібнику використовується зразок компонента коду, створеного за допомогою Power Apps component framework для демонстрації елемента керування картою на вебсторінці. Можна використати наявний або новий компонент самостійно, а також будь-яку іншу вебсторінку для цього посібника. У цьому разі під час виконання кроків, описаних у цьому посібнику, слід використовувати компонент і вебсторінку. Щоб отримати додаткові відомості про створення компонентів коду, перейдіть до розділу Створення першого компонента.

Крок 1. Додавання компонента коду на вебсторінку з Studio

1. Відкрийте свій портал в Power Apps порталах Студія.

2. У верхньому лівому куті виберіть елемент Нова сторінка.

3. Виберіть елемент Пустий.

4. В області властивостей праворуч змініть ім'я веб-сторінки. Наприклад, «Перегляд карти».

5. Оновіть часткову URL-адресу. Наприклад, «Перегляд карти».

6. Розгорніть Дозволи.

7. Відключіть Сторінка доступна всім.

8. Виберіть веб-ролі, яким має бути дозволено доступ на цю сторінку.

9. Виберіть область на сторінці з правами редагування вихідного коду Liquid.

10. Відкрийте Редактор коду студії.

11. Додайте елемент керування з позначкою шаблону Liquid, використовуючи наведений нижче синтаксис.

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

    Підказка

    Докладні відомості про всі імпортовані компоненти та пошук імені компонента див. у CustomControl Web 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
Позначка шаблону сodecomponent
Огляд Power Apps component framework
Створення першого компонента
Додавання компонентів коду до стовпця або таблиці в модельних програмах
Реалізація компонента веб-API порталу

Примітка

Розкажіть нам про свої уподобання щодо мови документації? Візьміть участь в короткому опитуванні. (зверніть увагу, що це опитування англійською мовою)

Проходження опитування займе близько семи хвилин. Персональні дані не збиратимуться (декларація про конфіденційність).