item (Ensemble de conditions requises pour la boîte aux lettres 1.13)
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 | ||
addFileAttachmentFromBase64Async(base64File, attachmentName, [options], [callback]) | élément en lecture/écriture | Organisateur de rendez-vous | 1.8 |
Composer un message | 1.8 | ||
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 | ||
disableClientSignatureAsync([options], [callback]) | élément en lecture/écriture | Organisateur de rendez-vous | 1.10 |
Composer un message | 1.10 | ||
displayReplyAllForm(formData) | lire l’élément | Participant au rendez-vous | 1.1 |
Message lu | 1.1 | ||
displayReplyAllFormAsync(formData, [options], [callback]) | lire l’élément | Participant au rendez-vous | 1.9 |
Message lu | 1.9 | ||
displayReplyForm(formData) | lire l’élément | Participant au rendez-vous | 1.1 |
Message lu | 1.1 | ||
displayReplyFormAsync(formData, [options], [callback]) | lire l’élément | Participant au rendez-vous | 1.9 |
Message lu | 1.9 | ||
getAllInternetHeadersAsync([options], [callback]) | lire l’élément | Message lu | 1.8 |
getAttachmentContentAsync(attachmentId, [options], [callback]) | lire l’élément | Organisateur de rendez-vous | 1.8 |
Participant au rendez-vous | 1.8 | ||
Composer un message | 1.8 | ||
Message lu | 1.8 | ||
getAttachmentsAsync([options], [callback]) | lire l’élément | Organisateur de rendez-vous | 1.8 |
Composer un message | 1.8 | ||
getComposeTypeAsync([options], callback) | lire l’élément | Composer un message | 1.10 |
getEntities() | lire l’élément | Participant au rendez-vous | 1.1 |
Message lu | 1.1 | ||
getEntitiesByType(entityType) | Restreint | Participant au rendez-vous | 1.1 |
Message lu | 1.1 | ||
getFilteredEntitiesByName(name) | lire l’élément | Participant au rendez-vous | 1.1 |
Message lu | 1.1 | ||
getInitializationContextAsync([options], [callback]) | lire l’élément | Organisateur de rendez-vous | 1.8 |
Participant au rendez-vous | 1.8 | ||
Composer un message | 1.8 | ||
Message lu | 1.8 | ||
getItemIdAsync([options], callback) | lire l’élément | Organisateur de rendez-vous | 1.8 |
Composer un message | 1.8 | ||
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() | 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 | ||
getSharedPropertiesAsync([options], callback) | lire l’élément | Organisateur de rendez-vous | 1.8 (prise en charge des dossiers partagés) 1.13 (prise en charge des boîtes aux lettres partagées) |
Participant au rendez-vous | 1.8 (prise en charge des dossiers partagés) 1.13 (prise en charge des boîtes aux lettres partagées) |
||
Composer un message | 1.8 (prise en charge des dossiers partagés) 1.13 (prise en charge des boîtes aux lettres partagées) |
||
Message lu | 1.8 (prise en charge des dossiers partagés) 1.13 (prise en charge des boîtes aux lettres partagées) |
||
isClientSignatureEnabledAsync([options], callback) | lire l’élément | Organisateur de rendez-vous | 1.10 |
Composer un message | 1.10 | ||
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 |
AttachmentsChanged |
Une pièce jointe a été ajoutée à l’élément ou supprimée de celui-ci. | 1.8 |
EnhancedLocationsChanged |
L’emplacement du rendez-vous sélectionné a changé. | 1.8 |
InfobarClicked |
Une action a été sélectionnée dans un message de notification. | 1.10 |
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 |
SensitivityLabelChanged |
L’étiquette de confidentialité d’un message ou d’un rendez-vous en mode composition a changé. | 1.13 |
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 function.
$(document).ready(function () {
// After the DOM is loaded, app-specific code can run.
var item = Office.context.mailbox.item;
var subject = item.subject;
// Continue with processing the subject of the current item,
// which can be a message or appointment.
});
};
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour