Microsoft Power Platform CLI бағдарламасына қолдау көрсететін порталдар
Ескерім
2022 жылдың 12 қазанынан бастап күшіне енеді, Power Apps порталдары — Power Pages. Қосымша ақпарат: Microsoft Power Pages енді жалпыға қолжетімді (блог)
Жақында Power Apps порталдары құжаттамасын Power Pages құжаттамасымен көшіреміз және біріктіреміз.
Microsoft Power Platform CLI (Пәрмен жолы интерфейсі) — әзірлеушілерге және бағдарлама жасаушыларына код құрамдастарын жасауға мүмкіндік беретін қарапайым, әмбебап әзірлеуші пәрмен жолының интерфейсі.
Microsoft Power Platform CLI құралы — бұл кәсіпорын әзірлеушілері мен ISV жеткізушілері кеңейтімдер мен теңшеулерді жылдам, әрі тиімді жасап, құрап, түзетіп және жариялай алатын кешенді бағдарлама жарамдылық кезеңін басқаруға алғашқы қадам. Қосымша ақпарат алу үшін Microsoft Power Platform CLI бағдарламасы дегеніміз не? бөлімін қараңыз
Бұл мүмкіндіктің көмегімен Microsoft Power Apps порталдар портал конфигурациясының CI/CD (Үздіксіз біріктіру/үздіксіз орналастыру) мүмкіндігін қосу үшін Microsoft Power Platform CLI қолдайды. Енді сіз портал конфигурациясын бастапқы басқару үшін тексере аласыз және портал конфигурациясын 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 бағдарламасын орнатқаннан кейін, пәрмен жолын ашыңыз және нәтижеде Power Apps порталдарына арналған “paportal” пәрменінің бар екендігіне көз жеткізу үшін pac іске қосыңыз.
Порталдарға арналған Microsoft Power Platform CLI пәрмендері
Порталдарға арналған Microsoft Power Platform CLI пәрмені – “paportal”.
Келесі бөлімдерде "paportal" пәрменінің әртүрлі сипаттары туралы қосымша мәліметтер келтірілген.
Параметрлер
| Сипат атауы | Сипаттама | Мысал |
|---|---|---|
| тізім | Ағымдағы Dataverse ортасындағы барлық портал веб-сайттарын тізімдейді. | pac paportal list |
| жүктеп алу | Ағымдағы Dataverse ортасынан портал веб-сайтының мазмұнын жүктеп алыңыз. Оның келесі параметрлері бар: - жол: веб-сайт мазмұны жүктеп алынатын жол (alias: -p) - webSiteId: жүктеп алуға арналған портал веб‑сайтының идентификаторы (alias: -id) - қайта жазу: (қосымша) шын - бұрыннан бар мазмұнды қайта жазу үшін; жалған ‑ егер қалтада веб‑сайт мазмұны бұрыннан бар болса сәтсіз (alias: -o) |
pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 |
| жүктеп салу | Ағымдағы Dataverse ортасына портал веб-сайтының мазмұнын жүктеп салыңыз. Оның келесі параметрі бар: - жол: веб-сайт мазмұны сақталатын жол (alias: -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 айнымалысын пайдалануға болады.
Бірегей схема мәліметтері бар осы "test.deployment.yml" профилінің YAML файлының мысалы:
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 бағдарламасындағы жалпы пәрмендер бөліміне өтіңіз.
Манифест файлдары
CLI пәрменін pac paportal жүктеп алу арқылы веб-сайт мазмұнын жүктеп алған кезде, сайт мазмұнын жүктеп алумен бірге ол екі манифест файлын жасайды;
- Ортаның манифест файлы (org-url-manifest.yml)
- Бақылау манифест файлын жою (manifest.yml)
Ортаның манифест файлы (org-url-manifest.yml)
Ортаның манифест файлы pac paportal жүктеп алу пәрмені іске қосылған сайын жасалады.
Әрбір жүктеуден кейін PAC CLI құралы бар орта манифест файлын оқиды және ортада жойылған жазбаларды жаңартады немесе ол жоқ болса, орта манифест файлын жасайды.
Портал веб-сайтының мазмұнын жүктеп салу үшін pac paportal жүктеп салу пәрменін іске қосқан кезде. Ол ортаның манифест файлын оқиды және соңғы жүктеп алғаннан кейін жасалған өзгерістерді анықтайды және тек жаңартылған мазмұнды жүктеп салады. Бұл жүктеп салу процесін оңтайландыруға көмектеседі, өйткені әрбір жүктеп салу пәрменіндегі барлық мазмұнды жүктеп салудың орнына тек жаңартылған веб-сайт мазмұны жүктеп салынады.
Кездейсоқ өзгерістерді болдырмау үшін ортаның манифест файлы бір ортаға қосылғанда ғана оқылатын болады (ортаның URL мекенжайы файл атауына сәйкес келеді).
Бақылау манифест файлын жою (manifest.yml)
Бұл файл ортадан жойылған жазбаларды қадағалау үшін пайдаланылады.
Веб-сайт мазмұны pac paportal жүктеп алу пәрменімен жүктеп алынғанда, бұл жойылған жазбаларды ортаның манифест файлынан (org-url-manifest.yml) manifest.yml файлына қосады. Осылайша, pac paportal жүктеп салу пәрмені арқылы веб-сайт мазмұнын жүктеп салған кезде, ол файлдарды ортадан (тіпті басқа ортаға) жояды. Бұл файл жойылмайды және қай ортаға қосылғаныңызға қарамастан пайдаланылады.
Ескерім
Бір ортадағы сайт мазмұны жазбаларын жою және PAC CLI арқылы басқа ортадағы бірдей мазмұн жазбаларын жою үшін веб-сайт жазбасының мазмұнын жоймас бұрын және одан кейін pac paportal жүктеп алу пәрменін орындау қажет. manifest.yml бұл өзгерістерді қадағалайды және pac paportal жүктеп салу пәрмені іске қосылған кезде мақсатты ортадағы тиісті жазбаларды жояды.
Visual Studio Code кеңейтімін пайдалану
You can also use VS Code extension Power Platform VS Code Extension to benefit built-in Liquid language from IntelliSense, code completion assistance, hinting, and interact with the Microsoft Power Platform CLI using the VS Code Integrated Terminal. Қосымша ақпарат: Visual Studio Code кеңейтімін (алдын ала қарау нұсқасы) пайдалану
Қосымша қарастырулар
- Егер сіздің файл жолыңыз жолдың максималды ұзындығы шегінен асып кетсе, қате туралы хабарланады. Қосымша ақпарат: Windows жүйесіндегі жол ұзындығының максималды шегі
- Қайталанатын жазбалар үшін, мысалы, қайталатын веб-беттің атауы, Microsoft Power Platform CLI бағдарламасы екі түрлі қалтаны жасайды—біреуі веб-беттің атауымен, ал екіншісі хэш-кодпен префикстелген дәл сол атаумен. Мысалы, "Менің бетім" және "Менің бетім-хэш-код".
Келесі қадамдар
Оқулық: порталдары бар Microsoft Power Platform CLI бағдарламасын пайдалану