Tutorial: Utilizar a Microsoft Power Platform CLI com o Power Pages

Neste tutorial, aprenderá como começar a utilizar a Microsoft Power Platform CLI para atualizar a configuração de um site de amostra.

Nota

• Este tutorial centra-se nos comandos da Microsoft Power Platform CLI necessários para utilizar o Power Pages. Para obter mais informações sobre os comandos utilizados na CLI do Power Platform, leia Comandos comuns.
• A partir da versão 1.27 do Power Platform CLI, o comando pac paportal é alterado para pac powerpages. paportal continua a funcionar, mas recomendamos a utilização do powerpages daqui para a frente. Este artigo será brevemente atualizado para utilizar o powerpages, em vez de paportal.

Transferir e Instalar Visual Studio Code

Para ligar aos portais do Power Apps e utilizar comandos da CLI do Microsoft Power Platform, utilize o Visual Studio Code e o terminal integrado. O terminal integrado facilita a ligação ao ambiente do Dataverse e transferir, alterar e carregar a configuração dos portais. Em alternativa, também pode utilizar o Windows PowerShell.

Passo 1. Autenticar

Antes de ligar, listar, transferir ou carregar quaisquer alterações para um portal do Power Apps, tem de autenticar primeiro o ambiente do Dataverse. Para obter mais informações sobre a autenticação utilizando a CLI do Microsoft Power Platform, aceda a pac auth.

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

pac auth create -u [Dataverse URL]

Exemplo

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

Siga as indicações de autenticação para iniciar sessão no ambiente.

Passo 2. Listar sites disponíveis

Utilize o comando pac paportal list para listar os sites do Power Pages disponíveis no ambiente do Dataverse ao qual se ligou no passo anterior.

pac paportal list

Passo 3. Transferir conteúdo de sites

Transfira conteúdo do site a partir do ambiente ligado do Dataverse utilizando o comando pac paportal download.

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

Exemplo

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

Para o parâmetro id, utilize o WebSiteId devolvido pela saída do passo anterior.

Nota

• Utilize modelVersion1 ou 2 para indicar se os dados do site a serem carregados utilizarão o padrão (1) ou o modelo de dados avançado (2).
• Execute o comando pac powerpages list -v para ver que modelo de dados que está a ser utilizado para o seu site. Para mais detalhes, aceda ao modelo de dados avançado.

Passo 4. Alterar conteúdo dos sites

Altere a configuração utilizando o Visual Studio Code e guarde as alterações.

Nota

Certifique-se de que atualiza apenas as tabelas suportadas para utilização com a CLI do Power Platform. Para obter mais informações, veja os Tabelas suportadas.

Por exemplo, a página do portal predefinido apresenta texto como este:

Este texto está visível a partir do HTML da página Web:

Pode alterar este texto e guardar as alterações:

Gorjeta

Pode alterar a localização do caminho da pasta no PowerShell/terminal integrado para o local transferido e introduzir "código." para abrir a pasta diretamente no Visual Studio Code.

Passo 5. Carregar as alterações

Nota

• Se estiver a carregar para vários ambientes, consulte Carregar as alterações através do perfil de implementação para saber como carregar as alterações através do perfil de implementação.
• Certifique-se de que o tamanho de anexos máximo do ambiente de destino está definido para o mesmo tamanho ou maior que o ambiente de origem.
• O tamanho máximo de ficheiros é determinado pela definição Tamanho de ficheiro máximo no separador de e-mail de definições de sistema na caixa de diálogo de definições de sistema do ambiente.

Depois de efetuar as alterações necessárias, carregue-as utilizando o comando pac paportal upload:

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

Exemplo

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

Nota

Certifique-se de que o caminho para o conteúdo dos portais que introduziu está correto. Por predefinição, é criada uma pasta com o nome atribuído pelo portal (nome amigável) com o conteúdo dos portais transferido. Por exemplo, se o nome amigável do portal for portal-personalizado, o caminho para o comando acima (--path) deve ser C:\pac-portals\downloads\custom-portal.

O carregamento só acontece para conteúdo que é alterado. Neste exemplo, uma vez que a alteração é feita para uma página web, o conteúdo é carregado apenas para a tabela adx_webpage.

Carregue as alterações através do perfil de implementação

Quando trabalha com vários ambientes diferentes, poderá considerar utilizar os perfis de implementação para assegurar que as alterações são carregadas para o ambiente correto utilizando o perfil de implementação.

1. Crie uma pasta denominada perfis de implementação na pasta que contém o conteúdo do portal. Por exemplo, se o conteúdo do portal transferido estiver dentro do "portal de início", a pasta de perfis de implementação deve estar dentro desta pasta.

   

2. Dentro da pasta de perfis de implementação, crie um ficheiro YAML de implementação que contenha as alterações específicas do ambiente. Por exemplo, o ambiente de desenvolvimento pode ser denominado "dev.deployment.yml".

   

3. Edite o ficheiro YAML de implementação ao utilizar o Visual Studio Code com o seguinte formato:

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

   Por exemplo, o seguinte código YAML de amostra atualiza o valor de "Sufixo de Título de Browser" do "Portal Personalizado" predefinido para o "Portal Personalizado (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:   · Custom Portal (Dev) # Setting value
   

4. Para carregar as alterações para um ambiente diferente através de um ficheiro YAML de perfil de implementação, primeiro autentique junto da organização de destino.

5. Depois de autenticado e ligado ao ambiente correto, utilize o comando pac paportal upload para carregar o conteúdo:

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

   Nota

   No exemplo acima, o nome do perfil de implantação utilizado é "dev" depois de seguir os passos anteriores para criar um perfil de implementação de desenvolvimento. Altere o nome de "dev" para qualquer outro (tal como QA para "qa.deployment.yml" ou Teste para "test.deployment.yml") se tiver utilizado um nome de ficheiro diferente para o seu ficheiro YAML de implementação.

Passo 6. Confirmar as alterações

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

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

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

   

3. Se utilizou o exemplo de perfil de implementação explicado anteriormente, o fragmento de YAML atualiza o valor, tal como é mostrado na captura de ecrã a seguir.

   

   O sufixo do título do browser atualizado através da alteração acima mostra a alteração quando abre o portal num browser:

   

Deste modo, conclui-se o tutorial. Pode repetir os passos acima e alterar o conteúdo dos portais para outras tabelas suportadas.

Próximos passos

Utilizar a extensão do Visual Studio Code

Consulte também

• Microsoft Power Platform CLI
• Utilizar a extensão do Visual Studio Code