Administrar un manifiesto unificado y una versión de manifiesto de solo complemento del complemento de Office
Microsoft está realizando una serie de mejoras en la plataforma para desarrolladores de Microsoft 365. Estas mejoras proporcionan más coherencia en el desarrollo, la implementación, la instalación y la administración de todos los tipos de extensiones de Microsoft 365, incluidos los complementos de Office.
Una mejora importante en la que estamos trabajando es la capacidad de crear una sola unidad de distribución para todas las extensiones de Microsoft 365 mediante el mismo formato de manifiesto: el manifiesto unificado con formato JSON para Microsoft 365.
Sugerencia
Para obtener información sobre cómo convertir un complemento existente para usar el manifiesto unificado, consulte Conversión de un complemento para usar el manifiesto unificado para Microsoft 365.
Después de crear una versión del complemento que usa el manifiesto unificado, debe vincular el complemento existente y la aplicación compilada mediante el manifiesto unificado para asegurarse de que los usuarios no ven dos copias de la interfaz de usuario del complemento dentro de Outlook.
Nota:
La configuración que se describe a continuación no surte efecto hasta 24 horas después de instalar la nueva versión en el equipo de un usuario. Durante ese período, la interfaz de usuario de ambas versiones es visible. Por ejemplo, si ambas versiones tienen un botón de cinta personalizado, ambos botones aparecen en la cinta de opciones.
Siga estos pasos.
Abra el objeto de extensión en la matriz "extensiones".
Cree una propiedad de matriz "alternativa", si aún no hay ninguna.
En la matriz "alternatives", cree un objeto "alternativo" que tenga una propiedad "hide".
Si el complemento existente se comercializa a través de AppSource, asigne al objeto "hide" una propiedad "storeOfficeAddin". De lo contrario, vaya al paso 6.
Asigne al objeto "storeOfficeAddin" dos propiedades:
- Un "officeAddinId" con el GUID del complemento antiguo como su valor.
- Un "assetId" con el identificador de recurso de AppSource como su valor.
A continuación puede ver un ejemplo:
"extensions": [ ... { ... "alternates": [ ... { ... "hide": { "storeOfficeAddin": { "officeAddinId": "b5a2794d-4aa5-4023-a84b-c60a3cbd33d4", "assetId": "WA999999999" } } } ] } ]Nota:
- El identificador de recurso del complemento en el manifiesto unificado debe coincidir con un complemento existente publicado por su cuenta de vendedor en el Centro de partners. Si el identificador de recurso del complemento que ha vinculado en el manifiesto unificado no coincide con una oferta existente publicada por su cuenta de vendedor, se producirá un error en el envío del manifiesto unificado. Tendrá que actualizar el manifiesto para usar el identificador de recurso del complemento correcto y volver a enviar el manifiesto unificado.
- Un complemento existente solo se puede ocultar mediante un único manifiesto unificado. En este momento, no puede usar varios manifiestos unificados para ocultar el mismo complemento. Si intenta ocultar un complemento ya vinculado mediante un manifiesto unificado diferente, se producirá un error en el envío. Tendrá que quitar la vinculación y volver a enviar el manifiesto unificado.
Si el complemento anterior no se distribuye a través de AppSource, asigne al objeto "hide" una propiedad "customOfficeAddin".
Asigne al objeto "customOfficeAddin" una propiedad "officeAddinId" con el GUID del complemento antiguo como su valor. A continuación se muestra un ejemplo.
"extensions": [ ... { ... "alternates": [ ... { ... "hide": { "customOfficeAddin": { "officeAddinId": "b5a2794d-4aa5-4023-a84b-c60a3cbd33d4" } } } ] } ]
No quite el complemento existente de AppSource o del Centro de administración de Microsoft 365, o las versiones anteriores de Office ya no podrán usar el complemento.
Mantenimiento de ambas versiones para el futuro inmediato
Por lo general, los complementos que usan el manifiesto unificado solo se pueden instalar en Microsoft 365 versión 2307 (compilación 16626.20132) y versiones posteriores. Sin embargo, hay dos excepciones que permiten que estos complementos se instalen en versiones anteriores de Microsoft 365 y en versiones de licencia perpetua de Office.
- El administrador de Microsoft 365 del usuario implementa el complemento para todos los usuarios.
- El usuario instala el complemento en otra aplicación cliente de Microsoft 365 que es la versión 2307 (compilación 16626.20132) y versiones posteriores. Esto hace que el complemento esté disponible en los demás clientes de Office del mismo usuario, incluida la licencia anterior o perpetua.
Si tiene usuarios en versiones de licencia anteriores o perpetuas para las que estas excepciones no se aplican, tendrá que mantener ambas versiones del complemento. Cuando todos los usuarios trabajan con versiones de Office que admiten el manifiesto unificado, puede quitar la versión XML de la implementación.
También hay algunos escenarios en los que es posible que desee mantener ambas versiones del complemento durante un período prolongado. Por ejemplo, hay dos características de complementos que no se admiten con el manifiesto unificado porque están poco usados o en desuso. Puede optar por mantener una versión del complemento que use estas características. A continuación se muestran las características que no se admiten en el manifiesto unificado.
- No se admiten los módulos de Outlook. Pero puede proporcionar una experiencia casi idéntica mediante el manifiesto unificado mediante la inclusión de una pestaña de Teams con el complemento en una sola aplicación.
- No se admiten complementos contextuales de Outlook (también conocidos como "reglas de activación"). Pero puede proporcionar experiencias similares mediante el manifiesto unificado y la activación basada en eventos.
El requisito fundamental para que dos versiones estén disponibles es asegurarse de que las dos aparecen distintas en la interfaz de usuario de Outlook.
- Asigne a la nueva versión un nombre diferente del complemento existente.
- Cree y use iconos diferentes para la nueva versión.
- Asegúrese de que la propiedad "id" del manifiesto unificado de la nueva versión es un GUID diferente del <elemento Id> del manifiesto de solo complemento del complemento existente.
Nota:
Si usa el mismo nombre e icono, las soluciones antiguas y nuevas aparecen indistinguibles en la interfaz de usuario de Outlook para la instalación del complemento.