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.

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 da lista pac powerpages para listar os sites disponíveis do Power Pages no ambiente do Dataverse a que ligou no passo anterior.

pac powerpages list

Passo 3. Transferir conteúdo de sites

Transfira o conteúdo do site a partir do ambiente do Dataverse ligado utilizando o comando transferir pac powerpages.

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, utilize o WebSiteId devolvido pela saída do passo anterior.

Passo 4. Alterar conteúdo dos sites

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

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:

Passo 5. Carregar as alterações

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

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

Exemplo

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

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 carregar pac powerpages para carregar o conteúdo:

   pac powerpages 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