Compartilhar via

Suporte do Microsoft Power Platform CLI para Power Pages

A CLI do Microsoft Power Platform (interface de linha de comando) é uma interface de linha de comando de desenvolvedor simples e única que capacita desenvolvedores e criadores de aplicativos a criar componentes de código.

As ferramentas do Microsoft Power Platform CLI são a primeira etapa rumo a um processo abrangente de gerenciamento do ciclo de vida do aplicativo (ALM), em que os desenvolvedores corporativos e ISVs podem criar, construir, depurar e publicar suas extensões e personalizações de forma rápida e eficiente. Para obter mais informações, acesse O que é Microsoft Power Platform CLI?

Com este recurso, o Microsoft Power Platform CLI habilita a CI/CD (Integração Contínua/Implantação Contínua) de uma configuração do site do Power Pages. Agora você pode fazer o check-in da configuração do site para o controle do código-fonte e mover a configuração do site para qualquer ambiente usando o Microsoft Power Platform CLI.

Nota

  • Este recurso está disponível para o público a partir da versão 1.9.8 do Power Platform CLI. Para saber como instalar a versão mais recente, acesse Instalar o Microsoft Power Platform CLI.
  • Com a CLI do Power Platform versão 1.32, o comando pac powerpages foi alterado para pac pages. Com o pac cli versão 1.27, o comando pac paportal foi alterado para pac powerpages. Tanto o "powerpages" quanto o "paportal" vão continuar funcionando, mas recomendamos o uso de páginas daqui para frente.

Por que usar o Microsoft Power Platform CLI para desenvolvimento do site?

Com o Microsoft Power Platform CLI, agora você pode usar o recurso semelhante ao modo offline para personalização de site, fazendo alterações no conteúdo do site. Quando todas as personalizações ou alterações forem salvas, você pode carregar a configuração do site novamente para o Microsoft Dataverse. Quando você baixa o conteúdo do site usando o Microsoft Power Platform CLI, o conteúdo é estruturado nos formatos YAML e HTML para facilitar a personalização, possibilitando uma experiência favorável ao desenvolvimento.

Veja a seguir uma lista de recursos e funcionalidades dos quais os portais se beneficiam com o suporte ao Microsoft Power Platform CLI:

Facilidade de uso

  • Suporte para download/upload de dados de configuração do site de/para o sistema de arquivos local

  • Desenvolvido com base na ferramenta Microsoft Power Platform CLI.

Gerenciamento do ciclo de vida do aplicativo (ALM)

  • Rastreie as alterações para configuração do site em uma organização

  • Mova arquivos de configuração entre organizações ou locatários

Pró-desenvolvimento e suporte empresarial

  • Ajuda na integração total com ferramentas de controle do código-fonte, como "git"

  • Configure facilmente pipelines de CI/CD

Instalar o Microsoft Power Platform CLI

Para obter instruções passo a passo, consulte Instalar o Microsoft Power Platform CLI.

Tabelas com suporte

O suporte dos portais para o Microsoft Power Platform CLI está limitado às seguintes tabelas.

adx_ad

adx_adplacement

adx_blog

adx_blogpost

adx_botconsumer

adx_communityforum

adx_communityforumaccesspermission

adx_contentsnippet

adx_entityform

adx_entityformmetadata

adx_entitylist

adx_entitypermission

adx_forumthreadtype

adx_pagetemplate

adx_poll

adx_polloption

adx_pollplacement

adx_portallanguage

adx_publishingstate

adx_redirect

adx_shortcut

adx_sitemarker

adx_sitesetting

adx_tag

adx_urlhistory

adx_webfile

adx_webform

adx_webformmetadata

adx_webformstep

adx_weblink

adx_weblinkset

adx_webpage

adx_webpageaccesscontrolrule

adx_webrole

adx_website

adx_websiteaccess

adx_websitebinding (apenas download)

adx_websitelanguage

adx_webtemplate

anotação

Importante

  • Tabelas personalizadas e tabelas específicas do modelo do portal (como blog, comunidade ou portal de ideias) não têm suporte para personalização usando a CLI do Microsoft Power Platform.
  • Arquivos de imagem anexados a registros de anúncio (adx_ad) não são baixados usando a Interface de Linha de Comando do Power Platform. Como solução alternativa, use o campo URL da Imagem, ou adicione uma referência HTML ao campo Cópia para um registro do arquivo da Web contendo um arquivo de imagem.

Instalar e verificar o Microsoft Power Platform CLI para portais

Para aprender a instalação do Microsoft Power Platform CLI, acesse Instalar o Microsoft Power Platform CLI.

Após instalar o Microsoft Power Platform CLI, abra um prompt de comando e execute pac para verificar se a saída contém "paportal" - o comando para os portais do Power Apps.

Confirmar o comando paportal no Microsoft Power Platform CLI.

Os comandos Microsoft Power Platform CLI para os portais

O comando do Microsoft Power Platform CLI para os portais é "paportal".

As seções a seguir fornecem mais detalhes sobre diferentes propriedades do comando "paportal".

Parâmetros

Nome da Propriedade Descrição Exemplo
lista Lista todos os sites do portal do ambiente atual do Dataverse.

Você pode adicionar o parâmetro -v para indicar se o site está usando o modelo de dados aprimorado ou padrão		 pac pages list
baixar Baixe o conteúdo do site do portal do ambiente atual do Dataverse. Ele tem os seguintes parâmetros:
- path: caminho no qual o conteúdo do site é baixado (alias: -p)
- webSiteId: ID do site do portal para baixar (alias: -id)
- substituir: (Opcional) verdadeiro para substituir o conteúdo existente; falso para não substituir se a pasta já tiver o conteúdo do site (alias: -o)
- modelVersion: 1 ou 2 para indicar se os dados do site a serem baixados usam o modelo de dados padrão (1) ou avançado (2).		 pac pages download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 --modelVersion 2
carregar Carrega o conteúdo do site do portal no ambiente atual do Dataverse. Ele tem o seguinte parâmetro:
- path: caminho em que o conteúdo do site é armazenado (alias: -p)
- deploymentProfile: Carregar dados do portal com detalhes do ambiente definidos através de variáveis de perfil no arquivo deployment-profiles/[profile-name].deployment.yaml
- modelVersion: 1 ou 2 para indicar se os dados do site a serem carregados usam o modelo de dados padrão (1) ou avançado (2).
- forceUploadAll: envia todos os arquivos locais para o ambiente. Use isso quando você estiver certo de que o estado remoto está corrompido, fora de sincronia ou quando o último download veio de um branch diferente.		 pac pages upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" --modelVersion 2

Nota

  • Quando você baixa um portal do Ambiente A e o carrega no Ambiente B, a CLI do PAC executa um upload completo. Esse comportamento ocorre porque o controle de alterações usa Arquivos de Manifesto, que não transportam informações de estado entre ambientes.
  • Os uploads delta, em que apenas arquivos modificados são carregados, têm suporte somente quando as operações de download e upload ocorrem no mesmo ambiente. Nesse caso, a CLI do PAC detecta alterações locais e carrega apenas os arquivos atualizados. Para saber mais sobre como o controle de alterações funciona, consulte Arquivos de Manifesto.
  • Use --forceUploadAll nessas situações. (Atualmente, esse parâmetro está disponível apenas na CLI. As tarefas do Azure DevOps ainda não o exibem.)
    • Desvio de estado do pipeline (você reaplicou ou escolheu commits específicos, de modo que o último estado do servidor não corresponde mais à ramificação).
    • Suspeita de falha delta (por exemplo, após um upload normal, somente alterações parciais aparecem).

Usar o perfil de implantação

A opção deploymentProfile permite definir um conjunto de variáveis para o ambiente no formato YAML. Por exemplo, você pode ter perfis de implementação diferentes (como dev, test, prod) que possuem detalhes de esquema diferentes definidos no perfil.

Se você estiver criando um perfil de teste, você pode criar um arquivo em deployment-profiles com o nome "test.deployment.yml" (ou seja, <profileTag>.deployment.yml). E você pode executar o comando com a tag (<profileTag>) para usar este perfil:

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

Neste arquivo, você pode ter o nome da tabela (entidade) com a ID da tabela, lista de atributos e os valores que você deseja substituir ao enviar a configuração do portal usando o parâmetro deploymentProfile.

Além disso, você pode usar a variável OS para acessar as variáveis de ambiente do sistema operacional.

Aqui está um exemplo deste arquivo YAML do perfil "test.deployment.yml" que tem detalhes de esquema exclusivos:

adx_sitesetting:
    - adx_sitesettingid: 4ad86900-b5d7-43ac-1234-482529724970
      adx_value: ${OS.FacebookAppId} 
      adx_name: Authentication/OpenAuth/Facebook/AppId
    - adx_sitesettingid: 5ad86900-b5d7-43ac-8359-482529724979
      adx_value: contoso_sample
      adx_name: Authentication/OpenAuth/Facebook/Secret
adx_contentsnippet:
    - adx_contentsnippetid: b0a1bc03-0df1-4688-86e8-c67b34476510
      adx_name: PowerBI/contoso/sales
      adx_value:  https://powerbi.com/group/contoso/sales

Observação

Para saber mais sobre todos os comandos usados na CLI, além dos portais, acesse Comandos comuns no Microsoft Power Platform CLI.

Arquivos de manifesto

Quando você baixa o conteúdo do site usando o comando CLI pac pages download, além de baixar o conteúdo do site, o processo também gera dois arquivos de manifesto.

  • Arquivo de manifesto do ambiente (org-url-manifest.yml)
  • Excluir arquivo de manifesto de rastreamento (manifest.yml)

Arquivo de manifesto do ambiente (org-url-manifest.yml)

O arquivo de manifesto do ambiente é gerado toda vez que o comando pac pages download é executado.

Após cada download, a ferramenta PAC CLI lê o arquivo de manifesto do ambiente existente e atualiza as entradas excluídas no ambiente, ou criará o arquivo de manifesto do ambiente se ele não existir.

Quando você executa o comando pac pages upload para carregar o conteúdo do site do portal. Ele lê o arquivo de manifesto do ambiente e identifica as alterações feitas desde o último download e carrega apenas o conteúdo atualizado. Isso ajuda a otimizar o processo de upload, pois apenas o conteúdo atualizado do site é carregado, em vez de carregar todo o conteúdo em cada comando de upload.

O arquivo de manifesto do ambiente é somente leitura quando se conecta ao mesmo ambiente (o URL do ambiente corresponde ao nome do arquivo), para evitar alterações acidentais.

Nota

  • O arquivo de manifesto do ambiente não foi projetado para controlar as alterações ao implantar o site em ambientes diferentes.
  • O arquivo de manifesto do ambiente foi projetado para ser usado por desenvolvedores para implantação local em seu ambiente de desenvolvedor e deve ser adicionado à lista de ignorados do git.

Excluir arquivo de manifesto de rastreamento (manifest.yml)

Este arquivo é usado para rastrear os registros excluídos do ambiente.

Quando o conteúdo do site é baixado com o comando pac pages download, adiciona os registros excluídos do arquivo de manifesto do ambiente (org-url-manifest.yml) ao arquivo manifest.yml. Portanto, quando você carrega o conteúdo do site usando o comando pac pages upload, ele exclui os arquivos do ambiente (mesmo que seja para um ambiente diferente). Este arquivo não é excluído e é usado independentemente do ambiente em que você está conectado. Esse arquivo precisa ser considerado ao enviar alterações ao controle de origem para considerar a exclusão de itens no ambiente de destino.

Nota

Para excluir os registros de conteúdo do site em um ambiente e também excluir os mesmos registros de conteúdo em outro ambiente usando a PAC CLI, você precisará executar o comando pac pages downloadantes e depois da exclusão do conteúdo do registro do site. O manifest.yml acompanhará essas alterações e removerá os registros correspondentes no ambiente de destino quando o comando de carregamento de páginas pac for executado.

Usar a extensão do Visual Studio Code

Você também pode usar a extensão do VS Code Extensão do VS Code do Power Platform para aproveitar a linguagem do Liquid incorporada do IntelliSense, a assistência de conclusão de código, as dicas e a interação com o Microsoft Power Platform CLI usando o Terminal Integrado do VS Code. Mais informações: Usar a extensão do Visual Studio Code (versão preliminar)

Mais considerações

  • Um erro será relatado se o caminho do arquivo exceder a limitação do tamanho máximo. Mais informações: Limitação máxima do tamanho do caminho no Windows
  • Para registros duplicados, como um nome de página da Web duplicado, o Microsoft Power Platform CLI cria duas pastas diferentes, uma com o nome da página da Web e a outra com o mesmo nome prefixado com um código hash. Por exemplo, “My-page” e “My-page-hash-code”.

Próximas etapas

Tutorial: Usar o Microsoft Power Platform CLI com portais

Consulte também

  • Last updated on