Oktatóanyag: A Microsoft Power Platform CLI használata a Power Pages szolgáltatással

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

Feljegyzés

• Ez az oktatóanyag azokra a Microsoft Power Platform CLI-parancsokra koncentrál, amelyeket a Power Pages használ. A Power Platform CLI-ben használt parancsokról bővebben az Általános parancsok című részben olvashat.
• A CLI 1.27-es verziójától Power Platform kezdődően a parancs a pac paportal következőre pac powerpages módosul. paportal továbbra is működik, de javasoljuk a használatát powerpages . Ezt a cikket hamarosan frissítjük, hogy használhassuk powerpagespaportal.

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ó webhelyek listázása

A pac paportal list parancs segítségével az előző lépéssel csatlakoztatott Dataverse-környezetben listázhatja a rendelkezésre álló Power Pages-webhelyeket.

pac paportal list

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

Töltse le a webhely 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 webhely 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.

Feljegyzés

Ügyeljen arra, hogy csak a Power Platform CLI-vel használható támogatott táblákat frissítse. További információért olvassa el a következőt: Támogatott táblák.

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:

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

Tipp.

Módosíthatja a mappa elérési útját a PowerShell/integrált terminálon a letöltött helyre, és beírhatja a „code .” parancsot a mappának közvetlenül a Visual Studio Code programban történő megnyitásához.

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

Feljegyzés

• Ha több környezetbe tölti fel a módosításokat, a telepítési profil használatával történő feltöltésével megismerheti, hogyan lehet feltölteni a módosításokat a telepítési profil használatával.
• Ügyeljen arra, hogy a célkörnyezet maximális mellékletének mérete a forráskörnyezettel azonos vagy nagyobb legyen.
• A fájlok maximális méretét a Rendszerbeállítások e-mail lapon található Maximális fájlméret határozza meg a környezet rendszerbeállítások párbeszédpanelén.

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\

Feljegyzés

Ellenőrizze, hogy helyes-e a megadott portáltartalom elérési útja. Alapértelmezés szerint a portál által elnevezett mappa (felhasználóbarát név) a letöltött portálok tartalmával jön létre. Ha például a portál felhasználóbarát neve custom-portal, a fenti parancs (--path) elérési útja: 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

   Feljegyzé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 webhelyen végrehajtott módosítások megerősítése:

1. Válassza a Szinkronizálás lehetőséget a Power Pages tervezőstúdióban.

2. A változás megjelenítéséhez keresse meg a webhelyet.

   

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