Asistencia técnica de portais para a CLI de Microsoft Power Platform
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, os portais de Microsoft Power Apps permite á CLI de Microsoft Power Platform habilitar CI/CD (integración continua/despregue continuo) da configuración do portal. Agora pode revisar a configuración do portal para controlar o código fonte e mover a configuración do portal a calquera ambiente usando a CLI de Microsoft Power Platform.
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
Requisitos previos
Antes de usar os comandos da CLI de Microsoft Power Platform para os portais, asegúrese de que o seu portal estea configurado para permitir a compatibilidade con esta función.
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.
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 adicionais 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) -Perfil de implementación : cargue datos do portal cos detalles do contorno definidos mediante variables do perfil en deployment-profiles/[nome-perfil].deployment.yaml arquivo |
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.
Usar a extensión de Visual Studio Code (versión preliminar)
Tamén pode usar a extensión de VS Code Extensión de VS Code para Power Platform para beneficiar a linguaxe Liquid integrada de IntelliSense, asistencia para a conclusión de código, insinuación e interacción coa CLI de Microsoft Power Platform usando o terminal integrado en 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
Consulte tamén
Comentarios
Enviar e ver os comentarios