Suport de Microsoft Power Platform CLI per a Power Pages

Microsoft Power Platform CLI (interfície de línia d'ordres) és una interfície de línia d'ordres per a desenvolupadors senzilla que permet als desenvolupadors i creadors d'aplicacions crear components de codi.

Les eines del Microsoft Power Platform CLI són el primer pas cap a una administració del cicle de vida de l'aplicació (ALM) exhaustiva en què els desenvolupadors d'empreses i ISV poden crear, crear, depurar i publicar les seves extensions i personalitzacions de manera ràpida i eficient. Per obtenir més informació, aneu a Què és Microsoft Power Platform la CLI?

Amb aquesta característica, Microsoft Power Platform CLI habilita la CI/CD (integració contínua/implementació contínua) de la configuració del lloc de Power Pages. Ara podeu activar la configuració del lloc web al control del codi font i moure la configuració del lloc web a qualsevol entorn utilitzant el Microsoft Power Platform CLI.

Nota

• Aquesta característica està disponible de manera general a partir de la versió 1.9.8 de Power Platform CLI. Per obtenir informació sobre com instal·lar la versió més recent, aneu a Instal·la Microsoft Power Platform la CLI.
• Amb la versió 1.32 de la CLI del Power Platform, l'ordre pac powerpages s'ha canviat a pac pages. Amb la versió 1.27 de la CLI de pac, l'ordre pac paportal es va canviar a pac powerpages. Tant el powerpages com el paportal continuaran funcionant, però us recomanem que utilitzeu pàgines en el futur.

Per què utilitzar el Microsoft Power Platform CLI per al desenvolupament de llocs web?

Amb Microsoft Power Platform CLI, ara podeu utilitzar una funcionalitat semblant a fora de línia per a la personalització dels llocs web fent canvis al contingut dels llocs web. I una vegada desades totes les personalitzacions o canvis, podeu tornar a carregar la configuración del lloc a Microsoft Dataverse. Quan baixeu el contingut del lloc web utilitzant el Microsoft Power Platform CLI, el contingut està estructurat en formats YAML i HTML, que fa que la personalització sigui fàcil i permet una experiència favorable al desenvolupament.

Aquí teniu una llista de característiques i funcions de les quals els portals es beneficien amb la compatibilitat del Microsoft Power Platform CLI:

Facilitat d'ús

• Suport per a la descàrrega/càrrega de dades de configuració del lloc web a/des del sistema de fitxers local

• Creació sobre l'eina existent del Microsoft Power Platform CLI.

Administració del cicle de vida de l’aplicació (ALM)

• Fer el seguiment dels canvis fets a la configuració del lloc web d'una organització

• Trasllat de fitxers de configuració entre organitzacions o inquilins

Compatibilitat favorable a desenvolupadors i empresa

• Ajuda a integrar-se sense problemes amb qualsevol eina de control del codi font, com ara "git"

• Configuració fàcil de pipelines de CI/CD

Instal·lar el Microsoft Power Platform CLI

Per obtenir instruccions pas a pas, consulteu Instal·lar Microsoft Power Platform CLI.

Taules admeses

El suport de portals per a Microsoft Power Platform la CLI es limita a les taules següents.

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 (només baixada)

adx_websitelanguage

adx_webtemplate

anotació

Important

• Les taules personalitzades i les taules específiques de la plantilla del portal (com ara el bloc, la comunitat o el portal d'idees) no s'admeten per a la personalització mitjançant la CLI del Microsoft Power Platform.
• Els fitxers adjunts d'imatge als registres d'anuncis (adx_ad) no es baixen mitjançant la CLI del Power Platform. Com a solució alternativa, utilitzeu el camp URL d'imatge o afegiu una referència HTML al camp Còpia en un registre de fitxer web que contingui un fitxer d'imatge.

Instal·lar i verificar el Microsoft Power Platform CLI per als portals

Per conèixer com instal·lar el Microsoft Power Platform CLI, aneu a Instal·lar el Microsoft Power Platform CLI.

Després d'instal·lar el CLI del Microsoft Power Platform, obriu l'indicador d'ordres i executeu pac per comprovar que la sortida conté "paportal", l'ordre per als portals del Power Apps.

Ordres del Microsoft Power Platform CLI per als portals

L'ordre del CLI del Microsoft Power Platform per als portals és "paportal".

Les seccions següents proporcionen detalls addicionals sobre diferents propietats de l'ordre "paportal".

Paràmetres

Nom de la propietat	Descripció	Exemple
llista	Enumera tots els llocs web del portal de l'entorn del Dataverse actual. Podeu afegir el paràmetre -v per indicar si el lloc utilitza el model de dades millorat o estàndard	pac pages list
descarregar	Baixa el contingut del lloc web de l'entorn del Dataverse actual. Té els següents paràmetres: - path: camí on es descarrega el contingut del lloc web (àlies: -p) - webSiteId: ID del lloc web del portal per baixar (àlies: -id) - sobreescriure: (opcional) true - per sobreescriure el contingut existent; false - fallar si la carpeta ja té contingut del lloc web (àlies: -o) - modelVersion: 1 o 2 per indicar si les dades del lloc a descarregar utilitzen el model de dades estàndard (1) o millorat (2).	pac pages download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 --modelVersion 2
pujar	Puja el contingut del lloc web del portal a l'entorn actual del Dataverse. Té el següent paràmetre: - camí: camí on s'emmagatzema el contingut del lloc web (àlies: -p) - deploymentProfile: carrega dades del portal amb els detalls de l'entorn definits mitjançant variables de perfil al fitxer deployment-profiles/[profile-name].deployment.yaml - modelVersion: 1 o 2 per indicar si les dades del lloc que es carregaran utilitzen el model de dades estàndard (1) o millorat (2). - forceUploadAll: empeny tots els fitxers locals a l'entorn. Utilitzeu-ho quan creieu que l'estat remot està malmès, no està sincronitzat o quan l'última baixada prové d'una branca diferent.	pac pages upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" --modelVersion 2

Nota

• Quan baixeu un portal de l'entorn A i el carregueu a l'entorn B, la CLI del PAC realitza una càrrega completa. Aquest comportament es produeix perquè el seguiment de canvis utilitza fitxers de manifest, que no transporten informació d'estat entre entorns.
• Les càrregues delta, on només es carreguen fitxers modificats, només s'admeten quan les operacions de baixada i càrrega es produeixen al mateix entorn. En aquest cas, l'CLI del PAC detecta els canvis locals i només carrega els fitxers actualitzats. Per obtenir més informació sobre com funciona el seguiment de canvis, vegeu Fitxers de manifest.
• Utilitzeu --forceUploadAll en aquestes situacions. (Aquest paràmetre actualment només és CLI. Les tasques de l'Azure DevOps encara no hi apareixen.)
  • Deriva de l'estat del pipeline (heu rebasat o seleccionat les confirmacions, de manera que l'últim estat del servidor ja no coincideix amb la vostra branca).
  • Sospita de fallada delta (per exemple, només apareixen canvis parcials després d'un uploadnormal ).

Utilitzar el perfil d'implementació

L'interruptor deploymentProfile us permet definir un conjunt de variables per a l'entorn en format YAML. Per exemple, podeu tenir diferents perfils d'implementació (com ara dev, test, prod) que tenen diferents detalls d'esquema definits al perfil.

Si esteu creant un perfil de prova, podeu crear un fitxer a deployment-profiles amb el nom "test.deployment.yml" (és a dir, <profileTag>.deployment.yml). I podeu executar l'ordre amb l'etiqueta (<profileTag>) per utilitzar aquest perfil:

pac pages upload --path "C:\portals\starter-portal" --deploymentProfile test --modelVersion 2

En aquest fitxer, podeu tenir el nom de la taula (entitat) amb l'identificador de la taula, la llista dels atributs i els valors que voleu substituir mentre carregueu la configuració del portal mitjançant el paràmetre deploymentProfile.

A més, podeu utilitzar la variable OS per accedir a les variables d'entorn del sistema operatiu.

Aquest exemple d'aquest fitxer YAML de perfil de "test.deployment.yml" té detalls d'esquema únics:

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

Nota

Per conèixer totes les ordres utilitzades a la CLI a més dels portals, aneu a Ordres habituals al Microsoft Power Platform CLI.

Fitxers de manifest

Quan descarregueu el contingut del lloc web mitjançant l'ordre de descàrrega de la CLI de les pàgines pac , juntament amb la descàrrega del contingut del lloc, també genera dos fitxers de manifest;

• Fitxer de manifest de l'entorn (org-url-manifest.yml)
• Suprimir el fitxer de manifest de seguiment (manifest.yml)

Fitxer de manifest de l'entorn (org-url-manifest.yml)

El fitxer de manifest de l'entorn es genera cada vegada que s'executa l'ordre de descàrrega de pàgines pac .

Després de cada baixada, l'eina PAC CLI llegeix el fitxer de manifest de l'entorn existent i actualitza les entrades suprimides a l'entorn o crea el fitxer de manifest de l'entorn si no existeix.

Quan executeu l'ordre de càrrega de pàgines pac per carregar el contingut del lloc web del portal. Llegeix el fitxer de manifest de l'entorn i identifica els canvis fets des de la darrera baixada i només puja el contingut actualitzat. Això ajuda a optimitzar el procés de càrrega quan només es puja el contingut del lloc web actualitzat, en comptes de carregar tot el contingut amb cada ordre de càrrega.

El fitxer de manifest de l'entorn és només de lectura quan es connecta al mateix entorn (l'URL de l'entorn coincideix amb el nom del fitxer), per evitar canvis accidentals.

Nota

• El fitxer de manifest de l'entorn no està dissenyat per fer un seguiment dels canvis quan s'implementa el lloc web en entorns diferents.
• El fitxer de manifest de l'entorn està dissenyat per ser utilitzat pels desenvolupadors per implementar localment en el seu entorn de desenvolupador i s'ha d'afegir a la llista d'ignorar git.

Suprimir el fitxer de manifest de seguiment (manifest.yml)

Aquest fitxer s'utilitza per fer el seguiment dels registres suprimits de l'entorn.

Quan el contingut del lloc web es baixa amb l'ordre de descàrrega de pàgines pac , s'afegeixen els registres suprimits del fitxer de manifest de l'entorn (org-url-manifest.yml) al manifest.yml fitxer. Per tant, quan pengeu el contingut del lloc web mitjançant l'ordre de càrrega de pàgines pac , suprimeix els fitxers de l'entorn (fins i tot a un entorn diferent). Aquest fitxer no se suprimeix i s'utilitza independentment de l'entorn que us connecteu. Cal tenir en compte aquest fitxer quan s'han d'introduir canvis al control d'origen per tal de tenir en compte la possibilitat de suprimir elements de l'entorn de destinació.

Nota

Per suprimir els registres de contingut del lloc en un entorn i també suprimir els mateixos registres de contingut en un altre entorn mitjançant la CLI del PAC, haureu d'executar l'ordre de descàrrega de pàgines pacabans i després de suprimir el contingut del registre del lloc web. El manifest.yml farà un seguiment d'aquests canvis i eliminarà els registres corresponents a l'entorn de destinació quan s'executi l'ordre de càrrega de pàgines pac .

Utilitzar l'extensió del Visual Studio Code

També podeu utilitzar l'extensió del VS Code Extensió del VS Code del Power Platform per beneficiar-vos del llenguatge Liquid integrat d'IntelliSense, l'assistència d'emplenament de codi, consells i interactuar amb el Microsoft Power Platform CLI utilitzant el terminal Integrat del VS Code. Més informació: Utilitzar l'extensió del Visual Studio Code (versió preliminar)

Més consideracions

• S'informa d'un error si el vostre camí de fitxer excedeix la limitació màxima de longitud del camí. Més informació: Límit màxim de longitud del camí al Windows
• Per als registres duplicats, com ara un nom de pàgina web duplicat, el Microsoft Power Platform CLI crea dues carpetes diferents: una amb el nom de la pàgina web i l'altra amb el mateix nom amb un prefix de codi hash. Per exemple, "La meva pàgina" i "La meva pàgina-codi-hash".

Passos següents

Tutorial: Utilitzar Microsoft Power Platform la CLI amb portals

Consulteu també

• Microsoft Power Platform CLI
• Utilitzar l'extensió Visual Studio Codi (visualització prèvia)