Modernizar um site clássico do SharePoint para um site de comunicação ou equipe moderno pode quebrar recursos, permissões e fluxos de trabalho se feito sem planejamento. Sites clássicos dependem de páginas mestras personalizadas, web parts e definições de site que os sites modernos não suportam. Este artigo fornece um checklist de governança que cobre auditoria pré-migração, comunicação com stakeholders, validação de conteúdo e procedimentos de rollback. Seguir este checklist ajuda a evitar perda de dados, links quebrados e interrupções para os usuários durante a transição.
Principais Conclusões: Governança na Migração de Clássico para Moderno
- Inventário de sites e mapeamento de dependências: Identifique todos os sites clássicos, subsites, scripts personalizados e integrações de terceiros antes de iniciar a migração.
- Modelo de plano de comunicação: Notifique proprietários de sites, autores de conteúdo e usuários finais pelo menos duas semanas antes da data de migração com um cronograma claro e tempo de inatividade esperado.
- Plano de rollback usando backup do conjunto de sites: Exporte o site clássico como um arquivo .cmp ou use o Centro de Administração do SharePoint para criar um backup do conjunto de sites antes de aplicar qualquer modelo moderno.
Por que Sites Clássicos Exigem um Checklist de Governança para Modernização
Os sites clássicos do SharePoint foram construídos em uma infraestrutura de publicação que suporta páginas mestras personalizadas, layouts de página baseados em HTML e soluções em sandbox. Os sites modernos usam uma arquitetura plana, um modelo de página moderno e um conjunto limitado de web parts. Ao conectar um site clássico a um grupo do Microsoft 365 ou alterar seu modelo para um site de equipe moderno, vários componentes podem parar de funcionar:
Páginas mestras personalizadas e arquivos CSS alternativos são ignorados. Web parts que dependem de código do lado do servidor, como a Web Part de Consulta de Conteúdo ou a Web Part de Links de Resumo, são substituídas ou removidas. Os subsites perdem a navegação herdada. Níveis de permissão personalizados definidos no nível do subsite podem não ser transferidos corretamente. Um checklist de governança força você a documentar essas dependências antes de fazer alterações, o que reduz a chance de uma migração com falha.
O que Acontece ao Conectar um Site Clássico a um Grupo do Microsoft 365
Conectar um site de equipe clássico a um grupo do Microsoft 365 altera o proprietário, a associação e o modelo de armazenamento do site. O site se torna conectado ao grupo, o que significa que as permissões são gerenciadas através do grupo, e não através dos grupos do SharePoint. Sites clássicos que tinham permissões exclusivas em listas ou bibliotecas podem perder essas permissões após a conexão. O checklist de governança deve incluir uma auditoria completa de permissões antes que a conexão do grupo seja feita.
Checklist de Governança: Auditoria e Preparação Pré-Migração
Antes de modificar qualquer site clássico, conclua estas etapas de auditoria. Use o Centro de Administração do SharePoint, PnP PowerShell ou ferramentas de terceiros para coletar os dados.
- Inventarie todos os sites e subsites clássicos
Execute um relatório do Centro de Administração do SharePoint para listar todos os conjuntos de sites que usam o modelo de site de equipe clássico (STS#0) ou o modelo de publicação clássico (BLANKINTERNET#0). Registre a URL, o ID do modelo, o armazenamento usado e a data da última modificação de cada site. - Documente páginas mestras e layouts de página personalizados
Verifique a Galeria de Páginas Mestras em busca de arquivos .master personalizados. Se o site usar uma página mestra personalizada, anote sua URL e se ela está definida como página mestra do site ou página mestra do sistema. Sites modernos não suportam páginas mestras personalizadas. - Audite as web parts em todas as páginas
Exporte a lista de web parts de cada página clássica usando o PnP PowerShell Get-PnPClientSideWebPart. Identifique web parts que não estão disponíveis em páginas modernas, como a Web Part de Consulta de Conteúdo, a Web Part de Links de Resumo e a Web Part Silverlight. - Verifique scripts personalizados e soluções em sandbox
Revise a biblioteca de ativos do site em busca de arquivos JavaScript e ações de usuário personalizadas. As soluções em sandbox devem ser convertidas em extensões do SharePoint Framework antes que o site possa ser modernizado. - Mapeie todos os níveis de permissão personalizados
Exporte o relatório de permissões do site em Configurações do Site > Permissões do Site > Verificar Permissões. Observe quaisquer níveis de permissão que foram criados manualmente, em vez de herdados do site pai.
Execução da Migração: Aplicando o Modelo Moderno com Segurança
Após a conclusão da auditoria e a documentação de todas as dependências, você pode prosseguir com a modernização. Use a alternância de experiência do SharePoint integrada ou o PnP PowerShell para alternar o site para um modelo moderno.
- Crie um backup completo do conjunto de sites
No Centro de Administração do SharePoint, selecione o site e clique em Backup. Como alternativa, use o comando Export-SPOSite PowerShell para criar um arquivo .cmp. Armazene o backup em um local seguro que não esteja no próprio site. - Notifique todos os usuários e proprietários do site
Envie um e-mail pelo menos uma semana antes da migração. Inclua a data, o tempo de inatividade esperado (geralmente 2 a 4 horas) e um link para uma cópia somente leitura do site, se necessário. - Remova páginas mestras e layouts de página personalizados
Redefina a página mestra do site para o padrão Seattle.master ou Oslo.master. Exclua quaisquer arquivos de layout de página personalizados que não sejam mais necessários. Os sites modernos usam o modelo de página moderno e ignoram esses arquivos. - Substitua web parts não suportadas
Para cada web part não suportada, crie um equivalente moderno. Por exemplo, substitua a Web Part de Consulta de Conteúdo pela web part Conteúdo em Destaque. Substitua a Web Part de Links de Resumo pela web part Links Rápidos. - Converta soluções em sandbox para SPFx
Se o site usar soluções em sandbox, extraia o código e empacote-o como uma extensão do SharePoint Framework. Implante o pacote SPFx no Catálogo de Aplicativos antes de alternar o modelo do site. - Habilite a experiência moderna
Vá para Configurações do Site > Informações do Site > Recursos do Site. Desative o recurso Infraestrutura de Publicação do SharePoint Server, se estiver ativo. Em seguida, em Configurações do Site, clique em Alterar a aparência e selecione um modelo moderno. Se o site for um site de equipe, conecte-o a um grupo do Microsoft 365 clicando em Configurações > Informações do Site > Conectar a um novo grupo do Microsoft 365. - Valide todas as listas, bibliotecas e páginas
Após a alternância do modelo, abra cada lista e biblioteca para confirmar que colunas, exibições e permissões estão intactas. Abra as 10 páginas mais visitadas para verificar se as web parts são renderizadas corretamente.
Problemas Comuns Após a Modernização de um Site Clássico
Navegação Quebrada Após a Alternância de Modelo
Os sites clássicos geralmente usam navegação estrutural que mostra subsites na barra de navegação superior. Os sites modernos usam navegação de hub ou uma navegação lateral plana. Após a alternância, os links dos subsites desaparecem. Para corrigir isso, crie um site de hub e associe o site moderno ao hub. Em seguida, adicione a navegação do hub à navegação lateral do site moderno usando a opção Editar Navegação em Configurações do Site.
Conteúdo Ausente de Páginas de Publicação
As páginas de publicação que usam layouts de página personalizados podem não renderizar após a alternância. O conteúdo é armazenado na biblioteca Páginas, mas o modelo de página não é mais suportado. Para recuperar o conteúdo, abra cada página de publicação no modo de edição, copie o conteúdo e cole-o em uma nova página moderna. Exclua a página de publicação antiga após a migração do conteúdo.
Erros de Permissão em Sites Conectados a Grupo
Quando um site clássico é conectado a um grupo do Microsoft 365, o grupo se torna o proprietário principal. Os usuários que tinham acesso direto através do grupo Membros do site clássico podem perder o acesso se o grupo não os incluir. Execute um relatório de comparação de permissões antes e depois da conexão do grupo. Adicione manualmente quaisquer usuários ausentes ao grupo.
| Item | Site Clássico (Antes) | Site Moderno (Depois) |
|---|---|---|
| Páginas mestras | Arquivos .master personalizados suportados | Não suportado; usa tema moderno padrão |
| Layouts de página | Layouts .aspx personalizados permitidos | Apenas modelo de página moderno |
| Navegação | Navegação estrutural ou gerenciada com subsites | Navegação de hub ou navegação lateral |
| Web parts | Consulta de Conteúdo, Links de Resumo, Silverlight | Conteúdo em Destaque, Links Rápidos, sem Silverlight |
| Permissões | Permissões exclusivas por subsite ou lista | Permissões baseadas em grupo; listas exclusivas podem perder configurações |
| Código personalizado | Soluções em sandbox, ações de usuário personalizadas | Extensões do SharePoint Framework |
Após concluir o checklist de governança e as etapas de migração, você pode verificar se o site moderno funciona conforme o esperado. Execute uma auditoria de conteúdo completa usando o Explorador de Conteúdo do Centro de Administração do SharePoint para confirmar que todos os arquivos, versões e metadados estão presentes. Se algum problema aparecer, restaure o site a partir do backup que você criou anteriormente e reaplique as etapas do checklist. Para projetos de modernização futuros, use a ferramenta SharePoint Modernization Scanner para automatizar o processo de mapeamento de dependências.