Підтримка порталів для Microsoft Power Platform CLI

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.

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

Інсталяція та перевірка 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.

Параметри

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

Перемикач 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

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

Під час завантаження вмісту веб-сайту за допомогою команди 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 видаляються файли з середовища (навіть до іншого середовища). Цей файл не видаляється, і він використовується незалежно від того, до якого середовища ви підключені.

Використання розширення 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 із порталами

Статті за темою

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