2. ¿Qué es un Add-in?
Es un complemento que se hospedada en un control del explorador web o iframe que
se ejecuta en el contexto de una aplicación host de Office. Esta aplicación puede
interactuar con los documentos o los elementos de correo de un usuario.
Al usar complementos de Office ampliamos las capacidades de los elementos con los
que interactuamos:
Documentos o datos: documentos de Word, hojas de cálculo de Excel,
presentaciones de PowerPoint, bases de datos basadas en el explorador de Access, y
programaciones y vistas de Project.
Elementos de buzón de Outlook: mensajes de correo, convocatorias de reuniones o
citas.
3. ¿Qué es un Add-in?
Producto de Office Complemento
Excel Mapas de Bing
Outlook Package Tracker
PowerPoint Contenido de Khan en Microsoft
Word Translator
Para probar algunos complementos, puede instalar los siguientes complementos desde la
Tienda Office.
6. Conceptos básicos sobre el desarrollo
Para crear Complementos de Office, puede usar cualquier aplicación capaz de
guardar un archivo como texto, pero puede crear un Complemento de Office
más fácilmente con el entorno de desarrollo basado en web de Herramientas de
desarrollo de Office 365 de Napa o con las plantillas de proyecto, el entorno de
desarrollo y las herramientas de depuración de Visual Studio 2015.
13. ¿Qué hace un complemento para Office?
Casi todo lo que hace una página web dentro del explorador, por ejemplo:
• Proporcionar una interfaz de usuario interactiva y una lógica personalizada a través
de JavaScript.
• Usar marcos de JavaScript, como jQuery.
• Conectarse a los extremos de REST y a servicios web a través de HTTP y AJAX.
• Ejecutar código o lógica del lado servidor, si la página se ha implementado con un
lenguaje de scripting del lado servidor, como ASP o PHP.
14. Escenarios
Asistente para la traducción
Creación de diagramas
Integración con servicios de terceros
Aplicaciones web mixtas enriquecidas
Validación de especificaciones
Inicio de flujos de trabajo
Exploración de detalles de pedido en contexto
15. Empezar con NAPA
Napa es una forma genial para comenzar a compilar Complementos de Office
directamente desde una ventana de explorador. No tiene que instalar ninguna
otra herramienta, como Visual Studio. Todo lo que necesita es un explorador
compatible y un par de cosas más:
Una cuenta de correo de Microsoft
Entrar al sitio www.napacloudapp.com
Los complementos se pueden ejecutar en distintos entornos, como aplicaciones de escritorio de Office, Office Online en exploradores de escritorio y móviles, y un número cada vez mayor de complementos de Office para tabletas y teléfonos. Si publica complementos en la Tienda Office o en un catálogo de complementos local, estarán disponibles para los clientes desde sus aplicaciones de Office.
Para probar algunos complementos, puede instalar los siguientes complementos desde la Tienda Office.
Los componentes básicos de una Complemento de Office son un archivo de manifiesto XML y la página web predeterminada del complemento. El manifiesto define distintas configuraciones, incluida la URL de la página web que implementará la interfaz de usuario del complemento y la lógica personalizada. Cuando el complemento ya esté listo para los clientes, deberá subir el manifiesto correspondiente a un catálogo de complementos local o enviarlo a la Tienda Office. La página web (junto con todos los archivos .js o de otro tipo necesarios para su implementación) debe hospedarse en un servidor web o en un servicio de hospedaje web como Microsoft Azure.
Manifiesto + página web = complemento de Office
El manifiesto especifica la configuración y las funcionalidades del complemento, por ejemplo:
La URL de la página web que implementa la interfaz de usuario del complemento y la lógica de programación.
El nombre para mostrar, la descripción, el identificador, la versión y la configuración regional predeterminada del complemento.
Cómo se activa y se muestra el complemento:
Si el complemento interactúa con documentos, se puede mostrar como un panel de tareas o siguiendo el contenido del documento.
Si el complemento interactúa con elementos de correo (mensajes o citas), se mostrará al leer o crear el elemento.
El nivel de permiso y los requisitos de acceso a datos del complemento.
Para obtener más información, consulte Manifiesto XML de complementos para Office.
Para crear una Complemento de Office, un desarrollador tiene que crear, como mínimo, una página web HTML y un archivo de manifiesto. La página HTML se puede publicar en cualquier servidor web o servicio de hospedaje web, como Microsoft Azure. El archivo de manifiesto debe apuntar a la ubicación de la página web y se debe publicar en cualquiera de las siguientes ubicaciones: la Tienda Office pública, una lista de SharePoint interna o una ubicación de red compartida.
El Complemento de Office más básica consta de una página HTML estática hospedada dentro de una aplicación de Office, pero que no interactúa con el documento de Office ni con ningún otro recurso de Internet.
Tal vez, la forma más rápida de crear una Complemento de Office sea con un explorador directamente. Para ello, use Napa. Napa es un entorno de desarrollo basado en web que le permite crear proyectos, escribir código y ejecutar sus complementos, todo ello desde dentro del explorador. No es necesario instalar ninguna otra herramienta, como Visual Studio.
Para más información, consulte Crear complementos de Office con Napa con un sitio para desarrolladores de Office 365. Para empezar a desarrollar inmediatamente, consulte estos temas:
Empezar a crear un complemento de panel de tareas con las herramientas de desarrollo de Office 365 Napa
Empezar a crear un complemento de contenido para Excel con las herramientas de desarrollo de Office 365 Napa
Get Started with Mail add-ins for Office 365
Asimismo, si empieza a desarrollar Complementos de Office con Napa, puede seguir desarrollando los proyectos en Visual Studio y aprovechar características más eficaces, como la depuración avanzada o la posibilidad de usar un proyecto web como parte del complemento.
La manera más eficaz de crear un Complemento de Office es usar la plantilla de proyecto Complemento para Office en Visual Studio. Visual Studio crea una solución completa con todos los archivos que necesita para empezar a probar el complemento en Office al instante. Visual Studio proporciona una gran variedad de características que facilitan el desarrollo y las pruebas de los Complementos de Office. Para obtener más información, consulte Crear y depurar complementos de Office en Visual Studio. Si quiere empezar ya a desarrollar, consulte este tema:
Crear un complemento de panel de tareas o de contenido con Visual Studio
Creación de una Complemento de Office con un editor de texto
Si desea usar su editor de texto preferido para crear una Complemento de Office, consulte estos temas para conocer los pasos básicos:
Crear un complemento de panel de tareas o de contenido para Word o Excel con un editor de texto
Get Started with Mail add-ins for Outlook.com (Preview)
API de JavaScript para Office
La API de JavaScript para Office contiene objetos y miembros que permiten crear complementos e interactuar con el contenido y los servicios web de Office.
Para más información sobre la API de JavaScript para Office:
Consulte Información sobre la API de JavaScript para Office y la referencia API de JavaScript para Office.
Ejecute y edite código de la API de JavaScript para Office en Excel Online con el tutorial interactivo de la API de complementos de Office
Las API de JavaScript para Word y Excel proporcionan modelos de objetos específicos del host que se pueden usar en un complemento de Office. Las API permiten obtener acceso a objetos conocidos, como párrafos y libros, lo cual facilita la creación de un complemento de Office para Word y Excel. Para obtener más información sobre estas API, consulte los temas de información general word-add-ins yComplementos de Excel.
Complementos de panel de tareas
Los complementos de panel de tareas funcionan junto con los documentos de Office, y permiten brindar información contextual y funciones para mejorar la visualización de documentos y la experiencia de creación de documentos. Por ejemplo, un complemento de panel de tareas puede buscar y recuperar información sobre un producto desde un servicio web a partir del nombre del producto o el número de pieza seleccionado en el documento.
( Abrir Wikipedia)
Complementos de contenido
Los complementos de contenido integran características web como contenido que se puede mostrar alineado con el cuerpo del documento. Los complementos de contenido permiten integrar visualizaciones de datos web enriquecidos, medios incrustados (como un reproductor de vídeo de YouTube o una galería de imágenes), además de otro contenido externo.
(Mostrar Excel)
Complementos de Outlook
Los complementos de Outlook se muestran junto a los elementos de Outlook que se están viendo o redactando en ese momento. Pueden funcionar con un mensaje de correo, una convocatoria de reunión, una respuesta a la reunión, una cancelación de la reunión o una cita en un escenario de lectura (cuando el usuario está viendo un elemento recibido) o de redacción (cuando el usuario está escribiendo una respuesta o creando un elemento nuevo). Los complementos de Outlook pueden tener acceso a información contextual del elemento, como la dirección o el identificador de seguimiento, y después usar esos datos para tener acceso a información adicional en el servidor y a información de servicios web para hacer atractiva la experiencia del usuario. En la mayoría de los casos, un complemento de Outlook se ejecuta sin modificaciones en las diversas aplicaciones host compatibles, incluidas Outlook, Outlook para Mac, Outlook Web App y OWA para dispositivos, para proporcionar una experiencia perfecta en dispositivos de escritorio, web, tabletas y móviles.
Nota Los complementos de Outlook necesitan, como mínimo, la versión Exchange 2013 o Exchange Online para hospedar el buzón de correo del usuario. Las cuentas de correo electrónico POP e IMAP no se admiten.
Para probar un complemento de Outlook en Outlook, en Outlook para Mac o en Outlook Web App, instale el complemento Package Tracker.
Información general sobre la plataforma de complementos para Office
Office and SharePoint Add-ins
La última versión de esta ayuda de complementos de Office está disponible en el repositorio del GitHub del complemento.
Use la plataforma de Complementos de Office para crear nuevas y atractivas experiencias para consumidores y empresas en aplicaciones cliente de Office. Con las capacidades de la Web y tecnologías web estándar como API de REST, HTML5, XML, CSS3 y JavaScript, cree complementos que interactúen con documentos de Office, mensajes de correo electrónico, convocatorias de reuniones y citas.
Hace referencia a:Access apps for SharePoint | apps for Office | Excel | Office Add-ins | Outlook | PowerPoint | Project | Word
Este artículo proporciona una introducción rápida a la plataforma de Complementos de Office e información sobre el funcionamiento de un complemento con una aplicación de Office. Para saber cómo empezar a desarrollar complementos directamente, consulte Conceptos básicos sobre el desarrollo.
Una Complemento de Office es una aplicación web hospedada en un control de explorador web o iframe que se ejecuta en el contexto de una aplicación host de Office. Esta aplicación puede interactuar con los documentos o los elementos de correo de un usuario. Use Complementos de Office para ampliar las capacidades de los elementos siguientes e interaccionar con ellos:
Documentos o datos: documentos de Word, hojas de cálculo de Excel, presentaciones de PowerPoint, bases de datos basadas en el explorador de Access, y programaciones y vistas de Project.
Elementos de buzón de Outlook: mensajes de correo, convocatorias de reuniones o citas.
Los complementos se pueden ejecutar en distintos entornos, como aplicaciones de escritorio de Office, Office Online en exploradores de escritorio y móviles, y un número cada vez mayor de complementos de Office para tabletas y teléfonos. Si publica complementos en la Tienda Office o en un catálogo de complementos local, estarán disponibles para los clientes desde sus aplicaciones de Office.
Para probar algunos complementos, puede instalar los siguientes complementos desde la Tienda Office.
Producto de Office
Complemento
Excel
Mapas de Bing
Outlook
Package Tracker
PowerPoint
Contenido de Khan en Microsoft
Word
Translator
Si desea probar código, descargue el paquete de muestras de complementos de Office para Visual Studio.
Componentes de una Complemento de Office
Los componentes básicos de una Complemento de Office son un archivo de manifiesto XML y la página web predeterminada del complemento. El manifiesto define distintas configuraciones, incluida la URL de la página web que implementará la interfaz de usuario del complemento y la lógica personalizada. Cuando el complemento ya esté listo para los clientes, deberá subir el manifiesto correspondiente a un catálogo de complementos local o enviarlo a la Tienda Office. La página web (junto con todos los archivos .js o de otro tipo necesarios para su implementación) debe hospedarse en un servidor web o en un servicio de hospedaje web como Microsoft Azure.
Manifiesto + página web = complemento de Office
El manifiesto especifica la configuración y las funcionalidades del complemento, por ejemplo:
La URL de la página web que implementa la interfaz de usuario del complemento y la lógica de programación.
El nombre para mostrar, la descripción, el identificador, la versión y la configuración regional predeterminada del complemento.
Cómo se activa y se muestra el complemento:
Si el complemento interactúa con documentos, se puede mostrar como un panel de tareas o siguiendo el contenido del documento.
Si el complemento interactúa con elementos de correo (mensajes o citas), se mostrará al leer o crear el elemento.
El nivel de permiso y los requisitos de acceso a datos del complemento.
Para obtener más información, consulte Manifiesto XML de complementos para Office.
Conceptos básicos sobre el desarrollo
Para crear Complementos de Office, puede usar cualquier aplicación capaz de guardar un archivo como texto, pero puede crear un Complemento de Office más fácilmente con el entorno de desarrollo basado en web de Herramientas de desarrollo de Office 365 de Napa o con las plantillas de proyecto, el entorno de desarrollo y las herramientas de depuración de Visual Studio 2015.
Componentes básicos de una Complemento de Office
Para crear una Complemento de Office, un desarrollador tiene que crear, como mínimo, una página web HTML y un archivo de manifiesto. La página HTML se puede publicar en cualquier servidor web o servicio de hospedaje web, como Microsoft Azure. El archivo de manifiesto debe apuntar a la ubicación de la página web y se debe publicar en cualquiera de las siguientes ubicaciones: la Tienda Office pública, una lista de SharePoint interna o una ubicación de red compartida.
La Complemento de Office más básica consta de una página HTML estática hospedada dentro de una aplicación de Office, pero que no interactúa con el documento de Office ni con ningún otro recurso de Internet.
Componentes de un complemento de Office Hola a todos
Creación de una Complemento de Office con Herramientas de desarrollo de Office 365 de Napa
Tal vez, la forma más rápida de crear una Complemento de Office sea con un explorador directamente. Para ello, use Napa. Napa es un entorno de desarrollo basado en web que le permite crear proyectos, escribir código y ejecutar sus complementos, todo ello desde dentro del explorador. No es necesario instalar ninguna otra herramienta, como Visual Studio. Para más información, consulte Crear complementos de Office con Napa con un sitio para desarrolladores de Office 365. Para empezar a desarrollar inmediatamente, consulte estos temas:
Empezar a crear un complemento de panel de tareas con las herramientas de desarrollo de Office 365 Napa
Empezar a crear un complemento de contenido para Excel con las herramientas de desarrollo de Office 365 Napa
Get Started with Mail add-ins for Office 365
Asimismo, si empieza a desarrollar Complementos de Office con Napa, puede seguir desarrollando los proyectos en Visual Studio y aprovechar características más eficaces, como la depuración avanzada o la posibilidad de usar un proyecto web como parte del complemento.
Creación de una Complemento de Office con Visual Studio
La manera más eficaz de crear un Complemento de Office es usar la plantilla de proyecto Complemento para Office en Visual Studio. Visual Studio crea una solución completa con todos los archivos que necesita para empezar a probar el complemento en Office al instante. Visual Studio proporciona una gran variedad de características que facilitan el desarrollo y las pruebas de los Complementos de Office. Para obtener más información, consulte Crear y depurar complementos de Office en Visual Studio. Si quiere empezar ya a desarrollar, consulte este tema:
Crear un complemento de panel de tareas o de contenido con Visual Studio
Creación de una Complemento de Office con un editor de texto
Si desea usar su editor de texto preferido para crear una Complemento de Office, consulte estos temas para conocer los pasos básicos:
Crear un complemento de panel de tareas o de contenido para Word o Excel con un editor de texto
Get Started with Mail add-ins for Outlook.com (Preview)
API de JavaScript para Office
La API de JavaScript para Office contiene objetos y miembros que permiten crear complementos e interactuar con el contenido y los servicios web de Office.
Para más información sobre la API de JavaScript para Office:
Consulte Información sobre la API de JavaScript para Office y la referencia API de JavaScript para Office.
Ejecute y edite código de la API de JavaScript para Office en Excel Online con el tutorial interactivo de la API de complementos de Office
Las API de JavaScript para Word y Excel proporcionan modelos de objetos específicos del host que se pueden usar en un complemento de Office. Las API permiten obtener acceso a objetos conocidos, como párrafos y libros, lo cual facilita la creación de un complemento de Office para Word y Excel. Para obtener más información sobre estas API, consulte los temas de información general word-add-ins yComplementos de Excel.
Tipos de Complementos de Office
Esta sección describe brevemente los tres tipos de Complementos de Office: panel de tareas, contenido y Outlook.
Complementos de panel de tareas
Los complementos de panel de tareas funcionan junto con los documentos de Office, y permiten brindar información contextual y funciones para mejorar la visualización de documentos y la experiencia de creación de documentos. Por ejemplo, un complemento de panel de tareas puede buscar y recuperar información sobre un producto desde un servicio web a partir del nombre del producto o el número de pieza seleccionado en el documento.
Complemento de panel de tareas
Para probar un complemento de panel de tareas en Excel 2013, Excel Online o Word 2013, instale el complemento Wikipedia.
Complementos de contenido
Los complementos de contenido integran características web como contenido que se puede mostrar alineado con el cuerpo del documento. Los complementos de contenido permiten integrar visualizaciones de datos web enriquecidos, medios incrustados (como un reproductor de vídeo de YouTube o una galería de imágenes), además de otro contenido externo.
Complemento de contenido
Para probar un complemento de contenido en Excel 2013 o Excel Online, instale el complemento Mapas de Bing.
Complementos de Outlook
Los complementos de Outlook se muestran junto a los elementos de Outlook que se están viendo o redactando en ese momento. Pueden funcionar con un mensaje de correo, una convocatoria de reunión, una respuesta a la reunión, una cancelación de la reunión o una cita en un escenario de lectura (cuando el usuario está viendo un elemento recibido) o de redacción (cuando el usuario está escribiendo una respuesta o creando un elemento nuevo). Los complementos de Outlook pueden tener acceso a información contextual del elemento, como la dirección o el identificador de seguimiento, y después usar esos datos para tener acceso a información adicional en el servidor y a información de servicios web para hacer atractiva la experiencia del usuario. En la mayoría de los casos, un complemento de Outlook se ejecuta sin modificaciones en las diversas aplicaciones host compatibles, incluidas Outlook, Outlook para Mac, Outlook Web App y OWA para dispositivos, para proporcionar una experiencia perfecta en dispositivos de escritorio, web, tabletas y móviles.
NotaLos complementos de Outlook necesitan, como mínimo, la versión Exchange 2013 o Exchange Online para hospedar el buzón de correo del usuario. Las cuentas de correo electrónico POP e IMAP no se admiten.
Complemento de Outlook en un escenario de lectura
Para probar un complemento de Outlook en Outlook, en Outlook para Mac o en Outlook Web App, instale el complemento Package Tracker.
Aplicaciones de Office que admiten Complementos de Office
Los Office Add-ins son compatibles con un número cada vez mayor de aplicaciones host de Office que se ejecutan en el escritorio, las tabletas, los dispositivos móviles y Office Online en el explorador. En muchos casos, esto quiere decir que puede desarrollar un solo complemento que se ejecute en distintos sistemas operativos y aplicaciones host de Office. Así los clientes podrán disfrutar de una experiencia coherente en el escritorio, los dispositivos o los exploradores web.
En el caso de los complementos del panel de tareas, esto significa que puede desarrollar un único complemento que se ejecute en Excel, PowerPoint y Word en el escritorio de Windows o con Excel Online, PowerPoint Online y Word Online en un explorador web. En el caso de los complementos de Outlook, quiere decir que puede desarrollar un único complemento que se ejecute con Outlook y Outlook para Mac en el escritorio, con OWA para dispositivos en la tableta y los dispositivos móviles, o con Outlook Web App en un explorador web.
Esta tabla muestra las aplicaciones host de Office (incluidos los clientes de escritorio, tableta, móvil y web) que admiten Complementos de Office y los tipos de complementos que admite cada host.
Tipos de complementos admitidos
Y, al igual que las páginas web, los Complementos de Office están sujetos a las mismas restricciones impuestas por los exploradores, como la directiva del mismo origen para el aislamiento de dominios y las zonas de seguridad.
Además de las capacidades normales de una página web, las Complementos de Office pueden interactuar con el complemento de Office y el contenido del usuario a través de una biblioteca JavaScript que proporciona la infraestructura de los Complementos de Office. La interacción de los complementos con Office dependerá del tipo de complemento:
Para los complementos de panel de tareas y de contenido, la API permite al complemento leer y escribir documentos, así como controlar eventos de aplicación y de usuario clave, como cuando se producen cambios en la selección activa. Si desea un resumen de las características disponibles para los complementos de panel de tareas y de contenido, vea Complementos de contenido y panel de tareas para Office 2013.
En los complementos de Outlook, la API permite al complemento obtener acceso a las propiedades del mensaje de correo, la convocatoria de reunión y la cita, así como a la información del perfil de usuario. También proporciona acceso a algunas operaciones de los servicios Web Exchange. Para obtener más información sobre los complementos de Outlook, consulteComplementos de Outlook. Para leer un resumen de las características principales de los complementos de Outlook, consulteIntroducción a las características y la arquitectura de los complementos de Outlook.
Los escenarios siguientes muestran que los Complementos de Office son complementos personalizados y de rápida creación que pueden usarse para resolver problemas complejos.
Estos escenarios recomiendan maneras con las que puede, por ejemplo, explorar datos de línea de negocio y fomentar la adopción de procesos empresariales estructurados desde la interfaz familiar de Office en múltiples dispositivos. Asimismo, recomienda maneras de usar complementos de administración de gastos que se conectan a Office, SharePoint y SAP o de crear un complemento que combine datos de ventas con mapas del servicio web de Mapas de Bing para crear informes de ventas más eficaces. También muestran cómo obtener rendimiento de las inversiones existentes como, por ejemplo, de las aplicaciones de planificación de recursos empresariales (ERP) o de administración de relaciones con los clientes (CRM), reduciendo el tiempo empleado en navegar desde estas aplicaciones a los clientes de Office y viceversa..
Los escenarios incluyen:
Asistente para la traducción: complemento de panel de tareas de Word que traduce automáticamente el texto seleccionado del idioma del documento a otro idioma seleccionado en una lista desplegable.
Creación de diagramas: complemento de contenido de Excel que crea gráficos automáticamente a partir de datos seleccionados.
Integración con servicios de terceros: complemento de panel de tareas de Word o Excel que muestra automáticamente la página de Wikipedia que corresponda al texto seleccionado.
Aplicaciones web mixtas enriquecidas: complemento de contenido de mapa de Bing en Excel que traza datos de ubicaciones de recursos y equipos marinos para una empresa petrolífera. Esta aplicación recupera la información en tiempo real desde el sistema de administración de recursos empresarial.
Validación de especificaciones: sección o párrafo de especificaciones de diseño de componentes de aviones etiquetados como obsoletos por el complemento de panel de tareas de Word que se comunica con un sistema empresarial para validar los contenidos con las especificaciones más recientes.
Inicio de flujos de trabajo: un complemento de Outlook le ayuda a crear un mensaje o una convocatoria de reunión basándose en diversas plantillas, insertar detalles del lugar de la reunión o la firma que elija el usuario y también adjuntar documentos relacionados.
Exploración de detalles del pedido en contexto: complemento de Outlook que detecta números de pedidos de compra o números de clientes en mensajes de correo y muestra los detalles del pedido o del cliente en el mensaje. Pueden ser características de acción, por ejemplo, la aprobación.