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.
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.
- Los anuncios que describen las características afectadas y los cambios recomendados se realizan en el blog para desarrolladores de Microsoft 365.
- Si el complemento se publica en AppSource, se le contactará a través de la información que proporcionó.
- Siempre que sea posible, se contactará a los administradores de los inquilinos de Microsoft 365 afectados ( incluidos los inquilinos del Programa para desarrolladores de Microsoft 365) a través del Centro de mensajes. Es responsabilidad del administrador ponerse en contacto con los proveedores de soluciones de complemento publicadas fuera de AppSource.
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.
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.
Actualización del complemento
Al actualizar el complemento, hay dos elementos a tener en cuenta: la aplicación web y el manifiesto. Novedades a la aplicación web no requieren ninguna acción de los usuarios. Esos usuarios solo tienen el manifiesto en su aplicación de Office. Los cambios en el manifiesto requieren que los usuarios actualicen. Si ha publicado el complemento en AppSource, 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, debe aumentar el número de versión del manifiesto.
- Si el complemento usa el manifiesto de solo complemento, consulte Elemento Version.
- Si el complemento usa el manifiesto unificado, consulte la propiedad 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.
- Cambios en los permisos solicitados. Consulte Solicitud de permisos para el uso de API en complementos y Descripción de los permisos de complementos de Outlook.
- Ámbitos adicionales o modificados. (No aplicable si el complemento usa el manifiesto unificado para Microsoft 365).
- Eventos de Outlook adicionales o modificados.
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.