Exploradores y controles de vista web usados por los complementos de Office

Artículo
04/24/2024

Los complementos de Office son aplicaciones web que se muestran mediante iframes al ejecutarse en Office en la Web. En Office para clientes de escritorio y móviles, los complementos de Office usan un control de explorador incrustado (también conocido como vista web). Los complementos también necesitan un motor JavaScript para ejecutar el JavaScript. Tanto el explorador incrustado como el motor se suministran mediante un explorador instalado en el equipo del usuario. En este artículo, "webview" hace referencia a la combinación de un control webview y un motor de JavaScript.

La vista web que se usa depende de:

El sistema operativo del equipo.
Si el complemento se ejecuta en Office en la Web, en Office descargado de una suscripción de Microsoft 365 o en Office 2016 perpetuo o posterior.
Dentro de las versiones perpetuas de Office en Windows, si el complemento se ejecuta en la variación "comercial" o "con licencia por volumen".

Importante

Las vistas web de Internet Explorer y Microsoft Edge (versión anterior) todavía se usan en complementos de Office

Algunas combinaciones de plataformas y versiones de Office, incluidas las versiones perpetuas con licencia por volumen a través de Office 2019, siguen usando los controles de vista web que vienen con Internet Explorer 11 (denominado "Trident") y Microsoft Edge (versión anterior) (denominado "EdgeHTML") para hospedar complementos, como se explica en este artículo. Internet Explorer 11 se deshabilitó en Windows 10 y Windows 11 en febrero de 2023, y se quitó la interfaz de usuario para iniciarla; pero sigue instalada en esos sistemas operativos. Por lo tanto, Office todavía puede llamar a Trident y otras funciones de Internet Explorer mediante programación.

Se recomienda (pero no es necesario) que siga admitiendo estas combinaciones, al menos de forma mínima, proporcionando a los usuarios del complemento un mensaje de error correcto cuando el complemento se inicie en una de estas vistas web. Tenga en cuenta estos puntos adicionales:

Office en la Web ya no se abre en Internet Explorer ni en Microsoft Edge (versión anterior). Por lo tanto, AppSource no prueba los complementos en Office en estos exploradores web.
AppSource sigue realizando pruebas para las combinaciones de versiones de escritorio de Office y plataforma que usan Trident o EdgeHTML. Sin embargo, solo emite una advertencia cuando el complemento no admite estas vistas web; AppSource no rechaza el complemento.
La herramienta Script Lab ya no admite Trident.

Para obtener más información sobre cómo admitir Trident o EdgeHTML, incluida la configuración de un mensaje de error correcto en el complemento, consulte Compatibilidad con versiones anteriores de Microsoft WebViews y Office.

En las secciones siguientes se especifica qué explorador se usa para las distintas plataformas y sistemas operativos.

Plataformas que no son de Windows

Para estas plataformas, la plataforma determina por sí sola el explorador que se usa.

SO	Versión de Office	Explorador
cualquiera	Office en la Web	El explorador en el que se abre Office Online. (Pero tenga en cuenta que Office en la Web no se abrirá en Internet Explorer. Al intentar hacerlo, se abre Office en la Web en Edge).
Mac	cualquiera	Safari con WKWebView
iOS	cualquiera	Safari con WKWebView
Android	cualquiera	Chrome

Importante

El acceso condicional no es compatible con los complementos de Office en iOS o Android. Esos complementos usan WKWebView basado en Safari o WebView basado en Android, no un control de explorador basado en Edge.

Windows

Un complemento que se ejecuta en Windows podría usar cualquiera de las tres vistas web diferentes:

WebView2, que proporciona Microsoft Edge (basado en Chromium).
EdgeHTML, que proporciona Microsoft Edge (versión anterior).
Trident+, que proporciona Internet Explorer 11. "+" al final indica que los complementos de Office usan funcionalidad adicional de Internet Explorer 11 que no está integrada en el propio Trident.

Versiones perpetuas de Office en Windows

En el caso de las versiones perpetuas de Office en Windows, el explorador que se usa viene determinado por la versión de Office, si la licencia es comercial o con licencia por volumen y si edge WebView2 (basado en Chromium) está instalado. La versión de Windows no importa, pero tenga en cuenta que los complementos web de Office no se admiten en versiones anteriores a Windows 7 y Office 2021 no se admiten en versiones anteriores a Windows 10.

Para determinar si Office 2016 u Office 2019 tiene licencia comercial o por volumen, use el formato de la versión de Office y el número de compilación. (Por Office 2021, la distinción entre la licencia por volumen y el comercio minorista no importa).

Retail: para Office 2016 y 2019, el formato es YYMM (xxxxx.xxxxxx), terminando con dos bloques de cinco dígitos; por ejemplo, 2206 (Build 15330.20264).
Licencia por volumen:
- Para Office 2016, el formato es 16.0.xxxx.xxxxx, terminando con dos bloques de cuatro dígitos; por ejemplo, 16.0.5197.1000.
- Para Office 2019, el formato es 1808 (xxxxx.xxxxxx), terminando con dos bloques de cinco dígitos; por ejemplo, 1808 (Build 10388.20027). Tenga en cuenta que el año y el mes siempre 1808son .

Versión de Office	Venta al por menor frente a licencia por volumen	¿WebView2 instalado?	Explorador
Office 2021	No importa	Sí¹	WebView2 (basado en Microsoft Edge² Chromium)
Office 2019	Venta minorista	Sí¹	WebView2 (basado en Microsoft Edge² Chromium)
Office 2019	Venta minorista	No	EdgeHTML (Microsoft Edge (versión anterior))^{2, 3} Si Edge no está instalado, se usa Trident+ (Internet Explorer 11).
Office 2019	Licencia por volumen	No importa	Trident+ (Internet Explorer 11)
Office 2016	Venta minorista	Sí¹	WebView2 (basado en Microsoft Edge² Chromium)
Office 2016	Venta minorista	No	EdgeHTML (Microsoft Edge (versión anterior))^{2, 3} Si Edge no está instalado, se usa Trident+ (Internet Explorer 11).
Office 2016	Licencia por volumen	No importa	Trident+ (Internet Explorer 11)

¹ En las versiones de Windows anteriores a Windows 11, se debe instalar el control WebView2 para que Office pueda insertarlo. Se instala con Office 2021 perpetuas o posteriores, pero no se instala automáticamente con Microsoft Edge. Si tiene una versión anterior de Office perpetua, use las instrucciones para instalar el control en Microsoft Edge WebView2 / Insertar contenido web ... con Microsoft Edge WebView2.

² Al usar EdgeHTML o WebView2, el Narrador de Windows (a veces denominado "lector de pantalla") lee la <title> etiqueta de la página que se abre en el panel de tareas. En Trident+, el Narrador lee la barra de título del panel de tareas, que procede del nombre del complemento especificado en el manifiesto del complemento.

³ Si el complemento usa un manifiesto XML e incluye el <elemento Runtimes> en el manifiesto o usa el manifiesto unificado e incluye una propiedad "extensions.runtimes.lifetime", no usará EdgeHTML. Si se cumplen las condiciones para usar WebView2, el complemento usa WebView2. De lo contrario, usa Trident+. Para obtener más información, vea Runtimes and Configure your Outlook add-in for event-based activation (Entornos en tiempo de ejecución y configurar el complemento de Outlook para la activación basada en eventos).

Versiones de suscripción de Microsoft 365 de Office en Windows

Para la suscripción de Office en Windows, el explorador que se usa viene determinado por el sistema operativo, la versión de Office y si está instalado el control WebView2.

SO	Versión de Office	¿WebView2 instalado?	Explorador
Windows 11, Windows 10, Windows 8.1, Windows Server 2022, Windows Server 2019, Windows Server 2016	Microsoft 365 ver. >= 16.0.13530.20424¹	Sí²	WebView2 (basado en Microsoft Edge³ Chromium)
Ventana 11, Windows 10 versión >= 1903	Microsoft 365 ver. >= 16.0.13530.20424¹	No	EdgeHTML (Microsoft Edge (versión anterior))^{3, 4}
Windows 11, Windows 10 versión >= 1903	Microsoft 365 ver. >= 16.0.11629 Y< 16.0.13530.20424¹	No importa	EdgeHTML (Microsoft Edge (versión anterior))^{3, 4}
Windows 11, Windows 10 versión >= 1903	Microsoft 365 ver. < 16.0.11629¹	No importa	Trident+ (Internet Explorer 11)
Windows 10 versión < 1903, Windows 8.1	Microsoft 365	No	Trident+ (Internet Explorer 11)
Windows 7	Microsoft 365	No importa	Trident+ (Internet Explorer 11)

¹ Vea la página del historial de actualizaciones y cómo encontrar la versión del cliente de Office y el canal de actualización para obtener más detalles.

² En las versiones de Windows anteriores a Windows 11, el control WebView2 debe instalarse para que Office pueda insertarlo. Se instala con Microsoft 365, versión 2101 o posterior, pero no se instala automáticamente con Microsoft Edge. Si tiene una versión anterior de Microsoft 365, use las instrucciones para instalar el control en Microsoft Edge WebView2 / Insertar contenido web ... con Microsoft Edge WebView2. En las compilaciones de Microsoft 365 anteriores a 16.0.14326.xxxxx, también debe crear la clave del Registro HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\16.0\WEF\Win32WebView2 y establecer su valor en dword:00000001.

³ Cuando se usa EdgeHTML o WebView2, el Narrador de Windows (a veces denominado "lector de pantalla") lee la <title> etiqueta de la página que se abre en el panel de tareas. En Trident+, el Narrador lee la barra de título del panel de tareas, que procede del nombre del complemento especificado en el manifiesto del complemento.

⁴ Si el complemento usa un manifiesto XML e incluye el <elemento Runtimes> en el manifiesto o usa el manifiesto unificado e incluye una propiedad "extensions.runtimes.lifetime", no usará EdgeHTML. Si se cumplen las condiciones para usar WebView2, el complemento usa WebView2. De lo contrario, usa Trident+. Para obtener más información, vea Runtimes and Configure your Outlook add-in for event-based activation (Entornos en tiempo de ejecución y configurar el complemento de Outlook para la activación basada en eventos).

Trabajar con Trident+ (Internet Explorer 11)

Trident+ no admite versiones de JavaScript posteriores a ES5. Si alguno de los usuarios del complemento tiene plataformas que usan Trident+, para usar la sintaxis y las características de ECMAScript 2015 o posterior, tiene dos opciones.

Escriba el código en ECMAScript 2015 (también denominado ES6) o en JavaScript posterior, o en TypeScript y, a continuación, compile el código en ES5 JavaScript mediante un compilador como babel o tsc.
Escriba en ECMAScript 2015 o una versión posterior de JavaScript, pero también cargue una biblioteca de polyfill como core-js que permita a IE ejecutar el código.

Para obtener más información sobre estas opciones, consulte Compatibilidad con versiones anteriores de Microsoft WebView y Office.

Además, Trident+ no admite algunas características HTML5, como medios, grabación y ubicación. Para más información, consulte Determinación de la vista web en la que se ejecuta el complemento en tiempo de ejecución.

Solución de problemas de EdgeHTML y WebView2 (Microsoft Edge)

Los trabajadores del servicio no funcionan

Los complementos de Office no admiten trabajadores de servicio cuando se usa EdgeHTML. Se admiten con WebView2.

La barra de desplazamiento no aparece en el panel de tareas

De forma predeterminada, las barras de desplazamiento de EdgeHTML y WebView2 se ocultan hasta que se mantiene el puntero sobre. Para asegurarse de que la barra de desplazamiento esté siempre visible, el estilo CSS que se aplica al <body> elemento de las páginas en el panel de tareas debe incluir la propiedad -ms-overflow-style y debe establecerse en scrollbar.

Al depurar con Microsoft Edge DevTools, el complemento se bloquea o se vuelve a cargar

Establecer puntos de interrupción en Microsoft Edge DevTools para EdgeHTML puede hacer que Office piense que el complemento está bloqueado. Se recargará automáticamente el complemento cuando esto suceda. Para evitar esto, agregue la siguiente clave y valor del registro al equipo de desarrollo: [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\16.0\Wef]"AlertInterval"=dword:00000000.

Cuando se intenta abrir el complemento, aparece el error "ERROR DE COMPLEMENTO no se puede abrir este complemento desde localhost".

Una causa conocida es que EdgeHTML requiere que localhost tenga una exención de bucle invertido en el equipo de desarrollo. Siga las instrucciones que aparecen en No se puede abrir el complemento desde localhost.

Obtención de errores al intentar descargar un archivo PDF

No se admite la descarga directa de blobs como archivos PDF en un complemento con EdgeHTML o WebView2. La solución alternativa consiste en crear una aplicación web sencilla que descargue blobs como archivos PDF. En el complemento, llame al Office.context.ui.openBrowserWindow(url) método y pase la dirección URL de la aplicación web. Se abrirá la aplicación web en una ventana del explorador fuera de Office.

Documentos protegidos por WIP

Hay un paso adicional necesario para que los complementos se ejecuten en un documento con WIP (Windows Information Protection) y usen WebView2 (basado en Microsoft Edge Chromium). Agregue el proceso WebView2, msedgewebview2.exe, a la lista de aplicaciones protegidas de la directiva WIP de la empresa. Un administrador agrega esta directiva WIP a través de Intune con los siguientes valores.

Nombre: Webview2
Publicador: O=MICROSOFT CORPORATION, L=REDMOND, S=WASHINGTON, C=US
Nombre del producto: MICROSOFT EDGE WEBVIEW2
Archivo: MSEDGEWEBVIEW2.EXE
Versión mínima: *
Versión máxima: *

Si no se ha agregado la directiva WIP, el complemento tiene como valor predeterminado un entorno de ejecución anterior. En las secciones Versiones perpetuas de Office en Windows y las versiones de suscripción de Microsoft 365 de Office en Windows anteriormente en este artículo, sustituya EdgeHTML (Microsoft Edge (versión anterior)) por WebView2 (basado en microsoft edge Chromium) dondequiera que aparezca este último.

Para determinar si un documento está protegido con WIP, siga estos pasos.

Abra el archivo.
Seleccione la pestaña Archivo en la cinta de opciones.
Seleccione Información.
En la sección superior de la página Información , justo debajo del nombre de archivo, un documento habilitado para WIP tendrá un icono de maletín seguido de Administrado por trabajo (...).

Nota:

Se agregó compatibilidad con WebView2 en documentos habilitados para WIP con la compilación 16.0.16626.20132. Si está en una compilación anterior, el entorno de ejecución tiene como valor predeterminado EdgeHTML (Microsoft Edge (versión anterior)), independientemente de la directiva.