Opasohjelma: Microsoft Power Platform CLI:n käyttäminen Power Pagesin kanssa

Tässä opetusohjelmassa opetellaan aloittamaan Microsoft Power Platform CLI:n käyttäminen esimerkkiverkkosivuston määrityksen päivittämiseen.

Lataa ja asenna Visual Studio Code

Yhdistääksesi Power Appsiin ja käyttääksesi Microsoft Power Platform CLI -komentoja käytä Visual Studio Codea ja integroitua päätettä. Integroidun päätteen avulla on helppo muodostaa yhteys Dataverse-ympäristöön sekä ladata, muuttaa ja ladata portaalien kokoonpano. Voit käyttää sen sijaan myös Windows PowerShelliä.

Vaihe 1: Todenna

Ennen kuin yhdistät, luetteloit tai lataat Power Apps -portaalin muutoksia, sinun on todennuttava Dataverse-ympäristöön. Lisätietoja todentamisesta Microsoft Power Platform CLI:n avulla on kohdassa pac auth.

Suorita todennus avaamalla Windows PowerShell ja suorittamalla komento pac auth create käyttämällä Dataverse-ympäristön URL-osoitetta:

pac auth create -u [Dataverse URL]

Esimerkiksi

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

Kirjaudu ympäristöön noudattamalla todennuskehotteita.

Vaihe 2. Luetteloi käytettävissä olevat sivustot

Pac-sivut-luettelokomennon avulla voit luetella Power Pages verkkosivustot Dataverse-ympäristössä, johon yhdistit edellisessä vaiheessa.

pac pages list

Vaihe 3. Sivuston sisällön lataaminen

Lataa sivuston sisältö yhdistetystä Dataverse-ympäristöstä käyttämällä pac-sivujen latauskomentoa .

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

Esimerkiksi

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

Käytä tunnus-parametrinä WebSiteId-tunnusta , jonka edellisen vaiheen tulokset palauttivat.

Vaihe 4. Sivuston sisällön vaihtaminen

Muuta määritystä Visual Studio Coden avulla ja tallenna muutokset.

Oletusportaalisivulla näkyy esimerkiksi tällaista tekstiä:

Tämä teksti näkyy verkkosivu-html:stä:

Voit muuttaa tätä tekstiä ja tallentaa muutokset:

Vaihe 5. Lataa muutokset

Kun olet tehnyt tarvittavat muutokset, lataa ne pac-sivujen latauskomennon avulla:

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

Esimerkiksi

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

Vain muuttunut sisältö ladataan. Tässä esimerkissä, koska muutos tehdään WWW-sivulle, sisältö ladataan vain adx_webpage-taulukolle.

Muutosten lataaminen käyttöönottoprofiilin avulla

Kun käsittelet useita eri ympäristöjä, voit harkita käyttöönottoprofiilien käyttämistä varmistaaksesi, että muutokset ladataan oikeaan ympäristöön käyttöönottoprofiilin avulla.

1. Luo kansio nimeltä käyttöönottoprofiilit portaalin sisällön sisältävään kansioon. Jos esimerkiksi ladattu portaalin sisältö on "starter-portaalissa", käyttöönottoprofiilikansion tulisi olla tämän kansion sisällä.

   

2. Luo käyttöönottoprofiilikansiossa käyttöönotto-YAML-tiedosto, joka sisältää ympäristökohtaiset muutokset. Kehitysympäristöä voidaan esimerkiksi kutsua nimellä "dev.deployment.yml".

   

3. Muokkaa käyttöönoton YAML-tiedostoa Visual Studio Codella seuraavassa muodossa:

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

   Esimerkiksi seuraava YAML-mallikoodi päivittää "Selaimen otsikon jälkiliitteen" arvon oletusarvosta "Mukautettu portaali" ja "Mukautettu portaali (kehitys)".

   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. Jos haluat ladata muutokset toiseen ympäristöön käyttämällä käyttöönottoprofiilin YAML-tiedostoa, todenna ensin kohdeorganisaatioon.

5. Kun olet todentanut ja muodostanut yhteyden oikeaan ympäristöön, lataa sisältö pac-sivujen latauskomennolla:

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

   Muistiinpano

   Yllä olevassa esimerkissä käytetty käyttöönottoprofiilin nimi on "kehitysalue" sen jälkeen, kun olet luonut kehityskäyttöönottoprofiilin aiempien vaiheiden mukaisesti. Muuta nimi kehitys-luvusta mihin tahansa muuhun (kuten qa.deployment.yml:n QA:han tai test.deployment.yml:hen), jos olet käyttänyt käyttöönotto-YAML-tiedostossa eri tiedostonimeä.

Vaihe 6: Vahvista muutokset

Verkkosivulle tehtyjen muutosten vahvistaminen:

1. Valitse Power Pages -suunnitteluohjelmassa Synkronoi.

2. Näet muutoksen selaamalla verkkosivulle.

   

3. Jos olet käyttänyt aiemmin selitettyä käyttöönottoprofiiliesimerkkiä, YAML-katkelma päivittää arvon alla olevassa näyttökuvassa esitetyllä tavalla.

   

   Yllä olevan muutoksen kautta päivitetty selaimen otsikon jälkiliite näyttää muutoksen, kun avaat portaalin selaimessa:

   

Opasohjelma päättyy tähän. Voit toistaa yllä olevat vaiheet ja muuttaa portaalin sisältöä muissa tuetuissa taulukoissa.

Seuraavat vaiheet

Visual Studio Code -laajennuksen käyttäminen

Katso myös

• Microsoft Power Platform CLI
• Visual Studio Code -laajennuksen käyttäminen