Поддержка порталов для интерфейса командной строки Microsoft Power Platform

Примечание

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

Microsoft Power Platform CLI (интерфейс командной строки) — это простой универсальный интерфейс командной строки для разработчиков, который позволяет разработчикам и создателям приложений создавать компоненты кода.

Инструменты Microsoft Power Platform CLI — это первый шаг к всеобъемлющей истории управления жизненным циклом приложения (ALM), в которой корпоративные разработчики и независимые поставщики программного обеспечения могут быстро и эффективно создавать, собирать, отлаживать и публиковать свои расширения и настройки. Дополнительные сведения см. в статье Что такое интерфейс командной строки Microsoft Power Platform CLI

Благодаря этой функции порталы Microsoft Power Apps поддерживают интерфейс командной строки Microsoft Power Platform для включения CI/CD (непрерывная интеграция/непрерывное развертывание) конфигурации портала. Теперь вы можете зарегистрировать конфигурацию портала в системе управления версиями и переместить конфигурацию портала в любую среду, используя Microsoft Power Platform CLI.

Примечание

Эта функция обычно доступна с интерфейса командной строки Power Platform версии 1.9.8. Чтобы узнать об установке последней версии, см. Установка интерфейса командной строки Microsoft Power Platform.

Зачем использовать Microsoft Power Platform CLI для разработки порталов?

С поддержкой порталов для Microsoft Power Platform CLI теперь вы можете использовать автономные возможности для настройки порталов, внося изменения в их содержимое. И как только все настройки или изменения будут сохранены, загрузите их на портал. Когда вы загружаете контент порталов с помощью Microsoft Power Platform CLI содержимое структурировано в форматах YAML и HTML, что упрощает настройку и обеспечивает удобство разработки.

Вот список функций и возможностей, полезных для порталов с поддержкой Microsoft Power Platform CLI:

Простота использования

  • Поддержка загрузки данных портала в локальную файловую систему и отправки данных портала из локальной файловой системы

  • Опираться на существующие инструменты Microsoft Power Platform CLI.

Управление жизненным циклом приложений (ALM)

  • Отслеживание изменений конфигурации портала в организации

  • Перемещение файлов конфигурации между организациями или клиентами

Поддержка профессиональных разработчиков и организаций

  • Помогает легко интегрироваться с любыми инструментами управления версиями, такими как «git»

  • Простая настройка конвейеров CI/CD

Установка Microsoft Power Platform CLI

Пошаговые инструкции см. в Установка Microsoft Power Platform CLI.

Поддерживаемые таблицы

Поддержка порталов для интерфейса командной строки Microsoft Power Platform ограничена таблицами, перечисленными ниже.

adx_ad

adx_adplacement

adx_blog

adx_blogpost

adx_botconsumer

adx_communityforum

adx_communityforumaccesspermission

adx_contentsnippet

adx_entityform

adx_entityformmetadata

adx_entitylist

adx_entitypermission

adx_forumthreadtype

adx_pagetemplate

adx_poll

adx_polloption

adx_pollplacement

adx_portallanguage

adx_publishingstate

adx_redirect

adx_shortcut

adx_sitemarker

adx_sitesetting

adx_tag

adx_urlhistory

adx_webfile

adx_webform

adx_webformmetadata

adx_webformstep

adx_weblink

adx_weblinkset

adx_webpage

adx_webpageaccesscontrolrule

adx_webrole

adx_website

adx_websiteaccess

adx_websitebinding (только скачивание)

adx_websitelanguage

adx_webtemplate

заметка

Важно!

  • Настраиваемые таблицы и таблицы, относящиеся к шаблону портала (например, блог, сообщество или портал идей), не поддерживаются для настройки с помощью Microsoft Power Platform CLI.
  • Вложения в виде файлов изображений в записях объявлений (adx_ad) не загружаются с помощью Power Platform CLI. В качестве обходного пути используйте поле URL-адрес изображения или добавьте в поле Копия ссылку HTML на запись веб-файла, содержащую файл изображения.

Установить и проверить Microsoft Power Platform CLI для порталов

Чтобы узнать об установке Microsoft Power Platform CLI, перейдите в Установка Microsoft Power Platform CLI.

После установки Microsoft Power Platform CLI откройте командную строку и запустите pac, чтобы убедиться, что выходные данные содержат "paportal" — команду для порталов Power Apps.

Подтвердите команду paportal в Microsoft Power Platform CLI.

Команды Microsoft Power Platform CLI для порталов

Команда интерфейса командной строки Microsoft Power Platform для порталов: "paportal".

В следующих разделах приведены дополнительные сведения о различных свойствах команды paportal.

Параметры

Имя свойства Description Пример
список Выводится список всех веб-сайтов портала из текущей среды Dataverse. pac paportal list
загрузить Загрузка содержания веб-сайта портала из текущей среды Dataverse. Должны быть следующие параметры:
- path: путь, по которому будет загружено содержимое веб-сайта (псевдоним: -p)
- webSiteId: идентификатор веб-сайта портала для загрузки (псевдоним: -id)
- overwrite: (необязательно) true — перезаписать существующее содержимое; false — ошибка, если в папке уже есть содержимое веб-сайта (псевдоним: -o)
pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902
отправить Отправка содержимого веб-сайта портала в текущую среду Dataverse. Должны быть следующие параметры:
- path: путь, по которому хранится содержимое веб-сайта (псевдоним: -p)
-deploymentProfile: отправить данные портала со сведениями среды, определенными с помощью переменных профиля в файле deployment-profiles/[profile-name].deployment.yaml
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name"
Использовать профиль развертывания

Переключатель deploymentProfile позволяет вам определять набор переменных для среды в формате YAML. Например, у вас могут быть разные профили развертывания (такие как разработка, тестирование, производство), которые имеют разные сведения схемы, определенные в профиле.

Если вы создаете тестовый профиль, вы можете создать файл в deployment-profiles с именем "test.deployment.yml" (то есть <profileTag>.deployment.yml). И вы можете запустить команду с тегом (<profileTag>) для использования этого профиля:

pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile test

В этом файле могут быть имя таблицы (сущности) с идентификатором таблицы, список атрибутов и значения, которые вы хотите переопределить при загрузке конфигурации портала с помощью параметра deploymentProfile.

Кроме того, вы можете использовать переменную OS для доступа к переменным среды операционной системы.

Вот пример этого YAML-файла профиля test.deployment.yml с уникальными сведениями схемы:

adx_sitesetting:
    - adx_sitesettingid: 4ad86900-b5d7-43ac-1234-482529724970
      adx_value: ${OS.FacebookAppId} 
      adx_name: Authentication/OpenAuth/Facebook/AppId
    - adx_sitesettingid: 5ad86900-b5d7-43ac-8359-482529724979
      adx_value: contoso_sample
      adx_name: Authentication/OpenAuth/Facebook/Secret
adx_contentsnippet:
    - adx_contentsnippetid: b0a1bc03-0df1-4688-86e8-c67b34476510
      adx_name: PowerBI/contoso/sales
      adx_value:  https://powerbi.com/group/contoso/sales

Примечание

Чтобы узнать обо всех командах, используемых в CLI, помимо порталов, перейдите по ссылке Общие команды в Microsoft Power Platform CLI.

Файлы манифеста

Когда вы загружаете содержимое веб-сайта с помощью команды интерфейса командной строки pac paportal download, наряду с загрузкой содержимого сайта, также будут созданы два файла манифеста.

  • Файл манифеста среды (org-url-manifest.yml)
  • Файл манифеста отслеживания удаления (manifest.yml)

Файл манифеста среды (org-url-manifest.yml)

Файл манифеста среды создается при каждом выполнении команды pac paportal download.

После каждой загрузки инструмент PAC интерфейса командной строки считывает существующий файл манифеста среды и обновляет записи, удаленные в среде, или создает файл манифеста среды, если он не существует.

При выполнении команды pac paportal upload для отправки содержимого веб-сайта портала. Он считывает файл манифеста среды и идентифицирует изменения, внесенные с момента последней загрузки, и отправляет только обновленное содержимое. Это помогает оптимизировать процесс отправки, поскольку отправляется только обновленный контент веб-сайта, а не весь контент при каждой команде отправки.

Файл манифеста среды будет доступен только для чтения при подключении к той же среде (URL-адрес среды совпадает с именем файла), чтобы избежать случайных изменений.

Файл манифеста отслеживания удаления (manifest.yml)

Этот файл используется для отслеживания записей, удаленных из среды.

Когда содержимое веб-сайта загружается с помощью команды pac paportal download, добавляются удаленные записи из файла манифеста среды (org-url-manifest.yml) в файл manifest.yml. Поэтому когда вы отправляете содержимое веб-сайта с помощью команды pac paportal upload, происходит удаление файлов из среды (даже из другой среды). Этот файл не удаляется и используется независимо от того, к какой среде вы подключены.

Примечание

Чтобы удалить записи содержимого сайта в одной среде, а также удалить те же записи содержимого в другой среде с помощью интерфейса командной строки PAC, вам потребуется запустить команду pac paportal download до, а также после удаления содержимого записи веб-сайта. Файл manifest.yml будет отслеживать эти изменения и удалять соответствующие записи в целевой среде при выполнении команды pac paportal upload.

Использование расширения Visual Studio Code

Вы также можете использовать расширение VS Code Расширение Power Platform VS Code, чтобы использовать встроенный язык Liquid из IntelliSense, помощь в завершении кода, подсказки и взаимодействие с интерфейсом командной строки Microsoft Power Platform с использованием встроенного терминала VS Code. Больше информации: Использование расширения Visual Studio Code (предварительная версия)

Дополнительные рекомендации

  • Сообщение об ошибке отображается, если путь к файлу превышает ограничение максимальной длины пути. Больше информации: Ограничение максимальной длины пути в Windows
  • Для повторяющихся записей, таких как повторяющееся имя веб-страницы, Microsoft Power Platform CLI создает две разные папки — одна с именем веб-страницы, а вторая с тем же именем с префиксом хэш-кода. Например, "My-page" и "My-page-hash-code".

Дальнейшие действия

Учебник. Использование интерфейса командной строки Microsoft Power Platform с порталами

См. также