Obtenir et définir des données d’élément Outlook dans des formulaires de lecture ou de composition

À compter de la version 1.1 du schéma de manifeste des compléments Office, Outlook peut activer les compléments lorsque l’utilisateur affiche ou compose un élément. Selon qu’un complément est activé dans un formulaire de lecture ou de composition, les propriétés disponibles pour le complément sur l’élément diffèrent également.

Par exemple, les propriétés dateTimeCreated et dateTimeModified sont définies uniquement pour un élément qui a déjà été envoyé (l’élément est affiché par la suite dans un formulaire de lecture), mais pas lorsque l’élément est en cours de création (dans un formulaire de composition). Un autre exemple est la propriété Cci qui est pertinente uniquement lorsqu’un message est en cours de création (dans un formulaire de composition) et n’est pas accessible à l’utilisateur dans un formulaire de lecture.

Propriétés d’éléments disponibles dans les formulaires de composition et de lecture

Le tableau 1 présente les propriétés au niveau de l’élément dans l’API JavaScript Office qui sont disponibles dans chaque mode (lecture et composition) des compléments de messagerie. En règle générale, les propriétés disponibles dans les formulaires de lecture sont en lecture seule, et celles disponibles dans les formulaires de composition sont en lecture/écriture, à l’exception des propriétés itemId, conversationId et itemType , qui sont toujours en lecture seule indépendamment.

Pour les propriétés restantes au niveau de l’élément disponibles dans les formulaires de composition, étant donné que le complément et l’utilisateur peuvent lire ou écrire la même propriété simultanément, les méthodes pour les obtenir ou les définir dans le mode de composition sont asynchrones et par conséquent, les types des objets renvoyés par ces propriétés peuvent également être différents dans les formulaires de compositions et les formulaires de lecture. Pour plus d’informations sur l’utilisation des méthodes asynchrones pour obtenir ou définir des propriétés au niveau de l’élément en mode de composition, reportez-vous à Obtenir et définir des données d’élément dans un formulaire de composition dans Outlook.

Tableau 1. Propriétés d’éléments disponibles dans les formulaires de composition et de lecture

Type d’élément	Propriété	Type de propriété dans les formulaires de lecture	Type de propriété dans les formulaires de composition
Rendez-vous et messages	dateTimeCreated	Objet Date JavaScript	Propriété non disponible
Rendez-vous et messages	dateTimeModified	Objet Date JavaScript	Propriété non disponible
Rendez-vous et messages	itemClass	String	Propriété non disponible
Rendez-vous et messages	itemId	String	Propriété non disponible
Rendez-vous et messages	itemType	Chaîne dans l’énumération ItemType	Chaîne dans l’énumération ItemType (en lecture seule)
Rendez-vous et messages	attachments	AttachmentDetails	Propriété non disponible
Rendez-vous et messages	body	Corps	Body
Rendez-vous et messages	normalizedSubject	String	Propriété non disponible
Rendez-vous et messages	subject	String	Subject
Rendez-vous	end	Objet Date JavaScript	Heure
Rendez-vous	location	String	Emplacement
Rendez-vous	optionalAttendees	EmailAddressDetails	Destinataires
Rendez-vous	organizer	EmailAddressDetails	Organizer
Rendez-vous	requiredAttendees	EmailAddressDetails	Destinataires
Rendez-vous	start	Objet Date JavaScript	Time
Messages	bbc	Propriété non disponible	Destinataires
Messages	cc	EmailAddressDetails	Destinataires
Messages	conversationId	String	Chaîne (en lecture seule)
Messages	from	EmailAddressDetails	From
Messages	internetMessageId	Entier	Propriété non disponible
Messages	sender	EmailAddressDetails	Propriété non disponible
Messages	to	EmailAddressDetails	Destinataires

Utilisation de jetons de rappel Exchange Server à partir d’un complément de lecture

Si votre complément Outlook est activé dans les formulaires de lecture, vous pouvez obtenir un jeton de rappel Exchange. Ce jeton peut être utilisé dans le code côté serveur pour accéder à l’élément complet via les services web Exchange (EWS).

En spécifiant l’autorisation d’élément en lecture dans le manifeste du complément, vous pouvez utiliser la méthode mailbox.getCallbackTokenAsync pour obtenir un jeton de rappel Exchange, la propriété mailbox.ewsUrl pour obtenir l’URL du point de terminaison EWS de la boîte aux lettres de l’utilisateur et item.itemId pour obtenir l’ID EWS de l’élément sélectionné. Vous pouvez ensuite transmettre le jeton de rappel, l’URL du point de terminaison EWS et l’ID d’élément EWS dans le code côté serveur pour accéder à l’opération GetItem afin d’obtenir d’autres propriétés de l’élément.

Accès à EWS à partir d’un complément de composition ou de lecture

Vous pouvez également utiliser la méthode mailbox.makeEwsRequestAsync pour accéder aux opérations des services web Exchange GetItem et UpdateItem directement à partir du complément. Vous pouvez utiliser ces opérations pour obtenir et définir de nombreuses propriétés d’un élément spécifié. Cette méthode est disponible pour les compléments Outlook, que le complément ait été activé ou non dans un formulaire de lecture ou de composition, à condition que vous spécifiiez l’autorisation de lecture/écriture de boîte aux lettres dans le manifeste du complément. Pour plus d’informations sur l’autorisation de lecture/écriture de boîte aux lettres , consultez Présentation des autorisations de complément Outlook

Pour plus d’informations sur l’utilisation de makeEwsRequestAsync pour accéder aux opérations EWS, reportez-vous à Appeler des services web à partir d’un complément Outlook.

Voir aussi

• Obtenir et définir des données d’élément dans un formulaire de composition dans Outlook
• Appeler des services web à partir d’un complément Outlook