Урок: Използване на 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, като използвате URL адреса на средата си на Dataverse:

pac auth create -u [Dataverse URL]

Пример

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

Следвайте указанията за удостоверяване, за да влезете в околната среда.

Стъпка 2. Избройте наличните портали

Използвайте pac paportal list команда за изброяване на наличните портали на Power Apps в Dataverse среда, към която сте се свързали в предишната стъпка.

pac paportal list

Стъпка 3. Изтеглете съдържание на портали

Изтеглете съдържанието на уебсайта на портала от свързания Dataverse среда с помощта на pac paportal download команда.

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 upload

pac paportal upload --path [Folder-location]

Пример

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

Качването се извършва само за съдържание, което е променено. В този пример, тъй като промяната е направена на уеб страница, съдържанието се качва само за таблицата adx_webpage.

Качете промените с помощта на профила за внедряване

Когато работите с множество различни среди, можете да обмислите използването на профили за внедряване, за да сте сигурни, че промените са качени в правилната среда с помощта на профила за внедряване.

1. Създайте папка с име профили за разгръщане вътре в папката, съдържаща съдържанието на портала. Например, ако изтегленото съдържание на портала е в "starter-portal", папката с профили за внедряване трябва да е в тази папка.

   

2. В папката с профили за внедряване създайте YAML файл за внедряване, който съдържа промените, специфични за средата. Например средата за разработка може да се нарече "dev.deployment.yml".

   

3. Редактирайте YAML файла за разполагане, като използвате Visual Studio Code със следния формат:

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

   Например, следният примерен YAML код актуализира стойността за „Суфикс на заглавието на браузъра“ от „Персонализиран портал“ по подразбиране на „Персонализиран портал (Dev)“.

   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 upload команда за качване на съдържанието:

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

   Бележка

   В горния пример използваното име на профил за разгръщане е „dev“, след като сте изпълнили предишните стъпки за създаване на профил за разгръщане на dev. Променете името от „dev“ на което и да е друго (като QA за „qa.deployment.yml“ или Test за „test.deployment.yml“), ако сте използвали различно име на файл за вашия YAML файл за внедряване.

Стъпка 6. Потвърждение на промените

За да потвърдите направените промени в уеб страницата на портала:

1. Изчистете кеш от страна на сървъра, или използвайте Конфигурация за синхронизиране като се използва студио за портали на Power Apps.

2. Прегледайте уеб страницата на портала, за да видите промяната.

   

3. Ако сте използвали пример за профил на внедряване обяснено по-рано, YAML фрагмент ще актуализира стойността, както е показано по-долу.

   

   Суфиксът на заглавието на браузъра, актуализиран чрез горната промяна, показва промяната, когато отворите портала в браузър:

   

Това завършва урока. Можете да повторите горните стъпки и да промените съдържанието на порталите за други поддържани таблици.

Следващи стъпки

Използване на разширение Visual Studio Code

Вижте също

• Microsoft Power Platform CLI
• Използване на разширение Visual Studio Code (преглед)