Partilhar via

Migrar sites existentes para o Bootstrap versão 5

A Bootstrap versão 5 oferece novos recursos e atualizações que tornam os sites do Power Pages mais reativos e fáceis de personalizar.

Importante

  • Pode migrar qualquer um dos seus sites Bootstrap versão 3 para a versão 5, independentemente do modelo que foi usado para os criar.
  • Ao migrar sites existentes da versão 3 do Bootstrap para a versão 5, pode usar o modelo de dados padrão ou o modelo de dados avançado.
  • Considere testar a migração com um site de programador.
  • Para verificar a versão atual do Bootstrap, consulte o ficheiro webbootstrap.min.css do seu site.

Para migrar o seu site Bootstrap versão 3, siga estes passos:

  1. Transferir a pasta do site.
  2. Executar a ferramenta de migração na pasta.
  3. Rever as suas alterações.
  4. Carregar o registo do site migrado.
  5. Limpar a cache do lado do servidor.

Uma vez que os passos da migração requerem a utilização do Microsoft Power Platform CLI, certifique-se de que sabe como a utilizar no Power Pages:

Pré-requisitos

Transferir a pasta do site

A partir da versão 1.27 do Microsoft Power Platform CLI, o comando pac paportal alterou para pac pages. paportal ainda funciona, mas recomendamos que use powerpages daqui para frente. Esse é o formulário que usamos nas instruções seguintes. Se estiver a usar a versão 1.26.6 do Microsoft Power Platform CLI, certifique-se de usar pac paportal em vez de pac pages.

  1. Abra uma linha de comandos.

  2. Introduza o seguinte comando para autenticar na organização do Dataverse para o seu ambiente do Power Platform: pac auth create -u [Dataverse URL]

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

    Mais informações: pac auth create

  3. Introduza o comando seguinte para gerar uma lista de sites na organização: pac pages list

    Anote o WebSiteId do site que planeia migrar.

    Mais informações: pac pages list

  4. Introduza o comando seguinte para transferir a pasta do site: pac pages download --path [PATH] -id [WebSiteId-GUID]

    Exemplo: pac pages download --path "c:\pac-powerpages\downloads" -id d44574f9-acc3-4ccc-8d8d-85cf5b7ad141

    Para o parâmetro id, utilize o WebSiteId que anotou no passo anterior.

    Mais informações: pac pages download

Executar a ferramenta de migração na pasta

Introduza o comando seguinte para executar a ferramenta de migração na pasta do site que transferiu: pac pages bootstrap-migrate -p "WebsiteFolderPath"

Exemplo: pac pages bootstrap-migrate -p "c:\pac-powerpages\downloads\bootstrap-dev-site"

O comando cria uma pasta com "V5" anexado ao nome da pasta.

Se tiver problemas ao atualizar para o Bootstrap versão 5 ou quiser reverter para Bootstrap versão 3, consulte Como reverter de Bootstrap versão 5 para a versão 3.

Rever as suas alterações

Se criou uma cópia do seu site antes de o migrar, compare-o com o site da versão 5.

  1. Abra a pasta V5 que criou no passo anterior.

  2. Abra um ficheiro HTML ou CSS.

  3. No Visual Studio Code, pressione Ctrl+Shift+P para abrir um pedido de comando. Introduzir bootstrap diff.

  4. O ficheiro da versão 3 e o ficheiro da versão 5 abrem. Paire o rato sobre cada alteração destacada para a rever.

Carregar o registo do site migrado

Introduza o comando seguinte para carregar o registo do site migrado para a organização: pac pages upload --path [Folder-location]

Exemplo: pac pages upload --path C:\pac-portals\downloads\custom-portal\

Mais informações: pac pages upload

Depois de carregar o registo, o site migrado é um site com a versão 5 do Bootstrap. Recomendamos que compare o site com o site da versão 3 mais uma vez e modifique o site Bootstrap versão 5 conforme necessário.

Limpar a cache do lado do servidor

Limpe a cache do lado do servidor para metadados/configuração e tabelas de dados.

Como reverter do Bootstrap versão 5 para a versão 3

Para reverter para o Bootstrap versão 3:

  1. Execute o comando de carregamento para substituir a pasta da versão 5 por uma pasta do Bootstrap versão 3. Mais informações em pac pages bootstrap-migrate.
  2. Abra a aplicação Gestão do Portal e elimine a definição do site Site/BootstrapV5Enabled. Mais informações em Configurar definições do site para sites.
  3. Limpar a cache do lado do servidor. Mais informações em Como funciona a colocação em cache do lado do servidor no Power Pages.

Veja também