Complément Outlook préversion d'API ensemble de conditions requises

  • Article

Le sous-ensemble d’API de complément Outlook de l’API JavaScript Office inclut des objets, des méthodes, des propriétés et des événements que vous pouvez utiliser dans un complément Outlook.

Les API en préversion sont susceptibles d’être modifiées et ne sont pas destinées à être utilisées dans un environnement de production. Nous vous recommandons de les tester uniquement dans les environnements de test et de développement. N’utilisez pas d’API en préversion dans un environnement de production ou dans des documents critiques pour l’entreprise.

Pour utiliser les API disponibles en préversion :

  • Vous devez utiliser la préversion de la bibliothèque d’API JavaScript Office à partir du réseau de distribution de contenu (CDN)Office.js. Le fichier de définition de type pour la compilation et la IntelliSense TypeScript se trouve aux CDN et DefinitelyTyped. Vous pouvez installer ces types avec npm install --save-dev @types/office-js-preview (veillez à supprimer les types pour @types/office-js si vous les avez déjà installés).

  • Vous devrez peut-être rejoindre le programme Microsoft 365 Insider pour accéder aux builds Office plus récentes dans Outlook sur Windows et sur Mac.

  • Vous devrez peut-être configurer l’option Version ciblée sur votre client Microsoft 365 pour afficher un aperçu des fonctionnalités dans Outlook sur le web. Pour plus d’informations, consultez la section « Version ciblée » dans Configurer les options de publication standard ou ciblée.

L’ensemble de conditions requises en préversion inclut toutes les fonctionnalités de l’ensemble de conditions requises 1.13.

Importante

Cette documentation concerne un ensemble de conditions requisesen préversion. Cet ensemble de conditions requises n’est pas encore entièrement implémenté et les clients ne le signalent pas avec précision la prise en charge. Vous ne devez pas spécifier cet ensemble de conditions requises dans le manifeste de votre complément.

Fonctionnalités (aperçu) :

Les fonctionnalités suivantes sont disponibles en aperçu.

Activer un complément basé sur un événement sur un message en mode lecture

Événements OnMessageReadWithCustomAttachment et OnMessageReadWithCustomHeader

Ajout d’événements pour activer un complément basé sur des événements sur un message en mode lecture lorsqu’il contient certains types de pièces jointes ou des en-têtes Internet personnalisés.

Disponible dans : Outlook sur Windows (abonnement Microsoft 365)

Attribut HeaderName dans l’élément LaunchEvent

Ajout d’un attribut à l’élément <XML LaunchEvent> pour spécifier le nom d’en-tête Internet sur lequel l’événement OnMessageReadWithCustomHeader se produit.

Disponible dans : Outlook sur Windows (abonnement Microsoft 365)

Élément MessageAttachments

Ajout d’un élément XML pour spécifier l’extension de fichier de la pièce jointe incluse dans un message sur lequel l’événement OnMessageReadWithCustomAttachment se produit.

Disponible dans : Outlook sur Windows (abonnement Microsoft 365)


Propriétés de calendrier supplémentaires

Office.IsAllDayEvent

Ajout d’un nouvel objet qui représente la propriété d’événement d’une journée entière d’un rendez-vous en mode composition.

Disponible dans : Outlook sur Windows (abonnement Microsoft 365)

Office.Sensitivity

Ajout d’un nouvel objet qui représente le niveau de sensibilité d’un rendez-vous en mode composition.

Disponible dans : Outlook sur Windows (abonnement Microsoft 365), Outlook sur Mac (abonnement Microsoft 365), Outlook sur le web (moderne), nouveau Outlook sur Windows (préversion)

Office.context.mailbox.item.isAllDayEvent

Ajout d’une nouvelle propriété qui indique si un rendez-vous est un événement d’une journée entière.

Disponible dans : Outlook sur Windows (abonnement Microsoft 365)

Office.context.mailbox.item.sensitivity

Ajout d’une nouvelle propriété qui représente la sensibilité d’un rendez-vous.

Disponible dans : Outlook sur Windows (abonnement Microsoft 365), Outlook sur Mac (abonnement Microsoft 365), Outlook sur le web (moderne), nouveau Outlook sur Windows (préversion)

Office.MailboxEnums.AppointmentSensitivityType

Ajout d’une nouvelle énumération AppointmentSensitivityType qui représente les options de confidentialité disponibles sur un rendez-vous.

Disponible dans : Outlook sur Windows (abonnement Microsoft 365), Outlook sur Mac (abonnement Microsoft 365), Outlook sur le web (moderne), nouveau Outlook sur Windows (préversion)


Membres de message supplémentaires

Office.context.mailbox.item.inReplyTo

Ajout d’une propriété pour obtenir l’ID du message d’origine à laquelle le message actuel répond.

Disponible dans : Outlook sur Windows (abonnement Microsoft 365)

Office.context.mailbox.item.getConversationIndexAsync

Ajout d’une méthode pour obtenir la position encodée en Base64 du message actuel dans un thread de conversation.

Disponible dans : Outlook sur Windows (abonnement Microsoft 365)

Office.context.mailbox.item.getItemClassAsync

Ajout d’une méthode pour obtenir la classe d’élément EWS (Exchange Web Services) d’un message en mode composition.

Disponible dans : Outlook sur Windows (abonnement Microsoft 365)


Fermer et ignorer un message dans composer

Office.context.mailbox.item.closeAsync

Ajout de la méthode pour fermer un message en cours de composition avec l’option permettant d’ignorer les modifications non enregistrées.

Disponible dans : Outlook sur Windows (abonnement Microsoft 365)


Obtenir l’URL du runtime JavaScript d’un complément

Office.context.urls.javascriptRuntimeUrl

Ajout de la propriété pour obtenir l’URL du runtime JavaScript d’un complément.

Disponible dans : Outlook sur Windows (abonnement Microsoft 365)


Rapports de courrier indésirable intégrés

Point d’extension ReportPhishingCommandSurface

Ajout d’un point d’extension pour activer votre complément de création de rapports de courrier indésirable dans le ruban Outlook et l’empêcher d’apparaître à la fin du ruban ou dans la section de dépassement.

Disponible dans : Outlook sur Windows (abonnement Microsoft 365), Outlook sur Mac (abonnement Microsoft 365), Outlook sur le web (moderne), nouveau Outlook sur Windows (préversion)

Élément ReportPhishingCustomization

Ajout d’un élément manifeste pour configurer le bouton du ruban et la boîte de dialogue de prétraitement d’un complément de création de rapports de courrier indésirable.

Disponible dans : Outlook sur Windows (abonnement Microsoft 365), Outlook sur Mac (abonnement Microsoft 365), Outlook sur le web (moderne), nouveau Outlook sur Windows (préversion)

Office.context.mailbox.item.getAsFileAsync

Ajout d’une méthode pour obtenir l’encodage Base64 d’un message.

Disponible dans : Outlook sur Windows (abonnement Microsoft 365), Outlook sur Mac (abonnement Microsoft 365), Outlook sur le web (moderne), nouveau Outlook sur Windows (préversion)

Office.SpamReportingEventCompletedOptions

Création d’options pour personnaliser une boîte de dialogue de post-traitement ou configurer un complément de création de rapports de courrier indésirable pour effectuer des opérations supplémentaires sur un message signalé, comme le supprimer de la boîte de réception.

Disponible dans : Outlook sur Windows (abonnement Microsoft 365), Outlook sur Mac (abonnement Microsoft 365), Outlook sur le web (moderne), nouveau Outlook sur Windows (préversion)

Office.MailboxEnums.MoveSpamItemTo

Ajout d’une nouvelle énumération pour spécifier le dossier vers lequel un message signalé est déplacé une fois qu’il est traité par un complément de création de rapports de courrier indésirable.

Disponible dans : Outlook sur Windows (abonnement Microsoft 365), Outlook sur Mac (abonnement Microsoft 365), Outlook sur le web (moderne), nouveau Outlook sur Windows (préversion)

Pour en savoir plus sur la façon d’implémenter la fonctionnalité intégrée de création de rapports de courrier indésirable dans votre complément, consultez Implémenter un complément de création de rapports de courrier indésirable intégré (préversion) .


Sélection multiple d’élément : propriétés de message supplémentaires

Office.SelectedItemDetails

La possibilité d’obtenir les propriétés des messages sélectionnés dans Outlook à l’aide d’Office.context.mailbox.getSelectedItemsAsync a été introduite dans l’ensemble de conditions requises 1.13. Des propriétés supplémentaires, telles que conversationId, internetMessageIdet hasAttachment, sont désormais disponibles en préversion.

Disponible dans : Outlook sur Windows (abonnement Microsoft 365)


Thème Office

Office.context.officeTheme

Ajout de la possibilité d’obtenir un thème Office.

Disponible dans : Outlook sur Windows (abonnement Microsoft 365)

Office.EventType.OfficeThemeChanged

Ajout de l’événement OfficeThemeChanged à Mailbox.

Disponible dans : Outlook sur Windows (abonnement Microsoft 365)


Alertes intelligentes : personnalisez l’option Ne pas envoyer et remplacez l’option mode d’envoi au moment de l’exécution

Office.SmartAlertsEventCompletedOptions : options supplémentaires

Ajout d’options supplémentaires event.completed pour personnaliser le bouton Ne pas envoyer de la boîte de dialogue Alertes intelligentes et remplacer l’option mode d’envoi au moment de l’exécution.

Disponible dans : Outlook sur Windows (abonnement Microsoft 365)

Office.MailboxEnums.SendModeOverride

Ajout d’un enum pour spécifier l’option de mode d’envoi qui remplace l’option définie dans le manifeste au moment de l’exécution.

Disponible dans : Outlook sur Windows (abonnement Microsoft 365)

Pour savoir comment implémenter ces fonctionnalités, consultez la procédure pas à pas des alertes intelligentes.


Définir temporairement le corps ou l’objet affiché en mode lecture

Office.context.mailbox.item.display

Ajout d’une propriété qui obtient un objet pour définir temporairement le contenu affiché dans le corps ou l’objet d’un message en mode lecture.

Disponible dans : Outlook sur Windows (abonnement Microsoft 365)

Office.Display

Ajout d’un objet qui fournit des propriétés pour définir temporairement le contenu affiché dans le corps ou l’objet d’un message en mode lecture.

Disponible dans : Outlook sur Windows (abonnement Microsoft 365)

Office.DisplayedBody

Ajout d’un objet qui fournit une méthode pour définir temporairement le contenu affiché dans le corps d’un message en mode lecture.

Disponible dans : Outlook sur Windows (abonnement Microsoft 365)

Office.DisplayedSubject

Ajout d’un objet qui fournit une méthode pour définir temporairement le contenu affiché dans l’objet d’un message en mode lecture.

Disponible dans : Outlook sur Windows (abonnement Microsoft 365)


Voir aussi