Учебник: использование компонентов кода набора данных

Примечание

Действует с 12 октября 2022 г, в качестве порталов для Power Apps используется Power Pages. Дополнительная информация: Microsoft Power Pages теперь доступен для всех (блог)
Скоро мы мигрируем и объединим документацию порталов Power Apps с документацией Power Pages.

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

Примечание

  • Это руководство основан на существующем руководстве по Power Apps component framework, которое содержит пошаговые инструкции по компоненту элемента управления сетки Power Apps (предварительная версия) в списке и вложенной сетке на пустой странице. Вы также можете использовать любой существующий или новый компонент, чтобы добавить его на любую другую веб-страницу для этого руководства. В этом случае убедитесь, что вы используете свой компонент и веб-страницу, выполняя шаги, описанные в этом руководстве. Чтобы узнать, как компоненты кода поддерживаются на порталах, см. раздел Использование компонентов кода на порталах. 

Из этого руководства вы узнаете, как выполнять следующие задачи:

  • Создание образца компонента с помощью Power Apps component framework
  • Упаковка компонента в среде Microsoft Dataverse
  • Настройка Power Pages для добавления компонента на веб-страницу
  • Посетите свою веб-страницу Power Pages для взаимодействия с компонентом

Предварительные условия

  • Версия портала  9.4.9.хх или выше. 
  • Базовый пакет портала Dataverse  9.3.2209.x или выше. 

Шаг 1 — Создание первого компонента

Завершите руководство Создание своего первого компонента.

Примечание

В конце руководства Создание своего первого компонента, у вас будет компонент с именем TSLinearInputComponent, упакованный и отправленный в вашу среду Dataverse.

Шаг 2 — Добавление компонента кода в представления или вложенные сетки в приложении на основе модели

Чтобы добавить компонент в таблицу  Организация, представления и вложенные сетки, следуйте инструкциям здесь Преобразование представлений и вложенных сеток в редактируемые сетки (предварительная версия) 

Шаг 3 — Добавление компонента кода в список и вложенную сетку на портале

На этом этапе вы создадите новую базовую форму на порталах, а затем добавите компонент в созданную базовую форму. Вместо этого вы также можете использовать существующую базовую форму. 

Шаг 3.1 — Добавление компонента кода в списки

  1. Откройте Приложение управления порталом.

  2. На левой панели в разделе  Содержимое выберите  список. 

  3. Выберите  Создать. 

  4. Введите  Имя. Например,  Список учетных записей с компонентом кода. 

  5. Для  Имя таблицы выберите таблицу, в которую вы добавили компонент кода ранее в этом руководстве. 

  6. Выберите  веб-сайт портала. 

  7. Выберите Использование настроенного компонента кода как Да 

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

Шаг 3.2 — Добавление компонента кода в представления в списке

Выполните следующие действия, чтобы включить элемент управления в представлении сущности в Dataverse. 

  1. Откройте Приложение управления порталом.

  2. Введите  Имя. Например,  Список учетных записей с компонентом кода. 

  3. Для  Имя таблицы выберите таблицу, в которую вы добавили компонент кода ранее в этом руководстве. 

  4. Выберите  веб-сайт портала. 

  5. Добавьте представления в сетку дополнительных параметров. 

    Добавьте представления в сетку дополнительных параметров.

  6. Выберите Использование настроенного компонента кода как Да 

Шаг 3.3 — Добавление компонента кода во вложенную сетку 

  1. Откройте Приложение управления порталом.

  2. На левой панели в разделе Содержимое выберите Базовые формы. 

  3. Выберите базовую форму, созданную на предыдущем этапе. 

  4. Выберите Связанный. 

  5. Выберите Метаданные базовой формы. 

  6. Выберите Создать метаданные базовой формы. 

  7. Выберите Тип как Вложенная сетка. 

  8. Выберите Имя вложенной сетки. 

    Добавление компонента кода к вложенной сетке.

  9. Для  Стиль элемента управления выберите  Компонент кода. 

    Выберите стиль элемент управления.

Добавление компонента кода на основе набора данных с помощью тега Liquid

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

Значения свойств, которые ожидает компонент кода, необходимо передать в виде пары ключ/значение, разделенных знаком ":" (знак двоеточия), где ключ — это имя свойства, а значение — строковое значение JSON. 

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

Для получения дополнительной информации см. раздел Тег шаблона Liquid для компонентов кода.

Ограничения

Действия и настройка фильтра метаданных для списков и вложенных сеток не поддерживаются элементами управления сеток Power Apps.

См. также

Использование компонентов кода на порталах Power Apps

  • Last updated on