item (ensemble de conditions requises pour la boîte aux lettres 1.7)
Office.context.mailbox.item
item
est utilisé pour accéder au message, à la demande de réunion ou au rendez-vous actuellement sélectionné. Vous pouvez déterminer le type de l’élément à l’aide de la itemType
propriété .
Configuration requise
Conditions requises | Valeur |
---|---|
Version de l’ensemble minimal de conditions de boîte aux lettres | 1.1 |
Niveau d’autorisation minimal | restreint |
Mode Outlook applicable | Organisateur de rendez-vous, Participant au rendez-vous, Composition de messages ou Lecture du message |
Importante
Android et iOS : Il existe des limitations quant à l’activation des compléments et aux API disponibles. Pour plus d’informations, reportez-vous à Ajouter une prise en charge mobile à un complément Outlook.
Propriétés
Méthodes
Méthode | Minimum niveau d’autorisation |
Détails par mode | Minimum Ensemble de conditions requises |
---|---|---|---|
addFileAttachmentAsync(uri, attachmentName, [options], [callback]) | élément en lecture/écriture | Organisateur de rendez-vous | 1.1 |
Composer un message | 1.1 | ||
addHandlerAsync(eventType, handler, [options], [callback]) | lire l’élément | Organisateur de rendez-vous | 1.7 |
Participant au rendez-vous | 1.7 | ||
Composer un message | 1.7 | ||
Message lu | 1.7 | ||
addItemAttachmentAsync(itemId, attachmentName, [options], [callback]) | élément en lecture/écriture | Organisateur de rendez-vous | 1.1 |
Composer un message | 1.1 | ||
close() | restreint | Organisateur de rendez-vous | 1.3 |
Composer un message | 1.3 | ||
displayReplyAllForm(formData) | lire l’élément | Participant au rendez-vous | 1.1 |
Message lu | 1.1 | ||
displayReplyForm(formData) | lire l’élément | Participant au rendez-vous | 1.1 |
Message lu | 1.1 | ||
getEntities() (déconseillé) | lire l’élément | Participant au rendez-vous | 1.1 |
Message lu | 1.1 | ||
getEntitiesByType(entityType) (déconseillé) | restreint | Participant au rendez-vous | 1.1 |
Message lu | 1.1 | ||
getFilteredEntitiesByName(name) (déconseillé) | lire l’élément | Participant au rendez-vous | 1.1 |
Message lu | 1.1 | ||
getRegExMatches() | lire l’élément | Participant au rendez-vous | 1.1 |
Message lu | 1.1 | ||
getRegExMatchesByName(name) | lire l’élément | Participant au rendez-vous | 1.1 |
Message lu | 1.1 | ||
getSelectedDataAsync(coercionType, [options], callback) | lire l’élément | Organisateur de rendez-vous | 1.2 |
Composer un message | 1.2 | ||
getSelectedEntities() (déconseillé) | lire l’élément | Participant au rendez-vous | 1.6 |
Message lu | 1.6 | ||
getSelectedRegExMatches() | lire l’élément | Participant au rendez-vous | 1.6 |
Message lu | 1.6 | ||
loadCustomPropertiesAsync(callback, [userContext]) | lire l’élément | Organisateur de rendez-vous | 1.1 |
Participant au rendez-vous | 1.1 | ||
Composer un message | 1.1 | ||
Message lu | 1.1 | ||
removeAttachmentAsync(attachmentId, [options], [callback]) | élément en lecture/écriture | Organisateur de rendez-vous | 1.1 |
Composer un message | 1.1 | ||
removeHandlerAsync(eventType, [options], [callback]) | lire l’élément | Organisateur de rendez-vous | 1.7 |
Participant au rendez-vous | 1.7 | ||
Composer un message | 1.7 | ||
Message lu | 1.7 | ||
saveAsync([options], callback) | élément en lecture/écriture | Organisateur de rendez-vous | 1.3 |
Composer un message | 1.3 | ||
setSelectedDataAsync(data, [options], callback) | élément en lecture/écriture | Organisateur de rendez-vous | 1.2 |
Composer un message | 1.2 |
Événements
Vous pouvez vous abonner et vous désabonner des événements suivants à l’aide addHandlerAsync
de et removeHandlerAsync
respectivement.
Importante
Les événements sont disponibles uniquement avec l’implémentation du volet Office.
Événement | Description | Minimum Ensemble de conditions requises |
---|---|---|
AppointmentTimeChanged |
La date ou l’heure de la série ou du rendez-vous sélectionné a été modifiée. | 1.7 |
RecipientsChanged |
La liste des destinataires de l’élément sélectionné ou du lieu de rendez-vous a été modifié. | 1.7 |
RecurrenceChanged |
La périodicité de la série sélectionnée a été modifiée. | 1.7 |
Exemple
L’exemple de code JavaScript suivant montre comment accéder à la propriété subject
de l’élément actif dans Outlook.
// The initialize function is required for all apps.
Office.initialize = function () {
// Checks for the DOM to load using the jQuery ready method.
$(document).ready(function () {
// After the DOM is loaded, app-specific code can run.
const item = Office.context.mailbox.item;
const subject = item.subject;
// Continue with processing the subject of the current item,
// which can be a message or appointment.
});
};