Suport de Microsoft Power Platform CLI per a Power Pages

El Microsoft Power Platform CLI (interfície de línia d'ordres) és una interfície de línia d'ordres senzilla per a desenvolupadors que facilita als desenvolupadors i creadors d'aplicacions la creació de 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 a més informació, aneu a Què és Microsoft Power Platform el 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 la instal·lació de la versió més recent, aneu a Instal·la Microsoft Power Platform CLI.
• A partir de la Power Platform versió 1.27 de CLI, l'ordre pac paportal es canvia a pac powerpages. paportal continua funcionant, però recomanem utilitzar-lo powerpages en el futur. Aquest article aviat s'actualitzarà per utilitzar-lo powerpages en lloc de paportal.

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

annotation

Important

• Les taules personalitzades i les taules específiques de plantilla (com ara blog, comunitat o portal d'idees) no són compatibles amb la personalització utilitzant el Microsoft Power Platform CLI.
• Els fitxers adjunts dels fitxers d'imatge de registres d'anunci (adx_ad) no es baixen mitjançant el 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 paportal list
baixar	Baixa el contingut del lloc web de l'entorn del Dataverse actual. Té els següents paràmetres: - ruta: Camí on es descarrega el contingut del lloc web (àlies: -p) - webSiteId: ID del lloc web del portal que s'ha de baixar (àlies: -id) - overwrite: (opcional) true - per sobreescriure el contingut existent; false - per generar un error si la carpeta ja té contingut del lloc web (àlies: -o) - modelVersió: 1 o 2 per indicar si les dades del lloc a descarregar utilitzen l'estàndard (1) o el model de dades millorat(2).	pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 --modelVersion 2
carregar	Puja el contingut del lloc web del portal a l'entorn actual del Dataverse. Té el següent paràmetre: - path: camí on s'emmagatzema el contingut del lloc web (àlies: -p) -deploymentProfile: carregueu les dades del portal amb els detalls de l'entorn definits a través de variables de perfil al fitxer deployment-profiles/[profile-name].deployment.yaml - modelVersió: 1 o 2 per indicar si les dades del lloc a carregar utilitzen l'estàndard (1) o el model de dades millorat(2).	pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" --modelVersion 2

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 paportal 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 pac paportal descarregueu l'ordre CLI, 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 pac paportal download.

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 pac paportal upload per pujar 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 només es llegeix quan es connecta al mateix entorn (l'adreça 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 el seguiment dels canvis quan s'implementa el lloc web a diferents entorns.
• 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 descarrega amb l'ordre pac paportal download , aquesta afegeix els registres suprimits del fitxer de manifest de l'entorn (org-url-manifest.yml) al fitxer manifest.yml. Per tant, quan carregueu el contingut del lloc web mitjançant l'ordre pac paportal upload 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 poder suprimir els registres de contingut del lloc en un entorn i suprimir també els mateixos registres de contingut d'un altre entorn mitjançant el CLI PAC, haureu d'executar l'ordre pac paportal downloadabans i després de suprimir el contingut del registre de lloc web. El fitxer manifest.yml farà el seguiment d'aquests canvis i suprimirà els registres corresponents a l'entorn de destinació quan s'executi l'ordre pac paportal upload.

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 el Microsoft Power Platform CLI amb portals

Consulteu també

• Microsoft Power Platform CLI
• Utilitzar l'extensió del Visual Studio Code (versió preliminar)