Partager via

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

  • 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,
Message Compose ou Message lu

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 Recipients 1.1
body lire l’élément Organisateur de rendez-vous Body 1.1
Participant au rendez-vous Body 1.1
Composer un message Body 1.1
Message lu Body 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 Recipients 1.1
Message lu Tableau.<EmailAddressDetails> 1.1
conversationId lire l’élément Composer un message String 1.1
Message lu String 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 String 1.1
itemClass lire l’élément Participant au rendez-vous String 1.1
Message lu String 1.1
itemId lire l’élément Participant au rendez-vous String 1.1
Message lu String 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 String 1.1
Message lu
(Demande de réunion)		 String 1.1
normalizedSubject lire l’élément Participant au rendez-vous String 1.1
Message lu String 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 Recipients 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 Recipients 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 String 1.7
Participant au rendez-vous String 1.7
Composer un message String 1.7
Message lu String 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 Subject 1.1
Participant au rendez-vous String 1.1
Composer un message Subject 1.1
Message lu String 1.1
au lire l’élément Composer un message Recipients 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
(Windows classique, Mac)

1.8
(Web, nouveau Windows)
Composer un message 1.1
(Windows classique, Mac)

1.8
(Web, nouveau Windows)
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
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
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.
  });
};