Prueba del complemento de Office en Trident

  • Artículo

Si tiene previsto admitir versiones anteriores de Windows y Office, el complemento debe funcionar en el control de explorador incrustable denominado "Trident" proporcionado por Internet Explorer 11. Puede usar una línea de comandos para cambiar de una vista web más moderna usada por los complementos a Trident para esta prueba. Para obtener información sobre qué versiones de Windows y Office usan el control webview de Internet Explorer 11, vea Exploradores y controles de vista web que usan los complementos de Office. En este artículo, "webview" hace referencia a la combinación de un control webview y un motor de JavaScript.

Importante

Las vistas web de Internet Explorer y Microsoft Edge heredado 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 Legacy (denominado "EdgeHTML") para hospedar complementos, como se explica en Exploradores y controles de vista web usados por complementos de Office. 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 todavía está instalado en con 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 admita 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 estas vistas web. Tenga en cuenta estos puntos adicionales:

  • Office en la web ya no se abre en Internet Explorer o Microsoft Edge Heredado. Por lo tanto, AppSource no prueba los complementos en Office en la web en estos exploradores.
  • 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.

Si tiene previsto admitir versiones anteriores de Windows y Office, el complemento debe funcionar en el control de explorador incrustable denominado "Trident" proporcionado por Internet Explorer 11. Puede usar una línea de comandos para cambiar de una vista web más moderna usada por los complementos a Trident para esta prueba. Para obtener información sobre qué versiones de Windows y Office usan el control webview de Internet Explorer 11, vea Exploradores y controles de vista web que usan los complementos de Office.

Importante

Trident no admite versiones de JavaScript posteriores a ES5. Si desea usar la sintaxis y las características de ECMAScript 2015 o posterior, tiene que usar un transpilador, un polyfill o ambos. 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.

Nota:

  • Office en la web no se puede abrir en Internet Explorer 11, por lo que no puede (y no es necesario) probar el complemento en Office en la web con Internet Explorer.

  • Para que los complementos de Office Web funcionen, se debe desactivar la configuración de seguridad mejorada de Internet Explorer (ESC). Si usa un equipo con Windows Server como cliente al desarrollar complementos, tenga en cuenta que ESC está activado de forma predeterminada en Windows Server.

Cambiar a la vista web tridente

Sugerencia

En las versiones recientes de Office, una manera de identificar el control de vista web que usa Office es a través del menú de personalidad en cualquier complemento donde esté disponible. (El menú personalidad no se admite en Outlook). Abra el menú y seleccione Información de seguridad. En el cuadro de diálogo Información de seguridad de Windows , runtime notificaMicrosoft Edge, Microsoft Edge Heredado o Internet Explorer. El tiempo de ejecución no se incluye en el cuadro de diálogo en versiones anteriores de Office.

Hay dos maneras de cambiar la vista web trident. Puede ejecutar un comando simple en un símbolo del sistema o puede instalar una versión de Office que use Trident de forma predeterminada. Se recomienda el primer método, pero debe usar el segundo en los escenarios siguientes.

  • El proyecto se desarrolló con Visual Studio e IIS. No se basa en Node.js.
  • Quiere ser absolutamente sólido en las pruebas.
  • No puede usar el canal Beta para Microsoft 365 en el equipo de desarrollo.
  • Estás desarrollando en un Equipo Mac.
  • Si por algún motivo la herramienta de línea de comandos no funciona.

Cambiar a través de la línea de comandos

Si el proyecto está basado en Node.js (es decir, no desarrollado con Visual Studio e Internet Information Server (IIS)), puede forzar a Office en Windows a usar el control webview EdgeHTML proporcionado por Edge Legacy o el control webview Trident proporcionado por Internet Explorer para ejecutar complementos, incluso si tiene una combinación de versiones de Windows y Office que normalmente usarían una vista web más reciente. Para obtener más información sobre qué exploradores y vistas web usan varias combinaciones de versiones de Windows y Office, vea Exploradores y controles de vista web que usan los complementos de Office.

Nota:

La herramienta que se usa para forzar el cambio en la vista web solo se admite en el canal de suscripción Beta de Microsoft 365. Únase al programa Microsoft 365 Insider y seleccione la opción Canal beta para acceder a las compilaciones de Office Beta. Vea también Acerca de Office: ¿Qué versión de Office estoy usando?.

Estrictamente, es el webview cambio de esta herramienta (consulte el paso 2) el que requiere el canal Beta. La herramienta tiene otros modificadores que no tienen este requisito.

  1. Si el proyecto no se creó con la herramienta generador de Yeoman para complementos de Office , debe instalar la herramienta office-addin-dev-settings. Ejecute el siguiente comando en un símbolo del sistema.

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

    Importante

    La herramienta office-addin-dev-settings no se admite en Mac.

  2. Especifique la vista web que quiere que Office use con el siguiente comando en un símbolo del sistema en la raíz del proyecto. Reemplace por <path-to-manifest> la ruta de acceso relativa, que es solo el nombre de archivo del manifiesto si está en la raíz del proyecto. Reemplace por <webview> o ieedge-legacy. Tenga en cuenta que las opciones tienen el nombre de los exploradores en los que se originaron las vistas web. La ie opción significa "Trident" y la edge-legacy opción significa "EdgeHTML".

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

    Estos son algunos ejemplos.

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

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

    Debería ver un mensaje en la línea de comandos que indica que el tipo de vista web ahora está establecido en IE (o Edge Legacy).

  3. Cuando haya terminado, establezca Office para reanudar el uso de la vista web predeterminada para la combinación de versiones de Windows y Office con el siguiente comando.

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

Instalación de una versión de Office que usa Internet Explorer

Use el procedimiento siguiente para instalar una versión de Office (descargada desde una suscripción de Microsoft 365) que use la vista web heredada de Microsoft Edge (EdgeHTML) para ejecutar complementos o una versión que use Internet Explorer (Trident).

  1. En cualquier aplicación de Office, abra la pestaña Archivo en la cinta de opciones y, a continuación, seleccione Cuenta de Office o Cuenta. Seleccione el botón Acerca del nombre de host (por ejemplo, Acerca de Word).

  2. En el cuadro de diálogo que se abre, busque el número de compilación xx.x.xxxxx.xxxxx completo y haga una copia de él en algún lugar.

  3. Descargar la Herramienta de implementación de Office.

  4. Ejecute el archivo descargado para extraer la herramienta. Se le pedirá que elija dónde instalar la herramienta.

  5. En la carpeta donde instaló la herramienta (donde se encuentra el setup.exe archivo), cree un archivo de texto con el nombre config.xml y agregue el siguiente contenido.

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

  6. Cambie el Version valor.

    • Para instalar una versión que usa EdgeHTML, cámbiela a 16.0.11929.20946.
    • Para instalar una versión que use Trident, cámbiela a 16.0.10730.20348.

  7. Opcionalmente, cambie el valor de OfficeClientEdition a "32" para instalar Office de 32 bits y cambie el Language ID valor según sea necesario para instalar Office en otro idioma.

  8. Abra un símbolo del sistema como administrador.

  9. Vaya a la carpeta con los setup.exe archivos y config.xml .

  10. Ejecuta el siguiente comando.

    setup.exe /configure config.xml

    Este comando instala Office. Es posible que este proceso tarde varios minutos.

  11. Borre la memoria caché de Office.

Importante

Después de la instalación, asegúrese de desactivar la actualización automática de Office, para que Office no se actualice a una versión que no use la vista web con la que desea trabajar antes de completar su uso. Esto puede ocurrir en cuestión de minutos después de la instalación. Siga estos pasos.

  1. Inicie cualquier aplicación de Office y abra un nuevo documento.
  2. Abra la pestaña Archivo en la cinta de opciones y, a continuación, seleccione Cuenta de Office o Cuenta.
  3. En la columna Información del producto , seleccione Opciones de actualización y, a continuación, deshabilitar actualizaciones. Si esa opción no está disponible, Office ya está configurado para no actualizarse automáticamente.

Cuando haya terminado de usar la versión anterior de Office, vuelva a instalar la versión más reciente editando el config.xml archivo y cambiando al Version número de compilación que copió anteriormente. A continuación, repita el setup.exe /configure config.xml comando en un símbolo del sistema de administrador. Opcionalmente, vuelva a habilitar las actualizaciones automáticas.

Vea también