Freigeben über

URL-Zuordnung während der websiteübergreifenden Seitentransformation

  • Artikel

Wenn Sie eine websiteübergreifende Seitentransformation durchführen, wird standardmäßig die URL-Zuordnung verwendet. Bei der Modernisierung ihrer Veröffentlichungsseiten ist die websiteübergreifende Seitentransformation zwingend erforderlich, da die modernen Seiten immer innerhalb einer modernen (Kommunikations-) Website erstellt werden. Bei Durchführung einer direkten Modernisierung der Teamwebsite gibt es keinen Grund, URL-Adressen zuzuordnen, wenn die websiteübergreifende URL-Zuordnung angewendet wird. Die URL-Zuordnung ersetzt automatisch die URL-Adressen, die auf "Quellspeicherorte" verweisen, durch ähnliche URLs, die dann jedoch auf "Zielspeicherorte" zeigen. Es gibt eine Standard-URL-Zuordnungskomponente, die standardmäßig aktiv ist (aber deaktiviert werden kann), und es gibt eine optionale benutzerdefinierte URL-Zuordnungskomponente, die verwendet werden kann.

Wo wird die URL-Zuordnung angewendet?

Die URL-Zuordnung/-Umschreibung wird für folgende Komponenten angewendet:

  • Alle Inhalte, die auf der modernen Seite als Textteile enden (ab Version von Mai 2019)
  • SummaryLinks-Transformation entweder in Textinhalte oder das moderne QuickLinks-Webpart (ab Version von Mai 2019)
  • Verankern von Tags von Bildern (seit dem Release vom November 2019)

Standard-URL-Zuordnungslogik

Wie weiter oben beschrieben, wird die URL-Zuordnung standardmäßig immer dann angewendet, wenn Sie eine websiteübergreifende Transformation durchführen. Der Standard-URL-Zuordnungsmechanismus ordnet die aktuelle Website sowie die vollständigen und relativen URL-Adressen zu und verarbeitet den Wechsel von den klassischen Veröffentlichungsseitenbibliothek in die neue moderne SitePages-Bibliothek. Das folgende Beispiel zeigt, wie die Standard-URL-Zuordnung funktioniert. Unter der Voraussetzung, dass die Quellwebsite die folgende http://contoso.com/sites/portal/hr ist und die Zielkommunikationswebsite sich in https://contoso.sharepoint.com/sites/hr befindet, werden die folgenden URL-Umschreibungen angewendet:

Deaktivieren der URL-Zuordnung

Wenn Sie die URL-Zuordnung nicht anwenden möchten, können Sie sie über das Flag -SkipUrlRewriting in PnP PowerShell oder über das Attribut SkipUrlRewrite der Konfigurationsobjekte der .NET-Seitentransformation (PageTransformationInformation und PublishingPageTransformationInformation) deaktivieren.

Benutzerdefinierte URL-Zuordnung

Wenn Sie neben den von der Standardzuordnungslogik verarbeiteten Zuordnungen zusätzliche Zuordnungen durchführen möchten werden, müssen Sie eine Datei mit Ihren benutzerdefinierten URL-Zuordnungsdefinitionen bereitstellen. Hierbei handelt es sich um eine einfache CSV-Datei ohne Kopfzeile, in der die Werte für Quell- und Ziel-URLs aufgelistet sind. Als Trennzeichen in der CSV-Datei können Sie entweder das Komma (,) oder das Semikolon (;) verwenden.

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

Um diese benutzerdefinierte URL-Zuordnungsdatei zu verwenden, verweisen Sie das Seitentransformationsmodul einfach auf Ihre Datei. Wenn Sie PnP PowerShell verwenden, können Sie den Parameter -UrlMappingFile des Cmdlets ConvertTo-ClientSidePage (z. B. -UrlMappingFile "c:\temp\urlmap.csv") oder das Attribut UrlMappingFile der Konfigurationsobjekte der .Net-Seitentransformation (PageTransformationInformation und PublishingPageTransformationInformation) verwenden.

Benutzerdefinierte URL-Zuordnung im Vergleich zur Standard-URL-Zuordnung

Wenn Sie eine benutzerdefinierte URL-Zuordnung verwenden, ist es wichtig zu wissen, wie sie im Zusammenspiel mit der Standard-URL-Zuordnung funktioniert:

  • Die benutzerdefinierte URL-Zuordnung wird vor der Standard-URL-Zuordnung ausgeführt, sodass Sie das Verhalten der Standard-URL-Zuordnung ändern können, indem Sie eine benutzerdefinierte Zuordnung für die standardmäßigen umgeschriebenen URLs angeben.
  • Wenn Sie die URL-Zuordnung deaktivieren, wird auch die benutzerdefinierte URL-Zuordnung deaktiviert. Falls Sie nur Ihre benutzerdefinierte URL-Zuordnung nutzen möchten, verwenden Sie den Parameter -SkipDefaultUrlRewriting des ConvertTo-ClientSidePage-Cmdlet oder das Attribut SkipDefaultUrlRewrite der Konfigurationsobjekte der .Net-Seitentransformation (PageTransformationInformation und PublishingPageTransformationInformation).