Підтримка порталів для Microsoft Power Platform CLI
Примітка
З 12 жовтня 2022 року портали Power Apps перейменовано на Power Pages. Додаткова інформація: Microsoft Power Pages тепер у загальному доступі (блоґ)
Незабаром документацію порталів Power Apps буде перенесено та об’єднано з документацією Power Pages.
Microsoft Power Platform CLI (інтерфейс командного рядка) — це простий єдиний інтерфейс командного рядка для розробника, що дозволяє розробникам і авторам програм створювати компоненти коду.
Засоби CLI Microsoft Power Platform – це перший крок для повноцінного керування життєвим циклом програми (ALM), в межах якого розробники й постачальники програм можуть швидко та ефективно створювати, збирати, налагоджувати та публікувати розширення та настроювання. Додаткові відомості: Що таке Microsoft Power Platform CLI?
За допомогою цієї функції Microsoft Power Apps портали підтримують Microsoft Power Platform CLI, щоб увімкнути CI/CD (безперервну інтеграцію/безперервне розгортання) конфігурації порталу. Тепер ви можете перевірити конфігурацію порталу для контролю джерела та перемістити конфігурацію порталу в будь-яке середовище за допомогою Microsoft Power Platform CLI.
Примітка
Ця функція зазвичай доступна починаючи з Power Platform CLI версії 1.9.8. Щоб дізнатися про інсталяцію останньої версії, див. розділ Інсталяція Microsoft Power Platform CLI.
Навіщо використовувати Microsoft Power Platform CLI для розробки порталів?
Завдяки підтримці Microsoft Power Platform CLI ви можете використовувати близькі до автономних можливості настроювання порталів, вносячи зміни до вмісту порталів. А після збереження всіх настроювань або змін передавайте їх на портал. Під час завантаження вмісту порталів за допомогою 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. | pac paportal list |
завантаження | Завантажує вміст веб-сайту порталу з поточного середовища Dataverse. Має перелічені нижче параметри. - path: шлях, за яким буде завантажено вміст веб-сайту (псевдонім: -p) - webSiteId: ідентифікатор веб-сайту порталу для завантаження (псевдонім: -id) - overwrite: (необов'язково) значення true — перезаписати наявний вміст, значення false — перервати виконання, якщо у папці вже є вміст веб-сайту (псевдонім: -o) |
pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 |
передавання | Передає вміст веб-сайту порталу до поточного середовища Dataverse. Має зазначений нижче параметр. - path: шлях, за яким зберігається вміст веб-сайту (псевдонім: -p) -deploymentProfile: передавання даних порталу з відомостями про середовище, визначеними через змінні профілю у файлі deployment-profiles/[profile-name].deployment.yaml |
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" |
Використання профілю розгортання
Перемикач deploymentProfile дає змогу визначити набір змінних для середовища у форматі YAML. Наприклад, можна мати різні профілі розгортання (наприклад, для розробки, тестування, виробництва), які мають різні дані схеми, визначені в профілі.
Якщо ви створюєте тестовий профіль, можна створити файл у розділі deployment-profiles з іменем "test.deployment.yml" (а саме, <profileTag>.deployment.yml). І можна виконати команду з позначкою (<profileTag>), щоб використати цей профіль:
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile test
У цьому файлі можна мати ім’я таблиці (сутності) з ідентифікатором таблиці, списком атрибутів і значеннями, які потрібно змінити під час передавання конфігурації порталу за допомогою параметра 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-адреса середовища збігається з іменем файлу), щоб уникнути випадкових змін.
Видалення файлу маніфесту для відстеження (manifest.yml)
Цей файл використовується для відстеження видалених записів із середовища.
Під час завантаження вмісту веб-сайту за допомогою команди pac paportal download додаються видалені записи з environment manifest file (org-url-manifest.yml) до файлу manifest.yml. Отже, під час завантаження вмісту веб-сайту за допомогою команди pac paportal upload видаляються файли з середовища (навіть до іншого середовища). Цей файл не видаляється, і він використовується незалежно від того, до якого середовища ви підключені.
Примітка
Щоб видалити записи вмісту сайту в одному середовищі, а також видалити ті самі записи вмісту в іншому середовищі за допомогою PAC CLI, слід виконати команду pac paportal download до та після видалення вмісту запису веб-сайту. Під час виконання команди pac paportal upload файл manifest.yml відстежує ці зміни та видаляє відповідні записи в цільовому середовищі.
Використання розширення Visual Studio Code
Ви також можете використовувати розширення Power Platform VS Code VS Code Extension, щоб скористатися вбудованою мовою Liquid від IntelliSense, допомогою в завершенні коду, підказкою та взаємодіяти з CLI за допомогою інтегрованого терміналу VS Code Microsoft Power Platform . Додаткові відомості: Використання розширення Visual Studio Code (підготовча версія)
Додаткові міркування
- Якщо ваш шлях виявиться довшим, ніж обмеження на найбільшу довжину шляху, буде повідомлено про помилку. Додаткові відомості: Максимальне обмеження довжини шляху в Windows
- Для повторюваних записів, наприклад, повторюваних імен веб-сторінок, Microsoft Power Platform CLI створює дві різні папки — одну із іменем веб-сторінки, а іншу – із тим же іменем, перед яким іде хеш-код. Наприклад, «My-page» та «My-page-хеш-код».
Наступні кроки
Посібник: використання Microsoft Power Platform CLI із порталами