Oktatóanyag: A Microsoft Power Platform CLI használata portálokkal

Ebből az oktatóanyagból láthatja, milyen első lépések vannak a Microsoft Power Platform CLI esetén a mintaportálok konfigurálásának frissítése során.

A Visual Studio Code letöltése és telepítése

A Power Apps-portálokhoz való csatlakozás és a Microsoft Power Platform CLI-parancsok használata érdekében használja a Visual Studio Code programot és az integrált terminált. Az integrált terminál segítségével könnyen csatlakozhat a Dataverse környezethez, és letöltheti, módosíthatja, feltöltheti a portálok konfigurációját. Használhatja helyette a Windows PowerShell lehetőséget is.

1. lépés Hitelesítés

Mielőtt csatlakozna, listázna, letöltene vagy feltöltene bármilyen módosítást egy Power Apps portálhoz, először hitelesítenie kell a Dataverse környezetet. A Microsoft Power Platform parancssori felület használatával történő hitelesítésről részletesen itt olvashat: pac hitelesítés.

A hitelesítéshez nyissa meg a Windows PowerShell alkalmazást, és futtassa a pac auth létrehozása parancsot a Dataverse környezet URL-címével:

pac auth create -u [Dataverse URL]

Példa

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

A környezetbe való bejelentkezéshez kövesse a hitelesítésre vonatkozó utasításokat.

2. lépés A rendelkezésre álló portálok listázása

Az előző lépésben csatlakoztatott Dataverse környezet elérhető Power Apps portáljainak listázásához használja a pac portal list parancsot.

pac paportal list

3. lépés A portálok tartalmának letöltése

Töltse le a portál webhelyének tartalmát a csatlakoztatott Dataverse-környezetből a pac paportal download paranccsal.

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

Példa

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

Az id paraméternél használja az előző lépés kimenetében visszaadott WebSiteId azonosítót.

4. lépés A portálok tartalmának módosítása

Módosítsa a konfigurációt a Visual Studio Code használatával, és mentse a módosításokat.

Az alapértelmezett portáloldalon például ilyen szöveg jelenik meg:

Ez a szöveg látható a weboldal HTML-kódjában:

A

Módosíthatja ezt a szöveget, és elmentheti a változtatásokat:

5. lépés A módosítások feltöltése

Miután elvégezte a szükséges módosításokat, töltse fel azokat a pac paportal upload paranccsal:

pac paportal upload --path [Folder-location]

Példa

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

A feltöltés csak a megváltozott tartalmak esetében történik meg. Ebben a példában, mivel a módosítás egy weboldalon történik, csak az adx_webpage tábla tartalma kerül feltöltésre.

A változtatások feltöltése a telepítési profil használatával

Ha többféle környezetben dolgozik, érdemes megfontolni telepítési profilok használatával annak biztosítására, hogy a módosításokat a telepítési profil használatával a megfelelő környezetbe töltik fel.

1. Hozzon létre egy telepítési profilok nevű mappát a portál tartalmát tartalmazó mappán belül. Ha például a letöltött portál tartalma "kezdő portál", a telepítési profilok mappájának ebben a mappában kell lennie.

   

2. A központi telepítési profilok mappájában hozzon létre egy környezetspecifikus változtatásokat tartalmazó, telepítésre vonatkozó YAML-fájlt. A fejlesztői környezet például "dev.deployment.yml" néven is hívható.

   

3. Módosítsa a központi telepítési YAML-fájlt Visual Studio Code formátumban a következő formátumban:

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

   Az alábbi minta YAML-kód például frissíti a "Böngésző címsorának utótagja" értékét az alapértelmezett "Egyéni portál" értékről "Egyéni portál (Dev)" értékre.

   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. Ha egy másik környezetben a telepítési profilt használó YAML-fájl segítségével fel kell tölteni a módosításokat, előbb hitelesítse a cél szervezetben.

5. Hitelesítés után és a megfelelő környezethez való csatlakozást követően a tartalom feltöltéséhez használja a pac paportal apload parancsot:

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

   Megjegyzés

   A fenti példában a használt központi telepítési profil neve "dev" a fejlesztői telepítési profil létrehozásához szükséges előző lépések után. Módosítsa a "dev" nevet másra (például a "qa.deployment.yml" minőségének vagy a "test.deployment.yml tesztelése") ha a központi telepítéshez másik fájlnevet használt a központi telepítés YAML-fájljában.

6. lépés Erősítse meg a módosításokat

A portál weblapján végrehajtott módosítások megerősítése:

1. Törölje a kiszolgálóoldali gyorsítótárat, vagy használja a Szinkronizálás konfigurálását a Power Apps-portálok Studio lehetőségével.

2. A változás megjelenítéséhez keresse meg a portál webhelyét.

   

3. Ha már használt telepítési profilt korábban kifejtette, a YAML kódrészlet az alábbi módon frissíti az értéket.

   

   A fenti változáson keresztül frissített böngészőcím-utótag mutatja a változást, amikor megnyitja a portált a böngészőben:

   

Az oktatóanyag itt véget ér. A fenti lépéseket megismételve módosíthatja a portálok tartalmát egyéb támogatott táblák esetében is.

További lépések

A Visual Studio Code bővítmény használata

Kapcsolódó információk

• Microsoft Power Platform CLI
• A Visual Studio Code bővítmény használata (előzetes verzió)