Tutorial: Usar o Microsoft Power Platform CLI com o Power Pages

  • Artigo

Neste tutorial, você aprenderá a usar o Microsoft Power Platform CLI para atualizar uma configuração de um site de amostra.

Observação

  • O tutorial se concentra nos comandos necessários do Microsoft Power Platform CLI para uso do Power Pages. Para obter mais informações sobre os comandos usados na CLI do Power Platform, leia Comandos comuns.
  • A partir da versão 1.27 da CLI do Power Platform, o comando pac paportal foi alterado para pac powerpages. paportal continua funcionando, mas recomendamos usar o powerpages daqui em diante.

Baixar e instalar o Visual Studio Code

Para conectar-se aos portais do Power Apps, e para usar os comandos da CLI do Microsoft Power Platform, use o Visual Studio Code e o terminal integrado. O terminal integrado facilita a conexão com o ambiente do Dataverse e o download, a alteração e o upload da configuração dos portais. Você também pode usar o Windows PowerShell.

Etapa 1. Autenticar

Antes de conectar-se, liste, baixe ou carregue alterações para um portal do Power Apps. Primeiro, você deve se autenticar no ambiente do Dataverse. Para obter mais informações sobre autenticação usando a CLI do Microsoft Power Platform, acesse Autenticação de PAC.

Para autenticar, abra o Windows PowerShell e execute o comando pac auth create usando a URL do ambiente do Dataverse:

pac auth create -u [Dataverse URL]

Exemplo

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

Siga os prompts de autenticação para entrar no ambiente.

Exemplo de como fazer a autenticação em um ambiente do Dataverse usando a CLI do Microsoft Power Platform

Etapa 2. Listar sites disponíveis

Use o comando pac powerpages list para listar os sites do Power Pages disponíveis no ambiente do Dataverse ao qual você se conectou na etapa anterior.

pac powerpages list

Exemplo de lista de sites.

Etapa 3. Baixar conteúdo do site

Baixe o conteúdo do site do ambiente do Dataverse conectado usando o comando pac powerpages download .

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

Exemplo

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

Para o parâmetro id, use a WebSiteId retornada na saída da etapa anterior.

Texto é usado por leitores de tela.

Observação

  • Use modelVersion1 ou 2 para indicar se os dados do site a serem carregados usarão o modelo de dados aprimorado(2) ou o padrão (1)
  • Execute o comando pac powerpages list -v para exibir qual modelo de dados está sendo usado para seu site. Para obter mais detalhes, acesse modelo de dados aprimorado.

Etapa 4. Alterar conteúdo do site

Altere a configuração usando o Visual Studio Code e salve suas alterações.

Observação

Certifique-se de atualizar somente as tabelas compatíveis com o uso da CLI do Power Platform. Saiba mais em Tabelas com suporte.

Por exemplo, a página do portal padrão mostra um texto como este:

Texto de exemplo da página de portais

Este texto é visível na página html da Web:

Visual Studio Code com texto destacado para alteração.

Você pode alterar este texto e salvar as alterações:

Texto atualizado usando o Visual Studio Code.

Dica

Você pode alterar o local do caminho da pasta no PowerShell/terminal integrado para o local baixado e inserir "code ." para abrir a pasta diretamente no Visual Studio Code.

Etapa 5. Carregar as alterações

Observação

  • Se você estiver enviando para vários ambientes, consulte Carregar as alterações usando o perfil de implantação para saber como carregar alterações usando o perfil de implantação.
  • Certifique-se de que o tamanho máximo de anexo do ambiente de destino esteja definido para o mesmo tamanho ou maior do seu ambiente de origem.
  • O tamanho máximo dos arquivos é determinado pela configuração Tamanho máximo do arquivo na guia email de configurações do sistema na caixa de diálogo configurações do sistema do ambiente.

Depois de fazer as alterações necessárias, carregue-as usando o seguinte comando pac powerpages upload:

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

Exemplo

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

Iniciando o upload.

Observação

Certifique-se de que o caminho para o conteúdo dos portais inserido esteja correto. Por padrão, uma pasta nomeada pelo portal (nome amigável) será criada com o conteúdo dos portais baixados. Por exemplo, se o nome amigável do portal for custom-portal, o caminho para o comando acima (--path) deve ser C:\pac-portals\downloads\custom-portal.

O carregamento só acontecerá para conteúdo que foi alterado. Neste exemplo, como a alteração é feita em uma página da Web, o conteúdo é carregado apenas para a tabela adx_webpage.

Upload concluído somente para o conteúdo alterado.

Carregar as alterações usando o perfil de implantação

Ao trabalhar com vários ambientes diferentes, você pode considerar o uso de perfis de implantação para garantir que as alterações sejam carregadas no ambiente correto usando o perfil de implantação.

  1. Crie uma pasta chamada perfis de implantação na pasta que contém o conteúdo do portal. Por exemplo, se o conteúdo baixado do portal estiver no "portal inicial", a pasta de perfis de implantação deverá estar dentro dessa pasta.

    Pasta para perfis de implantação

  2. Na pasta de perfis de implantação, crie um arquivo YAML de implantação que contenha as alterações específicas do ambiente. Por exemplo, o ambiente de desenvolvimento pode ser chamado de "dev.deployment.yml".

    YAML de perfis de implantação para desenvolvimento

  3. Edite o arquivo YAML de implantação usando o Visual Studio Code com o seguinte formato:

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

    Por exemplo, o código YAML de amostra a seguir atualiza o valor de "Browser Title Suffix" do padrão "Custom Portal" para "Custom Portal (Dev)".

    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 carregar as alterações para um ambiente diferente usando um arquivo YAML de perfil de implantação, primeiro autentique para a organização de destino.

  5. Depois de autenticado e conectado ao ambiente correto, use o seguinte comando pac powerpages upload para carregar o conteúdo:

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

    Observação

    No exemplo acima, o nome do perfil de implantação usado é "dev" após seguir as etapas anteriores para criar um perfil de implantação dev. Altere o nome de "dev" para qualquer outro (como QA para "qa.deployment.yml" ou Teste para "test.deployment.yml") se tiver usado um nome de arquivo diferente para o arquivo YAML de implantação.

Etapa 6. Confirmar as alterações

Para confirmar as alterações feitas na página da Web:

  1. Selecione Sincronizar no estúdio de design do Power Pages.

  2. Para ver a alteração, navegue até a página da Web.

    Exibir o conteúdo atualizado da página.

  3. Se você usou o exemplo de perfil de implantação explicado anteriormente, o trecho do YAML atualizará o valor, conforme mostrado na captura de tela a seguir.

    Sufixo do título do navegador do aplicativo Gerenciamento do Portal

    O sufixo do título do navegador atualizado por meio da alteração acima mostra a alteração quando você abre o portal em um navegador:

    Mudança de navegador

Isso conclui o tutorial. Você pode repetir as etapas acima e alterar o conteúdo dos portais para outras tabelas compatíveis.

Próximas etapas

Usar a extensão do Visual Studio Code

Confira também