Freigeben über

Testen Ihres Office-Add-Ins auf Trident

  • Artikel

Wenn Sie ältere Versionen von Windows und Office unterstützen möchten, muss Ihr Add-In im einbettbaren Browsersteuerelement namens "Trident" funktionieren, das von Internet Explorer 11 bereitgestellt wird. Sie können eine Befehlszeile verwenden, um von einer moderneren Webansicht, die von Add-Ins verwendet wird, zu Trident für diesen Test zu wechseln. Informationen dazu, welche Versionen von Windows und Office das Webview-Steuerelement von Internet Explorer 11 verwenden, finden Sie unter Browser und Webview-Steuerelemente, die von Office-Add-Ins verwendet werden. In diesem Artikel bezieht sich "Webview" auf die Kombination aus einem Webview-Steuerelement und einer JavaScript-Engine.

Wichtig

Webviews von Internet Explorer und Microsoft Edge Legacy 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 in Internet Explorer 11 (als "Trident" bezeichnet) und Microsoft Edge Legacy (als "EdgeHTML" bezeichnet) zum Hosten von Add-Ins verwendet werden, wie unter Browser und Webview-Steuerelemente von Office-Add-Ins erläutert. Internet Explorer 11 wurde in Windows 10 und Windows 11 im Februar 2023 deaktiviert, und die Benutzeroberfläche zum Starten wurde entfernt. aber es ist immer noch mit diesen Betriebssystemen installiert. Daher können Trident und andere Funktionen von Internet Explorer weiterhin programmgesteuert von Office aufgerufen werden.

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

  • Office im Web wird nicht mehr in Internet Explorer oder Microsoft Edge Legacy geöffnet. Daher testet AppSource keine Add-Ins in Office im Web auf 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 Skript-Lab-Tool nicht mehr unterstützt.

Wenn Sie ältere Versionen von Windows und Office unterstützen möchten, muss Ihr Add-In im einbettbaren Browsersteuerelement namens "Trident" funktionieren, das von Internet Explorer 11 bereitgestellt wird. Sie können eine Befehlszeile verwenden, um von einer moderneren Webansicht, die von Add-Ins verwendet wird, zu Trident für diesen Test zu wechseln. Informationen dazu, welche Versionen von Windows und Office das Webview-Steuerelement von Internet Explorer 11 verwenden, finden Sie unter Browser und Webview-Steuerelemente, die von Office-Add-Ins verwendet werden.

Wichtig

Trident unterstützt keine JavaScript-Versionen höher als ES5. Wenn Sie die Syntax und die Features von ECMAScript 2015 oder höher verwenden möchten, müssen Sie ein Transpiler oder Polyfill oder beides verwenden. 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.

Hinweis

  • Office im Web kann in Internet Explorer 11 nicht geöffnet werden, sodass Sie Ihr Add-In nicht in Office im Web mit Internet Explorer testen können (und müssen es auch nicht).

  • Die Verstärkte Sicherheitskonfiguration (ESC) für Internet Explorer muss für Office-Web-Add-Ins deaktiviert werden, um die Funktion zu gewährleisten. Wenn Sie beim Entwickeln von Add-Ins einen Windows Server-Computer als Client verwenden, beachten Sie, dass ESC in Windows Server standardmäßig aktiviert ist.

Wechseln zur Trident-Webansicht

Tipp

In neueren Versionen von Office besteht eine Möglichkeit zum Identifizieren des von Office verwendeten Webview-Steuerelements im Persönlichkeitsmenü eines beliebigen Add-Ins, in dem es verfügbar ist. (Das Persönlichkeitsmenü wird in Outlook nicht unterstützt.) Öffnen Sie das Menü, und wählen Sie Sicherheitsinformationen aus. Im Dialogfeld Sicherheitsinformationen unter Windows meldet die RuntimeMicrosoft Edge, Microsoft Edge Legacy oder Internet Explorer. Die Runtime ist in älteren Versionen von Office nicht im Dialogfeld enthalten.

Es gibt zwei Möglichkeiten, die Trident-Webansicht zu wechseln. Sie können einen einfachen Befehl an einer Eingabeaufforderung ausführen, oder Sie können eine Version von Office installieren, die trident standardmäßig verwendet. Wir empfehlen die erste Methode, aber Sie sollten die zweite in den folgenden Szenarien verwenden.

  • Ihr Projekt wurde mit Visual Studio und IIS entwickelt. Es ist nicht Node.js basiert.
  • Sie möchten bei Ihren Tests absolut robust sein.
  • Sie können den Betakanal für Microsoft 365 nicht auf Ihrem Entwicklungscomputer verwenden.
  • Sie entwickeln auf einem Mac.
  • Wenn das Befehlszeilentool aus irgendeinem Grund nicht funktioniert.

Wechseln über die Befehlszeile

Wenn Ihr Projekt Node.js basiert (d. h. nicht mit Visual Studio und internetinformationsserver (IIS) entwickelt wurde), können Sie erzwingen, dass Office unter Windows entweder das EdgeHTML-Webview-Steuerelement verwendet, das von Edge Legacy bereitgestellt wird, oder das Trident-Webview-Steuerelement, das von Internet Explorer zum Ausführen von Add-Ins bereitgestellt wird, auch wenn Sie über eine Kombination aus Windows- und Office-Versionen verfügen, die normalerweise eine neuere Webansicht verwenden würden. Weitere Informationen dazu, welche Browser und Webviews von verschiedenen Kombinationen von Windows- und Office-Versionen verwendet werden, finden Sie unter Browser und Webview-Steuerelemente, die von Office-Add-Ins verwendet werden.

Hinweis

Das Tool, das verwendet wird, um die Änderung in der Webansicht zu erzwingen, wird nur im Beta-Abonnementkanal von Microsoft 365 unterstützt. Treten Sie dem Microsoft 365 Insider-Programm bei, und wählen Sie die Option Betakanal aus, um auf Office Beta-Builds zuzugreifen. Siehe auch Informationen zu Office: Welche Version von Office verwende ich?.

Streng genommen ist es die webview Umstellung dieses Tools (siehe Schritt 2), die den Beta-Kanal erfordert. Das Tool verfügt über andere Schalter, die diese Anforderung nicht erfüllen.

  1. Wenn Ihr Projekt nicht mit dem Yeoman-Generator für Office-Add-Ins erstellt wurde, müssen Sie das Tool office-addin-dev-settings installieren. Führen Sie den folgenden Befehl an einer Eingabeaufforderung aus.

    npm install office-addin-dev-settings --save-dev

    Wichtig

    Das Tool office-addin-dev-settings wird unter Mac nicht unterstützt.

  2. Geben Sie die Webansicht an, die Office verwenden soll, mit dem folgenden Befehl in einer Eingabeaufforderung im Stammverzeichnis des Projekts. Ersetzen Sie durch <path-to-manifest> den relativen Pfad, bei dem es sich nur um den Manifestdateinamen handelt, wenn er sich im Stammverzeichnis des Projekts befindet. Ersetzen Sie <webview> durch ie oder edge-legacy. Beachten Sie, dass die Optionen nach den Browsern benannt sind, in denen die Webansichten entstanden sind. Die ie Option bedeutet "Trident" und die edge-legacy Option bedeutet "EdgeHTML".

    npx office-addin-dev-settings webview <path-to-manifest> <webview>

    Es folgen einige Beispiele.

    npx office-addin-dev-settings webview manifest.xml ie

    npx office-addin-dev-settings webview manifest.json edge-legacy

    In der Befehlszeile sollte eine Meldung angezeigt werden, dass der Webview-Typ jetzt auf IE (oder Edge Legacy) festgelegt ist.

  3. Wenn Sie fertig sind, legen Sie mit dem folgenden Befehl fest, dass Office mit der Standardwebansicht für Ihre Kombination aus Windows- und Office-Versionen fortgesetzt wird.

    npx office-addin-dev-settings webview <path-to-manifest> default

Installieren einer Office-Version, die Internet Explorer verwendet

Verwenden Sie das folgende Verfahren, um entweder eine Version von Office (heruntergeladen aus einem Microsoft 365-Abonnement) zu installieren, die die Microsoft Edge Legacy Webview (EdgeHTML) zum Ausführen von Add-Ins verwendet, oder eine Version, die Internet Explorer (Trident) verwendet.

  1. Öffnen Sie in einer beliebigen Office-Anwendung die Registerkarte Datei im Menüband, und wählen Sie dann Office-Konto oder Konto aus. Wählen Sie die Schaltfläche About host-name (z. B . About Word) aus.

  2. Suchen Sie im daraufhin geöffneten Dialogfeld die vollständige Buildnummer xx.x.xxxxx.xxxxx, und erstellen Sie irgendwo eine Kopie davon.

  3. Laden Sie das Office-Bereitstellungstool herunter.

  4. Führen Sie die heruntergeladene Datei aus, um das Tool zu extrahieren. Sie werden aufgefordert, auszuwählen, wo das Tool installiert werden soll.

  5. Erstellen Sie in dem Ordner, in dem Sie das Tool installiert haben (in dem sich die setup.exe Datei befindet), eine Textdatei mit dem Namen config.xml , und fügen Sie den folgenden Inhalt hinzu.

    <Configuration>
  <Add OfficeClientEdition="64" Channel="SemiAnnual" Version="16.0.xxxxx.xxxxx">
    <Product ID="O365ProPlusRetail">
      <Language ID="en-us" />
    </Product>
  </Add>
</Configuration>

  6. Ändern Sie den Version Wert.

    • Um eine Version zu installieren, die EdgeHTML verwendet, ändern Sie sie in 16.0.11929.20946.
    • Um eine Version zu installieren, die Trident verwendet, ändern Sie sie in 16.0.10730.20348.

  7. Ändern Sie optional den Wert von OfficeClientEdition in "32" , um 32-Bit-Office zu installieren, und ändern Sie den Language ID Wert nach Bedarf, um Office in einer anderen Sprache zu installieren.

  8. Öffnen Sie eine Eingabeaufforderung als Administrator.

  9. Navigieren Sie zu dem Ordner mit den setup.exe Dateien und config.xml .

  10. Führen Sie den folgenden Befehl aus.

    setup.exe /configure config.xml

    Mit diesem Befehl wird Office installiert. Dieser Vorgang kann einige Minuten in Anspruch nehmen.

  11. Löschen Sie den Office-Cache.

Wichtig

Stellen Sie nach der Installation sicher, dass Sie die automatische Aktualisierung von Office deaktivieren, damit Office nicht auf eine Version aktualisiert wird, die keine Webview verwendet, mit der Sie arbeiten möchten, bevor Sie die Verwendung abgeschlossen haben. Dies kann innerhalb weniger Minuten nach der Installation geschehen. Führen Sie die folgenden Schritte aus.

  1. Starten Sie eine beliebige Office-Anwendung, und öffnen Sie ein neues Dokument.
  2. Öffnen Sie im Menüband die Registerkarte Datei , und wählen Sie dann Office-Konto oder Konto aus.
  3. Wählen Sie in der Spalte Produktinformationendie Option Updateoptionen und dann Updates deaktivieren aus. Wenn diese Option nicht verfügbar ist, ist Office bereits so konfiguriert, dass es nicht automatisch aktualisiert wird.

Wenn Sie die alte Version von Office nicht mehr verwenden, installieren Sie Ihre neuere Version neu, indem Sie die config.xml Datei bearbeiten und in die Version zuvor kopierte Buildnummer ändern. Wiederholen Sie dann den setup.exe /configure config.xml Befehl in einer Administratoreingabeaufforderung. Aktivieren Sie optional automatische Updates erneut.

Siehe auch