Оқулық: порталдары бар Microsoft Power Platform CLI бағдарламасын пайдалану

Ескерім

2022 жылдың 12 қазанынан бастап күшіне енеді, Power Apps порталдары — Power Pages. Қосымша ақпарат: Microsoft Power Pages енді жалпыға қолжетімді (блог)
Жақында Power Apps порталдары құжаттамасын Power Pages құжаттамасымен көшіреміз және біріктіреміз.

Осы оқулық мысалында сіз үлгі порталдарының конфигурациясын жаңарту үшін Microsoft Power Platform CLI бағдарламасымен жұмысты бастау жолын көресіз.

Ескерім

• Сондай-ақ Power Pages бар Power Platform CLI бағдарламасын пайдалануға болады. Қосымша ақпарат: Power Pages деген не?
• Бұл оқулықта Power Apps порталдары пайдаланатын қажетті Microsoft Power Platform CLI пәрмендері қарастырылады. Power Platform CLI бағдарламасында пайдаланылатын пәрмендер туралы қосымша ақпарат алу үшін Жалпы пәрмендер бөлімін қараңыз.

Visual Studio Code өңдегішін жүктеп алу және орнату

Power Apps порталдарына қосылу үшін және Microsoft Power Platform CLI пәрмендерін пайдалану үшін Visual Studio Code және біріктірілген терминалды пайдаланыңыз. Кіріктірілген терминал Dataverse ортасына қосылуды және портал конфигурациясын жүктеп алу, өзгерту және жүктеп салуды жеңілдетеді. Сонымен қатар оның орнына Windows PowerShell бағдарламасын пайдалануға болады.

1-қадам. Түпнұсқалығын растау

Power Apps порталына кез келген өзгерістерді қосу, тізімдеу, жүктеп алу немесе жүктеп салу алдында алдымен Dataverse ортасында аутентификациядан өту керек. Microsoft Power Platform CLI бағдарламасын пайдалану арқылы аутентификациялау туралы қосымша ақпарат алу үшін pac auth бөліміне өтіңіз.

Аутентификациялау үшін Windows PowerShell бағдарламасын ашып, pac auth create пәрменін Dataverse ортасының URL мекенжайымен іске қосыңыз:

pac auth create -u [Dataverse URL]

Мысал

pac auth create -u https://contoso-org.crm.dynamics.com

Ортаға кіру үшін аутентификация сұрауларын орындаңыз.

2-қадам. Қолжетімді порталдарды тізімдеу

Сіз алдыңғы қадамда қосылған Dataverse ортасында қолжетімді Power Apps порталдарын тізімдеу үшін pac paportal тізімдеу пәрменін пайдаланыңыз.

pac paportal list

3-қадам. Порталдардың мазмұнын жүктеп алу

pac paportal жүктеп алу пәрменін пайдаланып, қосылған Dataverse ортасынан портал веб-сайтының мазмұнын жүктеп алыңыз.

pac paportal download --path [PATH] -id [WebSiteId-GUID]

Мысал

pac paportal download --path c:\pac-portals\downloads -id d44574f9-acc3-4ccc-8d8d-85cf5b7ad141

Идентификатор параметрі үшін алдыңғы қадамның нәтижесіндегі WebSiteId параметрін пайдаланыңыз.

4-қадам. Порталдардың мазмұнын өзгерту

Конфигурацияны Visual Studio Code өңдегішінің көмегімен өзгертіңіз және өзгертулерді сақтаңыз.

Ескерім

Power Platform CLI бағдарламасымен пайдалану үшін тек қолдау көрсетілетін кестелерді жаңартқаныңызға көз жеткізіңіз. Қосымша ақпарат алу үшін Қолдау көрсетілетін кестелер бөлімін қараңыз.

Мысалы, әдепкі портал беті келесідей мәтінді көрсетеді:

Бұл мәтін html веб-бетінен көрінеді:

Сіз бұл мәтінді өзгертіп және өзгертулерді сақтай аласыз:

Шайпұл

PowerShell/біріктірілген терминалдағы қалта жолының орнын жүктелген орынға ауыстырып, "кодты" енгізуге болады. қалтаны тікелей Visual Studio Code өңдегішінде ашу үшін.

5-қадам. Өзгерістерді жүктеп салу

Ескерім

• Бірнеше ортаға жүктеп салып жатсаңыз, орналастыру профилі арқылы өзгертулерді жүктеп салу жолын үйрену үшін орналастыру профилі арқылы өзгертулерді жүктеп салу бөлімін қараңыз.
• Мақсатты ортаның ең үлкен тіркеме өлшемі бастапқы ортамен бірдей немесе үлкенірек өлшемге орнатылғанына көз жеткізіңіз.
• Файлдардың максималды өлшемі орта жүйесінің параметрлері диалогтік терезесіндегі жүйе параметрлері электрондық пошта қойыншасындағы Максималды файл өлшемі параметрі арқылы анықталады.

Қажетті өзгертулерді енгізгеннен кейін, оларды pac paportal жүктеп салу пәрмені арқылы жүктеп салыңыз:

pac paportal upload --path [Folder-location]

Мысал

pac paportal upload --path C:\pac-portals\downloads\custom-portal\

Ескерім

Сіз енгізген порталдар мазмұнының жолы дұрыс екеніне көз жеткізіңіз. Әдепкі бойынша, портал атаған қалта (түсінікті ат) жүктеп алынған порталдар мазмұнымен жасалады. Мысалы, егер порталдың түсінікті атауы custom-portal, болса, жоғарыдағы пәрменге арналған жол (--жол) C:\pac-portals\downloads\custom-portal болуы керек.

Жүктеп салу тек өзгертілген мазмұн үшін ғана болады. Бұл мысалда, өзгеріс веб-бетке енгізілгендіктен, мазмұн тек adx_webpage кестесіне жүктеп салынады.

Орналастыру профилі арқылы өзгертулерді жүктеп салу

Бірнеше түрлі орталармен жұмыс істегенде, орналастыру профилі арөылы өзгертулердің дұрыс ортаға жүктеп салынуын қамтамасыз ету үшін орналастыру профильдерін пайдалануды қарастыруға болады.

1. Портал мазмұнын қамтитын қалта ішінде deployment-profiles атты қалтаны жасаңыз. Мысалы, жүктеп алынған портал мазмұны "starter-portal" ішінде болса, орналастыру профильдерінің қалтасы осы қалтаның ішінде болуы керек.

   

2. Орналастыру профильдері қалтасының ішінде ортаға қатысты өзгерістерді қамтитын орналастыру YAML файлын жасаңыз. Мысалы, әзірлеу ортасын "dev.deployment.yml" деп атауға болады.

   

3. Visual Studio Code пайдаланып YAML орналастыру файлын келесі пішімде өңдеңіз:

   <table-name>:
   - <record-id>: <GUID>
     <column-name>: <Name>
     <column-value>: <Value>
   

   Мысалы, келесі іріктеме YAML коды "Шолғыш тақырыбының жұрнағы" мәнін әдепкі "Теңшелетін порталдан" "Теңшелетін портал (әзірлеу)" мәніне жаңартады.

   adx_contentsnippet:
       - adx_contentsnippetid: 76227a41-a33c-4d63-b0f6-cd4ecd116bf8 # Replace with your content snippet ID
         adx_name: Browser Title Suffix # Setting name
         adx_value:   · Custom Portal (Dev) # Setting value
   

4. Орналастыру профилінің YAML файлы арқылы өзгертулерді басқа ортаға жүктеп салу үшін алдымен мақсатты ұйымға аутентификация жасаңыз.

5. Аутентификациядан және дұрыс ортаға қосылғаннан кейін, мазмұнды жүктеп салу үшін pac paportal жүктеп салу пәрменін пайдаланыңыз:

   pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile dev

   Ескерім

   Жоғарыдағы мысалда әзірлеу орналастыру профилін жасау үшін алдыңғы қадамдарды орындағаннан кейін пайдаланылған орналастыру профилінің атауы "dev" болып табылады. Орналастыру YAML файлы үшін басқа файл атауын пайдаланған болсаңыз, атауды "dev" атауынан кез келген басқа атауға өзгертіңіз (мысалы, "qa.deployment.yml" үшін QA немесе "test.deployment.yml" үшін Test).

6-қадам. Өзгерістерді растау

Порталдың веб-бетіне енгізілген өзгерістерді растау үшін:

1. Power Apps порталдар студиясын пайдалану арқылы сервер жағындағы кэшті тазалаңыз немесе синхрондау конфигурациясын пайдаланыңыз.

2. Өзгерісті көру үшін порталдың веб-бетіне өтіңіз.

   

3. Орналастыру профилінің бұрын түсіндірілген мысалын пайдаланған болсаңыз, YAML үзіндісі мәнді төменде көрсетілгендей жаңартады.

   

   Жоғарыдағы өзгерту арқылы жаңартылған шолғыш тақырыбының жұрнағы порталды шолғышта ашқан кезде өзгерісті көрсетеді:

   

Оқулық осымен аяқталды. Жоғарыда аталған әрекеттерді қайталауға және басқа қолдау көрсетілетін кестелер үшін порталдар мазмұнын өзгертуге болады.

Келесі қадамдар

Visual Studio Code кеңейтімін пайдалану

Сонымен қатар қараңыз

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