Gérer à la fois un manifeste unifié et une version de manifeste de complément uniquement de votre complément Office

Microsoft apporte un certain nombre d’améliorations à la plateforme de développement Microsoft 365. Ces améliorations offrent une plus grande cohérence dans le développement, le déploiement, l’installation et l’administration de tous les types d’extensions de Microsoft 365, y compris les compléments Office.

Une amélioration importante sur laquelle nous travaillons est la possibilité de créer une unité de distribution unique pour toutes vos extensions Microsoft 365 en utilisant le même format de manifeste : le manifeste unifié au format JSON pour Microsoft 365.

Une fois que vous avez créé une version de votre complément qui utilise le manifeste unifié, vous devez lier le complément existant et l’application créée à l’aide du manifeste unifié pour vous assurer que les utilisateurs ne voient pas deux copies de l’interface utilisateur du complément dans Outlook.

Procédez comme suit.

1. Ouvrez l’objet d’extension dans le tableau « extensions ».

2. Créez une propriété de tableau « alternatives » s’il n’en existe pas déjà une.

3. Dans le tableau « alternatives », créez un objet « alternative » qui a une propriété « masquer ».

4. Si le complément existant est commercialisé via AppSource, attribuez à l’objet « masquer » une propriété « storeOfficeAddin ». Sinon, passez à l’étape 6.

5. Attribuez deux propriétés à l’objet « storeOfficeAddin » :

   • « officeAddinId » avec le GUID de l’ancien complément comme valeur.
   • « assetId » avec l’ID de ressource AppSource comme valeur.

   Voici un exemple :

   "extensions": [
       ...
       {
           ...
           "alternates": [
               ...
               {
                   ...
                   "hide": {
                       "storeOfficeAddin": {
                           "officeAddinId": "b5a2794d-4aa5-4023-a84b-c60a3cbd33d4",
                           "assetId": "WA999999999"
                       }
                   }
               }
           ]
       }
   ]
   

   Remarque

   • L’ID de ressource du complément dans votre manifeste unifié doit correspondre à un complément existant qui a été publié par votre compte vendeur dans l’Espace partenaires. Si l’ID de ressource du complément que vous avez lié dans votre manifeste unifié ne correspond pas à une offre existante publiée par votre compte vendeur, la soumission du manifeste unifié échoue. Vous devez mettre à jour le manifeste pour utiliser l’ID de ressource de complément approprié et soumettre à nouveau le manifeste unifié.
   • Un complément existant ne peut être masqué que par un seul manifeste unifié. Pour l’instant, vous ne pouvez pas utiliser plusieurs manifestes unifiés pour masquer le même complément. Si vous essayez de masquer un complément déjà lié à l’aide d’un autre manifeste unifié, la soumission échoue. Vous devez supprimer la liaison et soumettre à nouveau le manifeste unifié.

6. Si l’ancien complément n’est pas distribué via AppSource, attribuez à l’objet « masquer » une propriété « customOfficeAddin ».

7. Attribuez à l’objet « customOfficeAddin » une propriété « officeAddinId » avec le GUID de l’ancien complément comme valeur. Voici un exemple.

   "extensions": [
       ...
       {
           ...
           "alternates": [
               ...
               {
                   ...
                   "hide": {
                       "customOfficeAddin": {
                           "officeAddinId": "b5a2794d-4aa5-4023-a84b-c60a3cbd33d4"
                       }
                   }
               }
           ]
       }
   ]
   

Ne supprimez pas le complément existant d’AppSource ou du Centre d’administration Microsoft 365 ou des versions antérieures d’Office ne pourront plus utiliser votre complément.

Maintenir les deux versions dans un avenir immédiat

En règle générale, les compléments qui utilisent le manifeste unifié 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 sur une autre application cliente Microsoft 365 qui est la version 2307 (build 16626.20132) et ultérieure. Cela rend le complément disponible sur les autres clients Office du même utilisateur, y compris les licences plus anciennes ou perpétuelles.

Si vous avez des utilisateurs sur des versions de licences anciennes ou perpétuelles pour lesquelles ces exceptions ne s’appliquent pas, vous devez conserver les deux versions du complément. Lorsque tous vos utilisateurs travaillent avec des versions d’Office qui prennent en charge le manifeste unifié, vous pouvez supprimer la version XML du déploiement.

Il existe également des scénarios dans lesquels vous pouvez conserver les deux versions du complément pendant une période prolongée. Par exemple, il existe deux fonctionnalités des compléments qui ne sont pas prises en charge avec le manifeste unifié, car elles sont peu utilisées ou déconseillées. Vous pouvez choisir de conserver une version de votre complément qui utilise ces fonctionnalités. Voici les fonctionnalités qui ne sont pas prises en charge dans le manifeste unifié.

• Les modules Outlook ne sont pas pris en charge. Toutefois, vous pouvez fournir une expérience presque identique à l’aide du manifeste unifié en incluant un onglet Teams avec votre complément dans une seule application.
• Les compléments contextuels Outlook (également appelés « règles d’activation ») ne sont pas pris en charge. Toutefois, vous pouvez fournir des expériences similaires à l’aide du manifeste unifié et de l’activation basée sur les événements.

L’exigence essentielle pour rendre deux versions disponibles est de s’assurer que les deux d’entre elles apparaissent distinctes dans l’interface utilisateur Outlook.

• Donnez à la nouvelle version un nom différent de celui du complément existant.
• Créez et utilisez différentes icônes pour la nouvelle version.
• Assurez-vous que la propriété « id » du manifeste unifié dans la nouvelle version est un GUID différent de l’élément <Id> dans le manifeste de complément uniquement du complément existant.