Поддръжка на портали за Microsoft Power Platform CLI
Бележка
В сила от 12 октомври 2022 г. „Портали на Power Apps“ става Power Pages. Повече информация: Microsoft Power Pages вече е общодостъпен (блог)
Скоро ще мигрираме и ще обединим документацията на „Портали на Power Apps“ с документацията на Power Pages.
Microsoft Power Platform CLI (интерфейс на командния ред) е прост интерфейс за команден ред за разработчици с едно спиране, който дава възможност на разработчиците и производителите на приложения да създават кодови компоненти.
Инструментариумът на Microsoft Power Platform CLI е първата стъпка към цялостна история за управление на жизнения цикъл на приложението (ALM), при която корпоративните разработчици и ISV могат да създават, изграждат, отстраняват грешки и публикуват своите разширения и персонализации бързо и ефективно. За повече информация вижте Какво е Microsoft Power Platform CLI?
С тази функция порталите поддържат CLI, Microsoft Power Apps Microsoft Power Platform за да активират 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].depoyment.yaml файл |
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" |
Използвайте профил за внедряване
Превключвателят deploymentProfile ви позволява да дефинирате набор от променливи за средата във формат YAML. Например, можете да имате различни профили за внедряване (като dev, test, prod), които имат различни детайли на схемата, дефинирани в профила.
Ако създавате тестов профил, можете да създадете файл под профили за разполагане с името "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 CLI команда, заедно с изтеглянето на съдържанието на сайта, тя също ще генерира два манифестни файла;
- Файл с манифест на средата (org-url-manifest.yml)
- Изтриване на файл с манифест за проследяване (manifest.yml)
Файл с манифест на средата (org-url-manifest.yml)
Файлът на манифеста на средата се генерира всеки път, когато изтегляне на pac paportal командата се изпълнява.
След всяко изтегляне инструментът PAC CLI чете съществуващия файл на манифеста на средата и актуализира записите, изтрити в околната среда, или създава манифестния файл на средата, ако не съществува.
Когато стартиратеpac paportal upload команда за качване на съдържанието на уебсайта на портала. Той чете файла с манифеста на средата и идентифицира промените, направени след последното изтегляне, и качва само актуализираното съдържание. Това помага за оптимизиране на процеса на качване, тъй като се качва само актуализирано съдържание на уебсайт, вместо да се качва цялото съдържание при всяка команда за качване.
Файлът с манифест на средата ще бъде само за четене, когато се свърже със същата среда (URL адресът на средата съвпада с името на файла), за да се избегнат случайни промени.
Изтриване на файл с манифест за проследяване (manifest.yml)
Този файл се използва за проследяване на изтритите записи от средата.
Когато съдържанието на уебсайта се изтегли с pac paportal download команда, това ще добави изтритите записи от файл с манифест на средата (org-url-manifest.yml) към файла manifest.yml. Така че, когато качвате съдържанието на уебсайта с помощта на pac paportal upload тя ще изтрие файловете от средата (дори в друга среда). Този файл не се изтрива и се използва независимо към коя среда сте свързани.
Бележка
За да изтриете записите за съдържание на сайта в една среда и също така да изтриете същите записи за съдържание в друга среда с помощта на PAC CLI, ще трябва да стартирате pac paportal download команда преди и след изтриването на съдържанието на записа на уебсайта. 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 създава две различни папки—единият с името на уеб страницата, а другият със същото име с префикс с хеш код. Например „Моята страница“ и „Хеш код на моята страница".
Следващи стъпки
Урок: Използване на Microsoft Power Platform CLI с портали