Información general sobre la plataforma de complementos de OfficeOffice Add-ins platform overview

Puede usar 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 extender e interactuar con Word, Excel, PowerPoint, OneNote, Project y Outlook. La solución se puede ejecutar en Office en varias plataformas, como Office para Windows, Office Online, Office para Mac y Office para iPad.You can use the Office Add-ins platform to build solutions that extend Office applications and interact with content in Office documents. With Office Add-ins, you can use familiar web technologies such as HTML, CSS, and JavaScript to extend and interact with Word, Excel, PowerPoint, OneNote, Project, and Outlook. Your solution can run in Office across multiple platforms, including Office for Windows, Office Online, Office for the Mac, and Office for the iPad.

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:Office Add-ins can do almost anything a webpage can do inside a browser. Use the Office Add-ins platform to:

  • 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.Add new functionality to Office clients - Bring external data into Office, automate Office documents, expose third-party functionality in Office clients, and more. For example, use Microsoft Graph API to connect to data that drives productivity.

  • 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.Create new rich, interactive objects that can be embedded in Office documents - Embed maps, charts, and interactive visualizations that users can add to their own Excel spreadsheets and PowerPoint presentations.

¿En qué se diferencian los complementos de Office de los completos COM y VSTO?How are Office Add-ins different than COM and VSTO add-ins?

Los complementos COM o VSTO son soluciones de integración de Office anteriores que solo se ejecutan en Office para 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 host, 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.COM or VSTO add-ins are earlier Office integration solutions that run only on Office for Windows. Unlike COM add-ins, Office Add-ins don't involve code that runs on the user's device or in the Office client. For an Office Add-in, the host application, for example Excel, reads the add-in manifest and hooks up the add-in’s custom ribbon buttons and menu commands in the UI. When needed, it loads the add-in's JavaScript and HTML code, which executes in the context of a browser in a sandbox.

Los complementos de Office proporcionan las siguientes ventajas respecto a los complementos creados con VBA, COM o VSTO:Office Add-ins provide the following advantages over add-ins built using VBA, COM, or VSTO:

  • Compatibilidad multiplataforma. Los complementos de Office se ejecutan en Office para Windows, Mac, iOS y Office Online.Cross-platform support. Office Add-ins run in Office for Windows, Mac, iOS, and Office Online.

  • Inicio de sesión único (SSO). Los complementos de Office se integran fácilmente con las cuentas de Office 365 de los usuarios.Single sign-on (SSO). Office Add-ins integrate easily with users' Office 365 accounts.

  • Implementación y distribución centralizadas. Los administradores pueden implementar complementos de Office de manera central en toda la organización.Centralized deployment and distribution. Admins can deploy Office Add-ins centrally across an organization.

  • 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.Easy access via AppSource. You can make your solution available to a broad audience by submitting it to AppSource.

  • Basados en tecnología web estándar. Puede usar la biblioteca que quiera para crear complementos de Office.Based on standard web technology. You can use any library you like to build Office Add-ins.

Componentes de un complemento de OfficeComponents of an Office Add-in

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.An Office Add-in includes two basic components: an XML manifest file, and your own web application. The manifest defines various settings, including how your add-in integrates with Office clients. Your web application needs to be hosted on a web server, or web hosting service, such as Microsoft Azure.

Figura 1. Complemento de manifiesto (XML) + página web (HTML, JS) = un complemento de OfficeFigure 1. Manifest + webpage = an Office Add-in

Manifiesto más página web es igual a complemento de Office

ManifiestoManifest

El manifiesto es un archivo XML que especifica la configuración y las funcionalidades del complemento, por ejemplo:The manifest is an XML file that specifies settings and capabilities of the add-in, such as:

  • El nombre para mostrar, la descripción, el identificador, la versión y la configuración regional predeterminada del complemento.The add-in's display name, description, ID, version, and default locale.

  • Cómo se integra el complemento con Office.How the add-in integrates with Office.

  • El nivel de permiso y los requisitos de acceso a datos del complemento.The permission level and data access requirements for the add-in.

Aplicación webWeb app

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 host 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.The most basic Office Add-in consists of a static HTML page that is displayed inside an Office application, but that doesn't interact with either the Office document or any other Internet resource. However, to create an experience that interacts with Office documents or allows the user to interact with online resources from an Office host application, you can use any technologies, both client and server side, that your hosting provider supports (such as ASP.NET, PHP, or Node.js). To interact with Office clients and documents, you use the Office.js JavaScript APIs.

Figura 2. Componentes de un complemento de Office Hola mundoFigure 2. Components of a Hello World Office Add-in

Componentes de un complemento Hola mundo

Extender e interactuar con clientes de OfficeExtending and interacting with Office clients

Los complementos de Office pueden hacer lo siguiente en una aplicación host de Office:Office Add-ins can do the following within an Office host application:

  • Ampliar funcionalidad (cualquier aplicación de Office)Extend functionality (any Office application)

  • Crear objetos (Excel o PowerPoint)Create new objects (Excel or PowerPoint)

Ampliar la funcionalidad de OfficeExtend Office functionality

Se puede agregar nueva funcionalidad a las aplicaciones de Office a través de lo siguiente:You can add new functionality to Office applications via the following:

  • Botones y comandos de menú personalizados de la cinta (denominados conjuntamente "comandos de complemento")Custom ribbon buttons and menu commands (collectively called “add-in commands”)

  • Paneles de tareas insertablesInsertable task panes

Los paneles personalizados de interfaz de usuario y tareas se especifican en el manifiesto del complemento.Custom UI and task panes are specified in the add-in manifest.

Botones y comandos de menú personalizadosCustom buttons and menu commands

Se pueden agregar botones y elementos de menú personalizados de la cinta a la cinta en Office para escritorio de Windows y Office Online. Esto facilita a los usuarios tener acceso a un complemento directamente desde su aplicación de Office. Los botones de comando pueden iniciar diferentes acciones, como mostrar un panel de tareas con HTML personalizado o ejecutar una función de JavaScript.You can add custom ribbon buttons and menu items to the ribbon in Office for Windows Desktop and Office Online. This makes it easy for users to access your add-in directly from their Office application. Command buttons can launch different actions such as showing a task pane with custom HTML or executing a JavaScript function.

Figura 3. Comandos de complemento en la cintaFigure 3. Add-in commands in the ribbon

Botones y comandos de menú personalizados

Paneles de tareasTask panes

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 admitan 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.You can use task panes in addition to add-in commands to enable users to interact with your solution. Clients that do not support add-in commands (Office 2013 and Office for iPad) run your add-in as a task pane. Users launch task pane add-ins via the My Add-ins button on the Insert tab.

Figura 4. Panel de tareasFigure 4. Task pane

Panel de tareas

Ampliar la funcionalidad de OutlookExtend Outlook functionality

Los complementos de Outlook pueden ampliar la cinta de Office y también se pueden mostrar en contexto al ver o redactar un elemento de Outlook. 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 cuando responde o crea un elemento.Outlook add-ins can extend the Office ribbon and also display contextually next to an Outlook item when you're viewing or composing it. They can work with an email message, meeting request, meeting response, meeting cancellation, or appointment when a user is viewing a received item or replying or creating a new item.

Los complementos de Outlook pueden tener acceso a la información contextual del elemento (como la dirección o el identificador de seguimiento) y usar esos datos para obtener acceso a más información en el servidor y de los servicios web para crear experiencias de usuario atractivas. En la mayoría de los casos, un complemento de Outlook se ejecuta sin modificaciones en las distintas aplicaciones auxiliares del host, incluyendo Outlook, Outlook para Mac, Outlook Web App y Outlook Web App para dispositivos, para proporcionar una experiencia transparente en el escritorio, la Web y tabletas y dispositivos móviles.Outlook add-ins can access contextual information from the item, such as an address or tracking ID, and then use that data to access additional information on the server and from web services to create compelling user experiences. In most cases, an Outlook add-in runs without modification on the various supporting host applications, including Outlook, Outlook for Mac, Outlook Web App, and Outlook Web App for devices, to provide a seamless experience on the desktop, web, and tablet and mobile devices.

Para obtener una introducción a los complementos de Outlook, vea Información general sobre los complementos de Outlook.For an overview of Outlook add-ins, see Outlook add-ins overview.

Crear objetos en documentos de OfficeCreate new objects in Office documents

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.You can embed web-based objects called content add-ins within Excel and PowerPoint documents. With content add-ins, you can integrate rich, web-based data visualizations, media (such as a YouTube video player or a picture gallery), and other external content.

Figura 5. Complemento de contenidoFigure 5. Content add-in

Complemento de contenido

API de JavaScript de OfficeOffice JavaScript APIs

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 comunes que Excel, Outlook, Word, PowerPoint, OneNote y Project comparten. También existen modelos de objetos host específicos más amplios para Excel y Word. Estas API proporcionan acceso a objetos bien conocidos tales como párrafos y libros, por lo que resulta sencillo crear un complemento para un host específico.The Office JavaScript APIs contain objects and members for building add-ins and interacting with Office content and web services. There is a common object model that is shared by Excel, Outlook, Word, PowerPoint, OneNote and Project. There are also more extensive host-specific object models for Excel and Word. These APIs provide access to well-known objects such as paragraphs and workbooks, which makes it easier to create an add-in for a specific host.

Pasos siguientesNext steps

Para obtener más información acerca de cómo comenzar a construir su complemento de Office, pruebe nuestro Inicio rápido en 5 minutos.To learn more about how to start building your Office Add-in, try out our 5-minute Quickstarts. You can start building add-ins right away using Visual Studio or any other editor. Puede comenzar a crear complementos de inmediato con Visual Studio o cualquier otro editor.To learn more about how to start building your Office Add-in, try out our 5-minute Quickstarts. You can start building add-ins right away using Visual Studio or any other editor.

Para empezar a planear soluciones que crean experiencias de usuario atractivas y eficaces, debe familiarizarse con las directrices de diseño y los procedimientos recomendados para complementos de Office.To start planning solutions that create effective and compelling user experiences, get familiar with the design guidelines and best practices for Office Add-ins.

Ver tambiénSee also