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 бағдарламасын пайдалану

Сондай-ақ, келесіні қараңыз

• Microsoft Power Platform CLI
• Visual Studio Code кеңейтімін (алдын ала қарау нұсқасы) пайдалану