Titorial: Usar Microsoft Power Platform CLI con Power Pages

Neste tutorial, aprenderás a comezar a usar a CLI para actualizar a configuración dun sitio web de exemplo. Microsoft Power Platform

Nota

  • Este titorial céntrase nos comandos de Microsoft Power Platform CLI necesarios para usar Power Pages. Para obter máis información sobre os comandos empregados na CLI de Power Platform, lea Comandos comúns.
  • A partir da versión 1.27 da Power Platform CLI, o comando pac paportal cambia a pac pages. paportal continúa a funcionar, pero recomendamos usar powerpages de agora en diante.

Descargar e instalar Visual Studio Code

Para conectarse a portais de Power Apps e para usar os comandos da CLI de Microsoft Power Platform, use Visual Studio Codee o terminal integrado. O terminal integrado facilita a conexión ao ambiente de Dataverse e a descarga, a modificación e a carga da configuración dos portais. No seu lugar, tamén pode usar Windows PowerShell.

Paso 1. Autenticar

Antes de conectarse, listar, descargar ou cargar calquera cambio para un portal de Power Apps, debe autenticarse primeiro no ambiente de Dataverse. Para obter máis información sobre a autenticación mediante a CLI de Microsoft Power Platform, vaia a pac auth.

Para autenticarse, abra Windows PowerShell e execute o seguinte comando pac auth create usando o URL do seu ambiente de Dataverse:

pac auth create -u [Dataverse URL]

Exemplo

pac auth create -u https://contoso-org.crm.dynamics.com

Siga as instrucións de autenticación para iniciar sesión no ambiente.

Exemplo de como autenticarse nun ambiente de Dataverse empregando a CLI de Microsoft Power Platform

Paso 2. Enumerar os sitios web dispoñibles

Usa o comando pac pages list para listar os sitios web dispoñibles de Power Pages no entorno Dataverse ao que te conectaches no paso anterior.

pac pages list

Exemplo de lista de sitios web.

Paso 3. Descargar contido de sitios web

Descarga o contido do sitio web desde o entorno conectado Dataverse usando o comando de descarga de páxinas pac .

pac pages download --path [PATH] -id [WebSiteId-GUID] --modelVersion [DataModel]

Exemplo

pac pages download --path c:\pac-portals\downloads -id d44574f9-acc3-4ccc-8d8d-85cf5b7ad141 --modelVersion 2

Para o parámetro id, use o WebSiteId devolto dos resultados do paso anterior.

Texto é usado polos lectores de pantalla.

Nota

  • Usa modelVersion1 ou 2 para indicar se os datos do sitio que se van cargar usarán o modelo de datos estándar (1) ou mellorado (2).
  • Executa pac pages list -v comandos para ver que modelo de datos se usa para o teu sitio. Para máis detalles, véxase modelo de datos mellorado.

Paso 4. Cambiar o contido de sitios web

Cambie a configuración usando Visual Studio Code e garde os seus cambios.

Nota

Asegúrese de actualizar só as táboas compatibles para usar coa CLI de Power Platform. Para obter máis información, consulte Táboas compatibles.

Por exemplo, a páxina predefinida do portal mostra texto como este:

Mostra de texto de páxina de portais

Este texto é visible desde a páxina web html:

Visual Studio Code con texto resaltado para o cambio.

Pode modificar este texto e gardar os cambios:

Texto actualizado usando Visual Studio Code.

Suxestión

Pode cambiar a situación da ruta do cartafol en PowerShell/terminal integrado á localización descargada e introducir "code ." para abrir o cartafol directamente en Visual Studio Code.

Paso 5. Cargar os cambios

Nota

Despois de facer os cambios necesarios, súbeos usando o comando de carga das páxinas de pac :

pac pages upload --path [Folder-location] --modelVersion [ModelVersion]

Exemplo

pac pages upload --path C:\pac-portals\downloads\custom-portal\ --modelVersion 2

Comezando a carga.

Nota

Asegúrese de que a ruta do contido dos portais que introduciu é correcta. De xeito predeterminado, créase un cartafol nomeado polo portal (nome amigable) co contido de portais descargados. Por exemplo, se o nome descritivo do portal é custom-portal, o camiño para o comando anterior (--path) debería ser C:\pac-portals\downloads\custom-portal.

A carga só se realiza para contido que foi modificado. Neste exemplo, dado que o cambio se realiza nunha páxina web, o contido só se carga para a táboa adx_webpage.

Carga completada só para o contido modificado.

Cargar os cambios usando o perfil de despregamento

Ao traballar con varios entornos diferentes, pode considerar o uso de perfís de despregamento para garantir que os cambios se carguen no entorno correcto mediante o perfil de despregamento.

  1. Cree un cartafol co nome perfís de despregamento dentro do cartafol que contén o contido do portal. Por exemplo, se o contido do portal descargado está dentro de "starter-portal", o cartafol de perfís de despregamento debería estar dentro deste cartafol.

    Cartafol para perfís de despregamento

  2. Dentro do cartafol de perfís de despregamento, cree un ficheiro YAML de despregamento que conteña os cambios específicos do ambiente. Por exemplo, o ambiente de desenvolvemento pódese chamar "dev.deployment.yml".

    Perfil de despregamento YAML para o desenvolvemento

  3. Edite o ficheiro YAML de despregamento usando Visual Studio Code co seguinte formato:

    <table-name>:
- <record-id>: <GUID>
  <column-name>: <Name>
  <column-value>: <Value>

    Por exemplo, a seguinte mostra de código YAML actualiza o valor de "Sufixo de título do navegador" de "Portal personalizado" predeterminado a "Portal personalizado (Desenvolvemento)".

    adx_contentsnippet:
    - adx_contentsnippetid: 76227a41-a33c-4d63-b0f6-cd4ecd116bf8 # Replace with your content snippet ID
      adx_name: Browser Title Suffix # Setting name
      adx_value:  &nbsp;· Custom Portal (Dev) # Setting value

  4. Para cargar os cambios nun ambiente diferente mediante un ficheiro YAML do perfil de despregamento, autentique primeiro á organización de destino.

  5. Despois de autenticarte e conectarte ao entorno correcto, usa o comando pac pages upload para subir o contido:

    pac pages upload --path "C:\portals\starter-portal" --deploymentProfile dev --modelVersion 2

    Nota

    No exemplo anterior, o nome do perfil de despregamento usado é "dev" despois de seguir os pasos anteriores para crear un perfil de The following sample de desenvolvemento. Cambie o nome de "dev" a calquera outro (como QA para "qa.deployment.yml" ou Test para "test.deployment.yml") se utilizou un nome de ficheiro diferente para o seu ficheiro YAML de despregamento.

Paso 6. Confirme as modificacións

Para confirmar os cambios realizados na páxina web:

  1. Seleccione Sincronizar no estudio de deseño de Power Pages.

  2. Para ver o cambio, navega á páxina web.

    Ver contido actualizado da páxina.

  3. Se empregaches o exemplo de perfil de despregamento explicado anteriormente, o fragmento de código YAML actualiza o valor como se mostra na seguinte captura de pantalla.

    Sufixo do título do navegador da aplicación de Xestión do portal

    O sufixo do título do navegador actualizado a través do cambio anterior mostra o cambio cando abre o portal nun navegador:

    Cambio do navegador

Isto conclúe o titorial. Pode repetir os pasos anteriores e cambiar o contido dos portais por outras táboas compatibles.

Pasos seguintes

Usar a extensión de código Visual Studio

Consulte tamén

  • Última actualización o