Поделиться через

Сопоставление URL-адресов при преобразовании страниц между сайтами

  • Статья

Если вы преобразуете страницы между сайтами, используется стандартное сопоставление URL-адресов. Преобразование страниц между сайтами является обязательным, когда выполняется модернизация страниц публикации, так как в современном (информационном) сайте всегда создаются современные страницы. Если выполняется модернизация сайта группы на месте, не требуется сопоставлять URL-адреса при применении сопоставления URL-адресов между сайтами. При выполнении сопоставления URL-адреса, указывающие на "исходные" расположения, автоматически заменяются аналогичными URL-адресами, но указывающими на "конечные" расположения. Существует стандартный компонент сопоставления URL-адресов, активный по умолчанию (но его можно отключить), а также можно использовать необязательный пользовательский компонент сопоставления URL-адресов.

Где применяется сопоставление URL-адресов?

Сопоставление или переопределение URL-адресов применяется к следующим расположениям:

  • Весь контент, размещаемый в виде текстовых частей на современной странице (в выпуске за май 2019 г.)
  • Преобразование SummaryLinks в текстовое содержимое или современную веб-часть QuickLinks (в выпуске за май 2019 г.)
  • Теги привязки изображений (в выпуске за ноябрь 2019 г.)

Логика стандартного сопоставления URL-адресов

Как указано выше, при преобразовании между сайтами применяется стандартное сопоставление URL-адресов Механизм стандартного сопоставления URL-адресов сопоставляет полный и относительный URL-адреса текущего веб-узла и сайта, а также осуществляет переключение с классической библиотеки публикации Pages на современную библиотеку SitePages. В следующем примере показано, как используется стандартное сопоставление URL-адресов. Предполагая в качестве исходного сайта http://contoso.com/sites/portal/hr, а в качестве конечного информационного сайта — https://contoso.sharepoint.com/sites/hr, выполняется следующая перезапись URL-адресов:

Отключение сопоставления URL-адресов

Если вы не хотите сопоставлять URL-адреса, можно отключить эту возможность с помощью флага -SkipUrlRewriting в PnP PowerShell или атрибута SkipUrlRewrite объектов настройки преобразования страниц в .Net (PageTransformationInformation и PublishingPageTransformationInformation).

Пользовательское сопоставление URL-адресов

Если нужно выполнить сопоставления в дополнение к стандартной логике сопоставления, требуется предоставить файл с определениями пользовательских сопоставлений URL-адресов. Это простой CSV-файл без заголовка, перечисляющий исходные и конечные значения URL-адресов. В качестве разделителя в CSV-файле можно использовать запятую (,) или точку с запятой (;).

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

Чтобы использовать этот пользовательский файл сопоставления URL-адресов, просто укажите свой файл в модуле преобразования страницы. При использовании PnP PowerShell можно применить параметр -UrlMappingFile командлета ConvertTo-ClientSidePage (например, -UrlMappingFile "c:\temp\urlmap.csv") или атрибут UrlMappingFile объектов настройки преобразования страниц в .Net (PageTransformationInformation и PublishingPageTransformationInformation).

Пользовательское и стандартное сопоставление URL-адресов

При использовании пользовательского сопоставления URL-адресов важно понимать его взаимодействие со стандартным сопоставлением URL-адресов:

  • Пользовательское сопоставление выполняется перед стандартным сопоставлением URL-адресов. Это позволяет изменить поведение стандартного сопоставления URL-адресов, указав пользовательское сопоставление для URL-адресов, перезаписываемых по умолчанию.
  • При отключении сопоставления URL-адресов также отключается пользовательское сопоставление URL-адресов. Если требуется использовать только пользовательское сопоставление URL-адресов, примените параметр -SkipDefaultUrlRewriting командлета ConvertTo-ClientSidePage или атрибут SkipDefaultUrlRewrite объектов настройки преобразования страниц в .Net (PageTransformationInformation и PublishingPageTransformationInformation).