Compartir a través de

Asignación de dirección URL durante la transformación de páginas entre sitios

  • Artículo

Al realizar una transformación de página entre sitios, se usa la asignación de dirección URL predeterminada. La transformación de página entre sitios es obligatoria cuando moderniza las páginas de publicación ya que siempre las páginas modernas siempre se crean en un sitio (de comunicación) moderno. Cuando se realiza la modernización de un sitio de equipo local, no hay motivo para asignar las direcciones URL, pero al hacerlo entre sitios se aplica la asignación de direcciones URL. La asignación de dirección URL reemplazará automáticamente la dirección URL que señala a las ubicaciones de "origen" con páginas URL similares que señalan a las ubicaciones de "destino". Hay un componente de asignación de direcciones URL predeterminadas que está activo de forma predeterminada (pero se puede deshabilitar). Además, existe un componente opcional de asignación de URL personalizada que se puede usar.

¿Dónde se aplica la asignación de URL?

La asignación o reescritura de direcciones URL se aplica en las siguientes ubicaciones:

  • Todo el contenido que se convertirá en partes de texto en la página moderna (a partir de la versión de mayo de 2019).
  • Transformación de SummaryLinks en contenido de texto o en el elemento web QuickLinks moderno (a partir de la versión 2019 de mayo)
  • Anclaje de etiquetas de imágenes (con la versión de noviembre de 2019)

Lógica de asignación de URL predeterminada

Como se indicó anteriormente, cada vez que se realiza una transformación entre sitios, se aplica la asignación de URL de forma predeterminada. El mecanismo de asignación de direcciones URL predeterminado asignará las direcciones URL completas y relativas del sitio y la web actual. Además, controlará el cambio de la biblioteca de "páginas" de publicación clásica a la nueva biblioteca moderna de SitePages. En el ejemplo siguiente se muestra cómo funciona la asignación de URL predeterminada. Suponiendo que el sitio de origen sea el siguiente http://contoso.com/sites/portal/hr y el sitio de comunicación de destino resida en https://contoso.sharepoint.com/sites/hr, se aplican las siguientes reescrituras de URL:

Desactivar la asignación de URL

Si no quiere que se produzca la asignación de direcciones URL, puede desactivarla a través de la marca -SkipUrlRewriting en el PowerShell de PnP o a través del atributo SkipUrlRewrite de los objetos de configuración de transformación de página .Net (PageTransformationInformation yPublishingPageTransformationInformation).

Asignación de dirección URL personalizada

Si quiere realizar asignaciones adicionales además de las controladas por la lógica de asignación predeterminada, tiene que proporcionar un archivo con una lista de definiciones de asignación de URL personalizada. Este es un archivo CSV simple sin encabezado donde se muestran los valores URL de origen y destino. Puede usar una coma (,) o un signo de punto y coma (;) como delimitador en el archivo CSV.

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

Para usar este archivo de asignación de URL personalizada, tan solo tiene que hacer que el motor de transformación de página apunte al archivo. Al usar el PowerShell de PnP, puede usar el parámetro -UrlMappingFile del cmdlet ConvertTo-ClientSidePage (por ejemplo, -UrlMappingFile "c:\temp\urlmap.csv"), o bien puede usar el atributo UrlMappingFile de los objetos de configuración de transformación de página .Net (PageTransformationInformation y PublishingPageTransformationInformation).

Diferencias entre asignación de URL personalizada y asignación de URL predeterminada

Cuando se usa la asignación de URL personalizada, es importante comprender cómo funciona junto con la asignación de URL predeterminada:

  • La asignación de URL personalizada se ejecuta antes de la asignación de dirección URL predeterminada, lo que le permite cambiar el comportamiento de la asignación de URL predeterminada al especificar una asignación personalizada para las direcciones URL reescritas predeterminadas.
  • Cuando deshabilita la asignación de dirección URL, también deshabilita la asignación de URL personalizada. Si solo quiere usar la asignación de dirección URL personalizada, utilice el parámetro -SkipDefaultUrlRewriting del cmdlet ConvertTo-ClientSidePage o el atributo SkipDefaultUrlRewrite de los objetos de configuración de transformación de página .Net (PageTransformationInformation y PublishingPageTransformationInformation).