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

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

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

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

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

С поддержкой интерфейса командной строки Microsoft Power Platform CLI теперь вы можете использовать автономные возможности для настройки веб-сайта, внося изменения в содержимое веб-сайта. И как только все настройки или изменения будут сохранены, вы можете загрузить конфигурацию веб-сайта обратно в Microsoft Dataverse. Когда вы загружаете контент веб-сайта с помощью интерфейс командной строки 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 CLI ограничена таблицами, перечисленными ниже.

Установить и проверить интерфейс командной строки 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 CLI для порталов: "paportal".

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

Параметры

Использовать профиль развертывания

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

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

pac pages upload --path "C:\portals\starter-portal" --deploymentProfile test --modelVersion 2

В этом файле могут быть имя таблицы (сущности) с идентификатором таблицы, список атрибутов и значения, которые вы хотите переопределить при загрузке конфигурации портала с помощью параметра 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 pac pages download, вместе с загрузкой содержимого сайта также создаются два файла манифеста.

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

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

Файл манифеста среды создается каждый раз, когда выполняется команда скачивания страниц pac .

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

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

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

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

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

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

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

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

Дополнительные соображения

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

Следующие шаги

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

См. также

• Интерфейс командной строки Microsoft Power Platform
• Использование расширения Visual Studio Code (предварительная версия)