Partilhar via

Suporte do Microsoft Power Platform CLI para o Power Pages

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

As ferramentas do Microsoft Power Platform CLI constituem o primeiro passo para uma narrativa abrangente de gestão do ciclo de vida de aplicações (ALM) onde os programadores e ISVs da empresa podem criar, construir, depurar e publicar as suas extensões e personalizações de forma rápida e eficiente. Para mais informações, aceda a O que é o Microsoft Power Platform CLI?

Com esta funcionalidade, o Microsoft Power Platform CLI permite a CI/CD (Integração Contínua/Implementação Contínua) de uma configuração de site do Power Pages. Agora, pode fazer check-in na configuração do site para controlo de código fonte e mover a configuração do site para qualquer ambiente que utilize o Microsoft Power Platform CLI.

Nota

  • Esta funcionalidade encontra-se geralmente disponível a partir do Power Platform CLI versão 1.9.8. Para saber como instalar a versão mais recente, aceda a Instalar o Microsoft Power Platform CLI.
  • Com a Power Platform CLI versão 1.32, o comando pac powerpages foi alterado para pac pages. Com pac cli versão 1.27, o comando pac paportal foi alterado para pac powerpages. Tanto o powerpages como o paportal continuarão a funcionar, mas recomendamos a utilização do pages no futuro.

Porquê utilizar o Microsoft Power Platform CLI para o desenvolvimento de sites?

Com o Microsoft Power Platform CLI, agora pode utilizar a capacidade offline para personalizar o site, efetuando alterações ao conteúdo do mesmo. E uma vez que todas as personalizações ou alterações sejam guardadas, pode carregar a configuração do site de volta para o Microsoft Dataverse. Quando transfere o conteúdo do site utilizando o Microsoft Power Platform CLI, o conteúdo é estruturado em formatos YAML e HTML, o que facilita a personalização e permite uma experiência de desenvolvimento profissional.

Eis uma lista das funcionalidades e capacidades com as quais os portais beneficiam com o suporte para o Microsoft Power Platform CLI:

Facilidade de utilização

  • Suporte para transferir/carregar dados da configuração do site de/para o sistema de ficheiros local

  • Desenvolvido com base na ferramenta Microsoft Power Platform CLI existente.

Gestão do ciclo de vida das aplicações (ALM)

  • Monitorize as alterações à configuração do site dentro de uma organização

  • Mover ficheiros de configuração entre organizações ou inquilinos

Suporte de desenvolvimento profissional e empresarial

  • Ajuda a integração perfeita com quaisquer ferramentas de controlo de origem, como "git"

  • Configurar facilmente os pipelines de CI/CD

Instalar o Microsoft Power Platform CLI

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

Tabelas suportadas

O suporte de portais para o Microsoft Power Platform CLI está limitado às tabelas a seguir.

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 transferência)

adx_websitelanguage

adx_webtemplate

anotação

Importante

  • Tabelas personalizadas e tabelas específicas de modelo de portal (como blog, comunidade ou portal de ideias) não são suportadas para personalização usando a CLI da Microsoft Power Platform.
  • Os anexos de ficheiros de imagem nos registos de anúncios (adx_ad) não são carregados utilizando o Power Platform CLI. Como solução, utilize o campo URL da Imagem ou ao adicionar uma referência de HTML no campo Copiar a um ficheiro Web que contém um ficheiro de imagem.

Instalar e verificar o Microsoft Power Platform CLI para portais

Para obter mais informações sobre a instalação do Microsoft Power Platform CLI, aceda a Instalar o Microsoft Power Platform CLI.

Depois de instalar o Microsoft Power Platform CLI, abra uma linha de comandos e execute pac para verificar se a saída contém "paportal" - o comando para os portais do Power Apps.

Confirme o comando paportal no Microsoft Power Platform CLI.

Comandos do Microsoft Power Platform CLI para portais

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

As secções seguintes fornecem mais detalhes sobre diferentes propriedades do comando "paportal".

Parâmetros

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

Pode adicionar o parâmetro -v para indicar se o site está a utilizar o modelo de dados avançado ou padrão		 pac pages list
transferir Transfira conteúdo de site de portal a partir do ambiente atual do Dataverse. Tem os seguintes parâmetros:
- path: caminho onde o conteúdo do site é transferido (alias: -p)
- webSiteId: ID do site do portal a transferir (alias: -id)
- overwrite: (opcional) true: para substituir o conteúdo existente; false: para falhar se a pasta já tiver conteúdo de 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 aprimorado (2).		 pac pages download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 --modelVersion 2
carregar Carregue conteúdo de site de portal para o ambiente atual do Dataverse. Tem o seguinte parâmetro:
- path: o caminho onde o conteúdo do site é armazenado (alias: -p)
- deploymentProfile: carregue dados do portal com detalhes de ambiente definidos por meio 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 aprimorado (2).
- forceUploadAll: Envia todos os arquivos locais para o ambiente. Use isso quando achar que o estado remoto está corrompido, fora de sincronia ou quando o último download veio de uma ramificação 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 carregamento completo. Esse comportamento ocorre porque o controle de alterações usa arquivos de manifesto, que não carregam informações de estado entre ambientes.
  • Os carregamentos delta, em que apenas os ficheiros modificados são carregados, são suportados apenas quando as operações de transferência e carregamento ocorrem no mesmo ambiente. Nesse caso, a PAC CLI deteta alterações locais e carrega apenas os arquivos atualizados. Para saber mais sobre como funciona o rastreio de alterações, consulte Ficheiros de Manifesto.
  • Use --forceUploadAll nessas situações. (Este parâmetro é atualmente apenas CLI. As tarefas de DevOps do Azure ainda não o disponibilizam.)
    • Desvio de estado do pipeline (rebaseia ou seleciona confirmações escolhidas a dedo, para que o último estado do servidor já não corresponda ao seu ramo).
    • Falha delta suspeita (por exemplo, apenas alterações parciais aparecem após uma operação normal upload).

Utilizar o perfil de implementação

O interruptor deploymentProfile permite definir um conjunto de variáveis para o ambiente no formato YAML. Por exemplo, pode ter diferentes perfis de implementação (tais como des, teste, prod) que têm diferentes detalhes de esquema definidos no perfil.

Se estiver a criar um perfil de teste, pode criar ficheiros em perfis de implementação com o nome "test.deployment.yml" (isto é, <profileTag>.deployment.yml). E pode executar o comando com a etiqueta (<profileTag>) para usar este perfil:

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

Neste ficheiro, pode ter o nome da tabela (entidade) com ID de tabela, lista de atributos e os valores que pretende anular enquanto faz o upload da configuração do portal utilizando o parâmetro deploymentProfile.

Além disso, pode utilizar a variável OS para aceder às variáveis de ambiente do sistema operativo.

Aqui está um exemplo deste ficheiro YAML de perfil "test.deployment.yml" com 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

Nota

Para obter mais informações sobre todos os comandos utilizados na CLI além dos portais, aceda a Comandos comuns no Microsoft Power Platform CLI.

Ficheiros de manifesto

Quando você baixa o conteúdo do site usando o comando pac pages download CLI, juntamente com o download do conteúdo do site, ele também gera dois arquivos de manifesto;

  • Ficheiro de manifesto de ambiente (org-url-manifest.yml)
  • Eliminar ficheiro de manifesto de rastreio (manifest.yml)

Ficheiro de manifesto de ambiente (org-url-manifest.yml)

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

Após cada transferência, a ferramenta CLI PAC lê o ficheiro de manifesto de ambiente existente e atualiza as entradas eliminadas no ambiente ou cria o ficheiro de manifesto de ambiente se não existir.

Quando você executa o comando pac pages upload para carregar o conteúdo do site do portal. Lê o ficheiro de manifesto de ambiente e identifica as alterações feitas desde a última transferência e carrega apenas o conteúdo atualizado. Isto ajuda a otimizar o processo de carregamento, pois só o conteúdo do Web site atualizado é carregado, em vez de carregar todo o conteúdo em todos os comandos de carregamento.

O ficheiro de manifesto do ambiente é só de leitura quando se liga ao mesmo ambiente (o URL de ambiente corresponde ao nome de ficheiro), 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 ficheiro de manifesto do ambiente foi concebido para ser utilizado pelos programadores para implementação local no seu ambiente de programação e deve ser adicionado a uma lista git Ignorar.

Eliminar ficheiro de manifesto de rastreio (manifest.yml)

Este ficheiro é utilizado para rastrear os dados eliminados do ambiente.

Quando o conteúdo do site é baixado com o comando pac pages download , isso adiciona os registros excluídos do arquivo de manifesto do ambiente (org-url-manifest.yml) ao arquivo manifest.yml. Assim, quando você carrega o conteúdo do site usando o comando pac pages upload , ele exclui os arquivos do ambiente (mesmo para um ambiente diferente). Este ficheiro não é eliminado e é utilizado independentemente do ambiente a que está ligado. Este ficheiro tem de ser considerado quando são necessárias alterações ao controlo de origem para considerar a eliminaçã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 controlará essas alterações e removerá os registros correspondentes no ambiente de destino quando o comando pac pages upload for executado.

Utilizar a extensão do Visual Studio Code

Também pode utilizar a extensão do VS Code da Extensão do VS Code do Power Platform para beneficiar de linguagem Liquid incorporada do IntelliSense, assistência na conclusão de código, sugestões e interação com o Microsoft Power Platform CLI utilizando o Terminal Integrado do VS Code. Mais informações: Utilizar a extensão do Visual Studio Code (pré-visualização)

Mais considerações

  • É comunicado um erro se o seu caminho de ficheiro exceder a limitação máxima do comprimento do caminho. Mais informações: Limitação máxima do comprimento do caminho no Windows
  • Para registos duplicados, como um nome de página Web duplicado, o Microsoft Power Platform CLI cria duas pastas diferentes: uma com o nome da página Web e outra com o mesmo nome com um código hash. Por exemplo, "A minha página" e "A minha páginacódigo hash".

Próximos passos

Tutorial: Utilizar o Microsoft Power Platform CLI com portais

Consultar também

  • Last updated on