Mokymo priemonė: „Microsoft Power Platform“ su portalais naudojimas

Šiame mokomajame pavyzdyje išmoksite pradėti dirbti su Microsoft Power Platform CLI, kad atnaujintumėte portalų konfigūravimo pavyzdžius.

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]

Pavyzdžiui

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

Norėdami prisijungti prie aplinkos, vykdykite autentifikavimo raginimus.

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

Naudodami komandą pac paportal list, galėsite nurodyti galimų portalų Power Apps sąrašą Dataverse aplinkoje, prie kurios prisijungėte ankstesniame veiksme.

pac paportal list

3 veiksmas. Portalų turinio atsisiuntimas

Atsisiųskite portalo svetainės turinį iš prijungtos Dataverse aplinkos naudodami komandą pac paportal download.

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

Pavyzdžiui

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

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

4 veiksmas. Portalų turinio keitimas

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

Pavyzdžiui, numatytame portalo puslapyje rodomas toks tekstas:

Šį tekstą mato tinklalapio html:

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

5 veiksmas. Pakeitimų nusiuntimas

Atlikę reikiamus pakeitimus, įkelkite juos naudodami komandą pac paportal upload:

pac paportal upload --path [Folder-location]

Pavyzdžiui

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

Įkėlimas vyksta tik pakeitus turinį. Š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 naudoti visuotinio diegimo profilius ir taip užtikrinti, kad pakeitimai bus nusiųsti į teisingą aplinką, naudojančią visuotinio 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. Atlikę autentifikavimą ir prisijungę prie tinkamos aplinkos, nusiųskite turinį naudodami komandą pac paportal upload:

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

   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 portalo tinklalapyje:

1. Išvalykite talpyklą serveryje arba naudokite sinchronizavimo konfigūraciją naudodami „Power Apps“ portalų studiją.

2. Eikite į portalo tinklalapį ir peržiūrėkite keitimą.

   

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

   

   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

Naudokite „Visual Studio Code“ plėtinį

Taip pat žr.

• „Microsoft Power Platform“ CLI
• Naudokite „Visual Studio Code“ plėtinį (peržiūra)