Compatibilitat dels portals amb el Microsoft Power Platform CLI

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 obtenir-ne més informació, vegeu Què és el Microsoft Power Platform CLI?

Amb aquesta característica, els portals del Microsoft Power Apps admeten el Microsoft Power Platform CLI per habilitar la CI/CD (integració contínua/implementació contínua) de la configuració del portal. Ara podeu activar la configuració del portal al control del codi font i moure la configuració del portal 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 més informació sobre la instal·lació de l'última versió, vegeu Instal·lar el Microsoft Power Platform CLI.

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

Amb la compatibilitat dels portals amb el Microsoft Power Platform CLI, ara podeu utilitzar una funcionalitat semblant a fora de línia per a la personalització dels portals fent canvis al contingut dels portals. I una vegada desades totes les personalitzacions o canvis, pujar-les al portal. Quan baixeu el contingut dels portals 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 del portal 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 portal 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

Requisits previs

Abans d'utilitzar les ordres del Microsoft Power Platform CLI per als portals, assegureu-vos que el portal estigui configurat per habilitar la compatibilitat amb a aquesta característica.

Instal·lar el Microsoft Power Platform CLI

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

Taules admeses

La compatibilitat dels portals amb el Microsoft Power Platform CLI està limitada a les taules indicades a continuació.

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.

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 Microsoft Power Platform CLI, obriu una finestra de línia d'ordres i executeu pac per comprovar que la sortida conté "paportal", l'ordre per als portals del Power Apps.

Confirmar l'ordre paportal al Microsoft Power Platform CLI.

Ordres del Microsoft Power Platform CLI per als portals

L'ordre del Microsoft Power Platform CLI 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. pac paportal list
baixeu Baixa el contingut del lloc web de l'entorn del Dataverse actual. Té els següents paràmetres:
- path: camí on es baixarà 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)
pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902
puja 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 : carrega dades del portal amb detalls de l'entorn definits a través de variables de perfil alfitxer deployment-profiles/[profile-name].deployment.yaml
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name"
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

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: 5ad86900-b5d7-43ac-8359-482529724979
      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.

Utilitzar l'extensió del Visual Studio Code (versió preliminar)

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)

Consideracions addicionals

  • 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 els portals

Consulteu també