Microsoft SharePoint Embedded: Aktualisierung des Verhaltens von driveItem.webUrl

[Was und warum]

Wir aktualisieren das Verhalten der Microsoft Graph driveItem.webUrl-Eigenschaft für Inhalte, die in SharePoint Embedded gespeichert sind.

Nach dieser Änderung gibt driveItem.webUrl die URL zurück, die verwendet wird, um eine Datei im Browser zu öffnen, anstatt als stabile Dateiposition oder Identifikator behandelt zu werden. Je nach Dateityp und Ihrer SharePoint Embedded-Konfiguration kann die zurückgegebene URL sein:

• Eine Microsoft 365-Webviewer-URL
• Eine SharePoint Embedded PDF-Viewer-URL
• Eine Weiterleitungs-URL, die basierend auf Ihrer konfigurierten urlTemplate generiert wird
• Eine Microsoft-Hilfeseiten-URL

Diese Aktualisierung bringt driveItem.webUrl in Einklang mit seinem beabsichtigten Zweck als Browser-Start-URL. Anwendungen, die einen stabilen Identifikator für eine Datei benötigen, sollten driveItemId verwenden, das weiterhin der einzige eindeutige und stabile Identifikator für ein Element innerhalb eines Laufwerks ist. Die SharePoint Embedded-Dokumentation beschreibt driveItem.webUrl als die URL, mit der unterstützte Dateien in Microsoft 365-Erlebnissen gestartet werden.

[Rollout-Zeitplan]

• Gezielte Bereitstellung: Beginn Mitte August 2026
• Allgemeine Verfügbarkeit (weltweit): Beginn Mitte Februar 2027
• Vorübergehender Opt-out verfügbar bis: 17. August 2026
• Kunden, die sich vor dem 17. August 2026 abmelden, erhalten zusätzlich sechs Monate, um auf das neue Verhalten umzusteigen.
• Vorübergehende Opt-out-Unterstützung endet am 22. Februar 2027
• Nach dem 22. Februar 2027 erhalten alle Kunden das aktualisierte driveItem.webUrl-Verhalten.

[Auswirkungen auf Ihre Organisation]

Betroffene Personen

Organisationen, die SharePoint Embedded-Anwendungen entwickeln, verwalten oder nutzen, die driveItem.webUrl als dauerhafte Dateiposition, stabile URL oder Dateiidentifikator verwenden

Plattformen und Dienste

• SharePoint Embedded
• Microsoft Graph
• Microsoft 365 Webviewer
• SharePoint Embedded PDF-Viewer

Was wird passieren

Nach dieser Änderung:

• Word-, Excel-, PowerPoint- und andere unterstützte Microsoft 365-Dateitypen liefern eine Microsoft 365-Viewer-URL zurück.
• PDF-Dateien liefern eine SharePoint Embedded PDF-Viewer-URL zurück.
• Nicht unterstützte Dateitypen mit einer konfigurierten urlTemplate liefern eine Weiterleitungs-URL, die aus dieser Vorlage generiert wurde, zurück.
• Nicht unterstützte Dateitypen ohne konfigurierte urlTemplate liefern eine Microsoft-Hilfeseiten-URL zurück.

Es wird erwartet, dass Anwendungen keine Änderungen benötigen, wenn driveItem.webUrl nur zum Öffnen von Dateien im Browser verwendet wird.

Ihre Anwendung benötigt möglicherweise Updates, wenn sie:

• driveItem.webUrl als dauerhafte Dateiposition speichert.
• driveItem.webUrl als Dateiidentifikator verwendet.
• driveItem.webUrl-Werte über die Zeit vergleicht, um Datei-Identität oder Position zu bestimmen.
• driveItem.webUrl an Dienste übergibt, die eine stabile Speicher-URL erfordern.
• davon ausgeht, dass driveItem.webUrl unabhängig vom Dateityp, dem Viewer-Szenario oder Weiterleitungskonfiguration unverändert bleibt.

[Erforderliche Maßnahmen und Empfehlungen]

Überprüfen Sie, wie Ihre SharePoint Embedded-Anwendungen driveItem.webUrl nutzen.

Keine Maßnahmen erforderlich, wenn driveItem.webUrl nur zum Öffnen von Dateien im Browser verwendet wird.

Wir empfehlen:

• Identifizieren Sie alle Anwendungsabhängigkeiten von driveItem.webUrl als stabilen Identifikator oder dauerhafte URL.
• Aktualisieren Sie Anwendungen so, dass driveItemId verwendet wird, wenn ein stabiler Element-Identifikator erforderlich ist.
• Überprüfen Sie das Weiterleitungsverhalten für nicht unterstützte Dateitypen.
• Konfigurieren Sie urlTemplate, falls Benutzer zu Ihrer Anwendung zurückgeleitet werden sollen. Lesen Sie mehr unter:  Redirect-Verhalten konfigurieren
• Validieren Sie das Anwendungsverhalten gegen die aktualisierte driveItem.webUrl-Erfahrung, bevor die Durchsetzung beginnt.
• Entfernen Sie Abhängigkeiten vom alten driveItem.webUrl-Verhalten, bevor die vorübergehende Opt-out-Unterstützung endet.

Verwenden Sie driveItem.webUrl​, wenn Ihre Anwendung eine URL benötigt, die die Datei im Browser öffnet. Verwenden Sie driveItemId, wenn Sie eine stabile, eindeutige Referenz auf ein Element benötigen.

Organisationen, die zusätzlichen Migrationszeitraum benötigen, können das aktuelle Verhalten für einen SharePoint Embedded-Containertyp vorübergehend beibehalten, indem sie UseLegacyItemWebUrl auf true setzen. Weitere Informationen unter:  Set-SPOContainerTypeConfiguration

Das vorübergehende Opt-out dient ausschließlich als Migrationshilfe und wird nach dem 22. Februar 2027 nicht mehr berücksichtigt.

Weitere Informationen

• Redirect-Verhalten konfigurieren - Office-Dateien aus Ihrer App öffnen | SharePoint | Microsoft Learn
• Set-SPOContainerTypeConfiguration | Microsoft.OnlineSharePoint.PowerShell | PowerShell | Microsoft Learn

[Compliance-Überlegungen]

Es wurden keine Compliance-relevanten Aspekte identifiziert. Überprüfen Sie dies entsprechend für Ihre Organisation.