Partager via

item (ensemble de conditions requises pour la boîte aux lettres 1.8)

  • Article

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 Tableau.<AttachmentDetails> 1.1
Message lu Tableau.<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 Tableau.<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
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 Tableau.<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 Tableau.<EmailAddressDetails> 1.1
sender lire l’élément Message lu EmailAddressDetails 1.1
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
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 Tableau.<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
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
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
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
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() (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
getSharedPropertiesAsync([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
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
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.
  });
};