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.

Conseil

Pour plus d’informations sur la conversion d’un complément existant pour utiliser le manifeste unifié, consultez Convertir un complément pour utiliser le manifeste unifié 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 Office.

Remarque

La configuration décrite ci-dessous ne prend pas effet jusqu’à 24 heures après l’installation de la nouvelle version sur l’ordinateur d’un utilisateur. Pendant cette période, l’interface utilisateur des deux versions est visible. Par exemple, si les deux versions ont un bouton de ruban personnalisé, les deux boutons apparaissent sur le ruban.

Procédez comme suit.

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

  2. Créez une "alternates" propriété de tableau, s’il n’en existe pas déjà une.

  3. Dans le "alternates" tableau, créez un autre objet qui a une "hide" propriété .

  4. Si le complément existant est commercialisé via la Place de marché Microsoft, attribuez une "storeOfficeAddin" propriété à l’objet "hide" . 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 de la Place de marché Microsoft comme valeur.

    Voici un exemple :

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

    Remarque

    • 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 correct 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 la Place de marché Microsoft, attribuez une "customOfficeAddin" propriété à l’objet"hide".

  7. Attribuez à l’objet "customOfficeAddin" une "officeAddinId" propriété 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 de la Place de marché Microsoft ou du Centre Administration Microsoft 365, ni les 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 certaines versions de Microsoft 365 et certaines plateformes. Pour plus d’informations, consultez Prise en charge des clients et des plateformes.

Toutefois, il existe une exception : si l’administrateur Microsoft 365 de l’utilisateur déploie le complément pour tous les utilisateurs, le complément peut être installé sur des versions antérieures de Microsoft 365 et sur des versions sous licence perpétuelle d’Office.

Si vous avez des utilisateurs sur des versions de licences anciennes ou perpétuelles pour lesquelles cette exception ne s’applique 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 avec le manifeste de complément uniquement 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é.

L’exigence essentielle pour rendre deux versions disponibles est de s’assurer que les deux d’entre elles apparaissent distinctes dans l’interface utilisateur d’Office . le portail des applications intégrées et, le cas échéant, l’interface utilisateur de la Place de marché Microsoft.

  • 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 "id" propriété 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.

Remarque

Si vous utilisez le même nom et la même icône, les anciennes et nouvelles solutions apparaissent indisctinguishables dans l’interface utilisateur Office pour l’installation du complément.

  • Last updated on