Mantener el complemento de Office

  • Artículo

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.

Cambios importantes en Office.js

La Plataforma para desarrolladores de Microsoft 365 se compromete a garantizar la compatibilidad del complemento. 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 API o herramientas con mejores alternativas pueden estar en desuso. Microsoft se somete a un mejor esfuerzo para declarar algo como en desuso al menos 24 meses antes de retirarlo. De manera similar, para las API individuales que cuentan con disponibilidad general (GA), Microsoft declara una API como obsoleta al menos 24 meses antes de eliminarla de la versión GA.

El desuso no significa necesariamente que los desarrolladores quiten la característica o la API e inutilizables. Muestra que después del período de tiempo de 24 meses, Microsoft ya no admitirá la API o la característica.

Una vez que se indica que la API está en desuso, se recomienda encarecidamente migrar a la versión más reciente 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, watch Traiga 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.

Cambios en plantillas y dependencias web de Yeoman

El generador de Yeoman para complementos de Office se basa en una serie de bibliotecas de Microsoft y otras. Estas bibliotecas se actualizan independientemente de cualquier actividad de Microsoft 365. Los proyectos creados con el generador 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.

office.js paquete NPM

El paquete NPM de office-js es una copia de lo que se hospeda en la red de entrega de contenido (CDN)Office.js. Está pensado para escenarios en los que no es posible el acceso directo a la red CDN. El paquete NPM no está pensado para proporcionar referencias con versiones a office.js. Se recomienda usar siempre la red CDN para asegurarse de que usa la versión más reciente de las API de JavaScript de Office.

Procedimientos recomendados actuales

Aunque nos esforzamos por mantener la compatibilidad con versiones anteriores, los patrones y prácticas que recomendamos evolucionan continuamente. Nuestra documentación se esfuerza por presentar los procedimientos recomendados actuales. Para mantenerse informado de las nuevas características que pueden mejorar la funcionalidad existente, únase a nuestra llamada mensual de la comunidad de complementos de Office.

Implementar actualizaciones

Al agregar características o corregir errores en el complemento, deberá implementar las actualizaciones. Si uno o varios administradores implementan el complemento en sus organizaciones, algunos cambios de manifiesto requerirán que el administrador dé su consentimiento a las actualizaciones. Los usuarios se bloquearán desde el complemento hasta que se conceda el consentimiento. Los siguientes cambios en el manifiesto requerirán que el administrador dé su consentimiento de nuevo.

Nota:

Cada vez que realice un cambio en el manifiesto, debe aumentar el número de versión del manifiesto.

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.