Ejemplos de código de complementos de Office

Estos ejemplos de código se escriben para ayudarle a aprender a usar varias características al desarrollar complementos de Office.

Introducción

En los siguientes ejemplos se muestra cómo crear un complemento de Office básico con solo un manifiesto, una página HTML y un logotipo. Estas son las partes fundamentales de un complemento de Office. Para más información sobre cómo empezar, consulte nuestras guías de inicio rápido y tutoriales.

Complementos de panel de tareas

Complementos de contenido

Tutoriales completados

Nombre Descripción
Tutorial de Excel Este ejemplo es la versión completa de Tutorial: Crear un complemento del panel de tareas de Excel que muestra cómo crear un complemento de Excel con un panel de tareas y botones de la cinta de comandos. El complemento muestra cómo crear y ordenar una tabla, crear un gráfico, inmovilizar una fila, proteger una hoja de cálculo y mostrar un cuadro de diálogo.
Tutorial de Outlook Este ejemplo es la versión completa del complemento Tutorial: Crear un complemento de Outlook para la redacción de mensajes , que muestra cómo crear un complemento de Outlook para la superficie de redacción de mensajes. El complemento muestra cómo recopilar información del usuario, capturar datos de un servicio externo, implementar un comando de función, implementar un panel de tareas, insertar contenido en el cuerpo de un mensaje y mostrar un cuadro de diálogo.
Tutorial de PowerPoint (yo office) Este ejemplo es la versión completa de Tutorial: Crear un complemento del panel de tareas de PowerPoint que muestra cómo crear un complemento de PowerPoint con un panel de tareas. El complemento muestra cómo agregar una imagen a una diapositiva, agregar texto a una diapositiva, obtener metadatos de diapositivas y navegar entre diapositivas.
PowerPoint tutorial (Visual Studio) Este ejemplo es la versión completa de Tutorial: Crear un complemento del panel de tareas de PowerPoint que muestra cómo crear un complemento de PowerPoint con un panel de tareas. El complemento muestra cómo agregar la foto del día de Bing a una diapositiva, agregar texto a una diapositiva, obtener metadatos de diapositivas y navegar entre diapositivas.
Tutorial de Word Este ejemplo es la versión completa de Tutorial: Crear un complemento del panel de tareas de Word que muestra cómo crear un complemento de Word con un panel de tareas. El complemento muestra cómo insertar y reemplazar rangos de texto, párrafos, imágenes, HTML, tablas y controles de contenido.
Tutorial de experiencia de primera ejecución del complemento de Office Este ejemplo es la versión completa de Crear un complemento de Office con una experiencia básica de primera ejecución que muestra los conceptos básicos de la implementación de una experiencia de primera ejecución (FRE). En este ejemplo se usa Excel, pero el patrón se puede aplicar a otras aplicaciones de Office en las que se admiten los complementos web de Office.

WebAssembly de Blazor

Si su experiencia de desarrollo está en la creación de complementos de VSTO, en los ejemplos siguientes se muestra cómo crear complementos web de Office con .NET Blazor WebAssembly. Puede conservar gran parte del código en C# y Visual Studio.

Excel

Nombre Descripción
Crear un libro de Excel desde un sitio web con un panel de tareas de apertura automática Cree un libro de Excel a partir de datos de sitios web utilizando Node.js y configúrelo para que se abra automáticamente un panel de tareas del complemento de Office personalizado al abrir el documento.
Explorador de tipos de datos Cree y explore tipos de datos en los libros. Los tipos de datos permiten a los desarrolladores de complementos organizar estructuras de datos complejas como objetos, como valores de número con formato, imágenes web y valores de entidad.
Abrir en Teams Cree una nueva hoja de cálculo de Excel en Microsoft Teams que contenga los datos que usted defina.
Insertar un archivo Excel externo y rellenarlo con datos JSON Inserte una plantilla existente de un archivo Excel externo en el libro de Excel abierto actualmente. A continuación, rellene la plantilla con datos de un servicio web JSON.
Crear pestañas contextuales personalizadas en la cinta de opciones Cree una pestaña contextual personalizada en la cinta de opciones de la interfaz de usuario de Office. El ejemplo crea una tabla y, cuando el usuario mueve el foco dentro de la tabla, se muestra la pestaña personalizada. Cuando el usuario se mueve fuera de la tabla, se oculta la pestaña personalizada.
Ejemplo de función personalizada con un trabajo web Use trabajos web en funciones personalizadas para evitar el bloqueo de la interfaz de usuario del complemento de Office.
Usar técnicas de almacenamiento para obtener acceso a los datos desde un complemento de Office cuando esté sin conexión Implemente localStorage para habilitar funcionalidad limitada para su complemento de Office cuando un usuario pierda la conexión.
Patrón de procesamiento por lotes de funciones personalizadas Procese por lotes de varias llamadas en una sola llamada para reducir el número de llamadas de red a un servicio remoto.
Complemento de contenido de Excel Inserte un complemento de contenido en la cuadrícula de Excel.
Visualización de datos en un complemento de contenido Cree un complemento de contenido de Excel que incluya visualización de datos.
Ejemplo de función personalizada sincrónica (versión preliminar) Se usa @supportSync para crear una función personalizada sincrónica que lea el valor de una celda junto con el proceso de cálculo de Excel. Esta característica está en versión preliminar pública.
Habilidad para Copilot en Excel (versión preliminar) Cree una aptitud personalizada para Copilot en Excel que use las API específicas de Excel en la biblioteca JavaScript de Office. Esta característica está en versión preliminar pública.

Outlook

Nombre Descripción
Cifrar y descifrar mensajes en Outlook Use las alertas inteligentes de Outlook y el OnMessageDecrypt evento para cifrar y descifrar mensajes.
Notificar correos electrónicos de spam o suplantación de identidad (phishing) en Outlook Cree una solución integrada de informes de correo no deseado que sea fácilmente reconocible en la cinta de opciones del cliente de Outlook. La solución proporciona al usuario un cuadro de diálogo para informar de un correo electrónico. También guarda una copia del correo electrónico notificado en un archivo para su posterior procesamiento en el sistema back-end.
Cifre datos adjuntos, procese asistentes a convocatorias de reunión y reaccione a los cambios de fecha y hora de las citas mediante la activación basada en eventos de Outlook Utilice la activación basada en eventos para cifrar los archivos adjuntos cuando los agregue el usuario. Utilice también la administración de eventos para los cambios de destinatarios en una convocatoria de reunión y los cambios en la fecha u hora de inicio o finalización de una convocatoria de reunión.
Identificar y etiquetar destinatarios externos con la activación basada en eventos de Outlook Use la activación basada en eventos para ejecutar un complemento de Outlook cuando el usuario cambie de destinatario mientras redacta un mensaje. El complemento también usa la API de appendOnSendAsync para agregar un aviso de declinación de responsabilidades.
Establecer la firma usando la activación basada en eventos de Outlook Use la activación basada en eventos para ejecutar un complemento de Outlook cuando el usuario crea un nuevo mensaje o cita. El complemento puede responder a eventos, incluso cuando el panel de tareas no está abierto. También usa la API de setSignatureAsync.
Verificar las categorías de color de un mensaje o cita antes de enviarlo mediante alertas inteligentes Use las alertas inteligentes de Outlook para comprobar que las categorías de color necesarias se aplican a un nuevo mensaje o cita antes de que se envíe.
Comprobar la etiqueta de confidencialidad de un mensaje Use la API de etiquetas de confidencialidad en un complemento basado en eventos para comprobar y aplicar la etiqueta de confidencialidad Extremadamente confidencial a los mensajes salientes aplicables.
Invocación de un complemento de Outlook desde un mensaje accionable Use una tarjeta adaptable en un mensaje accionable para activar un complemento y mostrar los datos de contexto de inicialización.

Word

Nombre Descripción
Agregar etiquetas automáticamente con un complemento cuando se abre un documento de Word Configure un complemento de Word para que se active cuando se abra un documento.
Obtener, editar y establecer contenido OOXML en un documento Word con un complemento de Word Obtenga, edite y establezca contenido OOXML en un documento de Word. El complemento de ejemplo proporciona un bloc de notas para obtener Office Open XML para su propio contenido y probar sus propios fragmentos editados de Office Open XML.
Importar una plantilla de documento de Word con un complemento de Word Importar plantillas en un documento de Word.
Cargar y escribir Open XML en el complemento de Word Agregar una variedad de tipos de contenido enriquecido a un documento de Word mediante el método setSelectedDataAsync con el tipo de coerción ooxml. El complemento también permite mostrar el marcado de Office Open XML para cada tipo de contenido de ejemplo en la misma página.
Administrar citas con el complemento de Word Administrar citas en un documento de Word.

Autenticación, autorización e inicio de sesión único (SSO)

Nombre Descripción
Complemento de Office con SSO que usa la autenticación de aplicaciones anidadas Use MSAL.js autenticación de aplicaciones anidadas (NAA) en un complemento de Office para acceder a las API de Microsoft Graph para el usuario que ha iniciado sesión. El ejemplo muestra el nombre y el correo electrónico del usuario que ha iniciado sesión. También inserta los nombres de los archivos de la cuenta de Microsoft OneDrive del usuario en el documento.
Complemento de Outlook con SSO que usa la autenticación de aplicaciones anidadas Use MSAL.js autenticación de aplicaciones anidadas (NAA) en un complemento de Outlook para acceder a las API de Microsoft Graph para el usuario que ha iniciado sesión. El ejemplo muestra el nombre y el correo electrónico del usuario que ha iniciado sesión. También inserta los nombres de los archivos de la cuenta de Microsoft OneDrive del usuario en un nuevo cuerpo del mensaje.
Usar SSO con activación basada en eventos en un complemento de Outlook Use SSO para acceder a los datos de Microsoft Graph de un usuario desde un evento desencadenado en un complemento de Outlook.
Complemento de Outlook de ejemplo de inicio de sesión único (SSO) Use la característica SSO de Office para conceder al complemento acceso a los datos de Microsoft Graph.
Obtener datos de OneDrive con Microsoft Graph y msal.js en un complemento de Office Cree un complemento de Office, como una aplicación de página única (SPA) sin back-end, que se conecte a Microsoft Graph para acceder a los libros almacenados en OneDrive para la Empresa y actualizar una hoja de cálculo.
Autenticación del complemento de Office para Microsoft Graph Cree un complemento de Microsoft Office que se conecte a Microsoft Graph para tener acceso a los libros almacenados en OneDrive para la Empresa y actualizar una hoja de cálculo.
Autenticación de complemento de Outlook para Microsoft Graph Cree un complemento de Outlook que se conecte a Microsoft Graph para acceder a los libros almacenados en OneDrive para la Empresa y redactar un nuevo mensaje de correo electrónico.
Inicio de sesión único (SSO) del complemento de Office con ASP.NET Use la API de getAccessToken en Office.js para dar acceso al complemento a los datos de Microsoft Graph. Este ejemplo se compila en ASP.NET.
Inicio de sesión único (SSO) del complemento de Office con Node.js Use la API de getAccessToken en Office.js para dar acceso al complemento a los datos de Microsoft Graph. Este ejemplo se compila en Node.js.

Office

Nombre Descripción
Guardar la configuración personalizada en el complemento de Office Guardar la configuración personalizada dentro de un complemento de Office. El complemento almacena los datos como pares clave-valor, mediante la API de JavaScript para el contenedor de propiedades de Office, las cookies del explorador, el almacenamiento web (localStorage y sessionStorage) o almacenando los datos en un div oculto en el documento.
Usar métodos abreviados de teclado para acciones de complementos de Office Cree métodos abreviados de teclado personalizados para invocar determinadas acciones para el complemento de Office.
Definir KeyTips para los controles de cinta de un complemento de Office Definir KeyTips para los controles de cinta de un complemento de Office.
Mostrar u ocultar controles en una pestaña personalizada de la cinta de opciones Establezca la visibilidad inicial de los grupos y controles en una pestaña de complementos de Office personalizada y cambie su visibilidad en tiempo de ejecución.

Tiempo de ejecución compartido

Nombre Descripción
Compartir datos globales con un tiempo de ejecución compartido Configure un proyecto básico que use el tiempo de ejecución compartido para ejecutar código para los botones de la cinta de opciones, el panel de tareas y las funciones personalizadas en un único tiempo de ejecución del explorador.
Administrar la interfaz de usuario del panel de tareas y la cinta de opciones, y ejecutar código en un documento abierto Cree botones contextuales de la cinta de opciones que se habilitan según el estado del complemento.

Ejemplos adicionales

Nombre Descripción
Usar una biblioteca compartida para migrar el complemento de Visual Studio Tools para Office a un complemento web de Office Use una biblioteca compartida para reutilizar el código al migrar de complementos de VSTO a complementos de Office.
Integrar una función de Azure con la función personalizada de Excel Integre funciones de Azure con funciones personalizadas para migrar a la nube o integrar servicios adicionales.
Ejemplos de código PPP dinámico Explore una colección de ejemplos para controlar los cambios de PPP en complementos COM, VSTO y Office.
Complemento del panel de tareas del calificador de rúbrica para OneNote en la Web Explore los aspectos básicos de los complementos de OneNote con una herramienta de ejemplo para profesores.

Pasos siguientes

Únase al Programa para desarrolladores de Microsoft 365 para obtener recursos e información que le ayuden a crear soluciones para la plataforma de Microsoft 365, incluidas recomendaciones adaptadas a sus áreas de interés.

También puede calificar para una suscripción de desarrollador gratuita que es renovable por 90 días y viene configurada con datos de muestra; para obtener más información, consulte las preguntas frecuentes.

  • Last updated on