Учебник. Использование Microsoft Power Platform CLI с Power Pages

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

Загрузка и установка Visual Studio Code

Чтобы подключиться к порталам Power Apps и использовать команды CLI Microsoft Power Platform, используйте Visual Studio Code и интегрированный терминал. Интегрированный терминал упрощает подключение к среде Dataverse и загрузку, изменение и отправку конфигурации порталов. Вместо этого вы также можете использовать Windows PowerShell.

Шаг 1. Аутентификация

Перед подключением перечислите, загрузите или отправьте изменения для портала Power Apps, сначала вы должны пройти аутентификацию в среде Dataverse. Для получения дополнительной информации об аутентификации с помощью интерфейса командной строки Microsoft Power Platform, перейдите в pac auth.

Для аутентификации откройте Windows PowerShell и выполните команду pac auth create, используя свой URL-адрес среды Dataverse.

pac auth create -u [Dataverse URL]

Пример

pac auth create -u https://contoso-org.crm.dynamics.com

Следуйте подсказкам аутентификации, чтобы войти в среду.

Шаг 2. Список доступных веб-сайтов

Используйте команду pac pages list, чтобы вывести список доступных веб-сайтов Power Pages в среде Dataverse, к которой вы подключились на предыдущем шаге.

pac pages list

Шаг 3. Загрузите содержимое веб-сайта

Скачайте содержимое веб-сайта из подключенной среды Dataverse с помощью команды pac pages download.

pac pages download --path [PATH] -id [WebSiteId-GUID] --modelVersion [DataModel]

Пример

pac pages download --path c:\pac-portals\downloads -id d44574f9-acc3-4ccc-8d8d-85cf5b7ad141 --modelVersion 2

Для параметра id используйте WebSiteId, возвращенный из выходных данных предыдущего шага.

Шаг 4. Изменить содержимое веб-сайта

Измените конфигурацию с помощью Visual Studio Code и сохраните изменения.

Например, на странице портала по умолчанию показан текст, такой как этот:

Этот текст виден в HTML веб-страницы:

Вы можете изменить этот текст и сохранить изменения:

Шаг 5. Отправить изменения

После внесения необходимых изменений загрузите их с помощью команды pac pages upload:

pac pages upload --path [Folder-location] --modelVersion [ModelVersion]

Пример

pac pages upload --path C:\pac-portals\downloads\custom-portal\ --modelVersion 2

Отправка происходит только для измененного содержимого. В этом примере, поскольку изменение сделано на веб-странице, содержимое отправляется только для таблицы adx_webpage.

Загрузить изменения с помощью профиля развертывания

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

1. Создайте папку с именем deployment-profiles внутри папки, содержащей содержимое портала. Например, если загруженное содержимое портала находится внутри "starter-portal", папка профилей развертывания должна находиться внутри этой папки.

   

2. Внутри папки профилей развертывания создайте файл YAML развертывания, содержащий изменения, относящиеся к среде. Например, среда разработки может называться "dev.deployment.yml".

   

3. Отредактируйте файл YAML развертывания, используя Visual Studio Code в следующем формате:

   <table-name>:
   - <record-id>: <GUID>
     <column-name>: <Name>
     <column-value>: <Value>
   

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

   adx_contentsnippet:
       - adx_contentsnippetid: 76227a41-a33c-4d63-b0f6-cd4ecd116bf8 # Replace with your content snippet ID
         adx_name: Browser Title Suffix # Setting name
         adx_value:   · Custom Portal (Dev) # Setting value
   

4. Чтобы отправить изменения в другую среду с помощью YAML-файла профиля развертывания, сначала выполните аутентификацию для целевой организации.

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

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

   Заметка

   В приведенном выше примере используется имя профиля развертывания "dev" после выполнения предыдущих шагов по созданию профиля развертывания dev. Измените имя с "dev" на любое другое (например, QA для "qa.deployment.yml" или Test для "test.deployment.yml"), если вы использовали другое имя файла для YAML-файла развертывания.

Шаг 6. Подтверждение изменений

Чтобы подтвердить изменения, внесенные на веб-страницу:

1. Выберите Синхронизировать в студии дизайна Power Pages.

2. Перейдите на веб-страницу, чтобы увидеть изменения.

   

3. Если вы использовали пример профиля развертывания, объясненный ранее, фрагмент кода YAML обновит значение, как показано на следующем снимке экрана.

   

   Суффикс заголовка браузера, обновленный посредством вышеуказанного изменения, показывает изменение, когда вы открываете портал в браузере:

   

На этом урок завершен. Вы можете повторить описанные выше шаги и изменить содержимое порталов для других поддерживаемых таблиц.

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

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

См. также

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