item (ensemble de conditions requises pour la préversion de boîte aux lettres)

Article
11/19/2024

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
delayDeliveryTime	lire l’élément	Composer un message	DelayDeliveryTime	1.13
montrer	élément en lecture/écriture	Message lu	Display	Aperçu
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
inReplyTo	lire l’élément	Composer un message	String	11.4
internetHeaders	lire l’élément	Composer un message	InternetHeaders	1.8
internetMessageId	lire l’élément	Message lu	String	1.1
isAllDayEvent	lire l’élément	Organisateur de rendez-vous	IsAllDayEvent	Aperçu
		Participant au rendez-vous	Boolean	Aperçu
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
sensitivity	lire l’élément	Organisateur de rendez-vous	Sensitivity	11.4
		Participant au rendez-vous	MailboxEnums.AppointmentSensitivityType	11.4
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	String	1.7
		Participant au rendez-vous	String	1.7
		Composer un message	String	1.7
		Message lu	String	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	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
closeAsync([options], [callback])	élément en lecture/écriture	Composer un message	11.4
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
getAsFileAsync([options], callback)	lire l’élément	Message lu	11.4
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
getConversationIndexAsync([options], callback)	lire l’élément	Composer un message	11.4
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
getItemClassAsync([options], callback)	lire l’élément	Composer un message	11.4
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 (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.

É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. Disponible uniquement avec l’implémentation du volet Office.	1.7
`AttachmentsChanged`	Une pièce jointe a été ajoutée à l’élément ou supprimée de celui-ci. Disponible uniquement avec l’implémentation du volet Office.	1.8
`EnhancedLocationsChanged`	L’emplacement du rendez-vous sélectionné a changé. Disponible uniquement avec l’implémentation du volet Office.	1.8
`InfobarClicked`	Une action a été sélectionnée dans un message de notification. Disponible uniquement avec l’implémentation du volet Office.	1.10
`RecipientsChanged`	La liste des destinataires de l’élément sélectionné ou du lieu de rendez-vous a été modifié. Disponible uniquement avec l’implémentation du volet Office.	1.7
`RecurrenceChanged`	La périodicité de la série sélectionnée a été modifiée. Disponible uniquement avec l’implémentation du volet Office.	1.7
`SensitivityLabelChanged`	L’étiquette de confidentialité d’un message ou d’un rendez-vous en mode composition a changé. Disponible uniquement avec l’implémentation du volet Office.	1.13
`SpamReporting`	Un message non sollicité a été signalé dans Outlook. Disponible uniquement avec une commande de fonction.	11.4

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

Partager via