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.
Remarque
Dans cette documentation, l’ensemble de conditions requises présenté est différent de l’ensemble de conditions requises de la version précédente.
Nouveautés de la version 1.13
Le jeu de conditions requises 1.13 inclut toutes les fonctionnalités du jeu de conditions requises 1.12. Les fonctionnalités suivantes ont été ajoutées.
- Ajout de la prise en charge permettant d’activer un complément sans que le volet de lecture soit activé ou qu’un message ne soit sélectionné.
- Ajout de la prise en charge de la gestion des données de remise et de l’heure d’un message.
- Ajout de nouveaux événements pour l’activation basée sur les événements.
- Ajout de la fonctionnalité de sélection multiple d’élément.
- Ajout de la fonction de préfixe à l’envoi.
- Ajout de la fonctionnalité d’étiquette de confidentialité.
- Ajout de la prise en charge des scénarios de boîte aux lettres partagée.
Liste des API
Le tableau suivant répertorie les API introduites dans le jeu de conditions requises de boîte aux lettres 1.13. Pour consulter la documentation de référence sur toutes les API prises en charge par le jeu d’exigences de boîte aux lettres 1.13 ou version antérieure, consultez API Outlook.
| Classe | Champs | Description |
|---|---|---|
| AppointmentCompose | sensitivityLabel | Permet à l’objet d’obtenir ou de définir l’étiquette de confidentialité d’un rendez-vous. |
| Body | prependOnSendAsync(data : string, callback ?: (asyncResult : Office.AsyncResult<void>) => void) | Ajout de HTML ou de texte brut au début du corps d’un message ou d’un rendez-vous lorsque l’élément de courrier est envoyé. |
| prependOnSendAsync(data : string, options : Office.AsyncContextOptions & CoercionTypeOptions, callback ?: (asyncResult : Office.AsyncResult<void>) => void) | Ajout de HTML ou de texte brut au début du corps d’un message ou d’un rendez-vous lorsque l’élément de courrier est envoyé. | |
| DelayDeliveryTime | getAsync(callback ?: (asyncResult : Office.AsyncResult<Date | 0>) => void) | Obtient la date et l’heure de remise d’un message. |
| getAsync(options : Office.AsyncContextOptions, callback ?: (asyncResult : Office.AsyncResult<Date | 0>) => void) | Obtient la date et l’heure de remise d’un message. | |
| setAsync(datetime : Date, callback ?: (asyncResult : Office.AsyncResult<void>) => void) | Définit la date et l’heure de remise d’un message. | |
| setAsync(datetime : Date, options : Office.AsyncContextOptions, callback ?: (asyncResult : Office.AsyncResult<void>) => void) | Définit la date et l’heure de remise d’un message. | |
| Boîte aux lettres | getSelectedItemsAsync(callback : (asyncResult : Office.AsyncResult<SelectedItemDetails[]>) => void) | Obtient les messages actuellement sélectionnés sur lesquels un complément peut activer et effectuer des opérations. |
| getSelectedItemsAsync(options : Office.AsyncContextOptions, callback : (asyncResult : Office.AsyncResult<SelectedItemDetails[]>) => void) | Obtient les messages actuellement sélectionnés sur lesquels un complément peut activer et effectuer des opérations. | |
| MessageCompose | delayDeliveryTime | Obtient ou définit la date et l’heure de remise différée d’un message. |
| sensitivityLabel | Récupère l’objet pour obtenir ou définir l’étiquette de confidentialité d’un message. | |
| SelectedItemDetails | itemId | ID d’élément EWS (Exchange Web Services) du message actuellement sélectionné. |
| itemMode | Mode Outlook (Read ou Compose) du message actuellement sélectionné. |
|
| itemType | Type de l’élément actuellement sélectionné. | |
| subject | Description qui s’affiche dans le champ d’objet du message actuellement sélectionné. | |
| SensitivityLabel | getAsync(callback : (asyncResult : Office.AsyncResult<string>) => void) | Obtient l’identificateur unique (GUID) de l’étiquette de confidentialité appliquée à un message ou un rendez-vous en cours de composition. |
| getAsync(options : Office.AsyncContextOptions, callback : (asyncResult : Office.AsyncResult<string>) => void) | Obtient l’identificateur unique (GUID) de l’étiquette de confidentialité appliquée à un message ou un rendez-vous en cours de composition. | |
| setAsync(sensitivityLabel : string | SensitivityLabelDetails, callback ?: (asyncResult : Office.AsyncResult<void>) => void) | Applique l’étiquette de confidentialité spécifiée au message ou au rendez-vous en cours de composition. | |
| setAsync(sensitivityLabel : string | SensitivityLabelDetails, options : Office.AsyncContextOptions, callback ?: (asyncResult : Office.AsyncResult<void>) => void) | Applique l’étiquette de confidentialité spécifiée au message ou au rendez-vous en cours de composition. | |
| SensitivityLabelChangedEventArgs | type | Type d’événement qui a été soulevé. |
| SensitivityLabelDetails | les enfants | Sous-étiquettes de l’étiquette de confidentialité. |
| color | Couleur de l’étiquette de confidentialité. | |
| id | Identificateur unique (GUID) de l’étiquette de confidentialité. | |
| name | Nom de l’étiquette de confidentialité. | |
| info-bulle | Description de l’étiquette de confidentialité. | |
| SensitivityLabelsCatalog | getAsync(callback : (asyncResult : Office.AsyncResult<SensitivityLabelDetails[]>) => void) | Obtient toutes les étiquettes de confidentialité activées dans Outlook. |
| getAsync(options : Office.AsyncContextOptions, callback : (asyncResult : Office.AsyncResult<SensitivityLabelDetails[]>) => void) | Obtient toutes les étiquettes de confidentialité activées dans Outlook. | |
| getIsEnabledAsync(callback : (asyncResult : Office.AsyncResult<boolean>) => void) | Vérifie si le catalogue des étiquettes de confidentialité est activé dans Outlook. | |
| getIsEnabledAsync(options : Office.AsyncContextOptions, callback : (asyncResult : Office.AsyncResult<boolean>) => void) | Vérifie si le catalogue des étiquettes de confidentialité est activé dans Outlook. |
Événements
Le tableau suivant répertorie les événements introduits dans le jeu de conditions requises 1.13. Pour obtenir la liste de tous les événements pris en charge qui peuvent être gérés à l’aide des méthodes etremoveHandlerAsync, consultez Office.EventTypeaddHandlerAsync.
| Événement | Description | Objet |
|---|---|---|
| SelectedItemsChanged | Un ou plusieurs messages sont sélectionnés ou désélectionnés. | Boîte aux lettres |
| SensitivityLabelChanged | L’étiquette de confidentialité d’un message ou d’un rendez-vous est modifiée. | Option |
Remarque
Pour les événements pris en charge dans un complément d’activation en fonction des événements, consultez Activer des compléments avec des événements.
Mises à jour du manifeste
Le tableau suivant répertorie les mises à jour de manifeste introduites dans l’ensemble de conditions requises pour la boîte aux lettres 1.13. Pour en savoir plus sur les types de manifestes de compléments Office, voir Manifeste de compléments Office.
| Fonctionnalité | Manifeste unifié pour Microsoft 365 | Manifeste du complément uniquement | Description |
|---|---|---|---|
| Aucun contexte d’élément | "extensions.runtimes.actions.supportsNoItemContext" |
SupportsNoItemContext | Permet l’activation des compléments du volet Office sans que le volet de lecture soit activé ou qu’un message ne soit sélectionné. |
| Prise en charge des boîtes aux lettres partagées |
"authorization.permissions.resourceSpecific.name" définir sur "Mailbox.SharedFolder" |
SupportsSharedFolders | Définit si le complément est disponible dans les scénarios de boîte aux lettres partagée. |