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, Microsoft Power Apps els portals suporten la Microsoft Power Platform CLI per habilitar CI/CD (Integració Contínua/Desplegament Continu) de la configuració del portal. Ara podeu comprovar a la configuració del portal el control d'origen i moure la configuració del portal a qualsevol entorn mitjançant 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

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

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

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

Fitxers de manifest

Quan baixeu el contingut del lloc web mitjançant l'ordre del CLI pac paportal download, juntament amb la baixada del contingut del lloc també es generaran 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 descàrrega, 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 serà de només lectura quan es connecta al mateix entorn (l'adreça URL de l'entorn coincideix amb el nom del fitxer) per evitar canvis accidentals.

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 pac paportal download, s'afegiran els registres suprimits del fitxer de manifest de l'entorn (org-url-manifest.yml) al fitxer manifest.yml. Per tant, quan pugeu el contingut del lloc web mitjançant l'ordre pac paportal upload, se suprimiran els fitxers de l'entorn (fins i tot amb un entorn diferent). Aquest fitxer no se suprimeix i s'utilitza independentment de l'entorn en què estigueu connectat.

Utilitzar l'extensió del Visual Studio Code

També podeu utilitzar l'extensió Power Platform del VS Code VS Code Extension per beneficiar el llenguatge Liquid integrat d'IntelliSense, l'assistència de compleció de codi, suggeriments i interactuar amb la Microsoft Power Platform CLI mitjançant el terminal integrat de codi VS. 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é

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