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

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

Завантаження та інсталяція 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

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

Крок 2. Список доступних порталів

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

pac paportal list

Крок 3. Завантаження вмісту порталів

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

pac paportal download --path [PATH] -id [WebSiteId-GUID]

Приклад

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

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

Крок 4. Змінення вмісту порталів

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

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

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

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

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

Після внесення необхідних змін передайте їх за допомогою команди pac paportal upload.

pac paportal upload --path [Folder-location]

Приклад

pac paportal upload --path C:\pac-portals\downloads\custom-portal\

Передаватися буде лише вміст, що зазнав змін. У цьому прикладі, оскільки зміни вносилися до веб-сторінки, буде передано тільки вміст для таблиці 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 змінює значення "Суфікс назви браузера" зі стандартного "Настроюваний портал" на "Настроюваний портал (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:   · Custom Portal (Dev) # Setting value
   

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

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

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

   Примітка

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

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

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

1. Очистіть кеш на стороні сервера, або скористайтеся можливістю Синхронізувати конфігурацію у Студії порталів Power Apps.

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

   

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

   

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

   

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

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

Використання розширення Visual Studio Code

Див. також

• Microsoft Power Platform CLI
• Використання розширення Visual Studio Code (підготовча версія)