Información general sobre los complementos de Excel
Un complemento de Excel le permite ampliar la funcionalidad de la aplicación de Excel en varias plataformas, como Windows, Mac, iPad y en un explorador. Utilice los complementos de Excel en un libro para:
- Interactuar con los objetos de Excel, leer y escribir datos de Excel.
- Ampliar la funcionalidad mediante el panel de tareas basadas en la web o el panel de contenido.
- Agregar botones personalizados de la cinta de opciones o elementos de menú contextual.
- Añadir funciones personalizadas
- Proporcionar una interacción más rica mediante la ventana de diálogo.
La plataforma de complementos de Office proporciona el marco y las API de JavaScript de Office.js que le permiten crear y ejecutar complementos de Excel. Al usar la plataforma de complementos de Office para crear el complemento en Excel, obtendrá los siguientes beneficios.
- Compatibilidad multiplataforma. Los complementos de Excel se ejecutan en Office en la Web, Windows, Mac e iPad.
- Implementación centralizada: los administradores pueden implementar rápida y fácilmente los complementos de Excel para los usuarios de una organización.
- Uso de tecnología web estándar: Cree su complemento de Excel mediante tecnologías web conocidas como HTML, CSS y JavaScript.
- Distribución a través de AppSource: Comparta su complemento de Excel con un amplio público mediante su publicación en AppSource.
Nota:
Los complementos de Excel son diferentes de los complementos COM y VSTO, que son soluciones de integración de Office anteriores que se ejecutan solo en Office en Windows. A diferencia de los complementos COM, los complementos de Excel no requieren que instale ningún código en el dispositivo de un usuario o en Excel.
Componentes de un complemento de Excel
Un complemento de Excel incluye dos componentes básicos: una aplicación web y un archivo de configuración llamado archivo de manifiesto.
La aplicación web usa la API de JavaScript de Office para interactuar con objetos en Excel y también puede facilitar la interacción con los recursos en línea. Por ejemplo, un complemento puede realizar cualquiera de las siguientes tareas.
- Crear, leer, actualizar y eliminar datos en el libro (hojas de cálculo, rangos, tablas, gráficos, elementos con nombre, etc.).
- Realizar la autorización del usuario con un servicio en línea mediante el flujo estándar de OAuth 2.0.
- Emitir solicitudes de API a Microsoft Graph o a cualquier otra API.
La aplicación web puede alojarse en cualquier servidor web y puede generarse usando marcos del lado cliente (por ejemplo, Angular, React, jQuery) o tecnologías del lado servidor (como ASP.NET, Node.js, PHP).
El manifiesto es un archivo de configuración que define cómo se integra el complemento con los clientes de Office especificando opciones y funcionalidades como:
- La dirección URL de la aplicación web del complemento.
- 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 Excel, incluida la interfaz de usuario personalizada que crea el complemento, (botones de la cinta, menús contextuales, etc.).
- Permisos requeridos por el complemento, como leer y escribir en el documento.
Para permitir que los usuarios finales instalen y usen un complemento de Excel, debe publicar su manifiesto en AppSource o en un catálogo de complementos. Para más detalles sobre AppSource, consulte Hacer que las soluciones estén disponibles en AppSource y en Office.
Capacidades de un complemento de Excel
Además de interactuar con el contenido del libro de trabajo, los complementos de Excel pueden agregar botones personalizados de la cinta de opciones o comandos de menú, insertar paneles de tareas, abrir cuadros de diálogo e incluso incorporar objetos enriquecidos basados en web, como gráficos o visualizaciones interactivas dentro de una hoja de cálculo.
Comandos de complemento
Los comandos de complemento son elementos de la interfaz de usuario que amplían la interfaz de usuario de Excel e inician acciones en el complemento. Puede agregar un botón a la cinta de opciones o un elemento a un menú contextual en Excel. Cuando los usuarios seleccionan un comando de complemento, inician acciones como ejecutar código de JavaScript o mostrar una página del complemento en un panel de tareas.
Para obtener más información sobre las capacidades de los comandos, las plataformas compatibles y las prácticas recomendadas para desarrollar comandos de complemento, consulte Comandos de complemento para Excel, Word y PowerPoint.
Paneles de tareas
Los paneles de tareas son superficies de la interfaz que aparecen normalmente en el lado derecho de la ventana de Excel. Los paneles de tareas dan acceso a los usuarios a los controles de la interfaz que ejecutan código para modificar el documento de Excel o para mostrar datos de un origen de datos.
Para obtener más información sobre los paneles de tareas, consulte Paneles de tareas de los complementos de Office. Para obtener un ejemplo que implementa un panel de tareas en Excel, consulte Complemento de Excel de tendencias de gastos de WoodGrove.
Funciones personalizadas
Las funciones personalizadas permiten a los desarrolladores añadir a Excel funciones nuevas definiéndolas en JavaScript como parte de un complemento. Los usuarios de Excel pueden acceder a las funciones personalizadas como lo harían a las funciones nativas de Excel, como SUM().
Para obtener más información acerca de personalizar funciones, consulte Crear funciones personalizadas en Excel.
Cuadros de diálogo
Los cuadros de diálogo son superficies que flotan por encima de la ventana de aplicación activa de Excel. Puede usar los cuadros de diálogo para tareas como mostrar las páginas de inicio de sesión que no se pueden abrir directamente en un panel de tareas, solicitar la confirmación de una acción efectuada por un usuario u hospedar vídeos que podrían ser demasiado pequeños si se limitaran a un panel de tareas. Para abrir cuadros de diálogo en el complemento de Excel, use la API de cuadro de diálogo.
Para obtener más información sobre los cuadros de diálogo y la API de diálogo, consulte Use la API de cuadro de diálogo en los complementos de Office.
Complementos de contenido
Los complementos de contenido son las superficies que puede incrustar directamente en los documentos de Excel. Puede usar complementos de contenido para incrustar objetos enriquecidos basados en Web, tales como gráficos, visualizaciones de datos u objetos multimedia en una hoja de cálculo, o para proporcionar a los usuarios acceso a los controles de interfaz que ejecutan código para modificar el documento de Excel o mostrar datos de un origen de datos. Use los complementos de contenido cuando no quiera insertar la funcionalidad directamente en el documento.
Para obtener más información sobre los complementos de contenido, consulte Complementos de Office de contenido. Para obtener un ejemplo que implementa un complemento de contenido en Excel, consulte Complemento de contenido de Excel Humongous Insurance en GitHub.
API de JavaScript para interactuar con el contenido del libro
Un complemento de Excel interactúa con objetos de Excel mediante la API de JavaScript de Office, que incluye dos modelos de objetos de JavaScript:
API de JavaScript de Excel: introducida con Office 2016, la API de JavaScript de Excel proporciona objetos de Excel fuertemente tipados que se pueden usar para obtener acceso a hojas de cálculo, rangos, tablas, gráficos, etc.
API comunes: Introducida con Office 2013, la API común lo habilita para acceder a características como la interfaz de usuario, los cuadros de diálogo y la configuración del cliente, que son comunes a través de varios tipos de aplicaciones de Office. La funcionalidad limitada para la interacción de Excel en Common API se ha reemplazado por la API de JavaScript de Excel.
Pasos siguientes
Comience por crear el primer complemento de Excel. Después, obtenga información sobre los conceptos básicos sobre la creación de complementos de Excel.