Partager via

Comparer le complément avec le manifeste unifié pour Microsoft 365

  • Article

Cet article est destiné à aider les lecteurs qui connaissent le manifeste du complément uniquement à comprendre le manifeste unifié en comparant les deux. Les lecteurs doivent également voir les compléments Office avec le manifeste unifié pour Microsoft 365.

Remarque

Actuellement, le manifeste unifié prend uniquement en charge les compléments Outlook et uniquement dans Office lié à un abonnement Microsoft 365 et installé sur Windows, sur un appareil mobile ou dans Outlook sur le web. Nous travaillons à l’extension de la prise en charge d’Excel, PowerPoint et Word, ainsi que d’Outlook sur Mac et des versions perpétuelles d’Office.

Schémas et points généraux

Il n’existe qu’un seul schéma pour le manifeste unifié, contrairement au manifeste de complément uniquement qui a un total de sept schémas.

Mappage conceptuel des manifestes unifiés et des manifestes de complément uniquement

Cette section décrit le manifeste unifié pour les lecteurs qui connaissent le manifeste du complément uniquement. Voici quelques points à garder à l’esprit :

  • Le manifeste unifié est au format JSON.

  • JSON ne fait pas la distinction entre l’attribut et la valeur d’élément comme le fait XML. En règle générale, le JSON qui mappe à un élément XML fait de la valeur de l’élément et de chacun des attributs une propriété enfant. L’exemple suivant montre un balisage XML et son équivalent JSON.

    <MyThing color="blue">Some text</MyThing>

    "myThing" : {
    "color": "blue",
    "text": "Some text"
}

  • Il existe de nombreux endroits dans le manifeste du complément uniquement où un élément avec un nom au pluriel a des enfants avec la version au singulier du même nom. Par exemple, le balisage permettant de configurer un menu personnalisé inclut un <élément Items> qui peut avoir plusieurs <enfants d’éléments Item> . L’équivalent JSON de ces divers éléments est une propriété avec un tableau comme valeur. Les membres du tableau sont des objets anonymes , et non des propriétés nommées « item » ou « item1 », « item2 », etc. Voici un exemple.

    "items": [
    {
        -- markup for a menu item is here --
    },
    {
        -- markup for another menu item is here --
    }
]

Structure de niveau supérieur

Le niveau racine du manifeste unifié, qui correspond approximativement à l’élément <OfficeApp> dans le manifeste de complément uniquement, est un objet anonyme.

Les enfants d’OfficeApp<> sont généralement divisés en deux catégories théoriques. L’élément< VersionOverrides> est une catégorie. L’autre se compose de tous les autres enfants d’OfficeApp<>, qui sont collectivement appelés manifeste de base. De même, le manifeste unifié a une division similaire. Il existe une propriété « extensions » de niveau supérieur qui correspond approximativement dans ses objectifs et ses propriétés enfants à l’élément <VersionOverrides> . Le manifeste unifié a également plus de 10 autres propriétés de niveau supérieur qui servent collectivement les mêmes objectifs que le manifeste de base du manifeste de complément uniquement. Ces autres propriétés peuvent être considérées collectivement comme le manifeste de base du manifeste unifié.

Manifeste de base

Les propriétés du manifeste de base spécifient les caractéristiques du complément que tout type d’extension de Microsoft 365 doit avoir. Cela inclut les onglets Teams et les extensions de message, pas seulement les compléments Office. Ces caractéristiques incluent un nom public et un ID unique. Le tableau suivant montre un mappage de certaines propriétés critiques de niveau supérieur dans le manifeste unifié aux éléments XML du manifeste actuel, où le principe de mappage est l’objectif du balisage.

Propriété JSON Objectif Éléments XML Commentaires
« $schema » Identifie le schéma de manifeste. attributs d’OfficeApp<> et <VersionOverrides> Aucune
"id" GUID du complément. <Id> Aucune
« version » Version du complément. <Version> Aucune
« manifestVersion » Version du schéma de manifeste. attributs d’OfficeApp<> Aucune
« nom » Nom public du complément. <DisplayName> Aucune
« description » Description publique du complément. <Description> Aucune
« accentColor » Aucune Aucune Cette propriété n’a pas d’équivalent dans le manifeste du complément uniquement et n’est pas utilisée dans le manifeste unifié. Mais il doit être présent.
« développeur » Identifie le développeur du complément. <ProviderName> Aucune
« localizationInfo » Configure les paramètres régionaux par défaut et les autres paramètres régionaux pris en charge. <DefaultLocale> et <Override> Aucune
« webApplicationInfo » Identifie l’application web du complément telle qu’elle est connue dans Azure Active Directory. <WebApplicationInfo> Dans le manifeste du complément uniquement, l’élément <WebApplicationInfo> se trouve dans <VersionOverrides>, et non dans le manifeste de base.
« autorisation » Identifie les autorisations Microsoft Graph dont le complément a besoin. <WebApplicationInfo> Dans le manifeste du complément uniquement, l’élément <WebApplicationInfo> se trouve dans <VersionOverrides>, et non dans le manifeste de base.

Les <éléments Hosts>, <Requirements> et <ExtendedOverrides> font partie du manifeste de base dans le manifeste du complément uniquement. Toutefois, les concepts et les objectifs associés à ces éléments sont configurés à l’intérieur de la propriété « extensions » du manifeste unifié.

Propriété « extensions »

La propriété « extensions » dans le manifeste unifié représente principalement les caractéristiques du complément qui ne seraient pas pertinentes pour d’autres types d’extensions Microsoft 365. Par exemple, les applications Office étendues par le complément (telles que Excel, PowerPoint, Word et Outlook) sont spécifiées à l’intérieur de la propriété « extensions », tout comme les personnalisations du ruban de l’application Office. Les objectifs de configuration de la propriété « extensions » correspondent étroitement à ceux de l’élément <VersionOverrides> dans le manifeste du complément uniquement.

Remarque

La <section VersionOverrides> du manifeste du complément uniquement a un système de « double saut » pour de nombreuses ressources de chaîne. Les chaînes, y compris les URL, sont spécifiées et affectées à un ID dans l’enfant <Ressources> de <VersionOverrides>. Les éléments qui nécessitent une chaîne ont un resid attribut qui correspond à l’ID d’une chaîne dans l’élément <Resources> . La propriété « extensions » du manifeste unifié simplifie les choses en définissant des chaînes directement en tant que valeurs de propriété. Rien dans le manifeste unifié n’équivaut à l’élément <Resources> .

Le tableau suivant montre un mappage de certaines propriétés enfants de haut niveau de la propriété « extensions » dans le manifeste unifié aux éléments XML du manifeste actuel. La notation par points est utilisée pour référencer les propriétés enfants.

Remarque

Ce tableau contient uniquement quelques propriétés descendantes représentatives sélectionnées de « extensions ». Il ne s’agit pas d’une liste exhaustive de toutes les propriétés enfants de « extensions ». Pour obtenir la référence complète du manifeste unifié, consultez Manifeste unifié pour Microsoft 365. Pour obtenir la référence du manifeste qui inclut toutes les dernières fonctionnalités de préversion, consultez Préversion publique pour les développeurs pour le manifeste unifié pour Microsoft 365.

Propriété JSON Objectif Éléments XML Commentaires
« requirements.capabilities » Identifie les ensembles de conditions requises que le complément doit être installable. que le complément doit être installable. <Conditions requises> et <ensembles> Aucune
« étendues des conditions » Identifie les applications Office dans lesquelles le complément peut être installé. <Hôtes> Aucune
« rubans » Rubans personnalisés par le complément. <Hôtes>, ExtensionPoints et divers éléments *FormFactor La propriété « rubans » est un tableau d’objets anonymes qui fusionnent chacun les objectifs de ces trois éléments. Consultez le tableau « rubans ».
« remplaçants » Spécifie la compatibilité descendante avec un complément COM équivalent, XLL ou les deux. <EquivalentAddins> Consultez EquivalentAddins - Consultez également pour obtenir des informations générales.
« runtimes » Configure les runtimes incorporés que le complément utilise, y compris différents types de compléments qui ont peu ou pas d’interface utilisateur, comme les compléments de fonction uniquement personnalisés et les commandes de fonction. <Runtimes>. <FunctionFile> et <ExtensionPoint> (de type CustomFunctions) Aucune
« AutoRunEvents » Configure un gestionnaire d’événements pour un événement spécifié. <ExtensionPoint> (de type LaunchEvent) Aucune

Tableau « rubans »

Le tableau suivant mappe les propriétés enfants des objets enfants anonymes du tableau « rubans » aux éléments XML du manifeste actuel.

Propriété JSON Objectif Éléments XML Commentaires
« contextes » Spécifie les surfaces de commande que le complément personnalise. Divers éléments *CommandSurface , tels que PrimaryCommandSurface et MessageReadCommandSurface Aucun.
« onglets » Configure les onglets du ruban personnalisé. <CustomTab> Les noms et la hiérarchie des propriétés descendantes de « tabs » correspondent étroitement aux descendants de <CustomTab>.
« fixedControls » (préversion pour les développeurs) Configure et ajoute le bouton d’un complément intégré de création de rapports de courrier indésirable au ruban Outlook. <Élément enfant control> de <ReportPhishingCustomization> Aucun.
« spamPreProcessingDialog » (préversion pour les développeurs) Configure la boîte de dialogue de prétraitement affichée après l’sélection du bouton d’un complément de création de rapports de courrier indésirable dans le ruban Outlook. <Élément enfant PreProcessingDialog> de <ReportPhishingCustomization> Aucun.

Pour obtenir un exemple complet de manifeste unifié, consultez Exemple de manifeste unifié.

Étapes suivantes