Megosztás a következőn keresztül:

Microsoft Power Platform CLI-támogatás a Power Pages szolgáltatáshoz

  • Cikk

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ó: 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ével kapcsolatos további információkért tekintse meg a CLI telepítését . Microsoft Power Platform
  • A CLI 1.27-es verziójától Power Platform kezdődően a pac paportal parancs a következőre módosul pac powerpages. paportal Továbbra is működik, de javasoljuk, hogy használja tovább powerpages . Ezt a cikket hamarosan frissítjük, hogy használhassuk powerpages paportal.

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 portálok CLI-támogatása Microsoft Power Platform a következő táblázatokra 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 paportal parancs megerősítése a Microsoft Power Platform CLI rendszerben.

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.

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 (elérési út): Az elérési út, ahová a webhely tartalma letöltődik (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)
- modelVersion:vagy 1 annak jelzésére, 2 hogy a letöltendő webhelyadatok a szabványos (1) vagy a továbbfejlesztett adatmodellt (2) használják-e.		 pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 --modelVersion 2
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
- modelVersion:vagy 1 annak jelzésére, 2 hogy a feltöltendő webhelyadatok a szabványos (1) vagy a továbbfejlesztett adatmodellt (2) használják-e.		 pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" --modelVersion 2

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 --modelVersion 2

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 letölti a webhely tartalmát a pac paportal download CLI paranccsal, a webhely tartalmának letöltése mellett két jegyzékfájlt is generál;

  • 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 környezeti jegyzékfájl csak akkor olvasható, ha ugyanahhoz a környezethez csatlakozik (a környezet URL-címe megegyezik a fájlnévvel), hogy elkerülje a véletlen módosításokat.

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.

Amikor a webhely tartalmát pac paportal letöltési paranccsal tölti le , ez hozzáadja a törölt rekordokat a környezeti jegyzékfájlból (org-url-manifest.yml) manifest.yml fájlhoz. Tehát, amikor feltölti a webhely tartalmát a pac paportal upload paranccsal, az 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

Kapcsolódó információk