Compartir a través de

Guía del desarrollador de complementos de VSTO para complementos web de Office

  • Artículo

Por lo tanto, ha creado algunos complementos de VSTO para aplicaciones de Office que se ejecutan en Windows y ahora está explorando la nueva forma de ampliar Office que se ejecutará en Windows, Mac y la versión del explorador web del conjunto de aplicaciones de Office: Complementos web de Office.

Importante

Los complementos COM y VSTO no se admiten en el nuevo Outlook en Windows que se encuentra actualmente en versión preliminar. Estos complementos siguen siendo compatibles con el cliente de escritorio clásico de Outlook en Windows. Para obtener más información, consulte Desarrollo de complementos de Outlook para nuevas Outlook en Windows.

Su conocimiento de los modelos de objetos para Excel, Word y otras aplicaciones de Office será de gran ayuda, ya que los modelos de objetos de los complementos web de Office siguen patrones similares. Pero habrá algunos desafíos:

  • Trabajará con un lenguaje diferente (JavaScript o TypeScript) en lugar de C# o Visual Basic .NET. (También hay una manera, que se describe más adelante, de reutilizar parte del código existente en un complemento web).
  • Los complementos web de Office se implementan de forma diferente que los complementos de VSTO.
  • Los complementos web de Office son aplicaciones web que se ejecutan en un control de vista web simplificado que está incrustado en la aplicación de Office, por lo que debe obtener una comprensión básica de las aplicaciones web y cómo se hospedan en servidores web o cuentas en la nube.

Por estas razones, gran parte de este artículo duplica nuestra guía para principiantes de las extensiones de Office. Lo que hemos agregado son algunos recursos de aprendizaje para ayudar a los desarrolladores de complementos de VSTO a aprovechar su experiencia y también ayudarles a reutilizar su código existente.

Paso 0: requisitos previos

  • Los complementos web de Office (también conocidos como complementos de Office) son esencialmente aplicaciones web incrustadas en Office. Por lo tanto, primero debe tener una comprensión básica de las aplicaciones web y cómo se hospedan en la web. Hay una gran cantidad de información sobre esto en Internet, en libros y en cursos en línea. Una buena manera de empezar si no tiene conocimientos previos de las aplicaciones web es buscar "¿Qué es una aplicación web?" en el motor de búsqueda.
  • El lenguaje de programación principal que usará en la creación de complementos de Office es JavaScript o TypeScript. Si no está familiarizado con ninguno de estos lenguajes, pero tiene experiencia con VBA, VB.NET, C#, es probable que TypeScript sea más fácil de aprender. De nuevo, hay una gran cantidad de información sobre estos lenguajes en Internet, en libros y en cursos en línea.

Paso 1: empezar con aspectos básicos

Sabemos que está ansioso por empezar a codificar, pero hay algunas cosas sobre los complementos de Office que debe leer antes de abrir el IDE o el editor de código.

  • Descripción general de la plataforma de complementos de Office: descubra qué son los complementos web de Office y en qué se diferencian de las formas anteriores de extender Office, como los complementos VSTO.
  • Desarrollo de complementos de Office: obtenga una descripción general del desarrollo y el ciclo de vida de los complementos de Office, incluidas las herramientas, la creación de una IU de complementos y el uso de las API de JavaScript para interactuar con el documento de Office.

Hay muchos vínculos en esos artículos, pero si está haciendo la transición a complementos web de Office, le recomendamos que vuelva aquí cuando los lea y prosiga con la sección siguiente.

Paso 2: instalar herramientas y crear un primer complemento

Ahora tiene una visión general, así que adéntrese en uno de nuestros inicios rápidos. Para el aprendizaje de la plataforma, recomendamos el inicio rápido de Excel. Hay una versión basada en Visual Studio y otra basada en Node.js y Visual Studio Code. Si realiza la transición desde complementos de VSTO, es probable que encuentre más fácil trabajar con la versión de Visual Studio.

Paso 3: código

No puede aprender a conducir leyendo el manual del propietario, así que comience a codificar con este tutorial de Excel Utilizará la biblioteca JavaScript de Office y algunos XML en el manifiesto del complemento. No es necesario memorizar nada, ya que podrá obtener más información sobre ambos en un paso posterior.

Paso 4: entender la biblioteca de JavaScript

Obtenga el panorama general de la biblioteca de JavaScript de Office con el tutorial Descripción de las API de JavaScript de Office del entrenamiento de Microsoft Learn.

A continuación, explore las API de JavaScript de Office con la herramienta Script Lab : un espacio aislado para ejecutar y explorar las API.

Recurso especial para desarrolladores de complementos de VSTO

Este sería un buen lugar para echar un vistazo al complemento de muestra, Complemento de Excel JavaScript SalesTracker. Fue creado para resaltar las similitudes y diferencias entre los complementos de VSTO y los complementos web de Office, y el archivo Léame de la muestra resalta los puntos importantes de comparación.

Paso 5: entender el manifiesto

Conozca los propósitos del manifiesto del complemento web y una introducción a su marcado XML o JSON en el manifiesto de complementos de Office.

Paso 6 (solo para desarrolladores de VSTO): volver a usar el código de VSTO

Puede volver a usar parte del código de su complemento de VSTO en un complemento web de Office moviéndolo al back-end de la aplicación web en el servidor y haciendo que esté disponible para JavaScript o TypeScript como una API web. Para obtener instrucciones, consulte Tutorial: compartir código entre un complemento de VSTO y un complemento de Office con una biblioteca de códigos compartida.

Siguientes pasos

Enhorabuena por finalizar la ruta de aprendizaje del desarrollador de complementos de VSTO para complementos web de Office. Aquí se muestran algunas sugerencias para seguir explorando nuestra documentación: