Actualización y mantenimiento del complemento de Office

Después de publicar el complemento, debe mantenerlo actualizado con los cambios importantes de las bibliotecas ascendentes. Aplicar parches a los problemas de seguridad es fundamental para generar confianza en los clientes. Dado que estos cambios no tienen ningún efecto en el manifiesto publicado, los clientes no tendrán que realizar ninguna acción para obtener las versiones más recientes del complemento.

Elija el escenario

Cambios importantes en Office.js

Nos esforzamos por evitar realizar cambios importantes en la superficie y el comportamiento de la API. Sin embargo, hay casos en los que necesitamos realizar actualizaciones importantes por razones de seguridad o confiabilidad. En esos casos excepcionales, se realizan los pasos siguientes para garantizar que los usuarios del complemento no se vean afectados.

Directiva de desuso

Las herramientas pueden quedar en desuso cuando hay algo mejor disponible, y las API de la Biblioteca de JavaScript de Office (Office.js) que están disponibles con carácter general (GA) pueden quedar en desuso cuando su tarea se realiza mejor con las API más recientes. Microsoft hace todo lo posible por declarar los desusos con al menos 24 meses de antelación. El desuso no significa necesariamente que la característica o API vaya a ser eliminada y no utilizable por los desarrolladores. Pero después de 24 meses, Microsoft dejará de admitir la herramienta o la API, y la herramienta puede retirarse y la API puede quitarse de la versión de disponibilidad general de Office.js.

Cuando una API se marca como obsoleta, se recomienda encarecidamente que migre a las API de reemplazo lo antes posible. En algunos casos, anunciaremos que las nuevas aplicaciones deben empezar a usar las nuevas API poco después de que las API originales estén en desuso. En estos casos, únicamente las aplicaciones activas que estén utilizando las API en desuso podrán continuar utilizándolas.

Importante

El período de desuso de 24 meses se acelerará si esperar tanto tiempo supone un riesgo de seguridad para el complemento o Microsoft.

App Assure

El servicio App Assure de Microsoft cumple la promesa de Microsoft de compatibilidad de aplicaciones: sus aplicaciones funcionarán en Windows y en Aplicaciones Microsoft 365. Los ingenieros de App Assure están disponibles para ayudarle a resolver cualquier problema que pueda experimentar sin coste adicional.

Si encuentra un problema de compatibilidad de aplicaciones, los ingenieros de App Assure trabajarán con usted para ayudarle a resolver el problema. Nuestros expertos:

  • Ayudarle a solucionar problemas e identificar una causa raíz.
  • Proporcionar instrucciones para ayudarle a corregir el problema de compatibilidad de las aplicaciones.
  • Engage con proveedores de software independientes (ISV) en su nombre para corregir alguna parte de su aplicación, de modo que sea funcional en la versión más moderna de nuestros productos.
  • Trabaje con los equipos de ingeniería de productos de Microsoft para corregir errores de productos.

Para obtener más información sobre App Assure, consulta Llevar las aplicaciones a Microsoft Edge con App Assure: sugerencias y trucos. Para enviar su solicitud de compatibilidad de aplicaciones con App Assure, complete el formulario de registro de Microsoft FastTrack o envíe un correo electrónico a achelp@microsoft.com.

Actualizar el complemento

Al actualizar el complemento, hay dos partes a considerar: la aplicación web y el paquete de complementos, incluido el manifiesto.

Actualizar la aplicación web

Las novedades de la aplicación web no requieren ninguna acción por parte de los usuarios. Cargue nuevos archivos HTML, CSS, código y otros archivos en la aplicación web y las CDN y los usuarios empezarán a ver automáticamente las nuevas características. Algunos artefactos, como los iconos de botón, se almacenan en caché cuando se instala el complemento por primera vez. Es posible que los usuarios no vean los iconos actualizados inicialmente. Si los usuarios se sienten confundidos al ver los iconos más antiguos, cerrar y volver a abrir la aplicación de Office debería hacer que se descargue la versión más reciente de los artefactos. Si esto no ocurre, puede indicarles cómo cerrar todas las aplicaciones de Office y luego borrar la memoria caché de Office. Al hacer eso, se quitarán los artefactos almacenados en caché de todos sus complementos instalados, pero se descargarán de nuevo la próxima vez que se inicie la aplicación de Office, por lo que el único efecto de esto es un ligero retraso en la aparición de los iconos.

Actualizar los archivos de paquete de la aplicación

Los cambios en el manifiesto u otros archivos del paquete de la aplicación requieren que los usuarios los actualicen. Si ha publicado el complemento en Microsoft Marketplace, tendrá que actualizar el envío. Se encuentra más información sobre ese proceso en el artículo Actualizar una oferta existente.

Siempre que realice un cambio en el manifiesto o en cualquier archivo del paquete de la aplicación, debe aumentar el número de versión del manifiesto. (Esto incluye cambios en las direcciones URL del manifiesto que apuntan a archivos de configuración complementarios en el paquete de la aplicación, como los archivos de configuración de Copilot).

  • Si el complemento usa el manifiesto unificado, consulte la propiedad de versión.
  • Si el complemento usa el manifiesto de solo complemento (en cuyo caso no hay ningún paquete de aplicación), consulte Elemento de versión.

Si uno o más administradores implementan el complemento en sus organizaciones, algunos cambios en el manifiesto requieren que el administrador dé su consentimiento a las actualizaciones. Se bloquea el acceso de los usuarios al complemento hasta que se conceda el consentimiento. Los siguientes cambios en el manifiesto requieren que el administrador vuelva a dar su consentimiento.

Mantener seguro el complemento

Los proyectos de complementos que se crean con los complementos de Yeoman Generator para Office o el kit de herramientas de agentes de Microsoft 365 se basan en varias bibliotecas de Microsoft y otros usuarios. Estas bibliotecas se actualizan independientemente de cualquier actividad de Microsoft 365. Los proyectos deben mantenerse actualizados a medida que desarrolla, publica y mantiene el complemento. Las siguientes herramientas pueden ayudar a garantizar que el proyecto usa versiones seguras de las bibliotecas dependientes.

Esta guía también se aplica a copias de ejemplos tomadas del complemento de Office, ejemplos de código y otros orígenes.

Solución de problemas

  • Mis usuarios no pueden acceder al complemento actualizado. Comprueba que se incrementó la versión del manifiesto y actualizó el envío de Marketplace.
  • Los diálogos de consentimiento del Administrador no aparecen. Asegúrese de que los permisos, ámbitos o eventos han sido realmente modificados. Prueba en el inquilino de desarrollo.

Compromiso de la comunidad

A medida que se propongan actualizaciones para la Plataforma de desarrollador de Microsoft 365, estaremos atentos a los comentarios. Notifique problemas, posibles consecuencias u otras preguntas a los canales enumerados en Recursos adicionales de complementos de Office.

Vea también

  • Se actualizó por última vez el