Visão geral do mapeamento de web parts usadas
Importante
A modernização do SharePoint PnP faz parte da Estrutura PnP e está em constante evolução, verifique as notas de versão para se manter atualizado sobre as alterações mais recentes. Se você tiver problemas, registre-o na lista de problemas do GitHub sobre Estrutura PnP.
Quando uma página é transformada de uma página clássica em uma página moderna, as Web parts mais comumente usadas também são transformadas. As web parts clássicas (por exemplo, XSLTListView) são substituídas pelos seus correspondentes modernos de OOB (por exemplo, web part de lista), supondo que haja um equivalente moderno disponível. O próximo capítulo fornece uma visão geral de quais web parts clássicas são transformadas e como.
Lista de transformação da Web Part
A transformação de página usa um mapeamento de web parts padrão ao transformar páginas clássicas em páginas modernas. O mapeamento usados neste moderno padrão é descrito aqui, mas saiba que você pode atualizar o mapeamento para, por exemplo, adicionar web parts personalizadas de terceiros como um destino de transformação. Veja a descrição de como estender o modelo de mapeamento de web parts no artigo Modelo de transformação página.
| Web Part clássica | Web Part moderna | Comentários | Suporte entre sites |
|---|---|---|---|
| Microsoft.SharePoint.WebPartPages.XsltListViewWebPart (exibir dados da lista) | Web part Lista, Biblioteca ou Eventos | Confira o próximo capítulo para obter mais detalhes | Se, se uma lista com o mesmo nome já existir |
| Microsoft.SharePoint.WebPartPages.ListViewWebPart (visualização herdada de dados da lista) | Web part Lista, Biblioteca ou Eventos | Confira o próximo capítulo para obter mais detalhes | Se, se uma lista com o mesmo nome já existir |
| Microsoft.SharePoint.Portal.WebControls.SiteFeedWebPart (Feed do site nos sites de equipes) | Web part Notícias | Essa web part normalmente é usada para exibir notícias na página inicial, por isso, ela é substituída com a web part notícias do OOB | Sim |
| Microsoft.SharePoint.WebPartPages.ContentEditorWebPart (incorporação de conteúdo) | Web Part Incorporar, Web Part Texto e/ou um editor de scripts de código aberto da comunidade como a Web Part de destino opcional | Confira o próximo capítulo para obter mais detalhes | Sim |
| Microsoft.SharePoint.WebPartPages.ScriptEditorWebPart (incorporação de script) | OOB não transformado, um editor de scripts de código aberto da comunidade como uma Web Part de destino opcional | Confira o próximo capítulo para obter mais detalhes | Sim |
| Microsoft.SharePoint.WebPartPages.ImageWebPart | Web part Imagem | Sim | |
| Microsoft.SharePoint.WebPartPages.ClientSideWebPart (=web part moderna baseada em SPFX moderna na página clássica) | Será mantida a mesma web part moderna com sua configuração | Sim, caso a mesma web part de SPFX esteja disponível no site de destino | |
| Microsoft.SharePoint.WebPartPages.ClientWebPart (=web part de Suplemento do SharePoint na página clássica) | O mesmo suplemento pode funcionar em páginas modernas e será usado incluindo a sua configuração | Sim, caso a mesma web part de suplemento esteja disponível no site de destino | |
| Microsoft.SharePoint.Publishing.WebControls.MediaWebPart (incorporação de vídeos) | Web Part Visualizador de arquivos | Sim | |
| Microsoft.SharePoint.Publishing.WebControls.ContentByQueryWebPart (consultar dados e apresentá-los) | Web part Conteúdo realçado | Não | |
| Microsoft.SharePoint.Publishing.WebControls.ContentBySearchWebPart (consultar dados e apresentá-los) | Web Part Conteúdo realçado | Não | |
| Microsoft.SharePoint.Publishing.WebControls.ResultScriptWebPart (consultar dados e apresentá-los) | Web Part Conteúdo realçado | Não | |
| Microsoft.Office.Excel.WebUI.ExcelWebRenderer (incorporação de arquivos do Excel) | Web Part Visualizador de arquivos | Não | |
| Microsoft.Office.Visio.Server.WebControls.VisioWebAccess (incorporação de arquivos do Visio) | Web part Visualizador de arquivos | Não | |
| Microsoft.SharePoint.WebPartPages.PageViewerWebPart (incorporação de outras páginas) | Web part Inserir | Sim | |
| Microsoft.SharePoint.WebPartPages.PictureLibrarySlideshowWebPart (apresentação de slides de imagens) | Web part Galeria de imagens | As bibliotecas de imagens não oferecem suporte a CDNs, é recomendável copiar o conteúdo da biblioteca de imagens para uma biblioteca de documentos comum e configurá-lo na Web Part da galeria de imagens | Sim, se uma biblioteca de imagens com o mesmo nome já existir |
| Microsoft.SharePoint.WebPartPages.SimpleFormWebPart (incorporação de formulário html) | OOB não transformado, opcionalmente, um editor de scripts de código aberto da comunidade poderá ser configurado | Confira o próximo capítulo para obter mais detalhes | Sim |
| Microsoft.SharePoint.Publishing.WebControls.SummaryLinkWebPart | Web Part Links Rápidos ou a Web Part Texto | Por padrão, o html dos links de resumo é transformado em Links Rápidos, mas, opcionalmente, você pode gerar o html, que será exibido a seguir usando a Web Part Texto. Confira o próximo capítulo para obter mais detalhes | Sim |
| Microsoft.SharePoint.Portal.WebControls.ContactFieldControl (cartão pessoal) | Web Part Pessoas | Sim | |
| Microsoft.SharePoint.WebPartPages.UserDocsWebPart (documentos do usuário) | Web part de Conteúdo realçado | Sim | |
| Microsoft.SharePoint.WebPartPages.XmlWebPart (usando xml e xsl para produzir html) | Removida (Web Part Texto adicionada para explicar o porquê) | Sim | |
| Microsoft.SharePoint.WebPartPages.DataFormWebPart (visualização herdada de formulários de lista) | Removida (Web Part Texto adicionada para explicar o porquê) | Sim | |
| Microsoft.SharePoint.WebPartPages.WikiContentWebpart | Removida (web part Texto adicionada para explicar o porquê) | Não é mais relevante no SPO | Sim |
| Microsoft.SharePoint.WebPartPages.SilverlightWebPart (executando aplicativos Silverlight) | Removida (web part Texto adicionada para explicar o porquê) | Não há nenhum substituto moderno + o Silverlight não está funcionando em navegadores modernos, como Microsoft Edge e Chrome | Sim |
| Microsoft.SharePoint.Publishing.WebControls.MembersWebPart | Removida (Web Part Texto adicionada para explicar o porquê) | Agora, o gerenciamento de membros do site é realizado com a funcionalidade de permissões de site do OOB | Sim |
| Microsoft.Office.InfoPath.Server.Controls.WebUI.BrowserFormWebPart (web part InfoPath) | Removido | Sim | |
| Microsoft.SharePoint.WebPartPages.GettingStartedWebPart (recebendo blocos introdução) | Removida | Não há motivo para manter a introdução para a experiência de site de equipe clássico | Sim |
| Microsoft.SharePoint.WebPartPages.SPUserCodeWebPart (web part Área restrita) | Removido | As web parts Área restrita não são mais possíveis no SPO | Sim |
| Microsoft.SharePoint.Publishing.WebControls.TableOfContentsWebPart | Removida | Esses dados devem ser integrados à navegação do site, se ainda forem relevantes | Sim |
Observação
Todas as outras web parts que não estejam listadas na tabela acima receberão um mapeamento "padrão" e a web part Texto informará "Web part xxx não foi transformada". Confira o artigo Experiências de web part clássica e moderna para entender como as web parts clássicas se relacionam com as modernas em nível funcional.
Propriedades de mapeamento
As propriedades de mapeamento permitem definir o comportamento ao usar o arquivo de mapeamento do OOB. Um exemplo típico é habilitar o uso do editor de scripts da comunidade. A tabela a seguir define as propriedades de mapeamento disponíveis.
| Propriedade de mapeamento | Padrão | Descrição |
|---|---|---|
| UseCommunityScriptEditor | falso | Configurar o uso do editor de scripts da comunidade nos mapeamentos aplicáveis |
| SummaryLinksToQuickLinks | verdadeiro | Configurar o mapeamento das Web Parts Links de Resumo para Links Rápidos |
Detalhes da transformação da Web Part
Habilitar o uso da Web Part de Editor de Scripts da Comunidade que será usada durante a transformação
O OOB não possui Web Parts de editor de scripts moderno uma vez que o script de incorporação é desencorajado devido a riscos inerentes à segurança. No entanto, se você quiser transformar as Web Parts do editor de scripts clássico, ainda poderá fazê-lo usando um editor de script moderno de código aberto da comunidade.
Instalar o editor de scripts da comunidade
Siga as instruções para instalar a web part do editor de script código aberto (https://github.com/SharePoint/sp-dev-fx-webparts/tree/master/samples/react-script-editor) no locatário.
Definir o sinalizador de mapeamento UseCommunityScriptEditor
É preciso informar o mecanismo de transformação da páginas que você já instalou o editor de scripts da comunidade e quer usá-lo durante a transformação. Ao usar o cmdlet do ConvertTo-PnPPagePowerShell PnP , você pode especificar o -UseCommunityScriptEditor sinalizador. Quando estiver usando o .Net, você pode definir o sinalizador conforme mostrado no exemplo abaixo
PageTransformationInformation pti = new PageTransformationInformation(page)
{
// If target page exists, then overwrite it
Overwrite = true,
};
pti.MappingProperties["UseCommunityScriptEditor"] = "true";
pageTransformator.Transform(pti);
web parts XsltListViewWebPart e ListViewWebPart
Essas web parts são bem flexíveis no clássico e, portanto, são substituídas por web parts modernas mais específicas. A substituição funciona da seguinte maneira:
- Biblioteca de documentos: web part Biblioteca
- Lista: web part Lista
- Calendário: web part Eventos
- Lista de problema: web part Lista
- Lista de tarefas: web part Texto explicando que não é possível mapear
- Quadro de discussões: web part Texto explicando que não é possível mapear
- Lista de pesquisas: web part Texto explicando que não é possível mapear
Durante a transformação da web part de uma Lista ou biblioteca, o mecanismo de transformação tentará detectar o modo de exibição usado para configurar a web part e configurará a web part Lista ou Biblioteca moderna para apresentar o mesmo modo de exibição.
Web part ContentEditorWebPart
A web part do editor de conteúdo também pode ser usada apontando para um arquivo em outro local no SharePoint ou, se preferir, pode ter o conteúdo inserido. Dependendo do modo usado é aplicada a lógica a seguir:
- Link do arquivo:
- Quando o arquivo for um arquivo ASPX, então isso pode ser exibido pela web part Inserir
- Quando o conteúdo é outro tipo de arquivo, o conteúdo do arquivo é lido e analisado:
- Se o conteúdo do arquivo não contiver JavaScript, ele será transformado em uma Web Part de editor de scripts de terceiros (se essa opção estiver configurada) ou uma Web Part Texto será exibida com o html de conteúdo do arquivo limpo
- Se o conteúdo do arquivo contiver scripts, ele será transformado em uma Web Part de editor de scripts de terceiros (se essa opção estiver configurada) ou substituído por uma Web Part Texto informando que não foi possível mapear esse conteúdo
- Conteúdo inserido:
- Se o conteúdo inserido não contiver JavaScript, ele será transformado em uma Web Part de editor de scripts de terceiros (se essa opção estiver configurada) ou uma Web Part Texto será exibida com o html inserido limpo
- Se o conteúdo inserido contiver scripts, ele será transformado em uma Web Part de editor de scripts de terceiros (se essa opção estiver configurada) ou substituído por uma Web Part Texto informando que não foi possível mapear esse conteúdo
Web Part ScriptEditorWebPart
Por padrão, uma Web Part Texto é exibida para explicar que esse conteúdo não é transformado. Como alternativa, caso seja definida, uma Web Part de editor de scripts de terceiros poderá ser usada (como mostrado acima)
Web Part SummaryLinks
Por padrão, o html dos links de resumo é transformado em Links Rápidos, mas, opcionalmente, você pode gerar o html, que será exibido a seguir usando a Web Part Texto. Para usar HTML, você precisa definir a propriedade de mapeamento necessária: ao usar o ConvertTo-PnPPage cmdlet do PowerShell PnP, você pode especificar o -SummaryLinksToHtml sinalizador. Quando estiver usando o .Net, você pode definir o sinalizador conforme mostrado no exemplo abaixo
PageTransformationInformation pti = new PageTransformationInformation(page)
{
// If target page exists, then overwrite it
Overwrite = true,
};
pti.MappingProperties["SummaryLinksToQuickLinks"] = "false";
pageTransformator.Transform(pti);