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

Осы оқулық мысалында сіз үлгі порталдарының конфигурациясын жаңарту үшін Microsoft 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 өңдегішінің көмегімен өзгертіңіз және өзгертулерді сақтаңыз.

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

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

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

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

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

pac paportal upload --path [Folder-location]

Мысал

pac paportal upload --path 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 кеңейтімін (алдын ала қарау нұсқасы) пайдалану