Поддержка порталов для интерфейса командной строки 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.
Команды 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 с порталами