Підтримка для Microsoft Power Platform CLI для Power Pages

Microsoft Power Platform CLI (інтерфейс командного рядка) — це простий єдиний інтерфейс командного рядка для розробника, що дозволяє розробникам і авторам програм створювати компоненти коду.

Засоби CLI Microsoft Power Platform – це перший крок для повноцінного керування життєвим циклом програми (ALM), в межах якого розробники й постачальники програм можуть швидко та ефективно створювати, збирати, налагоджувати та публікувати розширення та настроювання. Для отримання додаткової інформації перейдіть до розділу Що таке Microsoft Power Platform CLI?

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

Нотатка

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

Навіщо використовувати 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 обмежена наступними таблицями.

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 CLI для порталів — це paportal.

У розділах нижче наведено додаткові відомості про різні властивості команди paportal.

Параметри

Ім'я властивості	Опис	Приклад
список	Виводить список усіх веб-сайтів порталів із поточного середовища Dataverse. Можна додати параметр -v , щоб указати, чи використовується сайт стандартною або вдосконаленою моделлю даних	pac paportal list
завантажити	Завантажує вміст веб-сайту порталу з поточного середовища Dataverse. Має перелічені нижче параметри. - path: шлях, куди завантажується вміст веб-сайту (псевдонім: -p) - webSiteId: ідентифікатор веб-сайту порталу для завантаження (псевдонім: -id) - перезаписувати: (необов'язково) значення true — перезаписати наявний вміст, значення false — перервати виконання, якщо у папці вже є вміст веб-сайту (псевдонім: -o) - modelVersion: 1 або 2 щоб вказати, чи використовуються дані сайту, які потрібно завантажити, стандартну (1) або розширену модель даних(2).	pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 --modelVersion 2
завантажити	Передає вміст веб-сайту порталу до поточного середовища Dataverse. Має зазначений нижче параметр. - шлях: шлях, за яким зберігається вміст веб-сайту (псевдонім: -p) -deploymentProfile: передавання даних порталу з відомостями про середовище, визначеними через змінні профілю у файлі deployment-profiles/[profile-name].deployment.yaml - modelVersion: 1 або 2 щоб вказати, чи використовуються дані сайту, які потрібно завантажити, стандартну (1) або розширену модель даних(2).	pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" --modelVersion 2

Використання профілю розгортання

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

Якщо ви створюєте тестовий профіль, можна створити файл у розділі deployment-profiles з іменем «test.deployment.yml» (а саме, <profileTag>.deployment.yml). І можна виконати команду з позначкою (<profileTag>), щоб використати цей профіль:

pac paportal 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 на додачу до порталів, перейдіть до розділу Загальні команди в Microsoft Power Platform CLI.

Файли маніфесту

Коли ви завантажуєте вміст веб-сайту за допомогою команди pac paportal download CLI, разом із завантаженням вмісту сайту він також генерує два маніфест-файли;

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

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

Файл маніфесту середовища створюється кожного разу під час виконання команди pac paportal download.

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

Під час виконання команди pac paportal upload, щоб передати вміст веб-сайту порталу. Він читає файл маніфесту середовища та визначає зміни, внесені з моменту останнього завантаження, і передає лише оновлений вміст. Це допомагає оптимізувати процес завантаження, оскільки передаватиметься лише оновлений вміст веб-сайту, а не весь вміст для кожної команди передавання.

Файл маніфесту середовища читається лише тоді, коли він з’єднується з тим самим середовищем (URL-адреса середовища збігається з назвою файлу), щоб уникнути випадкових змін.

Нотатка

• Файл маніфесту середовища не призначений для відстеження змін під час розгортання веб-сайту в різні середовища.
• Файл маніфесту середовища призначений для використання розробниками для локального розгортання в середовищі для розробників і його слід додавати до списку ігнорування git.

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

Цей файл використовується для відстеження видалених записів із середовища.

Коли вміст веб-сайту завантажується за допомогою команди paportal download , це додає видалені записи з файлу маніфесту середовища (org-url-manifest.yml) до manifest.yml файлу. Таким чином, коли ви завантажуєте вміст веб-сайту за допомогою команди paportal upload , він видаляє файли з середовища (навіть в інше середовище). Цей файл не видаляється і його буде використано незалежно від середовища, з яким ви підключились. Цей файл потрібно враховувати під час внесення змін до джерела керування, щоб розглянути можливість видалення елементів у цільовому середовищі.

Нотатка

Щоб видалити записи вмісту сайту в одному середовищі, а також видалити ті самі записи вмісту в іншому середовищі за допомогою PAC CLI, слід виконати команду pac paportal downloadдо та після видалення вмісту запису веб-сайту. Під час виконання команди pac paportal upload файл manifest.yml відстежує ці зміни та видаляє відповідні записи в цільовому середовищі.

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

Крім того, ви можете використовувати розширення VS Code Розширення Power Platform VS Code, щоб скористатися вбудованою мовою Liquid від IntelliSense, помічником з автозавершення коду й порадами, а також взаємодіяти із Microsoft Power Platform CLI, застосувавши вбудований термінал. Додаткові відомості: Використання розширення Visual Studio Code (підготовча версія)

Додаткові рекомендації

• Якщо ваш шлях виявиться довшим, ніж обмеження на найбільшу довжину шляху, буде повідомлено про помилку. Додаткові відомості: Максимальне обмеження довжини шляху в Windows
• Для повторюваних записів, наприклад, повторюваних імен веб-сторінок, Microsoft Power Platform CLI створює дві різні папки одну із іменем веб-сторінки, а іншу – із тим же іменем, перед яким іде хеш-код. Наприклад, «My-page» та «My-page-хеш-код».

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

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

Див. також

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