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

Propriété Minimum
niveau d’autorisation
Détails par mode Type de retour Minimum
Ensemble de conditions requises
pièces jointes lire l’élément Participant au rendez-vous Array.<AttachmentDetails> 1.1
Message lu Array.<AttachmentDetails> 1.1
bcc lire l’élément Composer un message Destinataires 1.1
body lire l’élément Organisateur de rendez-vous Corps 1.1
Participant au rendez-vous Corps 1.1
Composer un message Corps 1.1
Message lu Corps 1.1
categories lire l’élément Organisateur de rendez-vous Categories 1.8
Participant au rendez-vous Categories 1.8
Composer un message Categories 1.8
Message lu Categories 1.8
cc lire l’élément Composer un message Destinataires 1.1
Message lu Array.<EmailAddressDetails> 1.1
conversationId lire l’élément Composer un message Chaîne 1.1
Message lu Chaîne 1.1
dateTimeCreated lire l’élément Participant au rendez-vous Date 1.1
Message lu Date 1.1
dateTimeModified lire l’élément Participant au rendez-vous Date 1.1
Message lu Date 1.1
delayDeliveryTime lire l’élément Composer un message DelayDeliveryTime 1.13
end lire l’élément Organisateur de rendez-vous Time 1.1
Participant au rendez-vous Date 1.1
Message lu
(Demande de réunion)
Date 1.1
enhancedLocation lire l’élément Organisateur de rendez-vous EnhancedLocation 1.8
Participant au rendez-vous EnhancedLocation 1.8
de élément en lecture/écriture Composer un message From 1.7
lire l’élément Message lu EmailAddressDetails 1.1
internetHeaders lire l’élément Composer un message InternetHeaders 1.8
internetMessageId lire l’élément Message lu Chaîne 1.1
itemClass lire l’élément Participant au rendez-vous Chaîne 1.1
Message lu Chaîne 1.1
Itemid lire l’élément Participant au rendez-vous Chaîne 1.1
Message lu Chaîne 1.1
itemType lire l’élément Organisateur de rendez-vous MailboxEnums.ItemType 1.1
Participant au rendez-vous MailboxEnums.ItemType 1.1
Composer un message MailboxEnums.ItemType 1.1
Message lu MailboxEnums.ItemType 1.1
emplacement lire l’élément Organisateur de rendez-vous Emplacement 1.1
Participant au rendez-vous Chaîne 1.1
Message lu
(Demande de réunion)
Chaîne 1.1
normalizedSubject lire l’élément Participant au rendez-vous Chaîne 1.1
Message lu Chaîne 1.1
notificationMessages lire l’élément Organisateur de rendez-vous NotificationMessages 1.3
Participant au rendez-vous NotificationMessages 1.3
Composer un message NotificationMessages 1.3
Message lu NotificationMessages 1.3
optionalAttendees lire l’élément Organisateur de rendez-vous Destinataires 1.1
Participant au rendez-vous Array.<EmailAddressDetails> 1.1
organizer élément en lecture/écriture Organisateur de rendez-vous Organizer 1.7
lire l’élément Participant au rendez-vous EmailAddressDetails 1.1
recurrence lire l’élément Organisateur de rendez-vous Périodicité 1.7
Participant au rendez-vous Périodicité 1.7
Message lu
(Demande de réunion)
Périodicité 1.7
requiredAttendees lire l’élément Organisateur de rendez-vous Destinataires 1.1
Participant au rendez-vous Array.<EmailAddressDetails> 1.1
sender lire l’élément Message lu EmailAddressDetails 1.1
sensitivityLabel élément en lecture/écriture Organisateur de rendez-vous SensitivityLabel 1.13
Composer un message SensitivityLabel 1.13
seriesId lire l’élément Organisateur de rendez-vous Chaîne 1.7
Participant au rendez-vous Chaîne 1.7
Composer un message Chaîne 1.7
Message lu Chaîne 1.7
sessionData lire l’élément Organisateur de rendez-vous SessionData 1.11
Composer un message SessionData 1.11
start lire l’élément Organisateur de rendez-vous Time 1.1
Participant au rendez-vous Date 1.1
Message lu
(Demande de réunion)
Date 1.1
subject lire l’élément Organisateur de rendez-vous Sujet 1.1
Participant au rendez-vous Chaîne 1.1
Composer un message Sujet 1.1
Message lu Chaîne 1.1
au lire l’élément Composer un message Destinataires 1.1
Message lu Array.<EmailAddressDetails> 1.1

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.
  });
};