Compartilhar via

Migrar sites existentes para o Bootstrap version 5

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

Importante

  • Você pode migrar qualquer um dos seus sites do Bootstrap versão 3 para a versão 5, independentemente do modelo que foi usado para criá-los.
  • Ao migrar sites existentes do Bootstrap versão 3 para a versão 5, você pode usar o modelo de dados padrão ou o modelo de dados aprimorado.
  • Pense em testar a migração com um site de desenvolvedor.
  • Para verificar a versão atual do Bootstrap, consulte o arquivo da webbootstrap.min.css de seu site.

Para migrar seu site do Bootstrap versão 3, siga estas etapas:

  1. Baixe a pasta do site.
  2. Execute a ferramenta de migração na pasta.
  3. Revise suas alterações.
  4. Carregue o registro do site migrado.
  5. Limpe o cache do servidor.

Como as etapas de migração exigem o uso do Microsoft Power Platform CLI, certifique-se de entender como usá-lo no Power Pages:

Pré-requisitos

Baixe a pasta do site

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

  1. Abrir um prompt de comando.

  2. Digite o seguinte comando para se autenticar na organização do Dataverse do 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. Digite o seguinte comando para gerar uma lista de sites na organização: pac pages list

    Anote o WebSiteId do site que você planeja migrar.

    Mais Informações: pac pages list

  4. Digite o seguinte comando para baixar 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, use a WebSiteId que você anotou na etapa anterior.

    Mais Informações: pac pages download

Execute a ferramenta de migração na pasta

Digite o seguinte comando para executar a ferramenta de migração na pasta do site que você baixou: 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" acrescentado ao nome da pasta.

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

Revisar suas alterações

Se você criou uma cópia do seu site antes de migrá-lo, compare-o com o site da versão 5.

  1. Abra a pasta V5 criada na etapa anterior.

  2. Abra um arquivo HTML ou CSS.

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

  4. O arquivo da versão 3 e o arquivo da versão 5 são abertos. Passe o mouse sobre cada alteração destacada para revisá-la.

Carregue o registro do site migrado

Digite o comando a seguir para carregar o registro 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 registro, o site migrado será um site Bootstrap da versão 5. Recomendamos que você compare o site com o seu site da versão 3 mais uma vez e modifique o site Bootstrap da versão 5, conforme necessário.

Limpar o cache do servidor

Limpe o cache 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 upload para substituir a pasta versão 5 por uma pasta Bootstrap versão 3. Saiba mais em pac pages bootstrap-migrate.
  2. Abra o aplicativo Gerenciamento do Portal e exclua a configuração do site Site/BootstrapV5Enabled. Saiba mais em Definir configurações do site para os sites.
  3. Limpe o cache do servidor. Saiba mais em Como funciona o cache do servidor no Power Pages.

Consultar também

  • Last updated on