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

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".

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.

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 de Office no se admiten en versiones anteriores a Windows 7 y Office 2021 y versiones posteriores 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. (Para Office 2021 y versiones posteriores, 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 .

¹ 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 de solo complemento 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.

¹ 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 de solo complemento 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.

1. Abra el archivo.
2. Seleccione la pestaña Archivo en la cinta de opciones.
3. Seleccione Información.
4. 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 (...).

Vea también

• Requisitos para ejecutar complementos de Office
• Tiempos de ejecución en complementos de Office