Ejemplos de código de complementos de Office

  • Artículo

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.

WebAssembly de Blazor

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

Excel

Nombre Descripción
Explorador de tipos de datos (versión preliminar) Crea un complemento de Excel que le permite crear y explorar 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.
Usar métodos abreviados de teclado para acciones de complementos de Office Configure un proyecto básico de complemento de Excel que use métodos abreviados de teclado.
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.

Outlook

Nombre Descripción
Informar de correos electrónicos no deseados o de suplantación de identidad (phishing) en Outlook Muestra cómo crear una solución integrada de informes de correo no deseado que se puede detectar fácilmente en la cinta de opciones del cliente de Outlook. Proporciona al usuario un cuadro de diálogo de procesamiento para informar de un correo electrónico. Facilita el guardado de una copia del correo electrónico notificado en un archivo para enviarlo al sistema back-end para su posterior procesamiento.
Cifrar datos adjuntos, procesar asistentes a la convocatoria de reunión y reaccionar a los cambios de fecha y hora de la cita 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 mediante 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.
Establecimiento de la firma mediante 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.
Compruebe 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.
Comprobación de la etiqueta de confidencialidad de un mensaje Use la API de etiqueta de confidencialidad en un complemento basado en eventos para comprobar y aplicar la etiqueta de confidencialidad extremadamente confidencial a los mensajes salientes aplicables.
Informar de correos electrónicos no deseados o de suplantación de identidad (phishing) en Outlook (versión preliminar) Cree un complemento integrado de informes de correo no deseado que se muestre en un lugar destacado en la cinta de Opciones de Outlook.

Word

Nombre Descripción
Obtener, editar y establecer contenido OOXML en un documento Word con un complemento de Word Este ejemplo muestra cómo obtener, editar y establecer contenido OOXML en un documento 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.
Importación de una plantilla de documento de Word con un complemento de Word Muestra cómo importar plantillas en un documento de Word.
Cargar y escribir Open XML en el complemento de Word En este complemento de ejemplo, se muestra cómo agregar diferentes tipos de contenido enriquecido a un documento de Word con 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.
Administración de citas con el complemento de Word Muestra cómo administrar citas en un documento Word.

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

Nombre Descripción
Ejemplo de nombre Descripción
---------------- --------------------------------------------------------
Complemento de Office con SSO mediante la autenticación de aplicaciones anidadas Muestra cómo usar 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. En el ejemplo se 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 mediante la autenticación de aplicaciones anidadas Muestra cómo usar 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. En el ejemplo se 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.
Uso del inicio de sesión único con activación basada en eventos en un complemento de Outlook Muestra cómo usar el inicio de sesión único 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 Compile un complemento de Office, como una aplicación de página única (SPA) sin back-end, que se conecte a Microsoft Graph y acceda a los libros almacenados en OneDrive para la Empresa para actualizar una hoja de cálculo.
Autenticación del complemento de Office para Microsoft Graph Obtenga información sobre cómo compilar un complemento de Microsoft Office que se conecte a Microsoft Graph y acceda a los libros almacenados en OneDrive para la Empresa para actualizar una hoja de cálculo.
Autenticación del complemento de Outlook para Microsoft Graph Compile un complemento de Outlook que se conecte a Microsoft Graph y acceda a libros almacenados en OneDrive para la Empresa para 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 Guarde la configuración personalizada dentro de un complemento de Office. El complemento almacena los datos como pares clave-valor, mediante el contenedor de propiedades de la API de JavaScript para Office, las cookies del explorador, el almacenamiento web (localStorage y sessionStorage) o almacenando los datos en un div oculto en el documento.

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 Proporciona una estrategia para la reutilización de 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 Una colección de ejemplos para controlar los cambios de PPP en COM, VSTO y complementos de Office.

Próximos pasos

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

También puede calificar para una suscripción gratuita para desarrolladores que sea renovable durante 90 días y que se configure con datos de ejemplo; Para obtener más información, consulte las preguntas más frecuentes.