Partager via

Conseils généraux sur la combinaison d’un complément Office et d’une application Teams

  • Article

Lorsque vous disposez d’une application Teams et d’un complément Office qui ont des fonctionnalités et des charges de travail étroitement liées ou qui se chevauchent, nous vous recommandons de les combiner en une seule application. Cela permet aux utilisateurs et aux administrateurs de locataires Microsoft 365 d’acquérir et d’approuver le complément et l’application Teams en tant qu’unité. Pour obtenir un exemple d’application qui combine un complément et une application Teams, consultez Exemple d’offres de remise.

Remarque

Les compléments Outlook sont le seul type de complément Office pouvant être combiné avec une application Teams. Nous travaillons d’arrache-pied pour prendre en charge cette fonctionnalité pour Excel, PowerPoint et les compléments Word également.

Il ne peut y avoir aucune procédure algorithmique pour fusionner un complément et une application Teams pour les raisons suivantes :

  • Un algorithme doit faire des hypothèses sur la structure des dossiers et des fichiers de l’application Teams existante. Toutefois, ces structures varient en fonction de l’outil utilisé pour créer le projet d’application et de la version de cet outil. Et, bien sûr, le développeur de l’application peut avoir modifié la structure après la création du projet.
  • La puce précédente s’applique également au projet de complément.
  • Un algorithme doit faire des hypothèses sur les paramètres dans différents fichiers de configuration. Toutefois, ces paramètres varient également en fonction de la façon dont le projet a été créé et des modifications apportées à la configuration depuis sa création.
  • Un algorithme doit faire une hypothèse sur le langage, TypeScript ou JavaScript, qui a été utilisé pour le code source côté client de l’application web.

Remarque

En plus de ces puces, notez également qu’il existe deux familles de bases de frameworks d’application web sur lesquelles le complément ou l’application Teams ont peut-être été créés.

Visual Studio ne prend actuellement pas en charge le manifeste unifié dans les projets de complément. Cet article suppose donc que les projets de complément et d’applications Teams sont basés sur des Node.js et ne sont pas créés avec Visual Studio.

Toutefois, nous pouvons formuler des recommandations générales sur la combinaison d’un complément avec une application Teams.

En savoir plus sur le manifeste et la structure d’une application Teams combinée et d’un complément Office

Avant de commencer à fusionner vos deux extensions existantes, découvrez comment fusionner les deux types d’extensions en créant une application Teams et un nouveau complément dans la boîte à outils Teams, puis en suivant les instructions fournies dans Ajouter un complément Outlook à une application Teams pour les combiner. Portez une attention particulière aux éléments suivants :

  • Comment le manifeste unifié unique est créé.
  • Différences dans la façon dont le complément et l’application Teams sont chargés et débogués.

Suivez les principes appropriés pour combiner des applications et des compléments Teams

Lorsque vous êtes prêt à fusionner votre complément existant et votre application Teams, suivez les principes suivants :

  • Si le complément utilise un manifeste XML, convertissez-le pour utiliser le manifeste unifié pour Microsoft 365, comme décrit dans Convertir un complément pour utiliser le manifeste unifié pour Microsoft 365 avant de le combiner avec une application Teams.
  • Utilisez le projet d’application Teams comme projet de base pour l’application fusionnée.
  • Conservez les fichiers de configuration applicables au complément et à l’application Teams à la racine du projet.
  • Déplacez les fichiers sources et les fichiers de configuration qui s’appliquent uniquement à l’application Teams dans un sous-dossier à partir de la racine du projet. De même, copiez les fichiers sources et de configuration qui sont utilisés uniquement par le complément à partir du complément existant vers un sous-dossier différent à partir de la racine du projet combiné.
  • Utilisez le même domaine de base pour les fichiers générés du complément et de l’application Teams ; par exemple, contoso.com.
  • Fusionnez les deux manifestes en un seul manifeste. Utilisez le processus que vous avez suivi à l’étape 1 comme guide.
  • La propriété id dans le nouveau manifeste doit avoir la même valeur que la propriété « id » dans le manifeste d’application Teams d’origine.
  • Augmentez la valeur de la propriété version ; par exemple, augmentez « 1.0.0 » à « 1.1.0 ».
  • Ajoutez une propriété extensions.alternates au manifeste et configurez-la pour masquer le complément Office d’origine dans les versions d’Office qui prennent en charge la combinaison d’un complément et d’une application Teams. Pour plus d’informations, consultez Gérer les versions nouvelles et anciennes d’un complément.

Publier l’application Teams et le complément Office combinés

Pour publier l’application combinée, traitez-la comme une mise à jour de l’application Teams. Pour plus d’informations, consultez Publier des mises à jour sur votre application.

Lorsque la mise à jour a été publiée, la façon dont la mise à jour devient disponible pour les utilisateurs finaux varie. Voici les principes généraux.

Remarque

Pour être clair sur ce que signifie « disponible », notez qu’Outlook et l’application Microsoft 365 ont une barre d’application tout comme Teams. En principe, une « application Teams » peut être installée à partir du bouton Applications ou Plus d’applications sur l’une de ces trois barres d’application. L’application « Teams » installée peut être lancée à partir de (ou épinglée séparément à) l’une des barres d’application de l’une des trois applications. En revanche, un complément Outlook autonome est installé via le bouton Toutes les applications du ruban Outlook. Et, qu’il soit autonome ou combiné dans une application Teams, un complément est lancé à partir du ruban Outlook ou se lance automatiquement en réponse à un événement dans le message ou l’élément de réunion Outlook ouvert. Ces faits sont supposés dans le reste de cette section.

  • Si l’administrateur Microsoft 365 consent à la mise à jour, alors :

    • La version mise à jour de l’application Teams est disponible immédiatement à partir des applications ou autres applications dans Outlook et de l’application Microsoft 365, mais pas les applications Teams, pour les utilisateurs qui avaient précédemment acquis l’application Teams.
    • Le complément Outlook est également disponible immédiatement pour les utilisateurs qui avaient précédemment acquis l’application Teams, qu’ils l’avaient déjà acquis ou non.
    • Si un administrateur Teams autorise la mise à jour, les utilisateurs peuvent l’installer individuellement dans Teams à partir des applications Teams.

  • Si l’administrateur ne donne pas son consentement, chaque utilisateur qui a précédemment acquis l’application Teams doit donner son consentement à la mise à jour et celle-ci ne peut être mise à disposition dans Teams que si l’administrateur Teams l’a autorisée.

  • Les utilisateurs qui avaient précédemment acquis uniquement le complément Office doivent acquérir la nouvelle application combinée à partir du magasin Teams. Il ne peut pas être acquis via le bouton Toutes les applications dans le ruban Outlook.

Importante

Les utilisateurs disposant de certaines versions antérieures d’Office peuvent toujours voir l’ancienne version du complément, même après l’acquisition de la nouvelle application combinée. En règle générale, les compléments qui utilisent le manifeste d’application unifié pour Microsoft 365 (anciennement manifeste d’application Teams) peuvent être installés uniquement sur Microsoft 365 version 2307 (build 16626.20132) et versions ultérieures. Toutefois, il existe deux exceptions qui permettent d’installer ces compléments sur les versions antérieures de Microsoft 365 et sur les versions sous licence perpétuelle d’Office.

  • L’administrateur Microsoft 365 de l’utilisateur déploie le complément pour tous les utilisateurs.
  • L’utilisateur installe le complément dans Outlook sur le web, outlook pour Windows ou dans une autre application cliente de bureau Microsoft 365 version 2307 (build 16626.20132) ou ultérieure. Cela rend le complément disponible sur les autres clients Office du même utilisateur, y compris les clients de licences plus anciennes ou perpétuelles.

À l’avenir, il vous suffit de mettre à jour la nouvelle version de l’application.

Voir aussi