Comprendre les concepts de base des compléments Office

14 minutes

La plateforme des compléments Office vous permet d’étendre les fonctionnalités des applications Office. Dans cette unité, vous allez découvrir les diverses utilisations des compléments pour étendre les applications Office et interagir avec elles. Vous apprendrez également comment configurer votre complément à l’aide de son fichier manifeste.

Présentation des concepts de base des compléments de volet Office et de contenu

Les Compléments Office proposent diverses options d’interaction entre votre solution et une application Office. Dans cette unité, nous traitons de deux de ces options :

Volet de tâches
Contenu

Compléments du volet Office

Les compléments du volet Office permettent l’interaction avec l’utilisateur au moyen d’un volet présent dans une application Office. À l’aide de l’interface du volet Office, vous pouvez permettre à l’utilisateur de modifier des documents ou des e-mails, d’afficher les données d’une source de données, etc. Dans l’image suivante, le volet Office se trouve à droite du document.

Représentation d’un complément de volet de tâches affiché sur le côté droit de la fenêtre de l'application Office.

Complément du volet Office affiché dans une application Office

Dans les versions plus récentes de Word, Excel et PowerPoint, vous pouvez configurer le volet Office pour qu’il apparaisse automatiquement dès qu’un utilisateur ouvre un fichier. L’utilisateur doit d’abord installer votre complément pour activer ce comportement.

Définir le type de complément du volet Office

Comme cela a déjà été mentionné, un fichier manifeste de complément définit les paramètres et les fonctionnalités du complément.

Pour configurer un complément en tant que complément de volet Office pour n’importe quelle application Office à l’exception d’Outlook, définissez l’attribut xsi:type sur TaskPaneApp dans l’élément OfficeApp du fichier manifeste, comme illustré dans l’exemple ci-dessous.

<OfficeApp
  ...
  xsi:type="TaskPaneApp">
  ...
</OfficeApp>

Pour configurer un complément pour Outlook, définissez l’attribut xsi:type sur MailApp dans l’élément OfficeApp du fichier manifeste, comme illustré dans l’exemple ci-dessous.

<OfficeApp
  ...
  xsi:type="MailApp">
  ...
</OfficeApp>

Compléments de contenu

Les compléments de contenu peuvent être utilisés pour insérer un objet dans une feuille de calcul Excel ou une présentation PowerPoint. Cet objet peut être une visualisation de données basée sur le web, un élément multimédia ou un autre contenu externe. Dans l’image suivante, le complément de contenu se trouve près du centre du document.

Représentation d’un complément de contenu affiché au milieu de la fenêtre de l’application Office.

Complément de contenu chargé dans une application Office

Définir le type de complément de contenu

Comme cela a déjà été mentionné, un fichier manifeste de complément définit les paramètres et les fonctionnalités du complément. Pour configurer un complément en tant que complément de contenu, définissez l’attribut xsi:type sur ContentApp dans l’élément OfficeApp du fichier manifeste, comme illustré dans l’exemple ci-dessous.

<OfficeApp
  ...
  xsi:type="ContentApp">
  ...
</OfficeApp>

Présentation des concepts de base des boîtes de dialogue des Compléments Office

La plateforme de Compléments Office vous permet d’afficher une boîte de dialogue pour que vos utilisateurs puissent :

Se connecter à un service intégré (par exemple, s’authentifier avec un compte Microsoft, Google ou Facebook).
Confirmer l’action de l’utilisateur.
Exécuter une tâche pouvant être trop confinée dans un volet Office (par exemple, lire une vidéo).

La boîte de dialogue n’est pas modale, ce qui signifie que votre utilisateur peut continuer à interagir avec l’application Office et votre complément pendant que la fenêtre est affichée. L’image suivante montre une boîte de dialogue affichée dans une application Office.

Illustration montrant la boîte de dialogue affichée dans la fenêtre de l’application Office.

Boîte de dialogue affichée dans une application Office

Présentation des concepts de base des fonctions personnalisées des Compléments Office

Les Compléments Office vous permettent de créer des fonctions JavaScript ou TypeScript personnalisées pouvant être utilisées comme des fonctions Excel intégrées telles que SUM().

L’image suivante montre une fonction personnalisée appelée SPHEREVOLUME entrée dans Excel.

Image animée montrant une fonction personnalisée entrée dans Excel.

Saisie d’une fonction personnalisée dans Excel

L’exemple de code suivant montre le code JavaScript pour la fonction SPHEREVOLUME() illustrée précédemment.

/**
 * Returns the volume of a sphere.
 * @customfunction
 * @param {number} radius
 */
function sphereVolume(radius) {
  return (Math.pow(radius, 3) * 4 * Math.PI) / 3;
}

Où peut-on utiliser les fonctions personnalisées ?

Les fonctions personnalisées sont disponibles dans Excel sur les plateformes suivantes.

Windows (connecté à un abonnement Microsoft 365)
macOS (connecté à un abonnement Microsoft 365)
Navigateur web

Définir le type de complément de fonction personnalisée

Pour configurer un complément de sorte qu’il contienne des fonctions personnalisées, les paramètres clés du fichier manifeste sont les suivantes pour les compléments Excel.

<OfficeApp
  ...
  xsi:type="TaskPaneApp">
  ...
  <Hosts>
    <Host Name="Workbook"/>
  </Hosts>
  ...
  <VersionOverrides xmlns="http://schemas.microsoft.com/office/taskpaneappversionoverrides" xsi:type="VersionOverridesV1_0">
    <Hosts>
      <Host xsi:type="Workbook">
        <AllFormFactors>
          <ExtensionPoint xsi:type="CustomFunctions">
            ...
          </ExtensionPoint>
        </AllFormFactors>
      </Host>
    </Hosts>
    ...
  </VersionOverrides>
</OfficeApp>

Présentation des concepts de base des commandes de complément

Les commandes de complément sont des éléments d’interface utilisateur qui étendent l’interface utilisateur d’Office et lancent des actions dans votre complément. Vous pouvez les utiliser pour ajouter un bouton sur le ruban ou un élément dans le menu contextuel. Lorsque les utilisateurs sélectionnent une commande de complément, ils lancent des actions telles que l’exécution de code JavaScript ou l’affichage d’une page du complément dans le volet des tâches. Les commandes de complément aident les utilisateurs à trouver et utiliser votre complément, ce qui favorise l’adoption et la réutilisation de votre complément, et améliore la fidélisation des clients.

Commandes de complément dans Excel, Word, PowerPoint et OneNote

Vous pouvez configurer un complément de sorte qu’un utilisateur puisse l’exécuter en sélectionnant :

Le bouton du menu de dépassement de commande ou du ruban d’une application Office
- Paramètre principal de fichier manifeste : <ExtensionPoint xsi:type="PrimaryCommandSurface">.
Élément de menu contextuel
- Paramètre principal de fichier manifeste : <ExtensionPoint xsi:type="ContextMenu">.

Une commande de complément peut également ouvrir un sous-menu avec davantage de commandes.

Remarque

Les compléments de contenu ne prennent actuellement pas en charge les commandes de complément.

L’image suivante montre trois commandes de complément (boutons personnalisés) ajoutées à l’onglet Données du ruban Excel.

Capture d’écran de commandes de complément dans Excel.

Commandes de complément dans Excel

Commandes de complément dans Outlook

Vous pouvez configurer un complément de sorte qu’un utilisateur puisse l’exécuter en sélectionnant un bouton dans le ruban Office ou le menu de dépassement de commande dans les cas suivants :

Lecture d’un message dans le volet de lecture ou une fenêtre indépendante.
- Paramètre principal de fichier manifeste : <ExtensionPoint xsi:type="MessageReadCommandSurface">.
Composition d’un message.
- Paramètre principal de fichier manifeste : <ExtensionPoint xsi:type="MessageComposeCommandSurface">.
Création ou affichage d’un rendez-vous ou d’une réunion en tant qu’organisateur.
- Paramètre principal de fichier manifeste : <ExtensionPoint xsi:type="AppointmentOrganizerCommandSurface">.
Affichage d’une réunion en tant que participant.
- Paramètre principal de fichier manifeste : <ExtensionPoint xsi:type="AppointmentAttendeeCommandSurface">.

Une commande de complément peut également ouvrir un sous-menu avec davantage de commandes.

Les images suivantes montrent trois commandes de complément (boutons personnalisés) ajoutées au ruban dans Outlook. Dans la première image, les boutons sont affichés dans un état normal ; dans la deuxième, ils sont à l’état réduit.

Capture d’écran de commandes de complément dans Outlook.

Commandes de complément dans Outlook sur Windows

Où peut-on utiliser les commandes de complément ?

Les commandes de complément sont disponibles dans Excel, Outlook, OneNote, PowerPoint et Word, comme le montre le tableau suivant.

Plateforme	Version principale d’Office	Abonnement ou achat définitif ?	Notes
Windows	Non applicable	(connecté à l’abonnement Microsoft 365)	Non disponible dans OneNote
	2021	achat définitif	Non disponible dans OneNote
	2019	achat définitif	Non disponible dans OneNote
	2016	achat définitif	Disponible uniquement dans Outlook sur Exchange 2016 (nécessite une mise à jour après la publication) ou une version ultérieure. Non disponible dans les autres applications d'Office.
	2013	achat définitif	Disponible uniquement dans Outlook sur Exchange 2016 ou une version ultérieure. Nécessite des mises à jour postérieures à la publication pour Outlook et Exchange 2016. Non disponible dans les autres applications Office.
macOS	Non applicable	(connecté à l’abonnement Microsoft 365)	Non disponible dans OneNote
	2021	achat définitif	Non disponible dans OneNote
	2019	achat définitif	Non disponible dans OneNote
	2016	achat définitif	Non disponible dans OneNote
iOS	Non applicable	(connecté à l’abonnement Microsoft 365)	Disponible uniquement dans Outlook
Android	Non applicable	(connecté à l’abonnement Microsoft 365)	Disponible uniquement dans Outlook
Navigateur web	Non applicable	Non applicable	Disponible dans toutes les applications Office prises en charge

Comprendre l’objet du fichier manifeste de complément

Le fichier manifeste XML d’un complément Office définit les paramètres et les fonctionnalités du complément. Vous pouvez le configurer de manière à contrôler la façon dont votre complément est rendu et se comporte dans les applications Office cibles.

Paramètres définis par le fichier manifeste

Dans le fichier manifeste, vous définissez des informations essentielles sur le complément, notamment :

Les métadonnées du complément (par exemple, ID, version, description, nom complet, paramètres régionaux par défaut)
Des informations sur l’intégration à Office (par exemple, applications cibles, fonctionnalités personnalisées, commandes du complément)
L’emplacement des images que le complément utilise pour la personnalisation et l’iconographie des commandes
Les autorisations nécessaires au complément
Les dimensions du complément (par exemple, dimensions par défaut pour les compléments de contenu, hauteur demandée pour des compléments Outlook)
Des règles qui indiquent quand activer le complément dans un message ou un rendez-vous (Outlook uniquement)

Utilisation du fichier manifeste

Un fichier manifeste de complément est utilisé des manières suivantes :

Les applications Office dans lesquelles votre complément s’exécute utilisent les informations du fichier manifeste pour rendre l’interface utilisateur du complément et relier des boutons personnalisés ou des entrées de menu.
Si vous publiez votre complément dans AppSource :
- Les informations du fichier manifeste (nom, description, auteur, logo, etc.) sont utilisées pour créer l’entrée d’application qui est présentée aux clients potentiels dans AppSource.
- Le processus de validation AppSource lit les informations du fichier manifeste et vérifie que votre complément s’exécute sur les plateformes prévues.

Résumé

La plateforme des compléments Office vous permet d’étendre les fonctionnalités des applications Office. Dans cette unité, vous avez découvert différentes possibilités d’utilisation des compléments pour étendre les applications Office et interagir avec elles. Vous avez également appris comment configurer votre complément à l’aide de son fichier manifeste.

Concepts de base des compléments Office

Parmi les affirmations suivantes sur les compléments Office, laquelle est vraie ?

Les compléments peuvent seulement être exécutés dans Office sur Windows, Mac et iPad/iOS.

Les administrateurs Microsoft 365 peuvent utiliser un déploiement centralisé pour déployer des modules au sein de leur organisation.

Un développeur peut publier son complément dans AppSource pour le dissimuler au public.

L’utilisateur doit se connecter pour accéder aux fonctionnalités du complément au sein d’une application Office. Quelle fonctionnalité de la plateforme Office Add-in le développeur doit-il afficher pour faciliter le processus de connexion ?

commande de complément

fonction personnalisée

fenêtre de dialogue

Quel fichier définit les paramètres et les capacités d'un complément d'Office ?

fichier de boîte de dialogue

fichier manifeste

fichier web.config

Vous devez répondre à toutes les questions avant de vérifier votre travail.

Continuer