Actualizar y mantener el complemento de Office

Después de publicar el complemento, debe mantenerlo actualizado con los cambios importantes de las bibliotecas ascendentes. La revisión de problemas de seguridad es fundamental para crear 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.

Elección del 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 es necesario realizar actualizaciones importantes en aras de la seguridad o confiabilidad. En esos casos poco frecuentes, se realizan los pasos siguientes para garantizar que los usuarios del complemento no se ven afectados.

Directiva de desuso

Las herramientas pueden estar 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 estar en desuso cuando su tarea se realiza mejor con las API más recientes. Microsoft hace todo lo posible para declarar desusos con al menos 24 meses de antelación. El desuso no significa necesariamente que los desarrolladores quiten la característica o la API e inutilizables. Pero después de 24 meses, Microsoft ya no 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 está marcada como en desuso, se recomienda encarecidamente migrar a las API de reemplazo lo antes posible. En algunos casos, anunciaremos que las nuevas aplicaciones deben empezar a usar las nuevas API poco tiempo 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 durante mucho tiempo supone un riesgo de seguridad para el complemento o Microsoft.

App Assure

El servicio App Assure de Microsoft cumple la promesa de Compatibilidad de aplicaciones de Microsoft: las aplicaciones funcionarán en Windows y Aplicaciones Microsoft 365. Los ingenieros de App Assure están disponibles para ayudar a resolver cualquier problema que pueda experimentar sin costo 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 principal.
  • Proporcione instrucciones para ayudarle a corregir el problema de compatibilidad de 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 producto.

Para obtener más información sobre App Assure, vea Traer sus aplicaciones a Microsoft Edge con App Assure: sugerencias y trucos. Para enviar la 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.

Actualización del complemento

Al actualizar el complemento, hay dos elementos a tener en cuenta: la aplicación web y el paquete del complemento, incluido el manifiesto.

Actualización de la aplicación web

Novedades a la aplicación web no requieren ninguna acción de los usuarios. Cargue nuevos archivos HTML, CSS, código y otros archivos en la aplicación web y las redes CDN, y los usuarios comenzarán a ver automáticamente las nuevas características. Algunos artefactos de complemento, como iconos de botón, se almacenan en caché cuando el complemento se instala por primera vez. Es posible que los usuarios no vean iconos actualizados inicialmente. Si los usuarios se confunden al ver los iconos anteriores, cerrar y volver a abrir la aplicación de Office debe hacer que se descargue la versión más reciente de los artefactos. Si esto no sucede, puede indicarles cómo cerrar todas las aplicaciones de Office y, a continuación, borrar la memoria caché de Office. Al hacerlo, 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 retraso muy pequeño en la aparición de los iconos.

Actualización de los archivos del paquete de la aplicación

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

Cada vez 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 adicionales 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 version.
  • Si el complemento usa el manifiesto de solo complemento (en cuyo caso no hay ningún paquete de aplicación), consulte Elemento Version.

Si uno o varios administradores implementan el complemento en sus organizaciones, algunos cambios de manifiesto requieren que el administrador dé su consentimiento a las actualizaciones. Los usuarios se bloquean del complemento hasta que se concede el consentimiento. Los siguientes cambios de manifiesto requieren que el administrador dé su consentimiento de nuevo.

Mantener el complemento seguro

Los proyectos de complemento que se crean con Yeoman Generator para complementos de Office o microsoft 365 Agents Toolkit se basan en varias bibliotecas de Microsoft y otras. Estas bibliotecas se actualizan independientemente de cualquier actividad de Microsoft 365. Los proyectos deben mantenerse actualizados a medida que desarrolle, publique y mantenga el complemento. Las herramientas siguientes pueden ayudar a garantizar que el proyecto usa versiones seguras de cualquier biblioteca dependiente.

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

Solución de problemas

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

Participación de la comunidad

A medida que se proponen actualizaciones para la Plataforma para desarrolladores de Microsoft 365, escucharemos los comentarios. Informe de problemas, posibles consecuencias u otras preguntas a los canales enumerados en los recursos adicionales de complementos de Office.

Manténgase informado de las nuevas características y los procedimientos recomendados en evolución a través de nuestra llamada comunitaria mensual de complementos de Office.

Vea también

  • Last updated on