Migrar sites existentes para a versão 5 do Bootstrap (pré-visualização)
[Este tópico é documentação de pré-lançamento e está sujeito a alterações.]
O Bootstrap versão 5 oferece novos recursos e atualizações que tornam seus Power Pages sites mais responsivos e fáceis de personalizar.
Importante
- Esta é uma funcionalidade de pré-visualização.
- As caraterísticas de pré-visualização não se destinam à produção e poderão ter caraterísticas restritas. Estas caraterísticas estão disponíveis antes do lançamento oficial, para que os clientes possam ter acesso antecipado e enviar comentários.
- 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:
- Faça o download da pasta do site.
- Execute a ferramenta de migração na pasta.
- Reveja as alterações.
- Carregue o registro do site migrado.
- Limpe o 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:
- Microsoft Power Platform Suporte CLI para Power Pages
- Tutorial: Usar Microsoft Power Platform a CLI com Power Pages
pac powerpages
Pré-requisitos
Instalar a Microsoft Power Platform CLI verão 1.28.2 ou posterior.
Se o site utilizar ficheiros SVG, certifique-se de que a definição do sistema Definir extensões de ficheiros bloqueados para anexos no seu ambiente Power Platform permite a extensão ".svg".
Considere criar duas versões do seu site do Power Pages utilizando a versão 3 do Bootstrap. Migre uma delas e use a outra como referência para comparar com o site migrado.
Transferir a pasta do site
A partir da versão 1.27 do Microsoft Power Platform CLI, o comando pac paportal
alterou para pac powerpages
. paportal
ainda funciona, mas recomendamos que você 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 powerpages
.
Abra uma linha de comandos.
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
Introduza o comando seguinte para gerar uma lista de sites na organização:
pac powerpages list
Anote o WebSiteId do site que planeia migrar.
Mais informações:
pac powerpages list
Introduza o comando seguinte para transferir 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, utilize o WebSiteId que anotou no passo anterior.
Mais informações:
pac powerpages 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 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" anexado ao nome da pasta.
Para reverter para a versão 3 do Bootstrap versão 5, use enviar comando para substituir a pasta da versão 5 por uma pasta do Bootstrap versão 3.
Mais informações: pac powerpages bootstrap-migrate
Reveja 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.
Abra a pasta V5 que criou no passo anterior.
Abra um ficheiro HTML ou CSS.
No Visual Studio Code, pressione Ctrl+Shift+P para abrir um pedido de comando. Introduzir
bootstrap diff
.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 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 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 o cache do lado do servidor para os metadados/configuração e tabelas de dados.