Share via

Obtenir et définir des données d’élément dans un formulaire de composition dans Outlook

  • Article

Découvrez comment obtenir ou définir diverses propriétés d’un élément dans un complément Outlook d’un scénario de composition, y compris ses destinataires, son objet, son corps, et ses emplacement et heure de rendez-vous.

Obtention et définition des propriétés d’un élément pour un complément de composition

Dans un formulaire de composition, vous pouvez obtenir la plupart des propriétés qui sont exposées sur le même genre d’élément que dans un formulaire de lecture (comme attendees, recipients, subject et body), et vous pouvez obtenir quelques propriétés supplémentaires qui sont pertinentes uniquement dans un formulaire de composition mais pas dans un formulaire de lecture (body, bcc).

Pour la plupart de ces propriétés, comme il est possible qu’un complément Outlook et l’utilisateur modifient la même propriété dans l’interface utilisateur en même temps, les méthodes d’obtention et de définition de ces propriétés sont asynchrones. Le tableau 1 énumère les propriétés de niveau élément et les méthodes asynchrones correspondantes pour les obtenir et les définir dans un formulaire de composition. Les propriétés item.itemType et item.conversationId constituent des exceptions, car les utilisateurs ne peuvent pas les modifier. Vous pouvez les obtenir par programmation de la même façon dans un formulaire de composition et dans un formulaire de lecture, directement à partir de l’objet parent.

Outre l’accès aux propriétés d’élément dans l’API JavaScript Office, vous pouvez accéder aux propriétés au niveau de l’élément à l’aide des services Web Exchange (EWS). Avec l’autorisation de lecture/écriture de boîte aux lettres , vous pouvez utiliser la méthode mailbox.makeEwsRequestAsync pour accéder aux opérations EWS, GetItem et UpdateItem, afin d’obtenir et de définir d’autres propriétés d’un ou plusieurs éléments dans la boîte aux lettres de l’utilisateur.

La makeEwsRequestAsync méthode est disponible dans les formulaires de composition et de lecture. Pour plus d’informations sur l’autorisation de lecture/écriture de boîte aux lettres et l’accès à EWS via la plateforme des compléments Office, voir Présentation des autorisations de complément Outlook et Appeler des services web à partir d’un complément Outlook.

Tableau 1. Méthodes asynchrones pour obtenir ou définir des propriétés d’élément dans un formulaire de composition

Propriété Type de propriété Méthode asynchrone d’obtention Méthodes asynchrones à définir
bcc Recipients Recipients.getAsync Recipients.addAsync, Recipients.setAsync
body Body Body.getAsync Body.prependAsync, Body.setAsync, Body.setSelectedDataAsync
cc Recipients Recipients.getAsync Recipients.addAsync Recipients.setAsync
end Time Time.getAsync Time.setAsync
location Location Location.getAsync Location.setAsync
optionalAttendees Recipients Recipients.getAsync Recipients.addAsync Recipients.setAsync
requiredAttendees Recipients Recipients.getAsync Recipients.addAsync Recipients.setAsync
start Heure Time.getAsync Time.setAsync
subject Subject Subject.getAsync Subject.setAsync
to Recipients Recipients.getAsync Recipients.addAsync Recipients.setAsync

Voir aussi