Mokomoji priemonė. Naudokite „Microsoft Power Platform“ CLI su „Power Pages“

Šiame vadovėlyje sužinosite, kaip pradėti naudoti CLI, Microsoft Power Platform kad atnaujintumėte svetainės konfigūracijos pavyzdį.

Pastaba.

• Šiuose mokymuose akcentuojamos reikalingos „Microsoft Power Platform CLI“ komandos „Power Pages“ naudojimui. Norėdami gauti daugiau informacijos apie komandas, naudojamas „Power Platform“ CLI, perskaitykite bendrosios komandas.
• Pradedant nuo Power Platform CLI versijos 1.27, pac paportal komanda pakeičiama į pac powerpages. paportal ir toliau dirba, tačiau rekomenduojame naudoti powerpages toliau.

Atsisiųsti ir diegti „Visual Studio Code“

Norėdami prisijungti prie „Power Apps“ portalų ir naudoti „Microsoft Power Platform“ CLI komandas, naudokite kodą „Visual Studio Code“ ir integruotą terminalą. Naudodami integruotą terminalą lengvai prisijungsite prie aplinkos „Dataverse“ ir siųstumėte, keistumėte ir nusiųstumėte portalų konfigūraciją. Vietoje jos taip pat galite naudoti „Windows PowerShell".

1 veiksmas. Autentifikuoti

Prieš prisijungdami, išvardidami, atsisiųskite arba įkelkite bet kokius „Power Apps“ portalo pakeitimus, pirmiausia turite autentifikuoti „Dataverse“ aplinką. Daugiau informacijos apie autentifikavimą naudojant Microsoft Power Platform CLI žr. pac auth.

Norėdami autentifikuoti, atidarykite „Windows PowerShell" ir vykdykite komandą pac auth create naudodami savo Dataverse aplinkos URL:

pac auth create -u [Dataverse URL]

Pavyzdys

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

Norėdami prisijungti prie aplinkos, vykdykite autentifikavimo raginimus.

2 veiksmas. Galimų tinklalapių sąrašas

Naudokite komandą pac powerpages list, kad pateiktumėte galimas Power Pages svetaines aplinkoje, Dataverse prie kurios prisijungėte atlikdami ankstesnį veiksmą.

pac powerpages list

3 veiksmas. Atsisiųsti svetainės turinį

Atsisiųskite svetainės turinį iš prijungtos Dataverse aplinkos naudodami pac powerpages atsisiuntimo komandą.

pac powerpages download --path [PATH] -id [WebSiteId-GUID] --modelVersion [DataModel]

Pavyzdys

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

Parametrui ID naudokite „WebSiteId“ grąžintą iš ankstesnio veiksmo išvestį.

Pastaba.

• Naudokite modelVersion1 arba 2 nurodykite, ar svetainės duomenims, kuriuos norite įkelti, bus naudojamas standartinis (1) ar patobulintas duomenų modelis [2].
• Vykdyti pac powerpages list -v komandą, kad peržiūrėtumėte, kuris duomenų modelis naudojamas jūsų svetainėje. Norėdami gauti daugiau informacijos, eikite į patobulintą duomenų modelį.

4 veiksmas. Tinklalapių turinio keitimas

Pakeiskite konfigūraciją naudodami „Visual Studio Code“ ir įrašykite pakeitimus.

Pastaba.

Įsitikinkite, kad atnaujinsite tik palaikomas lenteles, skirtas naudoti „ Power Platform“ CLI. Daugiau informacijos žr. Palaikomos lentelės.

Pavyzdžiui, numatytame portalo puslapyje rodomas toks tekstas:

Šį tekstą mato tinklalapio html:

Šį tekstą galite keisti ir įrašyti pakeitimus:

Arbatpinigiai

„PowerShell" / integruoto terminalo aplanko maršruto vietą galite keisti į atsisiųstą vietą ir įvesti „kodą, skirtą tiesiogiai atidaryti aplanką „Visual Studio Code“.

5 veiksmas. Pakeitimų nusiuntimas

Pastaba.

• Jei reikia nusiųsti į kelias aplinkas, žr. pakeitimų nusiuntimas naudojant visuotinio diegimo profilį, kur sužinosite, kaip nusiųsti pakeitimus naudojant visuotinio diegimo profilį.
• Užtikrinkite, kad nustatytas didžiausias tikslinės aplinkos priedo dydis yra toks pats arba didesnis nei jūsų šaltinio aplinkos.
• Didžiausias failų dydis nustatomas parametru Didžiausias failo dydis sistemos parametrų skirtuke El. paštas aplinkos sistemos parametrų dialogo lange.

Atlikę reikiamus pakeitimus, įkelkite juos naudodami pac powerpages įkėlimo komandą:

pac powerpages upload --path [Folder-location] --modelVersion [ModelVersion]

Pavyzdys

pac powerpages upload --path C:\pac-portals\downloads\custom-portal\ --modelVersion 2

Pastaba.

Patikrinkite, ar jūsų įvestas portalų turinys yra tinkamas. Pagal numatytuosius nustatymus portalo pavadintas aplankas (draugiškas pavadinimas) sukuriamas su atsisiųstu portalų turiniu. Pavyzdžiui, jei paprastas portalo pavadinimas yra pasirinktinis-portalas, minėtos komandos kelias (--kelias) turi būti C:\pac-portals\downloads\custom-portal.

Įkeliamas tik pakeistas turinys. Šiame pavyzdyje, kadangi pakeitimas atliktas tinklalapyje, turinys nusiunčiamas tik adx_webpage lentelei.

Pakeitimų nusiuntimas naudojant visuotinio diegimo profilį

Dirbdami su keliomis skirtingomis aplinkomis, galite apsvarstyti galimybę naudoti diegimo profilius, kad užtikrintumėte, jog keitimai būtų nusiųsti į tinkamą aplinką naudojant diegimo profilį.

1. Aplanke, kuriame yra portalo turinys, sukurkite aplanką, pavadintą visuotinio diegimo profiliai. Pavyzdžiui, jei atsisiųstas portalo turinys yra „darbo pradžios portalo“ viduje, visuotinio diegimo profilių aplankas turėtų būti šiame aplanke.

   

2. Visuotinio diegimo profilių aplanke sukurkite visuotinio diegimo YAML failą, kuriame yra tam tikrai aplinkai būdingų pakeitimų. Pavyzdžiui, kūrimo aplinka gali būti pavadinta „kūrimas.diegimas.yml“.

   

3. Redaguokite visuotinio diegimo YAML failą naudodami „Visual Studio Code“ šiuo formatu:

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

   Pavyzdžiui, šis YAML kodo pavyzdys atnaujina „Naršyklės pavadinimo sufikso“ reikšmę iš numatytosios „Pasirinktinis portalas“ į „Pasirinktinis portalas (kūrimas)“.

   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. Norėdami nusiųsti pakeitimus į kitą aplinką naudodami visuotinio diegimo profilio YAML failą, pirmiausia autentifikuokite pagal tikslinę organizaciją.

5. Autentifikavę ir prijungę prie tinkamos aplinkos, naudokite komandą pac powerpages nusiųsti , kad įkeltumėte turinį:

   pac powerpages upload --path "C:\portals\starter-portal" --deploymentProfile dev --modelVersion 2

   Pastaba.

   Aukščiau pateiktame pavyzdyje naudojamas visuotinio diegimo profilio pavadinimas yra „kūrimas“ prieš tai atlikus ankstesnius veiksmus sukuriant kūrimo visuotinio diegimo profilį. Pakeiskite pavadinimą iš „kūrimas“ į bet kurį kitą (pvz., QA – „qa.diegimas.yml“ arba Bandymas – „bandymas.diegimas.yml“), jei savo visuotinio diegimo YAML failui naudojate kitą failo pavadinimą.

6 veiksmas. Patvirtinkite pakeitimus

Norėdami patvirtinti pakeitimus, atliktus tinklalapyje:

1. „Power Pages“ dizaino studijoje pasirinkite Sinchronizuoti.

2. Norėdami pamatyti pakeitimą, eikite į tinklalapį.

   

3. Jei naudojote anksčiau paaiškintą diegimo profilio pavyzdį, YAML fragmentas atnaujina reikšmę, kaip parodyta toliau pateiktoje ekrano kopijoje.

   

   Pritaikius minėtą pakeitimą atnaujintame naršyklės pavadinimo sufikse matysis pakeitimas, kai atidarysite portalą naršyklėje:

   

Tai užbaigia mokymus. Galite pakartoti anksčiau nurodytus žingsnius ir keisti kitų palaikomų lentelių portalų turinį.

Paskesni veiksmai

Visual Studio Naudokite kodo plėtinį

Taip pat žr.

• Microsoft Power Platform CLI
• Visual Studio Naudokite kodo plėtinį