Добавление компонентов кода на настраиваемую страницу для вашего приложения на основе модели

Статья
15.03.2023

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

Важно!

Настраиваемые страницы - это новая функция со значительными изменениями продукта, которая в настоящее время имеет ряд известных ограничений, изложенных в разделе Известные проблемы с пользовательскими страницами.

Примечание

Настраиваемые страницы поддерживают все API-интерфейсы платформы компонентов, которые в настоящее время поддерживаются для приложений на основе холста.
API-интерфейсы некоторых конкретных приложений на основе модели, например WebAPI и Navigation опубликовали поддержку приложений для настраиваемых страниц. Эти API-интерфейсы можно использовать в компоненте кода для настраиваемых страниц и работать с окончательно опубликованным приложением.
Для получения информации об индивидуальном статусе поддержки API на каждой платформе см. справочник по API Power Apps component framework

Компоненты кода предоставляют профессиональным разработчикам возможность создавать собственные компоненты кода для использования в приложении. Этот механизм расширяемости профессионального программного кода обеспечивает отличное управление жизненным циклом приложений (ALM), позволяющее легко расширять компоненты, доступные всем разработчикам приложений в организации. Компоненты кода можно повторно использовать на настраиваемых страницах, холсте и в приложениях на основе модели. Их можно централизованно обновлять, упаковывать и перемещать с помощью стандартных решений Microsoft Dataverse. Больше информации:Обзор Power Apps component framework

Включение Power Apps component framework для настраиваемых страниц

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

Создайте компоненты кода для использования на настраиваемой странице

В этом разделе описывается, как создавать, импортировать и тестировать компоненты кода.

Создание и импорт компонентов кода в Dataverse

Компоненты кода для настраиваемых страниц следуют тому же шаблону, что и для приложения на основе холста. Компоненты кода должны быть реализованы в первую очередь, прежде чем их можно будет добавить на настраиваемую страницу. Чтобы создать компонент кода, см. Создайте свой первый компонент.

Вы также можете попробовать Примеры компонентов OOB для начала. Когда вы закончите реализацию своего компонента кода, его можно упаковать в решение и добавить в Dataverse, что сделает его доступным для использования на всех настраиваемых страницах в соответствии с приложениями на основе модели и холста. Больше информации: Управление жизненным циклом приложений компонентов кода (ALM).

Импорт и использование компонента кода на настраиваемой странице

В среде настраиваемые страницы могут использовать все компоненты кода, ранее импортированные в Dataverse с помощью решений. На левой панели выберите Добавить (+), а затем выберите Получение дополнительных компонентов внизу страницы. Вы увидите вкладку кода в области Импорт компонентов, показывающую все компоненты кода, присутствующие в среде.

Примечание

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

Недавно добавленные компоненты кода теперь доступны в разделе Компоненты кода. Можно добавить на настраиваемую страницу.

Тестирование компонента кода внутри студии и опубликованного приложения

Как и приложения на основе холста, компоненты кода интерактивны и могут быть протестированы в среде разработки студии пользовательских страниц. Однако конкретные API, такие как Web APIs и Navigation, который при вызове поддерживает только среду выполнения настраиваемой страницы, отобразят сообщение об ошибке «Метод не реализован».

Вы можете закрыть эту ошибку и опубликовать настраиваемую страницу. Затем добавьте эту настраиваемую страницу в приложение на основе модели и опубликуйте приложение, чтобы увидеть веб-API настраиваемой страницы в действии.

На изображении ниже показан стандартный Пример элемента управления веб-API и Элемент управления API навигации, добавленный на настраиваемую страницу, работающую в опубликованном приложении на основе модели.