Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Use la plataforma de complementos de Office para crear soluciones que extienden las aplicaciones de Office e interactúan con el contenido de documentos de Office. Con los complementos de Office, puede usar tecnologías web conocidas como HTML, CSS y JavaScript para ampliar e interactuar con Outlook, Excel, Word, PowerPoint, OneNote y Project. La solución se puede ejecutar en Office en varias plataformas, como Windows, Mac, iPad y en un explorador.
Importante
Un complemento puede tener cualquiera de los dos tipos de manifiestos. Este artículo se escribe suponiendo que el complemento usa el tipo recomendado para la mayoría de los escenarios: el manifiesto unificado para Microsoft 365. Para obtener más información sobre los dos tipos, vea Manifiesto de complementos de Office.
Use la plataforma de complementos de Office para:
Agregar nueva funcionalidad a los clientes de Office : traiga datos externos a Office, automatice documentos de Office, exponga la funcionalidad de Microsoft y otros clientes de Office, etc. Por ejemplo, puede usar la API Microsoft Graph para conectarse a datos que impulsen la productividad.
Creación de agentes de Copilot personalizados que leen y escriben en documentos abiertos en aplicaciones de Office (versión preliminar): permite a los usuarios usar el lenguaje natural para acceder a la funcionalidad del complemento.
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.
Componentes de un complemento de Office
Un complemento de Office incluye dos componentes básicos: un paquete de aplicación y su propia aplicación web. El paquete incluye un manifiesto que define varias opciones de configuración, incluido cómo se integra el complemento 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.
Paquete de la aplicación
El paquete de aplicación de una aplicación para Microsoft 365 es un archivo ZIP que contiene un archivo de manifiesto, dos iconos de aplicación y posiblemente archivos de configuración o localización adicionales. La lógica de la aplicación y el almacenamiento de datos se hospedan en otro lugar y la aplicación host de Microsoft 365 tiene acceso a ella a través de HTTPS. Enviará el paquete de la aplicación al administrador para publicarlo en su organización o en el Centro de partners para publicarlo en Microsoft Marketplace.
Para obtener información general detallada del paquete de la aplicación, consulte Paquete de aplicaciones para Microsoft 365.
Manifiesto
El manifiesto especifica la configuración y las funcionalidades del complemento, como:
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.
Cómo se integra el complemento con Copilot (versión preliminar).
El nivel de permiso y los requisitos de acceso a datos del complemento.
Para obtener información general detallada del manifiesto, consulte Complementos de Office con el manifiesto de aplicación unificada para Microsoft 365.
Aplicación web
El complemento de Office más básico consta de 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 otro recurso de Internet. Sin embargo, para crear una experiencia que interactúe con 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, tanto del lado cliente como del servidor, que admita el proveedor de hospedaje (como ASP.NET, PHP o Node.js). Para interactuar con clientes y documentos de Office, use las API de JavaScript de Office.js.
Extender e interactuar con clientes de Office
Dentro de una aplicación cliente de Office, los complementos de Office pueden realizar las siguientes tareas:
Ampliación de la funcionalidad
Llevar a cabo instrucciones de lenguaje natural desde Copilot (versión preliminar)
Crear nuevos objetos (solo Excel o PowerPoint)
Ampliar la funcionalidad de Office
Puede agregar nueva funcionalidad a las aplicaciones de Office a través de las siguientes características:
Botones de cinta de opciones personalizados y comandos de menú (denominados colectivamente "comandos de complemento").
Paneles de tareas insertables con un control webview que puede hacer casi cualquier cosa que una página web pueda hacer dentro de un explorador.
Controladores de eventos que responden a eventos en el documento de Office o la aplicación de Office.
La interfaz de usuario personalizada, los paneles de tareas y los controladores de eventos se especifican en el manifiesto del complemento.
Botones y comandos de menú personalizados
Puede agregar botones y elementos de menú personalizados a la cinta de opciones en 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 personalizados y los elementos de menú pueden iniciar diferentes acciones, como mostrar un panel de tareas con HTML personalizado o ejecutar una función de JavaScript.
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. En Excel, Word y PowerPoint, los usuarios inician complementos de panel de tareas mediante el botónComplementos deinicio>. En Outlook, los usuarios inician complementos del panel de tareas mediante el botón del complemento o a través del botón Todas las aplicaciones de la cinta de opciones.
Ampliar la funcionalidad de Outlook
Los usuarios pueden ejecutar complementos de Outlook cuando ven, responden o crean correos electrónicos, convocatorias de reunión, respuestas a reuniones, cancelaciones de reuniones o citas. Los complementos de Outlook pueden realizar las siguientes tareas:
- Ampliar la cinta de opciones de la aplicación de Office.
- Mostrar contextualmente junto a un elemento de Outlook al verlo o redactarlo.
- Realice una tarea cuando se produzca un evento específico, como cuando un usuario crea un nuevo mensaje.
Nota:
Los complementos que interactúan con el calendario, las reuniones o las citas del usuario solo están disponibles si el usuario abre el calendario en Outlook, no en Teams. Sin embargo, puede crear una aplicación de reunión de Teams y exponerla en Outlook. Para obtener más información, vea Extender una aplicación de reunión de Teams a Outlook.
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.
API de JavaScript de Office
Las API de JavaScript para 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 compartido por Excel, Outlook, Word, PowerPoint, OneNote y Project. También hay modelos de objetos más amplios específicos de la aplicación para Excel, OneNote, PowerPoint y Word. Estas API proporcionan acceso a objetos conocidos, como párrafos y libros, lo que facilita la creación de un complemento para una aplicación específica.
Ejemplos de código
Obtenga información sobre cómo crear el complemento de Office más sencillo con solo un manifiesto, una página web HTML y un logotipo. Los ejemplos siguientes le ayudan a empezar a trabajar en la aplicación de Office que le interesa.
- Complemento “Hola mundo” de Excel
- Complemento “Hola mundo” de Outlook
- Complemento “Hola mundo” de PowerPoint
- Complemento “Hola mundo” de Word
- Creación de gráficos de análisis de datos en Excel con un agente de Copilot
¿En qué se diferencian los complementos de Office de los completos COM y VSTO?
Los complementos COM y VSTO son soluciones de integración de Office anteriores que se ejecutan solo en Office en Windows. A diferencia de los complementos COM y VSTO, los complementos de Office son complementos web: la aplicación (por ejemplo, Excel), lee el manifiesto del complemento y conecta los botones de la cinta de opciones personalizados y los comandos de menú del complemento en la interfaz de usuario. Cuando sea necesario, carga el código JavaScript y HTML del complemento, que se ejecuta en el contexto de un explorador o control de vista web en un espacio aislado.
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.
Aplicaciones para compatibilidad con Microsoft 365: los complementos de Office se pueden empaquetar con otras extensiones de Microsoft 365, como aplicaciones de Teams y agentes de Copilot para la implementación como una sola unidad.
Implementación y distribución centralizadas: los administradores pueden implementar complementos de Office de forma centralizada en una organización.
Fácil acceso a través de Microsoft Marketplace: puede hacer que la solución esté disponible para un público amplio enviándola a Microsoft Marketplace.
Basado en la tecnología web estándar: puede usar cualquier biblioteca que desee para crear complementos de Office.
Importante
Los complementos COM y VSTO no se admiten en el nuevo Outlook en Windows. Estos complementos siguen siendo compatibles con el cliente de escritorio clásico de Outlook en Windows. Para obtener más información, consulte Desarrollo de complementos de Outlook para nuevas Outlook en Windows.
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
Colaborar con nosotros en GitHub
El origen de este contenido se puede encontrar en GitHub, donde también puede crear y revisar problemas y solicitudes de incorporación de cambios. Para más información, consulte nuestra guía para colaboradores.