Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Le sous-ensemble de l’API de complément Outlook de l’API JavaScript d’Office comprend 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 de prévisualisation 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 version d’évaluation 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 si@types/office-jsvous les avez déjà installés).Vous devrez peut-être rejoindre le programme Microsoft 365 Insider pour accéder aux builds plus récentes d’Office dans Outlook sur Windows et sur Mac.
Vous devrez peut-être configurer l’option de publication ciblée sur votre locataire Microsoft 365 pour afficher un aperçu des fonctionnalités dans Outlook sur le web. Pour plus d’informations, consultez la section « Publication ciblée » de Configurer les options de mise en production Standard ou ciblée.
L’ensemble d’exigences en préversion inclut toutes les fonctionnalités de l’ensemble d’exigences 1.15.
Importante
Cette documentation est destinée à un ensemble de conditions requises pour la préversion. Cet ensemble de conditions requises n’est pas encore entièrement implémenté et les clients ne signaleront pas avec précision son assistance. Vous ne devez pas spécifier cette condition dans le manifeste de votre complément.
Fonctionnalités (aperçu) :
Les fonctionnalités suivantes sont disponibles en aperçu.
- Ajout de la possibilité de déchiffrer les pièces jointes Outlook (
Office.MailboxEnums.AttachmentType.Item) dans un complément de chiffrement. Pour plus d’informations, voir Déchiffrer les pièces jointes aux éléments Outlook (préversion). - Ajout d’une propriété à la
event.completedméthode des compléments de chiffrement pour afficher un message d’erreur personnalisé en cas d’échec du déchiffrement. Pour plus d’informations, consultez Personnaliser les messages d’erreur pour l’opération de déchiffrement (préversion). - Ajout d’une propriété à la méthode des compléments de chiffrement pour limiter l’impression, la copie et l’enregistrement
event.completeddu contenu déchiffré. Pour plus d’informations, consultez Gérer la distribution du contenu déchiffré (préversion). - Ajout d’une nouvelle tentative à la notification d’expiration du délai de déchiffrement dans les compléments de chiffrement afin que les destinataires puissent réessayer une opération de déchiffrement ayant échoué sans basculer vers un autre message.
- La prise en charge de la propriété de la
errorMessageMarkdownevent.completedméthode aux compléments Smart Alerts dans Outlook sur Mac. - Ajout d’une propriété pour obtenir ou définir si un rendez-vous est un événement d’une journée entière.
- Ajout d’événements pour activer un complément basé sur un événement sur un message en mode lecture lorsque celui-ci contient certains types de pièces jointes ou des en-têtes Internet personnalisés.
- Ajout d’une propriété et d’objets pour définir temporairement le corps ou le sujet affiché en mode lecture.
Liste des API
Le tableau suivant répertorie les API JavaScript Outlook actuellement en préversion. Pour afficher la documentation de référence des API pour toutes les API JavaScript Outlook (y compris les API d’aperçu et les API publiées précédemment), voir API Outlook.
| Classe | Champs | Description |
|---|---|---|
| AccessControls | allowCopyPaste | Si la valeur est true, indique que le contenu déchiffré d’un message peut être copié et collé. |
| allowPrint | Si la valeur est true, spécifie que le contenu déchiffré d’un message peut être imprimé. | |
| allowSave | Si la valeur est true, indique que le contenu déchiffré d’un message peut être enregistré. | |
| AppointmentCompose | isAllDayEvent | Obtient ou définit la propriété Office.IsAllDayEvent d’un rendez-vous. |
| AppointmentRead | isAllDayEvent | Renvoie une valeur booléenne indiquant si l’événement a une durée toute la journée. |
| Display | body | Permet à un objet de définir temporairement le contenu affiché dans le corps d’un message en mode Lecture. |
| subject | Permet à un objet de définir temporairement le contenu affiché dans l’objet d’un message en mode Lecture. | |
| Corps affiché | setAsync(data : string, callback ?: (asyncResult : Office.AsyncResult<void>) => void) | Définit temporairement le contenu affiché dans le corps d’un message en mode Lecture. |
| setAsync(data : string, options : Office.AsyncContextOptions & CoercionTypeOptions, callback ?: (asyncResult : Office.AsyncResult<void>) => void) | Définit temporairement le contenu affiché dans le corps d’un message en mode Lecture. | |
| DisplayedSubject | setAsync(data : string, callback ?: (asyncResult : Office.AsyncResult<void>) => void) | Définit temporairement le contenu affiché dans l’objet d’un message en mode Lecture. |
| setAsync(data : string, options : Office.AsyncContextOptions, callback ?: (asyncResult : Office.AsyncResult<void>) => void) | Définit temporairement le contenu affiché dans l’objet d’un message en mode Lecture. | |
| IsAllDayEvent | getAsync(callback : (asyncResult : Office.AsyncResult<boolean>) => void) | Récupère la valeur booléenne indiquant si l’événement a lieu toute la journée ou non. |
| getAsync(options : Office.AsyncContextOptions, callback : (asyncResult : Office.AsyncResult<boolean>) => void) | Récupère la valeur booléenne indiquant si l’événement a lieu toute la journée ou non. | |
| setAsync(isAllDayEvent : boolean, callback ?: (asyncResult : Office.AsyncResult<void>) => void) | Définit le status de l’événement d’une journée entière d’un rendez-vous. | |
| setAsync(isAllDayEvent : boolean, options : Office.AsyncContextOptions, callback ?: (asyncResult : Office.AsyncResult<void>) => void) | Définit le status de l’événement d’une journée entière d’un rendez-vous. | |
| MessageDecryptEventCompletedOptions | accessControls | Lorsque vous utilisez la méthode completed pour signaler la fin d’un gestionnaire d’événements |
| errorMessage | Lorsque vous utilisez la méthode completed pour signaler la fin d’un gestionnaire d’événements | |
| MessageRead | affichage | Permet à un objet de définir temporairement le contenu affiché dans le corps ou l’objet d’un message en mode Lecture. |
Voir aussi
Collaborer avec nous sur GitHub
La source de ce contenu se trouve sur GitHub, où vous pouvez également créer et examiner les problèmes et les demandes de tirage. Pour plus d’informations, consultez notre guide du contributeur.