Compartilhar via

Migrar sites existentes para Bootstrap versão 5 (versão preliminar)

  • Artigo

[Este tópico faz parte da documentação de pré-lançamento e está sujeito a alterações.]

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

  • Este é um recurso em versão preliminar.
  • Os recursos de versão preliminar não foram criados para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e forneçam comentários.
  • 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 powerpages. paportal ainda funciona, mas recomendamos que você use powerpages daqui em diante. 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 powerpages.

  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 powerpages list

    Anote o WebSiteId do site que você planeja migrar.

    Mais Informações: pac powerpages list

  4. Digite o seguinte comando para baixar a pasta do site: pac powerpages download --path [PATH] -id [WebSiteId-GUID]

    Exemplo: pac powerpages 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 powerpages 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 powerpages bootstrap-migrate -p "WebsiteFolderPath"

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

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

Para reverter da versão 5 do Bootstrap para a versão 3, use o comando de upload para substituir a pasta da versão 5 por uma pasta da versão 3 do Bootstrap.

Mais Informações: pac powerpages bootstrap-migrate

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 powerpages upload --path [Folder-location]

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

Mais Informações: pac powerpages 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.

Confira também