Utiliser des remplacements étendus du manifeste

Lorsque votre complément utilise uniquement le manifeste de complément au format XML, certaines fonctionnalités d’extensibilité des compléments Office sont configurées avec des fichiers JSON hébergés sur votre serveur, plutôt qu’avec le manifeste du complément.

Remarque

Cet article part du principe que vous êtes familiarisé avec les manifestes de complément Office et leur rôle dans les compléments. Si ce n’est pas le cas récemment, lisez le manifeste des compléments Office.

Le tableau suivant spécifie les fonctionnalités d’extensibilité qui nécessitent un remplacement étendu, ainsi que des liens vers la documentation de la fonctionnalité.

Fonctionnalité	Instructions de développement
Raccourcis clavier	Ajouter des raccourcis clavier personnalisés à vos compléments Office

Le schéma qui définit le format JSON est un schéma de manifeste étendu.

Conseil

Cet article est quelque peu abstrait. Envisagez de lire l’un des articles du tableau pour clarifier les concepts.

Indiquer à Office où trouver le fichier JSON

Utilisez le manifeste pour indiquer à Office où trouver le fichier JSON. Juste en dessous (pas à l’intérieur) de l’élément <VersionOverrides> dans le manifeste, ajoutez un élément ExtendedOverrides . Définissez l’attribut Url sur l’URL complète d’un fichier JSON. Voici un exemple de l’élément ExtendedOverrides> le plus simple possible<.

    ...
    </VersionOverrides>  
    <ExtendedOverrides Url="https://contoso.com/addin/extended-overrides.json"></ExtendedOverrides>
</OfficeApp>

Voici un exemple de fichier JSON de remplacements étendus très simple. Il affecte le raccourci clavier Ctrl+Maj+A à une fonction (définie ailleurs) qui ouvre le volet Office du complément.

{
    "actions": [
        {
            "id": "SHOWTASKPANE",
            "type": "ExecuteFunction",
            "name": "Show task pane for add-in"
        }
    ],
    "shortcuts": [
        {
            "action": "SHOWTASKPANE",
            "key": {
                "default": "CTRL+SHIFT+A"
            }
        }
    ]
}

Localiser le fichier de remplacements étendus

Si votre complément prend en charge plusieurs paramètres régionaux, vous pouvez utiliser l’attribut ResourceUrl de l’élément <ExtendedOverrides> pour pointer Office vers un fichier de ressources localisées. Voici un exemple.

    ...
    </VersionOverrides>  
    <ExtendedOverrides Url="https://contoso.com/addin/extended-overrides.json" 
                       ResourceUrl="https://contoso.com/addin/my-resources.json">
    </ExtendedOverrides>
</OfficeApp>

Pour plus d’informations sur la création et l’utilisation du fichier de ressources, sur la façon de faire référence à ses ressources dans le fichier de remplacements étendus et pour obtenir des options supplémentaires non abordées ici, consultez Localiser les remplacements étendus.