Portáltámogatás a Microsoft Power Platform CLI szolgáltatáshoz
Megjegyzés
- október 12-től a Power Apps-portálok a Power Pages nevet kapják. További információ: A Microsoft Power Pages már általánosan elérhető (blog)
A Power Apps-portál dokumentációját hamarosan áttelepítjük és egyesítjük a Power Pages dokumentációjával.
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 Microsoft Power Apps a portálok támogatják a CLI-t a CI/CD (folyamatos integráció/folyamatos üzembe helyezés) engedélyezéséhez a Microsoft Power Platform portál konfigurációjában. Most már beadhatja a portál konfigurációját a forrásvezérléshez, és áthelyezheti a portál konfigurációját bármely környezetbe a CLI használatával Microsoft Power Platform .
Megjegyzé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.
Miért érdemes a Microsoft Power Platform CLI-t használni a portálok fejlesztéséhez?
A Microsoft Power Platform CLI portáltámogatásával mostantól a portálok tartalmának módosításával kapcsolat nélküli üzemmódhoz hasonló képességeket is használhat a portálok testreszabásához. Miután mentette az összes testreszabást vagy módosítást, töltse fel őket a portálra. Amikor portáltartalmat 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
Portáladatok 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 portálkonfigurá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 | Description | Példa |
|---|---|---|
| lista | Listázza az aktuális Dataverse-környezet összes portálwebhelyét. | 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 weboldal tartalmának letöltési helye (alias: -p) - webSiteId: A portál weboldalának azonosítója a letöltéshez (alias: -id) - overwrite: (Választható) igaz – a meglévő tartalom felülírása; false – hiba, ha a mappában már van weboldal tartalom (alias: -o) |
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 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 |
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étrehoz 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
Megjegyzé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.
A PAC CLI eszköz minden letöltés után beolvassa a meglévő környezeti jegyzékfájlt, és frissíti a környezetben törölt bejegyzéseket, vagy létrehozza a környezeti jegyzékfájlt, ha az még 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).
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 csatlakoztatott környezettől függetlenül használható.
Megjegyzé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 VS Code Extension Power Platform használatával az IntelliSense beépített folyékony nyelvét, a kódkiegészítési segítséget, a tippeket és a CLI-vel való interakciót is kihasználhatja a VS Microsoft Power Platform Code integrált terminál használatával. 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