Von Office-Add-Ins verwendete Browser und Webview-Steuerelemente

Artikel
10/31/2023

Office-Add-Ins sind Webanwendungen, die mithilfe von iframes angezeigt werden, wenn sie in Office im Web ausgeführt werden. In Office für Desktop- und mobile Clients verwenden Office-Add-Ins ein eingebettetes Browsersteuerelement (auch als Webansicht bezeichnet). Add-Ins benötigen zudem eine JavaScript-Engine, um das JavaScript auszuführen. Sowohl der eingebettete Browser als auch die Engine werden von einem Browser bereitgestellt, der auf dem Computer des Benutzers installiert ist. In diesem Artikel bezieht sich "Webview" auf die Kombination aus einem Webview-Steuerelement und einer JavaScript-Engine.

Welche Webansicht verwendet wird, hängt von folgenden Faktoren ab:

Das Betriebssystem des Computers.
Ob das Add-In in Office im Web, in Office aus einem Microsoft 365-Abonnement oder in unbefristeten Office 2013 oder höher ausgeführt wird.
In den unbefristeten Versionen von Office unter Windows, unabhängig davon, ob das Add-In in der Variante "Einzelhandel" oder "Volumenlizenz" ausgeführt wird.

Wichtig

Webviews von Internet-Explorer und Vorgängerversion von Microsoft Edge werden weiterhin in Office-Add-Ins verwendet.

Einige Kombinationen von Plattformen und Office-Versionen, einschließlich volumenlizenzierter unbefristeter Versionen über Office 2019, verwenden weiterhin die Webview-Steuerelemente, die im Internet Explorer 11 (als "Trident" bezeichnet) und Vorgängerversion von Microsoft Edge (als "EdgeHTML" bezeichnet) zum Hosten von Add-Ins verwendet werden, wie in diesem Artikel erläutert. Internet Explorer 11 wurde in Windows 10 und Windows 11 im Februar 2023 deaktiviert, und die Benutzeroberfläche zum Starten wurde entfernt. Auf diesen Betriebssystemen ist sie jedoch weiterhin installiert. Daher können Trident und andere Funktionen aus dem Internet Explorer weiterhin programmgesteuert von Office aufgerufen werden.

Es wird empfohlen (aber nicht erforderlich), dass Sie diese Kombinationen weiterhin unterstützen, zumindest auf minimale Weise, indem Sie Benutzern Ihres Add-Ins eine ordnungsgemäße Fehlermeldung bereitstellen, wenn Ihr Add-In in einer dieser Webviews gestartet wird. Beachten Sie diese zusätzlichen Punkte:

Office im Web wird nicht mehr in internet Explorer oder Vorgängerversion von Microsoft Edge geöffnet. Daher testet AppSource keine Add-Ins in Office im Web in diesen Browsern.
AppSource testet weiterhin auf Kombinationen von Plattform- und Office-Desktopversionen , die Trident oder EdgeHTML verwenden. Es gibt jedoch nur eine Warnung aus, wenn das Add-In diese Webansichten nicht unterstützt. Das Add-In wird von AppSource nicht abgelehnt.
Trident wird vom tool Script Lab nicht mehr unterstützt.

Weitere Informationen zur Unterstützung von Trident oder EdgeHTML, einschließlich der Konfiguration einer ordnungsgemäßen Fehlermeldung in Ihrem Add-In, finden Sie unter Unterstützen älterer Microsoft-Webansichten und Office-Versionen.

In den folgenden Abschnitten wird angegeben, welcher Browser für die verschiedenen Plattformen und Betriebssysteme verwendet wird.

Nicht-Windows-Plattformen

Für diese Plattformen bestimmt allein die Plattform den verwendeten Browser.

Betriebssystem	Office-Version	Browser
Beliebiger Wert	Office im Web	Der Browser, in dem Office geöffnet wird. (Beachten Sie jedoch, dass Office im Web nicht im Internet Explorer geöffnet wird. Wenn Sie dies versuchen, wird Office im Web in Edge geöffnet.)
Mac	Beliebiger Wert	Safari mit WKWebView
iOS	Beliebiger Wert	Safari mit WKWebView
Android	Beliebiger Wert	Chrome

Wichtig

Bedingter Zugriff wird für Office-Add-Ins unter iOS oder Android nicht unterstützt. Diese Add-Ins verwenden die Safari-basierte WKWebView oder die Android-basierte WebView, kein Edge-basiertes Browsersteuerelement.

Windows

Ein Unter Windows ausgeführtes Add-In kann eine von drei verschiedenen Webansichten verwenden:

WebView2, das von Microsoft Edge (Chromium-basiert) bereitgestellt wird.
EdgeHTML, das von Vorgängerversion von Microsoft Edge bereitgestellt wird.
Trident+, das von Internet Explorer 11 bereitgestellt wird. Das "+" am Ende gibt an, dass Office-Add-Ins zusätzliche Funktionen aus dem Internet Explorer 11 verwenden, die nicht in Trident selbst integriert sind.

Unbefristete Versionen von Office unter Windows

Bei unbefristeten Versionen von Office unter Windows wird der verwendete Browser von der Office-Version bestimmt, ob die Lizenz einzelhandels- oder volumenlizenziert ist und ob Edge WebView2 (Chromium-basiert) installiert ist. Die Version von Windows spielt keine Rolle, aber beachten Sie, dass Office-Web-Add-Ins unter früheren Versionen als Windows 7 nicht unterstützt werden und Office 2021 für Frühere versionen als Windows 10 nicht unterstützt wird.

Um zu bestimmen, ob Office 2016 oder Office 2019 einzelhandels- oder volumenlizenziert ist, verwenden Sie das Format der Office-Version und der Buildnummer. (Bei Office 2013 und Office 2021 spielt die Unterscheidung zwischen Volumenlizenz und Einzelhandel keine Rolle.)

Einzelhandel: Für Office 2016 und 2019 lautet YYMM (xxxxx.xxxxxx)das Format , das mit zwei Blöcken mit fünf Ziffern endet, 2206 (Build 15330.20264)z. B. .
Volumenlizenzierung:
- Für Office 2016 ist 16.0.xxxx.xxxxxdas Format , das mit zwei Blöcken mit vier Ziffern endet, 16.0.5197.1000z. B. .
- Für Office 2019 ist 1808 (xxxxx.xxxxxx)das Format , das mit zwei Blöcken mit fünf Ziffern endet, 1808 (Build 10388.20027)z. B. . Beachten Sie, dass das Jahr und der Monat immer 1808sind.

Office-Version	Einzelhandel im Vergleich zu Volumenlizenzen	WebView2 ist installiert?	Browser
Office 2021	Spielt keine Rolle	Ja¹	WebView2 (Microsoft Edge² Chromium-basiert)
Office 2019	Einzelhandel	Ja¹	WebView2 (Microsoft Edge² Chromium-basiert)
Office 2019	Einzelhandel	Nein	EdgeHTML (Vorgängerversion von Microsoft Edge)^{2, 3} Wenn Edge nicht installiert ist, wird Trident+ (Internet Explorer 11) verwendet.
Office 2019	Volumenlizenzierung	Spielt keine Rolle	Trident+ (Internet Explorer 11)
Office 2016	Einzelhandel	Ja¹	WebView2 (Microsoft Edge² Chromium-basiert)
Office 2016	Einzelhandel	Nein	EdgeHTML (Vorgängerversion von Microsoft Edge)^{2, 3} Wenn Edge nicht installiert ist, wird Trident+ (Internet Explorer 11) verwendet.
Office 2016	Volumenlizenzierung	Spielt keine Rolle	Trident+ (Internet Explorer 11)
Office 2013	Spielt keine Rolle	Spielt keine Rolle	Trident+ (Internet Explorer 11)

¹ Bei Windows-Versionen vor Windows 11 muss das WebView2-Steuerelement installiert werden, damit Es von Office eingebettet werden kann. Es wird mit unbefristeter Office 2021 oder höher installiert, aber es wird nicht automatisch mit Microsoft Edge installiert. Wenn Sie über eine frühere Version von unbefristeter Office verfügen, verwenden Sie die Anweisungen zum Installieren des Steuerelements unter Microsoft Edge WebView2 / Webinhalte einbetten ... mit Microsoft Edge WebView2.

² Wenn Sie EdgeHTML oder WebView2 verwenden, liest die Windows-Sprachausgabe (manchmal auch als "Sprachausgabe" bezeichnet) das <title> Tag auf der Seite, die im Aufgabenbereich geöffnet wird. In Trident+ liest die Sprachausgabe die Titelleiste des Aufgabenbereichs, die aus dem Add-In-Namen stammt, der im Manifest des Add-Ins angegeben ist.

³ Wenn Ihr Add-In ein XML-Manifest verwendet und das <Runtimes-Element> in das Manifest einschließt oder das vereinheitlichte Manifest verwendet wird und eine "extensions.runtimes.lifetime"-Eigenschaft enthält, wird EdgeHTML nicht verwendet. Wenn die Bedingungen für die Verwendung von WebView2 erfüllt sind, verwendet das Add-In WebView2. Andernfalls wird Trident+ verwendet. Weitere Informationen finden Sie unter Runtimes und Konfigurieren Ihres Outlook-Add-Ins für die ereignisbasierte Aktivierung.

Microsoft 365-Abonnementversionen von Office unter Windows

Für das Office-Abonnement unter Windows wird der verwendete Browser durch das Betriebssystem, die Office-Version und die Installation des WebView2-Steuerelements bestimmt.

Betriebssystem	Office-Version	WebView2 ist installiert?	Browser
Windows 11, Windows 10, Windows 8.1, Windows Server 2022, Windows Server 2019, Windows Server 2016	Microsoft 365 ver. >= 16.0.13530.20424¹	Ja²	WebView2 (Microsoft Edge³ Chromium-basiert)
Fenster 11, Windows 10-Version >= 1903	Microsoft 365 ver. >= 16.0.13530.20424¹	Nein	EdgeHTML (Vorgängerversion von Microsoft Edge)^{3, 4}
Windows 11, Windows 10-Version >= 1903	Microsoft 365 ver. >= 16.0.11629 UND< 16.0.13530.20424¹	Spielt keine Rolle	EdgeHTML (Vorgängerversion von Microsoft Edge)^{3, 4}
Windows 11, Windows 10-Version >= 1903	Microsoft 365 ver. < 16.0.11629¹	Spielt keine Rolle	Trident+ (Internet Explorer 11)
Windows 10-Version < 1903, Windows 8.1	Microsoft 365	Nein	Trident+ (Internet Explorer 11)
Windows 7	Microsoft 365	Spielt keine Rolle	Trident+ (Internet Explorer 11)

¹ Weitere Informationen finden Sie auf der Seite mit dem Updateverlauf und unter Ermitteln der Office-Clientversion und des Updatekanals .

² Unter Windows-Versionen vor Windows 11 muss das WebView2-Steuerelement installiert sein, damit Es von Office eingebettet werden kann. Es wird mit Microsoft 365, Version 2101 oder höher, aber nicht automatisch mit Microsoft Edge installiert. Wenn Sie über eine frühere Version von Microsoft 365 verfügen, verwenden Sie die Anweisungen zum Installieren des Steuerelements unter Microsoft Edge WebView2 / Webinhalte einbetten ... mit Microsoft Edge WebView2. Bei Microsoft 365-Builds vor 16.0.14326.xxxxx müssen Sie auch den Registrierungsschlüssel HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\16.0\WEF\Win32WebView2 erstellen und seinen Wert auf dword:00000001festlegen.

³ Wenn Sie EdgeHTML oder WebView2 verwenden, liest die Windows-Sprachausgabe (manchmal auch als "Sprachausgabe" bezeichnet) das <title> Tag auf der Seite, die im Aufgabenbereich geöffnet wird. In Trident+ liest die Sprachausgabe die Titelleiste des Aufgabenbereichs, die aus dem Add-In-Namen stammt, der im Manifest des Add-Ins angegeben ist.

⁴ Wenn Ihr Add-In ein XML-Manifest verwendet und das <Runtimes-Element> in das Manifest einschließt, oder wenn es das einheitliche Manifest verwendet und eine Eigenschaft "extensions.runtimes.lifetime" enthält, wird EdgeHTML nicht verwendet. Wenn die Bedingungen für die Verwendung von WebView2 erfüllt sind, verwendet das Add-In WebView2. Andernfalls wird Trident+ verwendet. Weitere Informationen finden Sie unter Runtimes und Konfigurieren Ihres Outlook-Add-Ins für die ereignisbasierte Aktivierung.

Arbeiten mit Trident+ (Internet Explorer 11)

Trident+ unterstützt keine JavaScript-Versionen höher als ES5. Wenn einer Ihrer Add-In-Benutzer über Plattformen verfügt, die Trident+ verwenden, haben Sie zwei Möglichkeiten, die Syntax und Features von ECMAScript 2015 oder höher zu verwenden.

Schreiben Sie Ihren Code in ECMAScript 2015 (auch als ES6 bezeichnet) oder höher javaScript oder in TypeScript, und kompilieren Sie Ihren Code dann mit einem Compiler wie babel oder tsc in ES5 JavaScript.
Schreiben Sie in ECMAScript 2015 oder höher JavaScript, aber laden Sie auch eine Polyfill-Bibliothek wie core-js , die es IE ermöglicht, Ihren Code auszuführen.

Weitere Informationen zu diesen Optionen finden Sie unter Unterstützung älterer Microsoft-Webansichten und Office-Versionen.

Außerdem unterstützt Trident+ einige HTML5-Features wie Medien, Aufzeichnungen und Speicherorte nicht. Weitere Informationen finden Sie unter Bestimmen der Webansicht, in der das Add-In zur Laufzeit ausgeführt wird.

Behandeln von Problemen mit EdgeHTML und WebView2 (Microsoft Edge)

ServiceMitarbeiter funktionieren nicht

Office-Add-Ins unterstützen keine Service Worker, wenn EdgeHTML verwendet wird. Sie werden mit WebView2 unterstützt.

Scrollleiste wird nicht im Aufgabenbereich angezeigt

Standardmäßig sind Bildlaufleisten in EdgeHTML und WebView2 ausgeblendet, bis der Mauszeiger angezeigt wird. Um sicherzustellen, dass die Scrollleiste immer angezeigt wird, sollte das auf das <body>-Element der Seiten im Aufgabenbereich angewendete CSS-Format die Eigenschaft -ms-overflow-style enthalten und auf scrollbar festgelegt sein.

Beim Debuggen mit Microsoft Edge DevTools stürzt das Add-In ab oder wird neu geladen.

Das Festlegen von Haltepunkten in den Microsoft Edge DevTools für EdgeHTML kann dazu führen, dass Office denkt, dass das Add-In nicht mehr vorhanden ist. In diesem Fall wird das Add-In automatisch neu geladen. Um dies zu verhindern, fügen Sie den folgenden Registrierungsschlüssel und -wert zum Entwicklungscomputer hinzu: [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\16.0\Wef]"AlertInterval"=dword:00000000.

Wenn versucht wird, das Add-In zu öffnen, wird die Fehlermeldung "ADD-IN-FEHLER: Add-In kann von localhost nicht geöffnet werden" angezeigt.

Eine bekannte Ursache ist, dass EdgeHTML erfordert, dass localhost eine Loopback-Ausnahme auf dem Entwicklungscomputer erhalten muss. Folgen Sie den Anweisungen unter Add-In kann von localhost nicht geöffnet werden.

Abrufen von Fehlern beim Herunterladen einer PDF-Datei

Das direkte Herunterladen von Blobs als PDF-Dateien in einem Add-In wird mit EdgeHTML oder WebView2 nicht unterstützt. Die Problemumgehung besteht darin, eine einfache Webanwendung zu erstellen, die Blobs als PDF-Dateien herunterlädt. Rufen Sie in Ihrem Add-In die Office.context.ui.openBrowserWindow(url) -Methode auf, und übergeben Sie die URL der Webanwendung. Dadurch wird die Webanwendung in einem Browserfenster außerhalb von Office geöffnet.

WIP-geschützte Dokumente

Es ist ein zusätzlicher Schritt erforderlich, damit Add-Ins in einem Dokument mit WIP (Windows Information Protection) ausgeführt und WebView2 (Microsoft Edge Chromium-basiert) verwendet werden können. Fügen Sie den WebView2-Prozess msedgewebview2.exeder Liste der geschützten Apps in der WIP-Richtlinie Ihres Unternehmens hinzu. Ein Administrator fügt diese WIP-Richtlinie über Intune mit den folgenden Werten hinzu.

Name: Webview2
Herausgeber: O=MICROSOFT CORPORATION, L=REDMOND, S=WASHINGTON, C=US
Produktname: MICROSOFT EDGE WEBVIEW2
Datei: MSEDGEWEBVIEW2.EXE
Mindestversion: *
Max Version: *

Wenn die WIP-Richtlinie nicht hinzugefügt wurde, verwendet das Add-In standardmäßig eine ältere Laufzeit. Ersetzen Sie in den Abschnitten Unbefristete Versionen von Office unter Windows und Microsoft 365-Abonnementversionen von Office unter Windows weiter oben in diesem Artikel EdgeHTML (Vorgängerversion von Microsoft Edge) durch WebView2 (Microsoft Edge Chromium-based), wo letzteres angezeigt wird.

Führen Sie die folgenden Schritte aus, um festzustellen, ob ein Dokument WIP-geschützt ist.

Öffnen Sie die Datei.
Wählen Sie im Menüband die Registerkarte Datei aus.
Wählen Sie Info aus.
Im oberen Abschnitt der Info-Seite, direkt unter dem Dateinamen, enthält ein WIP-fähiges Dokument ein Aktenkoffersymbol gefolgt von Managed by Work (...).

Hinweis

Unterstützung für WebView2 in WIP-fähigen Dokumenten wurde mit Build 16.0.16626.20132 hinzugefügt. Wenn Sie einen älteren Build verwenden, verwendet Ihre Runtime standardmäßig EdgeHTML (Vorgängerversion von Microsoft Edge), unabhängig von der Richtlinie.