Nota
O acceso a esta páxina require autorización. Pode tentar iniciar sesión ou modificar os directorios.
O acceso a esta páxina require autorización. Pode tentar modificar os directorios.
Nota
A partir do 12 de outubro de 2022, Portais de Power Apps é Power Pages. Máis información: Microsoft Power Pages xa está dispoñible de forma xeral (blog)
Proximamente migraremos e uniremos a documentación de Portais de Power Apps coa documentación de Power Pages.
A Microsoft Power Platform CLI (interface de liña de comandos) é unha interface de liña de comandos simple e sinxela para programadores que permite aos programadores e aos creadores de aplicacións crear compoñentes de código.
A ferramenta da CLI de Microsoft Power Platform é o primeiro paso cara a unha historia completa de xestión do ciclo de vida das aplicacións (ALM) onde os programadores empresariais e os ISV poden crear, construír, depurar e publicar as súas extensións e personalizacións de xeito rápido e eficiente. Para obter máis información, consulte Que é Microsoft Power Platform CLI?
Con esta función, Microsoft Power Apps portais admite a Microsoft Power Platform CLI para activar a CI/CD (integración continua/implementación continua) da configuración do portal. Agora podes verificar a configuración do portal para controlar o código fonte e mover a configuración do portal a calquera ambiente usando Microsoft Power Platform CLI.
Nota
Esta función está dispoñible xeralmente a partir da Versión 1.9.8. da CLI de Power Platform. Para saber como instalar a versión máis recente, consulte Instalar a CLI de Microsoft Power Platform.
Por que usar a CLI de Microsoft Power Platform para o desenvolvemento de portais?
Co soporte dos portais para a CLI de Microsoft Power Platform, agora pode usar a capacidade semellante a sen conexión para a personalización de portais facendo cambios no contido dos portais. E unha vez gardadas todas as personalizacións ou cambios, cárgaas no portal. Cando descarga contido de portais usando a CLI de Microsoft Power Platform, o contido está estruturado en formatos YAML e HTML polo que é fácil de personalizar, permitindo unha experiencia de desenvolvemento profesional.
Aquí ten unha lista de funcións e capacidades que se benefician dos portais co soporte para CLI de Microsoft Power Platform:
Facilidade de uso
Asistencia para descargar ou cargar datos do portal desde ou ao sistema de ficheiros local
Construír sobre a ferramenta de CLI de Microsoft Power Platform existente.
Xestión do ciclo de vida da aplicación (ALM)
Rastrexe os cambios na configuración do portal dentro dunha organización
Mova ficheiros de configuración entre organizacións ou arrendatarios
Desenvolvemento profesional e soporte empresarial
Axuda a integrarse perfectamente con calquera ferramenta de control de orixe, como "git"
Configurar facilmente canles CI/CD
Instalación da CLI de Microsoft Power Platform
Para obter instrucións paso a paso, consulte Instalar a CLI de Microsoft Power Platform.
Táboas compatibles
O soporte dos portais para a CLI de Microsoft Power Platform está limitada ás táboas listadas a continuación.
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 (só descarga)
adx_websitelanguage
adx_webtemplate
anotación
Importante
- As táboas personalizadas e as táboas específicas do modelo de portal (como o blog, a comunidade ou o portal de ideas) non son compatibles coa personalización mediante a CLI de Microsoft Power Platform.
- Os anexos de ficheiros de imaxe aos rexistros de anuncios (adx_ad) non se descargan mediante a CLI de Power Platform. Como solución alternativa, use o campo URL da imaxe ou engadindo unha referencia HTML no campo Copiar a un rexistro de ficheiro web que contén un ficheiro de imaxe.
Instalar e verificar a CLI de Microsoft Power Platform para portais
Para aprender sobre a instalación da CLI de Microsoft Power Platform, vaia a Instalar CLI de Microsoft Power Platform.
Despois da instalación da CLI de Microsoft Power Platform, abra un símbolo do sistema e execute pac para verificar que a saída contén "paportal", o comando para portais de Power Apps.
Comandos da CLI de Microsoft Power Platform para portais
O comando da CLI de Microsoft Power Platform para portais é "paportal".
As seguintes seccións fornecen máis detalles sobre as diferentes propiedades do comando "paportal".
Parámetros
| Nome da propiedade | Descripción | Exemplo |
|---|---|---|
| lista | Enumera todos os sitios web do portal do ambiente de Dataverse actual. | pac paportal list |
| descargar | Descargue o contido do sitio web do portal do contorno de Dataverse actual. Ten os seguintes parámetros: - camiño: Camiño onde se descargará o contido do sitio web (alias: -p) - webSiteId: ID do sitio web do portal para descargar (alias: -id) - sobrescribir: (Opcional) true, para sobrescribir o contido existente; false, para fallar se o cartafol xa ten contido do sitio web (alias: -o) |
pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 |
| cargar | Cargue o contido do sitio web do portal no contorno de Dataverse actual. Ten o seguinte parámetro: - camiño: Camiño onde se almacena o contido do sitio web (alias: -p) -deploymentProfile: Cargue datos do portal con detalles do contorno definidos a través de variables de perfil no ficheiro deployment-profiles/[profile-name].deployment.yaml |
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" |
Usar o perfil de despregamento
O interruptor deploymentProfile permítelle definir un conxunto de variables para o ambiente en formato YAML. Por exemplo, pode ter diferentes perfís de despregamento (como desenvolvemento, probas e produción) que teñan diferentes detalles do esquema definidos no perfil.
Se está creando un perfil de proba, pode crear o ficheiro en perfís de despregamento co nome "test.deployment.yml" (é dicir, <profileTag>.deployment.yml). E pode executar o comando coa etiqueta (<profileTag>) para usar este perfil:
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile test
Neste ficheiro, pode ter o nome da táboa (entidade) co ID da táboa, a lista de atributos e os valores que desexa substituír mentres se carga a configuración do portal usando o parámetro deploymentProfile.
Ademais, pode usar a variable OS para acceder ás variables de contorno do sistema operativo.
Aquí ten un exemplo deste ficheiro YAML de perfil "test.deployment.yml" que ten detalles exclusivos do esquema:
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
Para coñecer todos os comandos empregados na CLI ademais dos portais, vaia a Comandos comúns na CLI de Microsoft Power Platform.
Arquivos de manifesto
Cando descarga o contido do sitio web usando o comando da CLI pac paportal download, xunto coa descarga do contido do sitio, tamén xerará dous ficheiros de manifesto;
- Ficheiro de manifesto do contorno (org-url-manifest.yml)
- Eliminar o ficheiro do manifesto de seguimento (manifest.yml)
Ficheiro de manifesto do contorno (org-url-manifest.yml)
O ficheiro do manifesto do ambiente xérase cada vez que se executa o comando pac paportal download.
Despois de cada descarga, a ferramenta PAC CLI le o ficheiro de manifesto de ambiente existente e actualiza as entradas eliminadas no ambiente ou crea o ficheiro de manifesto de ambiente se non existe.
Cando executa o comando pac paportal upload para cargar o contido do sitio web do portal. Le o ficheiro do manifesto do contorno e identifica os cambios realizados desde a última descarga e só carga o contido actualizado. Isto axuda a optimizar o proceso de carga xa que só se carga o contido actualizado do sitio web, en lugar de cargar todo o contido en cada comando de carga.
O ficheiro de manifesto do ambiente será de só lectura cando se conecte ao mesmo ambiente (o URL do ambiente coincide co nome do ficheiro), para evitar cambios accidentais.
Eliminar o ficheiro do manifesto de seguimento (manifest.yml)
Este ficheiro úsase para rastrexar os rexistros eliminados do ambiente.
Cando se descarga o contido do sitio web co comando pac paportal download, isto engadirá os rexistros eliminados do ficheiro de manifesto do contorno (org-url-manifest.yml) ao ficheiro manifest.yml. Entón, cando carga o contido do sitio web usando o comando pac paportal upload eliminará os ficheiros do ambiente (incluso a un ambiente diferente). Este ficheiro non se elimina e úsase independentemente do ambiente ao que esteas conectado.
Nota
Para eliminar os rexistros de contido do sitio nun ambiente e tamén eliminar os mesmos rexistros de contido noutro mediante a CLI PAC, terá que executar o comando pac paportal download antes e despois da eliminación do contido do rexistro do sitio web. O manifest.yml fará un seguimento destes cambios e eliminará os rexistros correspondentes no ambiente de destino cando se execute o comando pac paportal upload.
Usar a extensión de Visual Studio Code
Tamén podes utilizar a extensión de código VS Power Platform Extensión de código VS para beneficiarte da linguaxe líquida integrada de IntelliSense, a asistencia para completar código, as suxestións e interactuar co Microsoft Power Platform CLI usando o terminal integrado VS Code. Máis información: Usar a extensión de Visual Studio Code (versión preliminar)
Consideracións adicionais
- Prodúcese un erro se o camiño do ficheiro supera a limitación máxima de lonxitude do camiño. Máis información: Limitación máxima de lonxitude do camiño en Windows
- Para rexistros duplicados como un nome de páxina web duplicado, a CLI de Microsoft Power Platform crea dous cartafoles diferentes: un co nome da páxina web e o outro co mesmo nome prefixado cun código hash. Por exemplo, "A miña páxina" e "A miña páxina-código hash".
Pasos seguintes
Titorial: usar a CLI de Microsoft Power Platform con portais