Présentation des compléments OutlookOutlook add-ins overview

Les compléments Outlook sont des intégrations conçues par des tiers dans Outlook à l’aide de notre plate-forme web.Outlook add-ins are integrations built by third parties into Outlook by using our web-based platform. Les compléments Outlook comportent trois aspects clés :Outlook add-ins have three key aspects:

  • La logique métier et de complément est la même pour les versions Outlook de bureau sur Windows et Mac, sur le web (Office 365 et Outlook.com) et sur mobile.The same add-in and business logic works across desktop (Outlook on Windows and Mac), web (Office 365 and Outlook.com), and mobile.
  • Les compléments Outlook se composent d’un manifeste, qui décrit la manière dont le complément s’intègre dans Outlook (par exemple, un bouton ou un volet de tâches), ainsi que d’un code JavaScript/HTML, qui constitue l’interface utilisateur et la logique métier du complément.Outlook add-ins consist of a manifest, which describes how the add-in integrates into Outlook (for example, a button or a task pane), and JavaScript/HTML code, which makes up the UI and business logic of the add-in.
  • Les compléments Outlook peuvent être acquis à partir d’AppSource ou chargés séparément par les utilisateurs finals ou les administrateurs.Outlook add-ins can be acquired from AppSource or sideloaded by end-users or administrators.

Les compléments Outlook diffèrent des compléments COM ou VSTO, qui sont des intégrations plus anciennes spécifiques d’Outlook sous Windows.Outlook add-ins are different from COM or VSTO add-ins, which are older integrations specific to Outlook running on Windows. Contrairement aux compléments COM, les compléments Outlook ne comportent pas de code physiquement installé sur le périphérique de l’utilisateur ou du client Outlook.Unlike COM add-ins, Outlook add-ins don't have any code physically installed on the user's device or Outlook client. Pour un complément Outlook, Outlook lit le manifeste et raccorde les contrôles spécifiés dans l’interface utilisateur, puis charge le code JavaScript et HTML.For an Outlook add-in, Outlook reads the manifest and hooks up the specified controls in the UI, and then loads the JavaScript and HTML. Les composants web s’exécutent tous dans le contexte d’un navigateur dans un bac à sable (sandbox).The web components all run in the context of a browser in a sandbox.

Les éléments Outlook qui prennent en charge les compléments incluent notamment les messages électroniques, les demandes de réunion, les réponses à des demandes de réunion, les annulations de réunion et les rendez-vous.The Outlook items that support add-ins include email messages, meeting requests, responses and cancellations, and appointments. Chaque complément Outlook définit le contexte dans lequel il est disponible, y compris les types d’éléments et si l’utilisateur lit ou compose un élément.Each Outlook add-in defines the context in which it is available, including the types of items and if the user is reading or composing an item.

Notes

Lorsque vous créez votre complément, si vous envisagez de le publier dans AppSource, assurez-vous que vous respectez les stratégies de validation AppSource. Par exemple, pour réussir la validation, votre complément doit fonctionner sur toutes les plateformes qui prennent en charge les méthodes définies (pour en savoir plus, consultez la section 4.12 et la page relative à la disponibilité des compléments Office sur les plateformes et les hôtes).When you build your add-in, if you plan to publish your add-in to AppSource, make sure that you conform to the AppSource validation policies. For example, to pass validation, your add-in must work across all platforms that support the methods that you define (for more information, see section 4.12 and the Office Add-in host and availability page).

Points d’extensionExtension points

Les points d’extension correspondent à la manière dont les compléments sont intégrés à Outlook. Voici les méthodes possibles :Extension points are the ways that add-ins integrate with Outlook. The following are the ways this can be done:

  • Les compléments peuvent indiquer des boutons qui apparaissent dans les surfaces de commande dans les messages et les rendez-vous. Pour plus d’informations, voir Commandes de complément pour Outlook.Add-ins can declare buttons that appear in command surfaces across messages and appointments. For more information, see Add-in commands for Outlook.

    Complément avec boutons de commande dans le rubanAn add-in with command buttons on the ribbon

    Forme sans interface utilisateur de commande de complément

  • Les compléments peuvent désactiver les correspondances d’expressions régulières ou des entités détectées dans les messages et les rendez-vous. Pour plus d’informations, voir Compléments Outlook contextuels.Add-ins can link off regular expression matches or detected entities in messages and appointments. For more information, see Contextual Outlook add-ins.

    Complément contextuel pour une entité en surbrillance (adresse)A contextual add-in for a highlighted entity (an address)

    Présente une application contextuelle dans une carte

Notes

Les volets personnalisés sont déconseillés. Veuillez donc vérifier que vous utilisez un point d’extension pris en charge.Custom panes have been deprecated so please ensure that you're using a supported extension point.

Éléments de boîtes aux lettres disponibles pour les complémentsMailbox items available to add-ins

Les compléments Outlook sont disponibles pour les messages ou les rendez-vous en mode de lecture ou de composition, mais pas pour d’autres types d’élément. Outlook ne les active pas si l’élément de message actuel, en mode de composition ou de lecture, fait partie des éléments suivants :Outlook add-ins are available on messages or appointments while composing or reading, but not other item types. Outlook does not activate add-ins if the current message item, in a compose or read form, is one of the following:

  • protégé par la Gestion des droits relatifs à l’information (IRM) ou chiffré par d’autres moyens de protection. Un message signé numériquement en est un exemple, puisque la signature numérique dépend de l’un de ces mécanismes ;Protected by Information Rights Management (IRM) or encrypted in other ways for protection. A digitally signed message is an example since digital signing relies on one of these mechanisms.

  • un rapport ou une notification de remise qui a la classe de message IPM.Report.* (notamment les rapports de remise et les notifications d’échec de remise, ainsi que les notifications de lecture, de non-lecture et de retard) ;A delivery report or notification that has the message class IPM.Report.*, including delivery and Non-Delivery Report (NDR) reports, and read, non-read, and delay notifications.

  • un brouillon (aucun expéditeur n’y est affecté), ou dans le dossier Brouillons d’Outlook ;A draft (does not have a sender assigned to it), or in the Outlook Drafts folder.

  • un fichier .msg ou .eml joint à un autre message ;A .msg or .eml file which is an attachment to another message.

  • un fichier .msg ou .eml ouvert à partir du système de fichiers ;A .msg or .eml file opened from the file system.

  • dans une boîte aux lettres partagée, dans la boîte aux lettres d’un autre utilisateur, dans une boîte aux lettres d’archivage ou dans un dossier public.In a shared mailbox, in another user's mailbox, in an archive mailbox, or in a public folder.

  • utilise un formulaire personnalisé.Using a custom form.

En général, Outlook peut activer des compléments sous forme de lecture pour les éléments dans le dossier Éléments envoyés, à l'exception des compléments qui s’activent en fonction des correspondances de chaînes d'entités connues.In general, Outlook can activate add-ins in read form for items in the Sent Items folder, with the exception of add-ins that activate based on string matches of well-known entities. Pour plus d'informations sur les raisons de ce problème, reportez-vous à la rubrique "Prise en charge pour les entités connues" dans Faire correspondre des chaînes dans un élément Outlook en tant qu'entités connues.For more information about the reasons behind this, see "Support for well-known entities" in Match strings in an Outlook item as well-known entities.

Hôtes pris en chargeSupported hosts

Les compléments Outlook sont pris en charge dans Outlook 2013 et versions ultérieures sur Windows, Outlook 2016 et versions ultérieures sur Mac, Outlook sur le web pour Exchange 2013 sur site et versions ultérieures, Outlook sur iOS, Outlook sur Android et Outlook sur le web dans Office 365 et Outlook.com.Outlook add-ins are supported in Outlook 2013 or later on Windows, Outlook 2016 or later on Mac, Outlook on the web for Exchange 2013 on-premises and later versions, Outlook on iOS, Outlook on Android, and Outlook on the web in Office 365 and Outlook.com. Les fonctionnalités les plus récentes ne sont pas toutes prises en charge dans tous les clients à la fois.Not all of the newest features are supported in all clients at the same time. Reportez-vous aux articles et références API relatives à ces fonctionnalités pour savoir dans quels hôtes elles peuvent ou non être prises en charge.Please refer to articles and API references for those features to see which hosts they may or may not be supported in.

Commencer à créer des compléments OutlookGet started building Outlook add-ins

Pour commencer à créer des compléments Outlook, procédez comme suit.To get started building Outlook add-ins, try the following.

  • Démarrage rapide : créer un volet Office simple.Quick start - Build a simple task pane.
  • Didacticiel : découvrez comment créer un complément qui insère des gists GitHub dans un nouveau message.Tutorial - Learn how to create an add-in that inserts GitHub gists into a new message.

Voir aussiSee also