Compartir a través de

Guía general para combinar un complemento de Office y una aplicación de Teams

  • Artículo

Cuando tiene una aplicación de Teams y un complemento de Office que tienen funciones y cargas de trabajo estrechamente relacionadas o superpuestas, se recomienda combinarlas en una sola aplicación. Esto permite a los usuarios y administradores de inquilinos de Microsoft 365 adquirir y aprobar tanto el complemento como la aplicación de Teams como una unidad. Para obtener un ejemplo de una aplicación que combina un complemento y una aplicación de Teams, vea Ejemplo de ofertas de descuento.

Nota:

Los complementos de Outlook son el único tipo de complemento de Office que se puede combinar con una aplicación de Teams. Estamos trabajando duro para admitir esta característica para Excel, PowerPoint y Word complementos también.

No puede haber ningún procedimiento algorítmica para combinar un complemento y una aplicación de Teams por los siguientes motivos:

  • Un algoritmo tendrá que hacer suposiciones sobre la carpeta y la estructura de archivos de la aplicación de Teams existente. Pero estas estructuras varían según la herramienta que se usó para crear el proyecto de aplicación y la versión de esa herramienta. Y, por supuesto, el desarrollador de la aplicación podría haber cambiado la estructura después de crear el proyecto.
  • La viñeta anterior también se aplica al proyecto de complemento.
  • Un algoritmo tendrá que hacer suposiciones sobre la configuración en varios archivos de configuración. Pero esta configuración también variará en función de cómo se creó el proyecto y de los cambios realizados en la configuración desde su creación.
  • Un algoritmo tendrá que hacer una suposición sobre qué lenguaje, TypeScript o JavaScript, se usó para el código fuente del lado cliente de la aplicación web.

Nota:

Además de estas viñetas, tenga en cuenta también que hay dos familias básicas de marcos de aplicaciones web en las que es posible que se haya creado el complemento o la aplicación de Teams.

Visual Studio no admite actualmente el manifiesto unificado en los proyectos de complementos, por lo que en este artículo se supone que tanto el complemento como los proyectos de aplicaciones de Teams se basan en Node.js y no se crean con Visual Studio.

Sin embargo, podemos realizar algunas recomendaciones generales sobre cómo combinar un complemento con una aplicación de Teams.

Más información sobre el manifiesto y la estructura de una aplicación de Teams combinada y un complemento de Office

Antes de empezar a trabajar combinando las dos extensiones existentes, obtenga una idea de cómo combinar los dos tipos de extensiones mediante la creación de una nueva aplicación de Teams y un nuevo complemento en el kit de herramientas de Teams y, a continuación, siga las instrucciones de Incorporación de un complemento de Outlook a una aplicación de Teams para combinarlas. Preste mucha atención a lo siguiente:

  • Cómo se crea el manifiesto unificado único.
  • Las diferencias en la forma en que el complemento y la aplicación de Teams se cargan y depuran de forma local.

Siga los principios adecuados para combinar aplicaciones y complementos de Teams

Cuando esté listo para combinar el complemento existente y la aplicación de Teams, siga estos principios:

  • Si el complemento usa un manifiesto XML, conviértalo para usar el manifiesto unificado para Microsoft 365 como se describe en Conversión de un complemento para usar el manifiesto unificado para Microsoft 365 antes de combinarlo con una aplicación de Teams.
  • Use el proyecto de aplicación de Teams como proyecto base para la aplicación combinada.
  • Mantenga los archivos de configuración que son aplicables tanto al complemento como a la aplicación teams en la raíz del proyecto.
  • Mueva los archivos de origen y los archivos de configuración que solo son aplicables a la aplicación de Teams a una subcarpeta de la raíz del proyecto. Del mismo modo, copie los archivos de origen y configuración que solo usa el complemento del complemento existente en una subcarpeta diferente de la raíz del proyecto combinado.
  • Use el mismo dominio base para los archivos integrados del complemento y la aplicación de Teams; por ejemplo, contoso.com.
  • Combine los dos manifiestos en un único manifiesto. Use el proceso que realizó en el paso 1 como guía.
  • La propiedad id del nuevo manifiesto debe ser el mismo valor que la propiedad "id" del manifiesto de aplicación original de Teams.
  • Genere el valor de la propiedad version ; por ejemplo, genere "1.0.0" a "1.1.0".
  • Agregue una propiedad extensions.alternates al manifiesto y configúrelo para ocultar las versiones originales del complemento de Office de Office que admiten la combinación de un complemento y una aplicación de Teams. Para obtener más información, vea Administrar versiones nuevas y antiguas de un complemento.

Publicación de la aplicación de Teams combinada y el complemento de Office

Para publicar la aplicación combinada, trátala como una actualización de la aplicación de Teams. Para obtener más información, consulte Publicación de actualizaciones en la aplicación.

Cuando se ha publicado la actualización, la forma en que la actualización está disponible para los usuarios finales varía. Los siguientes son los principios generales.

Nota:

Para tener claro lo que significa "disponible", tenga en cuenta que Outlook y la aplicación de Microsoft 365 tienen una barra de aplicaciones igual que Teams. En principio, se puede instalar una "aplicación de Teams" desde el botón Aplicaciones o Más aplicaciones en cualquiera de estas tres barras de aplicación. La "aplicación de Teams" instalada se puede iniciar desde (o anclada por separado a) cualquiera de las barras de aplicación de cualquiera de las tres aplicaciones. Por otro lado, un complemento independiente de Outlook se instala mediante el botón Todas las aplicaciones de la cinta de opciones de Outlook. Y, independientemente de si es independiente o combinado en una aplicación de Teams, se inicia un complemento desde la cinta de opciones de Outlook o se inicia automáticamente en respuesta a un evento en el mensaje de Outlook abierto o en el elemento de reunión. Estos hechos se asumen en el resto de esta sección.

  • Si el administrador de Microsoft 365 da su consentimiento a la actualización, haga lo siguiente:

    • La versión actualizada de la aplicación de Teams está disponible inmediatamente desde Aplicaciones o Más aplicaciones en Outlook y la aplicación de Microsoft 365, pero no las aplicaciones de Teams, a los usuarios que habían adquirido anteriormente la aplicación teams.
    • El complemento de Outlook también está disponible inmediatamente para los usuarios que anteriormente habían adquirido la aplicación teams, independientemente de si también habían adquirido previamente el complemento.
    • Si un administrador de Teams permite la actualización, los usuarios pueden instalarla individualmente en Teams desde las aplicaciones de Teams.

  • Si el administrador no da su consentimiento, cada usuario que haya adquirido previamente la aplicación de Teams debe dar su consentimiento a la actualización y solo se puede poner a disposición en Teams si el administrador de Teams lo ha permitido.

  • Los usuarios que hayan adquirido anteriormente solo el complemento de Office deben adquirir la nueva aplicación combinada de la tienda teams. No se puede adquirir a través del botón Todas las aplicaciones de la cinta de opciones de Outlook.

Importante

Es posible que los usuarios con ciertas versiones anteriores de Office sigan viendo la versión anterior del complemento, incluso después de adquirir la nueva aplicación combinada. Por lo general, los complementos que usan el manifiesto de aplicación unificado para Microsoft 365 (anteriormente manifiesto de aplicación de Teams) 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 Outlook en la Web, nueva Outlook para Windows o en otra aplicación cliente de escritorio de Microsoft 365 que sea la versión 2307 (compilación 16626.20132) o posterior. Esto hace que el complemento esté disponible en los demás clientes de Office del mismo usuario, incluidos los clientes de licencias anteriores o perpetuos.

En el futuro, solo tendrá que actualizar la nueva versión de la aplicación.

Recursos adicionales