Compartilhar via

Mapeamento de URL durante a transformação de página entre sites

  • Artigo

Ao executar uma transformação de página entre sites, por padrão, o mapeamento de URL é usado. A transformação de página entre sites é obrigatória ao modernizar as suas páginas de publicação, pois páginas modernas são sempre criadas em um site (de comunicação) moderno. Ao fazer a modernização do site de equipe no local, não é necessário mapear os URLs quando o mapeamento de URL entre sites for aplicado. O mapeamento de URL substituirá automaticamente os URLs que apontam para locais de "origem" com URLs semelhantes, mas que apontam para locais de "destino". Existe um componente de mapeamento de URL padrão que está ativo por padrão (mas que pode ser desativado), além de um componente de mapeamento de URL personalizado opcional que pode ser usado.

Onde o mapeamento de URL se aplica?

O mapeamento/regravação de URL aplica-se aos seguintes locais:

  • Todo o conteúdo termina como partes de texto na página moderna (a partir de maio de 2019)
  • Transformação de SummaryLinks em conteúdo de texto ou na Web Part moderna de QuickLinks (a partir de maio de 2019)
  • Marcas de ancoragem de imagens (a partir de novembro de 2019)

Lógica de mapeamento de URL padrão

Conforme mencionado acima, sempre que uma transformação entre sites for feita, por padrão, o mapeamento de URL é aplicado. O mecanismo de mapeamento de URL padrão mapeará a Web atual e os URLs completos e relativos do site + ele lidará com a transição da biblioteca clássica de "Páginas" de publicação para a nova biblioteca SitePages moderna. O exemplo a seguir mostra como o mapeamento de URL padrão funciona. Supondo que o site de origem seja http://contoso.com/sites/portal/hr e o site de comunicação de destino resida em https://contoso.sharepoint.com/sites/hr, as seguintes regravações de URL serão aplicadas:

Desativando o mapeamento de URL

Se você não quiser que o mapeamento de URL aconteça, você poderá desabilitá-lo por meio do sinalizador -SkipUrlRewriting no PnP PowerShell ou por meio do atributo SkipUrlRewrite dos objetos de configuração de transformação de página .Net (PageTransformationInformation e PublishingPageTransformationInformation).

Mapeamento de URL personalizado

Se você deseja executar mapeamentos adicionais, além dos processados pela lógica de mapeamento padrão, será necessário fornecer um arquivo listando as suas definições de mapeamento de URL personalizadas. Este é um arquivo CSV simples sem cabeçalho listando os valores de URL de origem e de destino. Você pode usar uma vírgula (,) ou ponto e vírgula (;) como delimitador em seu arquivo CSV.

https://contoso.com/intranet,https://contoso.sharepoint.com/sites/intranet
/sites/hr,/sites/myhrportal

Para usar este arquivo de mapeamento de URL personalizado, basta apontar o mecanismo de transformação de página para o seu arquivo. Ao usar o PnP PowerShell, você poderá usar o parâmetro -UrlMappingFile do cmdlet ConvertTo-ClientSidePage (por exemplo, -UrlMappingFile "c:\temp\urlmap.csv") ou usar o atributo UrlMappingFile dos objetos de configuração de transformação de página .Net (PageTransformationInformation e PublishingPageTransformationInformation).

Mapeamento de URL personalizado versus mapeamento de URL padrão

Ao usar o mapeamento de URL personalizado, é importante entender como ele funciona em conjunto com o mapeamento de URL padrão:

  • O mapeamento de URL personalizado é executado antes do mapeamento de URL padrão, o que permite a alteração do comportamento de mapeamento de URL padrão, especificando um mapeamento personalizado para os urls regravados padrão.
  • Ao desabilitar o mapeamento de URL, o mapeamento de URL personalizado também é desabilitado. Caso queira usar apenas o mapeamento de URL personalizado, utilize o -SkipDefaultUrlRewriting parâmetro do ConvertTo-ClientSidePage cmdlet ou o SkipDefaultUrlRewrite atributo dos objetos de configuração de transformação de página .Net (PageTransformationInformation e PublishingPageTransformationInformation).