Información general sobre la plataforma de complementos de Office

Puede usar la plataforma de complementos de Office para crear soluciones que extiendan las aplicaciones de Office e interactúen con el contenido de los documentos de Office. Con los complementos de Office, puede usar tecnologías web conocidas como HTML, CSS y JavaScript para extender e interactuar con Word, Excel, PowerPoint, OneNote, Project y Outlook. La solución se puede ejecutar en Office en varias plataformas, como Windows, Mac, iPad y en un explorador.

La aplicación de Office y un sitio web insertado (complemento) hacen que las posibilidades de extensibilidad sean infinitas.

Los complementos de Office pueden hacer lo mismo que cualquier página web dentro de un explorador. Use la plataforma de complementos de Office para:

  • Agregar nueva funcionalidad a los clientes de Office: Incluir datos externos en Office, automatizar los documentos de Office, exponer funcionalidad de terceros en los clientes de Office y mucho más. Por ejemplo, puede usar la API Microsoft Graph para conectarse a datos que impulsen la productividad.

  • Crear objetos interactivos avanzados que se pueden insertar en documentos de Office: Inserte mapas, gráficos y visualizaciones interactivas que los usuarios puedan agregar a sus propias hojas de cálculo de Excel y presentaciones de PowerPoint.

¿En qué se diferencian los complementos de Office de los completos COM y VSTO?

Los complementos COM o VSTO son soluciones de integración de Office anteriores que solo se ejecutan en Office de Windows. A diferencia de los complementos COM, los complementos de Office no requieren el código que se ejecuta en el dispositivo del usuario o en el cliente de Office. Para un complemento de Office, la aplicación, por ejemplo, Excel, lee el manifiesto del complemento y enlaza los botones de la cinta de opciones y los comandos de menú personalizados del complemento en la interfaz de usuario. Cuando es necesario, carga el código HTML y JavaScript del complemento, lo que se ejecuta en el contexto de un explorador en un espacio aislado.

Las razones para usar complementos de Office: implementación centralizada y multiplataforma, fácil acceso a través de AppSource y tecnologías web estándar construidas.

Los Complementos de Office proporcionan las siguientes ventajas respecto a los complementos creados con VBA, COM o VSTO.

  • Compatibilidad multiplataforma. Los complementos de Office se ejecutan en Office en la Web, Windows, Mac y iPad.

  • Implementación y distribución centralizadas. Los administradores pueden implementar complementos de Office de manera central en toda una organización.

  • Acceso fácil a través de AppSource. Puede hacer que la solución esté disponible para un público amplio si la envía a AppSource.

  • Basados en tecnología web estándar. Puede usar la biblioteca que quiera para crear complementos de Office.

Componentes de un complemento de Office

Un complemento de Office incluye dos componentes básicos: un archivo de manifiesto XML y su propia aplicación web. El manifiesto define diferentes opciones de configuración, como la forma en que el complemento se integra con los clientes de Office. Es necesario que la aplicación web este hospedada en un servidor web o un servicio de hospedaje de sitios web como Microsoft Azure.

Manifiesto

El manifiesto es un archivo XML que especifica la configuración y las funcionalidades del complemento, por ejemplo:

  • El nombre para mostrar, la descripción, el identificador, la versión y la configuración regional predeterminada del complemento.

  • Cómo se integra el complemento con Office.

  • El nivel de permiso y los requisitos de acceso a datos del complemento.

Aplicación web

El complemento de Office más básico está formado por una página HTML estática que se muestra dentro de una aplicación de Office, pero no interactúa con el documento de Office ni con ningún recurso de Internet. Pero para crear una experiencia que interactúe con los documentos de Office o permita al usuario interactuar con recursos en línea desde una aplicación cliente de Office, puede usar cualquier tecnología, del lado cliente y servidor, que sea compatible con su proveedor de servicios de hospedaje (como ASP.NET, PHP o Node.js). Para interactuar con clientes y documentos de Office, se usan las API de JavaScript de Office.js.

Figura 2. Componentes de un complemento de Office Hola mundo

Componentes de un complemento Hola, mundo.

Extender e interactuar con clientes de Office

Los Complementos de Office pueden hacer lo siguiente en una aplicación cliente de Office.

  • Ampliar funcionalidad (cualquier aplicación de Office)

  • Crear objetos (Excel o PowerPoint)

Ampliar la funcionalidad de Office

Se puede agregar nueva funcionalidad a las aplicaciones de Office a través de lo siguiente:

  • Botones y comandos de menú personalizados de la cinta (denominados conjuntamente "comandos de complemento")

  • Paneles de tareas insertables

Los paneles personalizados de interfaz de usuario y tareas se especifican en el manifiesto del complemento.

Botones y comandos de menú personalizados

Se pueden agregar botones de cinta y elementos de menú personalizados a la cinta de Office en la Web y en Windows. Esto facilita a los usuarios tener acceso a un complemento directamente desde su aplicación de Office. Los botones de comandos pueden iniciar diferentes acciones, como mostrar un panel de tareas con un HTML personalizado o ejecutar una función de JavaScript.

Figura 3. Comandos de complemento de la cinta de opciones

Botones personalizados y comandos de menú.

Paneles de tareas

Se pueden usar paneles de tareas además de los comandos del complemento para permitir a los usuarios interactuar con la solución. Los clientes que no admiten comandos de complementos (Office 2013 y Office para iPad) ejecutan el complemento como un panel de tareas. Los usuarios inician los complementos de panel de tareas a través del botón Mis complementos de la pestaña Insertar.

Figura 4. Panel de tareas

Usar los paneles de tareas junto con los comandos de complemento.

Ampliar la funcionalidad de Outlook

Los complementos de Outlook pueden ampliar la cinta de la aplicación de Office y también se pueden mostrar en contexto al ver o redactar un elemento de Outlook junto a dicho elemento. Pueden trabajar con un mensaje de correo, una convocatoria de reunión, una respuesta a una reunión, una cancelación de reunión o una cita cuando el usuario visualiza un elemento recibido, o bien, responde o crea un elemento.

Los complementos de Outlook pueden tener acceso a información contextual desde el elemento (como una dirección o un id. de seguimiento) y, después, usar esos datos para tener acceso a información adicional en el servidor, y desde servicios web para crear experiencias del usuario atractivas. En la mayoría de los casos, un complemento de Outlook se ejecuta sin modificación en la aplicación de Outlook para proporcionar una experiencia directa en el escritorio, en la Web, en tabletas y dispositivos móviles.

Para obtener una introducción a los complementos de Outlook, vea Información general sobre los complementos de Outlook.

Crear objetos en documentos de Office

Puede insertar objetos basados en web, denominados complementos de contenido, en documentos de Excel y PowerPoint. Con los complementos de contenido puede integrar visualizaciones de datos avanzadas basadas en web, contenido multimedia (como un reproductor de vídeo de YouTube o una galería de imágenes) y otro contenido externo.

Figura 5. Complemento de contenido

Insertar objetos basados en web llamados complementos de contenido.

API de JavaScript de Office

Las API de JavaScript de Office contienen objetos y miembros que permiten crear complementos e interactuar con el contenido y los servicios web de Office. Hay un modelo de objetos común que Excel, Outlook, Word, PowerPoint, OneNote y Project comparten. También existen modelos de objetos específicos para las aplicaciones más amplios para Excel y Word. Estas API dan acceso a objetos bien conocidos tales como párrafos y libros, por lo que resulta sencillo crear un complemento para una aplicación específica.

Pasos siguientes

Para obtener una introducción más detallada sobre el desarrollo de complementos de Office, vea Desarrollo de complementos de Office.

Recursos adicionales