Поділитися через

Посібник: використання Microsoft Power Platform CLI із Power Pages

  • Стаття

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

Нотатка

  • Цей посібник зосереджується на командах Microsoft Power Platform CLI, необхідних для використання Power Pages. Для отримання додаткових відомостей про команди, які використовуються в Power Platform CLI, див. Загальні команди.
  • Починаючи з Power Platform версії CLI 1.27, pac paportal команда змінюється на pac powerpages. paportal продовжує працювати, але ми рекомендуємо використовувати і надалі powerpages .

Завантаження та інсталяція Visual Studio Code

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

Крок 1. Автентифікуйтеся

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

Дотримуйтесь вказівок в процесі автентифікації, щоб увійти до середовища.

Приклад процесу автентифікації в середовищі Dataverse за допомогою Microsoft Power Platform CLI

Крок 2. Список доступних веб-сайтів

Використовуйте команду pac powerpages list , щоб відобразити список доступних Power Pages веб-сайтів у середовищі, до якого Dataverse ви підключалися на попередньому кроці.

pac powerpages list

Приклад списку веб-сайтів.

Крок 3. Завантаження вмісту веб-сайтів

Завантажуйте вміст веб-сайту з підключеного Dataverse середовища за допомогою команди завантаження pac powerpages.

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

Приклад

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

Для параметра id («ідентифікатор») використовуйте значення WebSiteId, що повертається разом із результатами наступного кроку.

Текст використовується невізуальними екранами.

Нотатка

  • Використовуйте modelVersion1 або 2 щоб вказати, чи будуть дані сайту використовувати стандартну (1) або розширену модель даних(2).
  • Запустіть pac powerpages list -v команду, щоб побачити, яка модель даних використовується для вашого сайту. Щоб дізнатися більше, перейдіть до розділу Розширена модель даних.

Крок 4. Змінення вмісту веб-сайтів

Змініть конфігурацію, використовуючи Visual Studio Code, та збережіть зміни.

Нотатка

Переконайтесь, що оновлюєте тільки ті таблиці, із якими дозволено використовувати Power Platform CLI. Додаткові відомості: Таблиці, що підтримуються.

Наприклад, на сторінці порталу за замовчуванням відображається такий текст:

Зразок тексту сторінки порталів

Цей текст можна побачити у HTML-коді веб-сторінки:

Visual Studio Code із виділеним текстом для змінення.

Цей текст можна змінити та зберегти зміни:

Оновлений за допомогою Visual Studio Code текст.

Порада

Ви можете змінити розташування шляху папки у PowerShell/вбудованому термінала на завантажене розташування і ввести код, щоб відкрити папку безпосередньо в Visual Studio Code.

Крок 5. Передавання змін

Нотатка

  • Якщо виконується передавання до кількох середовищ, див. передавання змін через профіль розгортання, щоб дізнатися, як передавати зміни за допомогою профілю розгортання.
  • Переконайтеся, що максимальний розмір вкладення в цільовому середовищі такий самий або більший, ніж у вихідному середовищі.
  • Максимальний розмір файлів визначається параметром Максимальний розмір файлу на вкладці "Електронна пошта" в настройках системи в діалоговому вікні "Параметри системи середовища".

Зробивши необхідні зміни, завантажте їх за допомогою команди pac powerpages upload :

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

Приклад

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

Початок передавання.

Нотатка

Переконайтеся, що введено правильний шлях до вмісту порталів. За замовчуванням папка із завантаженим вмістом порталів створюється з іменем, що співпадає із іменем порталу (зрозумілим ім’ям). Наприклад, якщо зрозуміле ім'я порталу — custom-portal, шлях у команді, наведеній вище (--path) буде C:\pac-portals\downloads\custom-portal.

Завантаження відбувається лише для зміненого контенту. У цьому прикладі, оскільки зміни вносилися до веб-сторінки, буде передано тільки вміст для таблиці adx_webpage.

Передавання завершено лише для зміненого вмісту.

Передавання змін за допомогою профілю розгортання

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

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

    Папка для профілів розгортання

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

    Профіль розгортання YAML для розробки

  3. Відредагуйте файл YAML розгортання за допомогою Visual Studio Code в такому форматі:

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

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

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

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

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

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

    Нотатка

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

Крок 6. Підтвердьте зміни.

Щоб підтвердити зміни, внесені на веб-сторінку, виконайте наведені кроки.

  1. Виберіть елемент Синхронізація у студії дизайну Power Pages.

  2. Щоб побачити зміни, перейдіть на веб-сторінку.

    Перегляд оновленого вмісту сторінки.

  3. Якщо ви використовували приклад профілю розгортання, описаний вище, фрагмент YAML оновлює значення, як показано на наступному знімку екрана.

    Суфікс назви браузера в програмі керування порталом

    Суфікс назви браузера, оновлений через зазначені вище зміни, змінюється під час відкриття порталу в браузері:

    Змінення браузера

Це є кінцевим підсумком цього посібника. Ви можете повторити кроки, наведені вище, щоб змінити вміст порталів для інших таблиць, що підтримуються.

Наступні кроки

Як використовувати розширення "Код" Visual Studio

Див. також