Carga del DOM y el entorno en tiempo de ejecución

  • Artículo

Antes de ejecutar su propia lógica personalizada, un complemento debe asegurarse de que se cargan tanto el dom como el entorno en tiempo de ejecución de los complementos de Office.

Inicio de un complemento de panel de tareas o de contenido

En la ilustración siguiente se muestra el flujo de eventos relacionados con el inicio de un complemento de panel de tareas o de contenido en Excel, PowerPoint, Project o Word.

Flujo de eventos al iniciar un complemento de contenido o panel de tareas.

Los siguientes eventos se producen cuando se inicia un complemento de contenido o panel de tareas.

  1. El usuario abre un documento que ya contiene un complemento o inserta un complemento en el documento.

  2. La aplicación cliente de Office lee el manifiesto del complemento desde AppSource, un catálogo de aplicaciones en SharePoint o el catálogo de carpetas compartidas desde el que se origina.

  3. La aplicación cliente de Office abre la página HTML del complemento en un control webview.

    Los próximos dos pasos (pasos 4 y 5) se llevan a cabo de manera asincrónica y simultánea. Por este motivo, el código del complemento debe asegurarse de que tanto el DOM como el entorno del tiempo de ejecución del complemento hayan terminado de cargarse antes de continuar.

  4. El control webview carga el dom y el cuerpo HTML, y llama al controlador de eventos para el window.onload evento.

  5. La aplicación cliente de Office carga el entorno en tiempo de ejecución, que descarga y almacena en caché los archivos de biblioteca de la API de JavaScript de Office desde el servidor de red de distribución de contenido (CDN) y, a continuación, llama al controlador de eventos del complemento para el evento de inicialización del objeto de Office , si se le ha asignado un controlador. En este momento, también comprueba si se ha pasado (o encadenado) Office.onReady al controlador cualquier devolución de llamada (o método encadenadothen()). Para obtener más información sobre la distinción entre Office.initialize y Office.onReady, vea Inicializar el complemento.

  6. Cuando el DOM y el cuerpo HTML terminan de cargarse y el complemento termina de inicializarse, la función principal del complemento puede continuar.

Inicio de un complemento de Outlook

En la ilustración siguiente se muestra el flujo de eventos relacionados con el inicio de un complemento de Outlook que se ejecuta en el escritorio, en una tableta o en un smartphone.

Flujo de eventos al iniciar el complemento de Outlook.

Los siguientes eventos se producen cuando se inicia un complemento de Outlook.

  1. Cuando se inicia Outlook, Outlook lee los manifiestos de los complementos de Outlook que se han instalado para la cuenta de correo electrónico del usuario.

  2. El usuario selecciona un elemento en Outlook.

  3. Si el elemento seleccionado cumple las condiciones de activación de un complemento de Outlook, Outlook activa el complemento y muestra el botón en la interfaz de usuario.

  4. Si el usuario hace clic en el botón para iniciar el complemento de Outlook, Outlook abre la página HTML en un control de vista web. Los próximos dos pasos (pasos 5 y 6) se llevan a cabo simultáneamente.

  5. El control webview carga el dom y el cuerpo HTML, y llama al controlador de eventos para el onload evento.

  6. Outlook carga el entorno de tiempo de ejecución, que descarga y almacena en la memoria caché la API de JavaScript para los archivos de la biblioteca de JavaScript del servidor de la red de entrega de contenido (CDN) y, después, llama al controlador de eventos del complemento para el evento de inicialización del objeto de Office del complemento, en caso de que se haya asignado un controlador. En este momento, también comprueba si se han pasado (o encadenado) al controlador las devoluciones de llamada (o los métodos encadenadosthen()).Office.onReady Para obtener más información sobre la distinción entre Office.initialize y Office.onReady, vea Inicializar el complemento.

  7. Cuando el DOM y el cuerpo HTML terminan de cargarse y el complemento termina de inicializarse, la función principal del complemento puede continuar.

Vea también