Partilhar via

Tutorial: Utilizar o Microsoft Power Platform CLI com portais

  • Artigo

Nota

A partir de 12 de outubro de 2022, os portais do Power Apps passam a ser Power Pages. Mais informações: O Microsoft Power Pages está agora em disponibilidade geral (blogue)
Em breve, vamos migrar e unir a documentação dos portais do Power Apps com a documentação do Power Pages.

Neste exemplo do tutorial, verá como começar a utilizar a CLI do Microsoft Power Platform para atualizar a configuração de portais da amostra.

Nota

  • Também pode utilizar a CLI do Power Platform com o Power Pages. Mais informações: O que é o Power Pages
  • Este tutorial centra-se nos comandos de CLI do Microsoft Power Platform necessários para utilizar os portais do Power Apps. Para obter mais informações sobre os comandos utilizados na CLI do Power Platform, leia Comandos comuns.

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.

Exemplo de como se autenticar num ambiente do Dataverse utilizando a CLI do Microsoft Power Platform.

Passo 2. Listar os portais disponíveis

Utilize o comando pac paportal list para listar os portais disponíveis do Power Apps no ambiente do Dataverse a que ligou no passo anterior.

pac paportal list

Exemplo de lista de portais.

Passo 3. Transferir conteúdo de portais

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

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

Exemplo

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

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

Exemplo de transferência de conteúdo de portais.

Passo 4. Alterar conteúdo dos portais

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:

Exemplo de texto da página de portais

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

Visual Studio Code com texto realçado para alteração.

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

Texto atualizado utilizando o Visual Studio Code.

Dica

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]

Exemplo

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

Iniciar o carregamento.

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 o conteúdo que foi 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.

Carregamento concluído apenas para conteúdo alterado.

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.

    Pasta para perfis de implementação

  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".

    YAML de perfil de implementação para dev

  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:  &nbsp;· 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

    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 do portal:

  1. Limpe a cache do lado do servidor ou utilize Configuração da Sincronização utilizando o Studio dos portais do Power Apps.

  2. Navegue até à página Web do portal para ver a alteração.

    Ver o conteúdo da página atualizado.

  3. Se utilizou o exemplo de perfil de implementação explicado anteriormente, o fragmento de YAML atualizará o valor, tal como é mostrado abaixo.

    Sufixo de título do browser da aplicação Gestão do Portal

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

    Alteração do 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