Microsoft Power Platform CLI-támogatás a Power Pages szolgáltatáshoz
A Microsoft Power Platform CLI (parancssori felület) egyszerű, egyablakos fejlesztői parancssori felület, amely lehetővé teszi a fejlesztőknek és alkalmazáskészítőknek kódösszetevők létrehozását.
A Microsoft Power Platform CLI eszközeinek használata az alkalmazás életciklusának átfogó kezelését (ALM) leíró cikk első lépése, amelyben a nagyvállalati fejlesztők és szoftverfejlesztők gyorsan és hatékonyan buildelhetik, javíthatják és közzétehetik a bővítményeiket és a testreszabásaikat. További információkért olvassa el a következőt: Mi az a Microsoft Power Platform CLI?
Ezzel a funkcióval a Microsoft Power Platform CLI támogatja a CI/CD (folyamatos integráció/folyamatos telepítés) Power Pages-webhelykonfigurációhoz történő engedélyezését. Mostantól a webhely-konfigurációban is ellenőrizheti a verziókövetést, és áthelyezheti a webhely-konfigurációt bármely környezetbe a Microsoft Power Platform CLI segítségével.
Feljegyzés
- Ez a funkció általánosan elérhető a Power Platform CLI 1.9.8-as verziójától kezdve. A legújabb verzió telepítéséről a Microsoft Power Platform CLI telepítése részben olvashat.
- A CLI 1.27-es verziójától Power Platform kezdődően a parancs a
pac paportalkövetkezőrepac powerpagesmódosul.paportaltovábbra is működik, de javasoljuk a használatátpowerpages. Ezt a cikket hamarosan frissítjük, hogy használhassukpowerpagespaportal.
Miért érdemes a Microsoft Power Platform CLI-t használni a webhelyek fejlesztéséhez?
A Microsoft Power Platform CLI segítségével mostantól a webhelyek tartalmának módosításával kapcsolat nélküli üzemmódhoz hasonló képességeket is használhat a webhelyek testreszabásához. Miután mentette az összes testreszabást vagy módosítást, feltöltheti a webhely konfigurációját a Microsoft Dataverse rendszerébe. Amikor webhelytartalmat tölt le a Microsoft Power Platform CLI használatával, a tartalom YAML- és HTML-formátumban van strukturálva, megkönnyítve a testreszabást, és így lehetővé teszi a fejlesztőbarát élményt.
Itt találja a Microsoft Power Platform CLI által a portáloknak biztosított szolgáltatásokat és képességeket:
Egyszerű használat
Webhely-konfigurációs adatok letöltésének/feltöltésének támogatása a helyi fájlrendszerbe/fájlrendszerből
Építsen a meglévő Microsoft Power Platform CLI eszközre!
Alkalmazás életciklus-kezelése (ALM)
A webhely-konfiguráció változásainak nyomon követése egy szervezeten belül
Konfigurációs fájlok áthelyezése szervezetek vagy bérlők között
Fejlesztői és nagyvállalati támogatás
Segíti a zökkenőmentes integrációt bármely forráskód-ellenőrző eszközzel, mint például a „git”
CI/CD csővezetékek egyszerű beállítása
A Microsoft Power Platform CLI telepítése
A részletes utasításokat lásd: A Microsoft Power Platform CLI telepítése.
Támogatott táblák
A Microsoft Power Platform CLI portáltámogatás az alábbi táblákra korlátozódik.
adx_ad
adx_adplacement
adx_blog
adx_blogpost
adx_botconsumer
adx_communityforum
adx_communityforumaccesspermission
adx_contentsnippet
adx_entityform
adx_entityformmetadata
adx_entitylist
adx_entitypermission
adx_forumthreadtype
adx_pagetemplate
adx_poll
adx_polloption
adx_pollplacement
adx_portallanguage
adx_publishingstate
adx_redirect
adx_shortcut
adx_sitemarker
adx_sitesetting
adx_tag
adx_urlhistory
adx_webfile
adx_webform
adx_webformmetadata
adx_webformstep
adx_weblink
adx_weblinkset
adx_webpage
adx_webpageaccesscontrolrule
adx_webrole
adx_website
adx_websiteaccess
adx_websitebinding (csak letöltés)
adx_websitelanguage
adx_webtemplate
jegyzet
Fontos
- A Microsoft Power Platform CLI segítségével való testreszabáshoz nem támogatottak az egyéni táblák és a portálok sablonspecifikus táblái (pl. blog, közösségi vagy ötletportál).
- A rekordok hozzáadásához használt képfájlmellékletek (adx_ad) letöltéséhez a rendszer nem használja a Power Platform CLI szolgáltatást. Megoldásként tegye a következőket: használja a Kép URL-címe mezőt, vagy adjon hozzá egy HTML-hivatkozást a Másolat mezőbe annak a webes fájlnak a rekordjához, amelyik a képet tartalmazza.
A Microsoft Power Platform CLI portálok számára telepítése és ellenőrzése
Ha többet szeretne megtudni a Microsoft Power Platform CLI telepítéséről, lépjen ide: A Microsoft Power Platform CLI telepítése.
A Microsoft Power Platform CLI telepítése után nyisson meg parancssort, és futtassa a pac parancsot annak ellenőrzése érdekében, hogy a kimenet tartalmazza-e a „paportal” parancsot – ez a Power Apps-portálok parancsa.
A Microsoft Power Platform CLI parancsai portálokhoz
A Microsoft Power Platform CLI parancsa a portálokhoz a „paportal”.
A következő szakaszok további részleteket tartalmaznak a „paportal” parancs különböző tulajdonságairól.
Paraméterek
| Tulajdonság neve | Adatfolyam leírása | Példa |
|---|---|---|
| lista | Listázza az aktuális Dataverse-környezet összes portálwebhelyét. Előzetes verzió A -v paramétert megadva jelezheti, hogy a webhely a standard vagy a továbbfejlesztett adatmodellt használja-e |
pac paportal list |
| letöltés | Portálwebhely tartalmának letöltése a jelenlegi Dataverse-környezetből. A következő paraméterekkel rendelkezik: - path: A webhely tartalmának letöltési helye (alias: -p) - webSiteId: A portál webhelyének azonosítója a letöltéshez (alias: -id) - overwrite: (Választható) igaz – a meglévő tartalom felülírása; hamis – hiba, ha a mappában már van weboldal tartalom (alias: -o) Előzetes verzió - modelVersion: 1 vagy 2, ami azt jelzi, hogy a letöltendő webhelyadatok a standard (1) vagy a továbbfejlesztett adatmodellt (2) fogják-e használni. |
pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 |
| feltöltés | Portálwebhely tartalmának feltöltése a jelenlegi Dataverse-környezetbe. A következő paraméterrel rendelkezik: - path: Ezen az elérési úton tárolja a webhely a tartalmát (alias: -p) -deploymentProfile: Portáladatok feltöltése a profilváltozók segítségével definiált környezetadatokkal a deployment-profiles/[profile-name].deployment.yaml fájlban Előzetes verzió - modelVersion: 1 vagy 2, ami azt jelzi, hogy a feltöltendő webhelyadatok a standard (1) vagy a továbbfejlesztett adatmodellt (2) fogják-e használni. |
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" |
Telepítési profil használata
A deploymentProfile kapcsolóval YAML formátumban definiálható egy sor változó a környezethez. Létrehozhat például különböző telepítési profilokat (például fejlesztés, tesztelés, termelés), amelyekhez a profilban különböző sémaadatok vannak megadva.
Tesztprofil létrehozásakor létrehozhat egy fájlt a telepítési profilok alatt a „test.deployment.yml” névvel (tehát, <profileTag>.deployment.yml). A profil használata paranccsal is futtatható a (<profileTag>) címkével:
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile test
Ebben a fájlban meg lehet adva az tábla (entitás) neve, amely tartalmazza az táblaazonosítót, az attribútumok listáját, és azokat az értékeket, amelyek felülírását a portálkonfiguráció deploymentProfile paraméter használatával való feltöltése során felül szeretné írni.
Az OS változóval hozzáférhet az operációs rendszer környezeti változóihoz is.
Itt egy példa a „test.deployment.yml” profil YAML-fájlra, amely egyedi sémaadatokat tartalmaz:
adx_sitesetting:
- adx_sitesettingid: 4ad86900-b5d7-43ac-1234-482529724970
adx_value: ${OS.FacebookAppId}
adx_name: Authentication/OpenAuth/Facebook/AppId
- adx_sitesettingid: 5ad86900-b5d7-43ac-8359-482529724979
adx_value: contoso_sample
adx_name: Authentication/OpenAuth/Facebook/Secret
adx_contentsnippet:
- adx_contentsnippetid: b0a1bc03-0df1-4688-86e8-c67b34476510
adx_name: PowerBI/contoso/sales
adx_value: https://powerbi.com/group/contoso/sales
Feljegyzés
A CLI-ban a portálokon kívül használt összes parancsról a Gyakori parancsok a Microsoft Power Platform CLI rendszerben részben olvashat.
Jegyzékfájlok
Amikor a weboldal tartalmát pac portal letöltés CLI-parancs használatával tölti le, a rendszer a webhely tartalmának letöltése mellett két jegyzékfájlt is létre fog hozni;
- Környezet jegyzékfájl (org-url-manifest.yml)
- Nyomkövetési jegyzékfájl törlése (manifest.yml)
Környezet jegyzékfájl (org-url-manifest.yml)
A környezet jegyzékfájlja minden alkalommal létrejön, amikor fut a pac portal letöltési parancs.
Minden letöltést követően a PAC CLI eszköz beolvassa a meglévő környezeti jegyzékfájlt, és frissíti a környezetben a törölt bejegyzéseket, vagy létrehozza a környezeti jegyzékfájlt, ha az nem létezik.
A portálwebhely tartalmának feltöltésére vonatkozó pac portal feltöltési parancs futtatásakor. Elolvassa a környezet jegyzékfájlját, és azonosítja az utolsó letöltés óta végrehajtott módosításokat, és csak a frissített tartalmat tölti fel. Így könnyebben optimalizálható a feltöltési folyamat, mivel csak a frissített webhelytartalom kerül feltöltésre, nem pedig az összes tartalom feltöltése minden feltöltési parancsra.
A véletlen módosítások elkerülése érdekében a környezet jegyzékfájlja írásvédetten fog kapcsolódni ugyanahhoz a környezethez (a környezet URL-címe megegyezik a fájlnévvel).
Feljegyzés
- A környezeti jegyzékfájlt nem arra tervezték, hogy nyomon kövesse a webhely módosításait, amikor azt különböző környezetekbe telepítik.
- A környezeti jegyzékfájlt arra tervezték, hogy a fejlesztők helyileg telepítsék azt a fejlesztői környezetükbe, a fájlt pedig hozzá kell adni a git kihagyási listájához.
Nyomkövetési jegyzékfájl törlése (manifest.yml)
Ezzel a fájllal lehet nyomon követni a környezetből törölt bejegyzéseket.
Ha letölti a webhely tartalmát a pac portal letöltés parancsával, akkor a rendszer hozzáadja a környezet jegyzékfájlból (org-url-manifest.yml) törölt rekordokat a manifest.yml fájlba. Ha tehát a webhely tartalmát a pac portal feltöltési paranccsal tölti fel, akkor a rendszer törli a fájlokat a környezetből (akár egy másik környezetbe is). Ez a fájl nem törlődik, és a rendszer attól függetlenül használja, hogy Ön melyik környezethez van csatlakozva. Ezt a fájlt figyelembe kell venni, amikor változtatásokat küld a verziókövetéshez, annak érdekében, hogy a rendszer figyelembe vegye a tételek törlését a célkörnyezetben.
Feljegyzés
A webhely tartalomrekordjainak egy környezetben PAC CLI használatával és ugyanazon tartalomrekordok egy másik környezetben a való törléséhez futtatnia kell a pac paportal letöltés parancsot a webhely rekordjainak törlése előtt és után. A manifest.yml ezeket a változtatásokat nyomon fogja követni, és a célkörnyezetben eltávolítja a megfelelő rekordokat a pac paportal feltöltési parancs futtatásakor.
A Visual Studio Code bővítmény használata
A VS Code bővítmény Power Platform VS Code bővítmény segítségével hasznosíthatja az IntelliSense beépített liquid nyelvét, a kódok befejezéséhez nyújtott segítséget, a jelzést, valamint a Microsoft Power Platform CLI-vel történő interakciót a VS Code integrált terminál segítségével. További információ: A Visual Studio Code bővítmény használata (előzetes verzió)
További szempontok
- Hiba történik, ha a fájl elérési útja meghaladja az elérési út maximális hosszára vonatkozó korlátozást. További információk: Az elérési út hosszának maximális korlátozása Windows-rendszerben
- A duplikált rekordok, például egy duplikált weblap neve esetén a Microsoft Power Platform CLI két különböző mappát hoz létre – az egyiket a weblap nevével, a másikat pedig ugyanezzel a névvel, egy hash-kóddal előtagozva. Például: "My-page" és "My-page-hash-code".
További lépések
Oktatóanyag: A Microsoft Power Platform CLI használata portálokkal