Office.LoadedMessageCompose interface
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Représente un message en mode de composition actuellement chargé. Un LoadedMessageCompose
objet est retourné quand Office.context.mailbox.loadItemByIdAsync
est appelé sur un message en mode de composition.
Remarques
[ Ensemble d’API : préversion de boîte aux lettres ]
Niveau d’autorisation minimal : élément en lecture/écriture
Mode Outlook applicable : message Compose
Important:
Lors de l’implémentation de la fonctionnalité de sélection multiple d’élément, déterminez si vous pouvez déjà accéder aux propriétés requises de l’élément sélectionné via l’appel
Office.context.mailbox.getSelectedItemsAsync
. Si vous le pouvez, vous n’avez pas besoin d’appelerloadItemByIdAsync
.Un seul élément de courrier peut être chargé à la fois. Lorsque vous implémentez
loadItemByIdAsync
, vous devez appelerunloadAsync
après le traitement de l’élément. Cette opération doit être effectuée avant d’appelerloadItemByIdAsync
sur un autre élément.
Propriétés
bcc | Obtient les destinataires sur la ligne Cci (copie carbone aveugle) d’un message. |
body | Obtient le corps et le format de l’élément. |
categories | Obtient un objet qui fournit des méthodes pour gérer les catégories de l’élément. |
cc | Obtient les destinataires sur la ligne Cc (copie carbone) d’un message. |
conversation |
Obtient l’identificateur de la conversation qui contient un message particulier. Vous pouvez obtenir un nombre entier de cette propriété si votre application de messagerie est activée dans les formulaires de lecture ou les réponses des formulaires de composition. Si, par la suite, l’utilisateur modifie l’objet du message de réponse, lors de l’envoi de la réponse, l’ID de conversation de ce message va changer et la valeur que vous avez obtenue plus tôt ne sera plus applicable. Cette propriété obtient une valeur null lorsqu’un élément est ajouté à un formulaire de composition. |
delay |
Obtient la date et l’heure de remise différées d’un message. |
from | Obtient l’adresse de messagerie de l’expéditeur d’un message. |
in |
Obtient l’ID du message d’origine à laquelle le message actuel répond. |
internet |
Obtient les en-têtes Internet personnalisés d’un message. Pour plus d’informations, voir Obtenir et définir des en-têtes Internet sur un message dans un complément Outlook. |
item |
Obtient le type d’élément représenté par une instance. La |
notification |
Obtient les messages de notification de l’élément. |
sensitivity |
Obtient l’étiquette de confidentialité d’un message. |
series |
Obtient l’ID de la série à laquelle appartient un instance. Dans Outlook sur le web et sur Windows (nouveau et classique), retourne |
subject | Obtient la description qui apparaît dans le champ objet d’un élément. La |
to | Obtient les destinataires sur la ligne À d’un message. Permet d’accéder aux destinataires figurant sur la ligne À d’un message. Le type d’objet et le niveau d’accès dépendent du mode de l’élément actif. |
Méthodes
get |
Obtient une pièce jointe à partir d’un message ou d’un rendez-vous et la renvoie en tant qu’objet La |
get |
Obtient une pièce jointe à partir d’un message ou d’un rendez-vous et la renvoie en tant qu’objet La |
get |
Obtient les pièces jointes de l’élément sous forme de tableau. |
get |
Obtient les pièces jointes de l’élément sous forme de tableau. |
get |
Spécifie le type de composition de message et son type de forçage. Le message peut être nouveau, ou une réponse ou un transfert. Le type de contrainte peut être HTML ou texte brut. |
get |
Spécifie le type de composition de message et son type de forçage. Le message peut être nouveau, ou une réponse ou un transfert. Le type de contrainte peut être HTML ou texte brut. |
get |
Obtient la position encodée en Base64 du message actuel dans un thread de conversation. |
get |
Obtient la position encodée en Base64 du message actuel dans un thread de conversation. |
get |
Obtient les données d’initialisation transmises lorsque le complément est activé par un message actionnable. |
get |
Obtient les données d’initialisation transmises lorsque le complément est activé par un message actionnable. |
get |
Obtient la classe d’élément Services Web Exchange du message sélectionné. |
get |
Obtient la classe d’élément Services Web Exchange du message sélectionné. |
get |
Obtient de façon asynchrone l’identificateur d’élément EWS (Exchange Web Services) d’un élément enregistré. Lorsqu’elle est appelée, cette méthode retourne l’ID d’élément via la fonction de rappel. |
get |
Obtient de façon asynchrone l’ID d’un élément enregistré. Lorsqu’elle est appelée, cette méthode retourne l’ID d’élément via la fonction de rappel.
Remarque : Si votre complément appelle |
get |
Obtient les propriétés d’un rendez-vous ou d’un message dans un dossier partagé ou une boîte aux lettres partagée. Pour plus d’informations sur l’utilisation de cette API, voir Activer les dossiers partagés et les scénarios de boîte aux lettres partagées dans un complément Outlook. |
get |
Obtient les propriétés d’un rendez-vous ou d’un message dans un dossier partagé ou une boîte aux lettres partagée. Pour plus d’informations sur l’utilisation de cette API, voir Activer les dossiers partagés et les scénarios de boîte aux lettres partagées dans un complément Outlook. |
is |
Obtient si la signature du client est activée. Dans Outlook sur Windows (classique), l’appel d’API retourne |
is |
Obtient si la signature du client est activée. Dans Outlook sur Windows (classique), l’appel d’API retourne |
load |
Charge de manière asynchrone les propriétés personnalisées de ce complément vers l’élément sélectionné. Les propriétés personnalisées sont stockées sous forme de paires clé-valeur par application et par élément. Cette méthode renvoie un objet CustomProperties dans le rappel, qui fournit des méthodes pour accéder aux propriétés personnalisées spécifiques à l’élément actuel et au complément actuel. Les propriétés personnalisées ne sont pas chiffrées sur l’élément. Il ne doit donc pas être utilisé comme stockage sécurisé. Les propriétés personnalisées sont fournies sous la forme d’un objet |
save |
Enregistre de façon asynchrone le message actuel en tant que brouillon. |
save |
Enregistre de façon asynchrone le message actuel en tant que brouillon. |
unload |
Lorsque plusieurs éléments de courrier sont sélectionnés, ferme l’élément actuellement chargé, afin qu’un autre élément de courrier sélectionné puisse être chargé pour traitement. |
unload |
Lorsque plusieurs éléments de courrier sont sélectionnés, ferme l’élément actuellement chargé, afin qu’un autre élément de courrier sélectionné puisse être chargé pour traitement. |
Détails de la propriété
bcc
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient les destinataires sur la ligne Cci (copie carbone aveugle) d’un message.
bcc: Recipients;
Valeur de propriété
Remarques
[ Ensemble d’API : Boîte aux lettres 1.1 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
Important:
Seule la
getAsync
méthode de l’objet Recipients est prise en charge.Selon le client et la plateforme Outlook, des limites peuvent s’appliquer au nombre de destinataires que vous pouvez obtenir. Pour plus d’informations, consultez l’objet Recipients .
body
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient le corps et le format de l’élément.
body: Body;
Valeur de propriété
Remarques
[ Ensemble d’API : Boîte aux lettres 1.1 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
Important : seules les getAsync
méthodes et getTypeAsync
de l’objet Body sont prises en charge.
categories
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient un objet qui fournit des méthodes pour gérer les catégories de l’élément.
categories: Categories;
Valeur de propriété
Remarques
[ Ensemble d’API : Boîte aux lettres 1.8 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
cc
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient les destinataires sur la ligne Cc (copie carbone) d’un message.
cc: Recipients;
Valeur de propriété
Remarques
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
Important:
Seule la
getAsync
méthode de l’objet Recipients est prise en charge.Selon le client et la plateforme Outlook, des limites peuvent s’appliquer au nombre de destinataires que vous pouvez obtenir. Pour plus d’informations, consultez l’objet Recipients .
conversationId
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient l’identificateur de la conversation qui contient un message particulier.
Vous pouvez obtenir un nombre entier de cette propriété si votre application de messagerie est activée dans les formulaires de lecture ou les réponses des formulaires de composition. Si, par la suite, l’utilisateur modifie l’objet du message de réponse, lors de l’envoi de la réponse, l’ID de conversation de ce message va changer et la valeur que vous avez obtenue plus tôt ne sera plus applicable.
Cette propriété obtient une valeur null lorsqu’un élément est ajouté à un formulaire de composition.
conversationId: string;
Valeur de propriété
string
Remarques
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
delayDeliveryTime
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient la date et l’heure de remise différées d’un message.
delayDeliveryTime: DelayDeliveryTime;
Valeur de propriété
Remarques
[ Ensemble d’API : Boîte aux lettres 1.13 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
Important : seule la getAsync
méthode de l’objet DelayDeliveryTime est prise en charge.
from
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient l’adresse de messagerie de l’expéditeur d’un message.
from: From;
Valeur de propriété
Remarques
[ Ensemble d’API : Boîte aux lettres 1.7 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
inReplyTo
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient l’ID du message d’origine à laquelle le message actuel répond.
inReplyTo: string;
Valeur de propriété
string
Remarques
[ Ensemble d’API : Boîte aux lettres 1.14 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
Important:
Dans Outlook sur Windows, la
inReplyTo
valeur est conservée sur toutes les réponses, quelles que soient les modifications apportées par l’utilisateur, telles que la modification de l’objet dans une réponse.La
inReplyTo
propriété retournenull
les nouveaux messages et les invitations à la réunion transférés par un utilisateur qui est également l’organisateur de la réunion.
internetHeaders
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient les en-têtes Internet personnalisés d’un message.
Pour plus d’informations, voir Obtenir et définir des en-têtes Internet sur un message dans un complément Outlook.
internetHeaders: InternetHeaders;
Valeur de propriété
Remarques
[ Ensemble d’API : Boîte aux lettres 1.8 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
Important : seule la getAsync
méthode de l’objet InternetHeaders est prise en charge.
itemType
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient le type d’élément représenté par une instance.
La itemType
propriété retourne l’une des valeurs d’énumérationItemType
, indiquant si l’objet élément instance est un message ou un rendez-vous.
itemType: MailboxEnums.ItemType | string;
Valeur de propriété
Office.MailboxEnums.ItemType | string
Remarques
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
notificationMessages
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient les messages de notification de l’élément.
notificationMessages: NotificationMessages;
Valeur de propriété
Remarques
[ Ensemble d’API : Boîte aux lettres 1.3 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
Important:
- Seule la
getAllAsync
méthode de l’objet NotificationMessages est prise en charge.
sensitivityLabel
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient l’étiquette de confidentialité d’un message.
sensitivityLabel: SensitivityLabel;
Valeur de propriété
Remarques
[ Ensemble d’API : Boîte aux lettres 1.13 ]
Niveau d’autorisation minimal : élément en lecture/écriture
Mode Outlook applicable : message Compose
Important:
Pour utiliser la fonctionnalité d’étiquette de confidentialité dans votre complément, vous devez disposer d’un abonnement Microsoft 365 E5.
Seule la
getAsync
méthode de l’objet SensitivityLabel est prise en charge.
Pour en savoir plus sur la gestion des étiquettes de confidentialité dans votre complément, consultez Gérer l’étiquette de confidentialité de votre message ou rendez-vous en mode composition.
seriesId
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient l’ID de la série à laquelle appartient un instance.
Dans Outlook sur le web et sur Windows (nouveau et classique), retourne seriesId
l’ID des services Web Exchange (EWS) de l’élément parent (série) auquel cet élément appartient.
seriesId: string;
Valeur de propriété
string
Remarques
[ Ensemble d’API : Boîte aux lettres 1.7 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
Important : l’identificateur retourné par la seriesId
propriété est identique à l’identificateur d’élément des services Web Exchange. La seriesId
propriété n’est pas identique aux ID Outlook utilisés par l’API REST Outlook. Avant d’effectuer des appels d’API REST à l’aide de cette valeur, vous devez la convertir à l’aide Office.context.mailbox.convertToRestId
de . Pour plus d’informations, voir Utiliser les API REST Outlook à partir d’un complément Outlook.
La seriesId
propriété retourne null
pour les éléments qui n’ont pas d’éléments parents tels que des rendez-vous uniques, des éléments de série ou des demandes de réunion, et retourne undefined
pour tous les autres éléments qui ne sont pas des demandes de réunion.
subject
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient la description qui apparaît dans le champ objet d’un élément.
La subject
propriété obtient l’objet entier de l’élément, tel qu’envoyé par le serveur de messagerie.
subject: Subject;
Valeur de propriété
Remarques
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
Important : seule la getAsync
méthode de l’objet Subject est prise en charge.
to
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient les destinataires sur la ligne À d’un message. Permet d’accéder aux destinataires figurant sur la ligne À d’un message. Le type d’objet et le niveau d’accès dépendent du mode de l’élément actif.
to: Recipients;
Valeur de propriété
Remarques
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
Important:
Seule la
getAsync
méthode de l’objet Recipients est prise en charge.Selon le client et la plateforme Outlook, des limites peuvent s’appliquer au nombre de destinataires que vous pouvez obtenir. Pour plus d’informations, consultez l’objet Recipients .
Détails de la méthode
getAttachmentContentAsync(attachmentId, options, callback)
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient une pièce jointe à partir d’un message ou d’un rendez-vous et la renvoie en tant qu’objet AttachmentContent
.
La getAttachmentContentAsync
méthode obtient la pièce jointe avec l’identificateur spécifié à partir de l’élément. Il est recommandé d’obtenir l’identificateur de la pièce jointe à partir d’un getAttachmentsAsync
appel, puis, dans la même session, d’utiliser cet identificateur pour récupérer la pièce jointe. Dans Outlook sur le web et la nouvelle version d’Outlook sur Windows, l’identificateur de pièce jointe est valide uniquement dans la même session. Une session est terminée lorsque l’utilisateur ferme l’application, ou si l’utilisateur commence à composer un formulaire inline, puis affiche ensuite le formulaire pour continuer dans une fenêtre distincte.
getAttachmentContentAsync(attachmentId: string, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<AttachmentContent>) => void): void;
Paramètres
- attachmentId
-
string
Identificateur de la pièce jointe que vous souhaitez obtenir.
- options
- Office.AsyncContextOptions
Littéral d’objet qui contient une ou plusieurs des propriétés suivantes : les asyncContext
développeurs peuvent fournir n’importe quel objet auquel ils souhaitent accéder dans la fonction de rappel.
- callback
-
(asyncResult: Office.AsyncResult<Office.AttachmentContent>) => void
Optional. Une fois la méthode terminée, la fonction passée dans le callback
paramètre est appelée avec un seul paramètre, asyncResult
, qui est un Office.AsyncResult
objet . Si l’appel échoue, la asyncResult.error
propriété contient un code d’erreur avec la raison de l’échec.
Retours
void
Remarques
[ Ensemble d’API : Boîte aux lettres 1.8 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
Erreurs :
AttachmentTypeNotSupported
: le type de pièce jointe n’est pas pris en charge. Les types non pris en charge incluent des images incorporées au format TEXTE enrichi ou des types de pièces jointes autres que les éléments de courrier électronique ou de calendrier (par exemple, un contact ou un élément de tâche).InvalidAttachmentId
: l’identificateur de pièce jointe n’existe pas.
getAttachmentContentAsync(attachmentId, callback)
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient une pièce jointe à partir d’un message ou d’un rendez-vous et la renvoie en tant qu’objet AttachmentContent
.
La getAttachmentContentAsync
méthode obtient la pièce jointe avec l’identificateur spécifié à partir de l’élément. Il est recommandé d’obtenir l’identificateur de la pièce jointe à partir d’un getAttachmentsAsync
appel, puis, dans la même session, d’utiliser cet identificateur pour récupérer la pièce jointe. Dans Outlook sur le web et la nouvelle version d’Outlook sur Windows, l’identificateur de pièce jointe est valide uniquement dans la même session. Une session est terminée lorsque l’utilisateur ferme l’application, ou si l’utilisateur commence à composer un formulaire inline, puis affiche ensuite le formulaire pour continuer dans une fenêtre distincte.
getAttachmentContentAsync(attachmentId: string, callback?: (asyncResult: Office.AsyncResult<AttachmentContent>) => void): void;
Paramètres
- attachmentId
-
string
Identificateur de la pièce jointe que vous souhaitez obtenir.
- callback
-
(asyncResult: Office.AsyncResult<Office.AttachmentContent>) => void
Optional. Une fois la méthode terminée, la fonction passée dans le callback
paramètre est appelée avec un seul paramètre, asyncResult
, qui est un Office.AsyncResult
objet . Si l’appel échoue, la asyncResult.error
propriété contient un code d’erreur avec la raison de l’échec.
Retours
void
Remarques
[ Ensemble d’API : Boîte aux lettres 1.8 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
Erreurs :
AttachmentTypeNotSupported
: le type de pièce jointe n’est pas pris en charge. Les types non pris en charge incluent des images incorporées au format TEXTE enrichi ou des types de pièces jointes autres que les éléments de courrier électronique ou de calendrier (par exemple, un contact ou un élément de tâche).InvalidAttachmentId
: l’identificateur de pièce jointe n’existe pas.
getAttachmentsAsync(options, callback)
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient les pièces jointes de l’élément sous forme de tableau.
getAttachmentsAsync(options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<AttachmentDetailsCompose[]>) => void): void;
Paramètres
- options
- Office.AsyncContextOptions
Littéral d’objet qui contient une ou plusieurs des propriétés suivantes : les asyncContext
développeurs peuvent fournir n’importe quel objet auquel ils souhaitent accéder dans la fonction de rappel.
- callback
-
(asyncResult: Office.AsyncResult<Office.AttachmentDetailsCompose[]>) => void
Optional. Une fois la méthode terminée, la fonction passée dans le callback
paramètre est appelée avec un seul paramètre de type Office.AsyncResult
. Si l’appel échoue, la asyncResult.error
propriété contient un code d’erreur avec la raison de l’échec.
Retours
void
Remarques
[ Ensemble d’API : Boîte aux lettres 1.8 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
getAttachmentsAsync(callback)
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient les pièces jointes de l’élément sous forme de tableau.
getAttachmentsAsync(callback?: (asyncResult: Office.AsyncResult<AttachmentDetailsCompose[]>) => void): void;
Paramètres
- callback
-
(asyncResult: Office.AsyncResult<Office.AttachmentDetailsCompose[]>) => void
Optional. Une fois la méthode terminée, la fonction passée dans le callback
paramètre est appelée avec un seul paramètre de type Office.AsyncResult
. Si l’appel échoue, la asyncResult.error
propriété contient un code d’erreur avec la raison de l’échec.
Retours
void
Remarques
[ Ensemble d’API : Boîte aux lettres 1.8 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
getComposeTypeAsync(options, callback)
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Spécifie le type de composition de message et son type de forçage. Le message peut être nouveau, ou une réponse ou un transfert. Le type de contrainte peut être HTML ou texte brut.
getComposeTypeAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<any>) => void): void;
Paramètres
- options
- Office.AsyncContextOptions
Littéral d’objet qui contient une ou plusieurs des propriétés suivantes : les asyncContext
développeurs peuvent fournir n’importe quel objet auquel ils souhaitent accéder dans la fonction de rappel.
- callback
-
(asyncResult: Office.AsyncResult<any>) => void
Une fois la méthode terminée, la fonction passée dans le callback
paramètre est appelée avec un seul paramètre de type Office.AsyncResult
. En cas de réussite, la asyncResult.value
propriété contient un objet avec le type de composition et le type de forçage de l’élément.
Retours
void
Objet avec ComposeType
les valeurs d’énumération et CoercionType
pour l’élément de message.
Remarques
[ Ensemble d’API : Boîte aux lettres 1.10 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
getComposeTypeAsync(callback)
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Spécifie le type de composition de message et son type de forçage. Le message peut être nouveau, ou une réponse ou un transfert. Le type de contrainte peut être HTML ou texte brut.
getComposeTypeAsync(callback: (asyncResult: Office.AsyncResult<any>) => void): void;
Paramètres
- callback
-
(asyncResult: Office.AsyncResult<any>) => void
Une fois la méthode terminée, la fonction passée dans le callback
paramètre est appelée avec un seul paramètre de type Office.AsyncResult
. En cas de réussite, la asyncResult.value
propriété contient un objet avec le type de composition et le type de forçage de l’élément.
Retours
void
Objet avec ComposeType
les valeurs d’énumération et CoercionType
pour l’élément de message.
Remarques
[ Ensemble d’API : Boîte aux lettres 1.10 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
getConversationIndexAsync(options, callback)
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient la position encodée en Base64 du message actuel dans un thread de conversation.
getConversationIndexAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<string>) => void): void;
Paramètres
- options
- Office.AsyncContextOptions
Littéral d’objet qui contient une ou plusieurs des propriétés suivantes : les asyncContext
développeurs peuvent fournir n’importe quel objet auquel ils souhaitent accéder dans la fonction de rappel.
- callback
-
(asyncResult: Office.AsyncResult<string>) => void
Une fois la méthode terminée, la fonction passée dans le callback
paramètre est appelée avec un seul paramètre, asyncResult
, qui est un Office.AsyncResult
objet . La position encodée en Base64 du message actuel dans une conversation est retournée dans la asyncResult.value
propriété .
Retours
void
Remarques
[ Ensemble d’API : Boîte aux lettres 1.14 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
Conseil : Vous pouvez utiliser l’index de conversation pour localiser un message dans un thread de conversation. Ensuite, utilisez son contenu pour fournir un contexte pour le message actuel en cours de composition.
getConversationIndexAsync(callback)
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient la position encodée en Base64 du message actuel dans un thread de conversation.
getConversationIndexAsync(callback: (asyncResult: Office.AsyncResult<string>) => void): void;
Paramètres
- callback
-
(asyncResult: Office.AsyncResult<string>) => void
Une fois la méthode terminée, la fonction passée dans le callback
paramètre est appelée avec un seul paramètre, asyncResult
, qui est un Office.AsyncResult
objet . La position encodée en Base64 du message actuel dans une conversation est retournée dans la asyncResult.value
propriété .
Retours
void
Remarques
[ Ensemble d’API : Boîte aux lettres 1.14 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
Conseil : Vous pouvez utiliser l’index de conversation pour localiser un message dans un thread de conversation. Ensuite, utilisez son contenu pour fournir un contexte pour le message actuel en cours de composition.
getInitializationContextAsync(options, callback)
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient les données d’initialisation transmises lorsque le complément est activé par un message actionnable.
getInitializationContextAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<string>) => void): void;
Paramètres
- options
- Office.AsyncContextOptions
Littéral d’objet qui contient une ou plusieurs des propriétés suivantes : les asyncContext
développeurs peuvent fournir n’importe quel objet auquel ils souhaitent accéder dans la fonction de rappel.
- callback
-
(asyncResult: Office.AsyncResult<string>) => void
Une fois la méthode terminée, la fonction passée dans le callback
paramètre est appelée avec un seul paramètre de type Office.AsyncResult
. En cas de réussite, les données de contexte d’initialisation sont fournies sous la forme d’une chaîne (ou d’une chaîne vide s’il n’y a pas de contexte d’initialisation) dans la asyncResult.value
propriété .
Retours
void
Remarques
[ Ensemble d’API : Boîte aux lettres 1.8 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
getInitializationContextAsync(callback)
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient les données d’initialisation transmises lorsque le complément est activé par un message actionnable.
getInitializationContextAsync(callback: (asyncResult: Office.AsyncResult<string>) => void): void;
Paramètres
- callback
-
(asyncResult: Office.AsyncResult<string>) => void
Une fois la méthode terminée, la fonction passée dans le callback
paramètre est appelée avec un seul paramètre de type Office.AsyncResult
. En cas de réussite, les données de contexte d’initialisation sont fournies sous la forme d’une chaîne (ou d’une chaîne vide s’il n’y a pas de contexte d’initialisation) dans la asyncResult.value
propriété .
Retours
void
Remarques
[ Ensemble d’API : Boîte aux lettres 1.8 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
getItemClassAsync(options, callback)
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient la classe d’élément Services Web Exchange du message sélectionné.
getItemClassAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<string>) => void): void;
Paramètres
- options
- Office.AsyncContextOptions
Littéral d’objet qui contient une ou plusieurs des propriétés suivantes : les asyncContext
développeurs peuvent fournir n’importe quel objet auquel ils souhaitent accéder dans la fonction de rappel.
- callback
-
(asyncResult: Office.AsyncResult<string>) => void
Une fois la méthode terminée, la fonction passée dans le callback
paramètre est appelée avec un seul paramètre, asyncResult
, qui est un Office.AsyncResult
objet . La classe de message est retournée dans la asyncResult.value
propriété .
Retours
void
Remarques
[ Ensemble d’API : Boîte aux lettres 1.14 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
Important:
Le tableau suivant répertorie les classes de message par défaut.
Classe de l’élément | Description |
---|---|
IPM. Note | Nouveaux messages et réponses aux messages |
IPM. Remarque.SMIME | Messages chiffrés qui peuvent également être signés |
IPM. Remarque.SMIME.MultipartSigned | Messages signés en clair |
IPM.Schedule.Meeting.Request | Demandes de réunion |
IPM.Schedule.Meeting.Canceled | Annulations de rendez-vous |
IPM. Schedule.Meeting.Resp.Neg | Réponses négatives à des demandes de rendez-vous |
IPM. Schedule.Meeting.Resp.Pos | Réponses à l’acceptation des demandes de réunion |
IPM. Schedule.Meeting.Resp.Tent | Réponses provisoirement positives à des demandes de rendez-vous |
getItemClassAsync(callback)
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient la classe d’élément Services Web Exchange du message sélectionné.
getItemClassAsync(callback: (asyncResult: Office.AsyncResult<string>) => void): void;
Paramètres
- callback
-
(asyncResult: Office.AsyncResult<string>) => void
Une fois la méthode terminée, la fonction passée dans le callback
paramètre est appelée avec un seul paramètre, asyncResult
, qui est un Office.AsyncResult
objet . La classe de message est retournée dans la asyncResult.value
propriété .
Retours
void
Remarques
[ Ensemble d’API : Boîte aux lettres 1.14 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
Important:
Le tableau suivant répertorie les classes de message par défaut.
Classe de l’élément | Description |
---|---|
IPM. Note | Nouveaux messages et réponses aux messages |
IPM. Remarque.SMIME | Messages chiffrés qui peuvent également être signés |
IPM. Remarque.SMIME.MultipartSigned | Messages signés en clair |
IPM.Schedule.Meeting.Request | Demandes de réunion |
IPM.Schedule.Meeting.Canceled | Annulations de rendez-vous |
IPM. Schedule.Meeting.Resp.Neg | Réponses négatives à des demandes de rendez-vous |
IPM. Schedule.Meeting.Resp.Pos | Réponses à l’acceptation des demandes de réunion |
IPM. Schedule.Meeting.Resp.Tent | Réponses provisoirement positives à des demandes de rendez-vous |
getItemIdAsync(options, callback)
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient de façon asynchrone l’identificateur d’élément EWS (Exchange Web Services) d’un élément enregistré.
Lorsqu’elle est appelée, cette méthode retourne l’ID d’élément via la fonction de rappel.
getItemIdAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<string>) => void): void;
Paramètres
- options
- Office.AsyncContextOptions
Littéral d’objet qui contient une ou plusieurs des propriétés suivantes : les asyncContext
développeurs peuvent fournir n’importe quel objet auquel ils souhaitent accéder dans la fonction de rappel.
- callback
-
(asyncResult: Office.AsyncResult<string>) => void
Une fois la méthode terminée, la fonction passée dans le callback
paramètre est appelée avec un seul paramètre de type Office.AsyncResult
. L’ID d’élément EWS de l’élément est retourné dans la asyncResult.value
propriété .
Retours
void
Remarques
[ Ensemble d’API : Boîte aux lettres 1.8 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
Important:
L’ID d’élément retourné n’est pas identique à l’ID d’entrée Outlook ou à l’ID utilisé par l’API REST Outlook. Avant d’effectuer des appels d’API REST à l’aide de cette valeur, vous devez la convertir à l’aide
Office.context.mailbox.convertToRestId
de .Si votre complément appelle
getItemIdAsync
sur un élément en mode composition (par exemple, pour obtenir unitemId
à utiliser avec EWS ou l’API REST), sachez que lorsqu’Outlook est en mode mis en cache, la synchronisation de l’élément sur le serveur peut prendre un certain temps. Tant que l’élément n’est pas synchronisé, leitemId
n’est pas reconnu et son utilisation retourne une erreur.
Erreurs :
-
ItemNotSaved
: l’ID ne peut pas être récupéré tant que l’élément n’est pas enregistré.
getItemIdAsync(callback)
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient de façon asynchrone l’ID d’un élément enregistré.
Lorsqu’elle est appelée, cette méthode retourne l’ID d’élément via la fonction de rappel.
Remarque : Si votre complément appelle getItemIdAsync
sur un élément en mode composition (par exemple, pour obtenir un itemId
à utiliser avec EWS ou l’API REST), sachez que lorsqu’Outlook est en mode mis en cache, la synchronisation de l’élément sur le serveur peut prendre un certain temps. Tant que l’élément n’est pas synchronisé, le itemId
n’est pas reconnu et son utilisation retourne une erreur.
getItemIdAsync(callback: (asyncResult: Office.AsyncResult<string>) => void): void;
Paramètres
- callback
-
(asyncResult: Office.AsyncResult<string>) => void
Une fois la méthode terminée, la fonction passée dans le callback
paramètre est appelée avec un seul paramètre de type Office.AsyncResult
.
Retours
void
Remarques
[ Ensemble d’API : Boîte aux lettres 1.8 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
Erreurs :
-
ItemNotSaved
: l’ID ne peut pas être récupéré tant que l’élément n’est pas enregistré.
getSharedPropertiesAsync(options, callback)
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient les propriétés d’un rendez-vous ou d’un message dans un dossier partagé ou une boîte aux lettres partagée.
Pour plus d’informations sur l’utilisation de cette API, voir Activer les dossiers partagés et les scénarios de boîte aux lettres partagées dans un complément Outlook.
getSharedPropertiesAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<SharedProperties>) => void): void;
Paramètres
- options
- Office.AsyncContextOptions
Littéral d’objet qui contient une ou plusieurs des propriétés suivantes : les asyncContext
développeurs peuvent fournir n’importe quel objet auquel ils souhaitent accéder dans la fonction de rappel.
- callback
-
(asyncResult: Office.AsyncResult<Office.SharedProperties>) => void
Une fois la méthode terminée, la fonction passée dans le callback
paramètre est appelée avec un seul paramètre, asyncResult
, qui est un Office.AsyncResult
objet . La asyncResult.value
propriété fournit les propriétés de l’élément partagé.
Retours
void
Remarques
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
Important : En mode Message Compose, cette API n’est pas prise en charge dans Outlook sur le web ou sur Windows (nouveau et classique), sauf si les conditions suivantes sont remplies.
a. Déléguer l’accès/Dossiers partagés
Le propriétaire de la boîte aux lettres démarre un message. Il peut s’agir d’un nouveau message, d’une réponse ou d’un transfert.
Ils enregistrent le message, puis le déplacent de leur propre dossier Brouillons vers un dossier partagé avec le délégué.
Le délégué ouvre le brouillon à partir du dossier partagé, puis continue la composition.
b. Boîte aux lettres partagée (s’applique uniquement à Outlook classique sur Windows)
L’utilisateur de la boîte aux lettres partagée démarre un message. Il peut s’agir d’un nouveau message, d’une réponse ou d’un transfert.
Ils enregistrent le message, puis le déplacent de leur propre dossier Brouillons vers un dossier dans la boîte aux lettres partagée.
Un autre utilisateur de boîte aux lettres partagée ouvre le brouillon à partir de la boîte aux lettres partagée, puis continue de composer.
Le message est maintenant dans un contexte partagé et les compléments qui prennent en charge ces scénarios partagés peuvent obtenir les propriétés partagées de l’élément. Une fois le message envoyé, il se trouve généralement dans le dossier Éléments envoyés de l’expéditeur.
getSharedPropertiesAsync(callback)
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient les propriétés d’un rendez-vous ou d’un message dans un dossier partagé ou une boîte aux lettres partagée.
Pour plus d’informations sur l’utilisation de cette API, voir Activer les dossiers partagés et les scénarios de boîte aux lettres partagées dans un complément Outlook.
getSharedPropertiesAsync(callback: (asyncResult: Office.AsyncResult<SharedProperties>) => void): void;
Paramètres
- callback
-
(asyncResult: Office.AsyncResult<Office.SharedProperties>) => void
Une fois la méthode terminée, la fonction passée dans le callback
paramètre est appelée avec un seul paramètre, asyncResult
, qui est un Office.AsyncResult
objet . La asyncResult.value
propriété fournit les propriétés de l’élément partagé.
Retours
void
Remarques
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
Important : En mode Message Compose, cette API n’est pas prise en charge dans Outlook sur le web ou sur Windows (nouveau et classique), sauf si les conditions suivantes sont remplies.
a. Déléguer l’accès/Dossiers partagés
Le propriétaire de la boîte aux lettres démarre un message. Il peut s’agir d’un nouveau message, d’une réponse ou d’un transfert.
Ils enregistrent le message, puis le déplacent de leur propre dossier Brouillons vers un dossier partagé avec le délégué.
Le délégué ouvre le brouillon à partir du dossier partagé, puis continue la composition.
b. Boîte aux lettres partagée (s’applique uniquement à Outlook sur Windows)
L’utilisateur de la boîte aux lettres partagée démarre un message. Il peut s’agir d’un nouveau message, d’une réponse ou d’un transfert.
Ils enregistrent le message, puis le déplacent de leur propre dossier Brouillons vers un dossier dans la boîte aux lettres partagée.
Un autre utilisateur de boîte aux lettres partagée ouvre le brouillon à partir de la boîte aux lettres partagée, puis continue de composer.
Le message est maintenant dans un contexte partagé et les compléments qui prennent en charge ces scénarios partagés peuvent obtenir les propriétés partagées de l’élément. Une fois le message envoyé, il se trouve généralement dans le dossier Éléments envoyés de l’expéditeur.
isClientSignatureEnabledAsync(options, callback)
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient si la signature du client est activée.
Dans Outlook sur Windows (classique), l’appel d’API retourne true
si la signature par défaut pour les nouveaux messages, réponses ou transfert est définie sur un modèle pour le compte Outlook d’envoi. Dans Outlook sur le web et outlook sur Windows, l’appel d’API retourne true
si la signature est activée pour les types newMail
compose , reply
ou forward
. Si les paramètres sont définis sur « (aucun) » dans Outlook sur Windows (classique) ou sont désactivés dans Outlook sur le web ou outlook sur Windows, l’appel d’API retourne false
.
isClientSignatureEnabledAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<boolean>) => void): void;
Paramètres
- options
- Office.AsyncContextOptions
Littéral d’objet qui contient une ou plusieurs des propriétés suivantes : les asyncContext
développeurs peuvent fournir n’importe quel objet auquel ils souhaitent accéder dans la fonction de rappel.
- callback
-
(asyncResult: Office.AsyncResult<boolean>) => void
Une fois la méthode terminée, la fonction passée dans le callback
paramètre est appelée avec un seul paramètre de type Office.AsyncResult
.
Retours
void
Remarques
[ Ensemble d’API : Boîte aux lettres 1.10 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
isClientSignatureEnabledAsync(callback)
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Obtient si la signature du client est activée.
Dans Outlook sur Windows (classique), l’appel d’API retourne true
si la signature par défaut pour les nouveaux messages, réponses ou transfert est définie sur un modèle pour le compte Outlook d’envoi. Dans Outlook sur le web et outlook sur Windows, l’appel d’API retourne true
si la signature est activée pour les types newMail
compose , reply
ou forward
. Si les paramètres sont définis sur « (aucun) » dans Outlook sur Windows (classique) ou sont désactivés dans Outlook sur le web ou outlook sur Windows, l’appel d’API retourne false
.
isClientSignatureEnabledAsync(callback: (asyncResult: Office.AsyncResult<boolean>) => void): void;
Paramètres
- callback
-
(asyncResult: Office.AsyncResult<boolean>) => void
Une fois la méthode terminée, la fonction passée dans le callback
paramètre est appelée avec un seul paramètre de type Office.AsyncResult
.
Retours
void
Remarques
[ Ensemble d’API : Boîte aux lettres 1.10 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
loadCustomPropertiesAsync(callback, userContext)
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Charge de manière asynchrone les propriétés personnalisées de ce complément vers l’élément sélectionné.
Les propriétés personnalisées sont stockées sous forme de paires clé-valeur par application et par élément. Cette méthode renvoie un objet CustomProperties dans le rappel, qui fournit des méthodes pour accéder aux propriétés personnalisées spécifiques à l’élément actuel et au complément actuel. Les propriétés personnalisées ne sont pas chiffrées sur l’élément. Il ne doit donc pas être utilisé comme stockage sécurisé.
Les propriétés personnalisées sont fournies sous la forme d’un objet CustomProperties
dans la propriété asyncResult.value
. Cet objet peut être utilisé pour obtenir des propriétés personnalisées à partir de l’élément de courrier.
loadCustomPropertiesAsync(callback: (asyncResult: Office.AsyncResult<CustomProperties>) => void, userContext?: any): void;
Paramètres
- callback
-
(asyncResult: Office.AsyncResult<Office.CustomProperties>) => void
Une fois la méthode terminée, la fonction passée dans le callback
paramètre est appelée avec un seul paramètre de type Office.AsyncResult
.
- userContext
-
any
Optional. Les développeurs peuvent fournir un objet auquel ils souhaitent accéder dans la fonction de rappel. Cet objet est accessible via la propriété asyncResult.asyncContext
dans la fonction de rappel.
Retours
void
Remarques
[ Ensemble d’API : Boîte aux lettres 1.1 ]
Pour en savoir plus sur les propriétés personnalisées, voir Obtenir et définir des métadonnées de complément pour un complément Outlook.
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : message Compose
saveAsync(options, callback)
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Enregistre de façon asynchrone le message actuel en tant que brouillon.
saveAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<string>) => void): void;
Paramètres
- options
- Office.AsyncContextOptions
Littéral d’objet qui contient une ou plusieurs des propriétés suivantes : les asyncContext
développeurs peuvent fournir n’importe quel objet auquel ils souhaitent accéder dans la fonction de rappel.
- callback
-
(asyncResult: Office.AsyncResult<string>) => void
Une fois la méthode terminée, la fonction passée dans le callback
paramètre est appelée avec un seul paramètre, asyncResult
, qui est un Office.AsyncResult
objet . L’ID de message EWS est retourné dans la asyncResult.value
propriété .
Retours
void
Remarques
[ Ensemble d’API : Boîte aux lettres 1.3 ]
Niveau d’autorisation minimal : élément en lecture/écriture
Mode Outlook applicable : message Compose
Important:
Dans Outlook sur le web, nouvel Outlook sur Windows ou Outlook classique sur Windows en mode en ligne (mode non mis en cache), l’élément est enregistré sur le serveur. Dans Outlook en mode mis en cache, l’élément est enregistré dans le cache local.
Lorsque vous utilisez du contenu au format HTML, il est important de noter que le client Outlook peut modifier le contenu. Cela signifie que les appels ultérieurs à des méthodes comme
Body.getAsync
,Body.setAsync
etsaveAsync
même peuvent ne pas aboutir au même contenu.L’identificateur retourné est identique à l’identificateur d’élément EWS (Exchange Web Services). L’ID d’élément retourné n’est pas identique à l’ID d’entrée Outlook ou à l’ID utilisé par l’API REST Outlook. Avant d’effectuer des appels d’API REST à l’aide de cette valeur, vous devez la convertir à l’aide
Office.context.mailbox.convertToRestId
de .Si votre complément appelle
saveAsync
un élément en mode composition afin d’obtenir un ID d’élément à utiliser avec EWS ou l’API REST, sachez que lorsqu’Outlook est en mode mis en cache, la synchronisation de l’élément sur le serveur peut prendre un certain temps. Tant que l’élément n’est pas synchronisé, l’utilisation de l’ID d’élément renvoie une erreur.Dans Outlook sur le web et outlook sur Windows, le compte de boîte aux lettres dans lequel un brouillon est enregistré varie lorsque
saveAsync
est appelé sur un message qui sera envoyé à partir d’un compte de boîte aux lettres partagé. Si l’expéditeur crée un message à partir de sa boîte aux lettres personnelle et sélectionne le compte de boîte aux lettres partagé dans le champ De ,saveAsync
enregistre le brouillon dans le dossier Brouillons de la boîte aux lettres personnelle de l’utilisateur. Si l’expéditeur ouvre le compte de boîte aux lettres partagé dans un onglet de navigateur distinct (via l’option Ouvrir une autre boîte aux lettres , par exemple) et y crée un nouveau message,saveAsync
enregistre le brouillon dans le dossier Brouillons de la boîte aux lettres partagée.
Erreurs :
-
InvalidAttachmentId
: l’identificateur de pièce jointe n’existe pas.
saveAsync(callback)
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Enregistre de façon asynchrone le message actuel en tant que brouillon.
saveAsync(callback: (asyncResult: Office.AsyncResult<string>) => void): void;
Paramètres
- callback
-
(asyncResult: Office.AsyncResult<string>) => void
Une fois la méthode terminée, la fonction passée dans le callback
paramètre est appelée avec un seul paramètre, asyncResult
, qui est un Office.AsyncResult
objet . L’ID de message EWS est retourné dans la asyncResult.value
propriété .
Retours
void
Remarques
[ Ensemble d’API : Boîte aux lettres 1.3 ]
Niveau d’autorisation minimal : élément en lecture/écriture
Mode Outlook applicable : message Compose
Important:
Dans Outlook sur le web, nouvel Outlook sur Windows ou Outlook classique sur Windows en mode en ligne (mode non mis en cache), l’élément est enregistré sur le serveur. Dans Outlook en mode mis en cache, l’élément est enregistré dans le cache local.
Lorsque vous utilisez du contenu au format HTML, il est important de noter que le client Outlook peut modifier le contenu. Cela signifie que les appels ultérieurs à des méthodes comme
Body.getAsync
,Body.setAsync
etsaveAsync
même peuvent ne pas aboutir au même contenu.L’identificateur retourné est identique à l’identificateur d’élément EWS (Exchange Web Services). L’ID d’élément retourné n’est pas identique à l’ID d’entrée Outlook ou à l’ID utilisé par l’API REST Outlook. Avant d’effectuer des appels d’API REST à l’aide de cette valeur, vous devez la convertir à l’aide
Office.context.mailbox.convertToRestId
de .Si votre complément appelle
saveAsync
un élément en mode composition afin d’obtenir un ID d’élément à utiliser avec EWS ou l’API REST, sachez que lorsqu’Outlook est en mode mis en cache, la synchronisation de l’élément sur le serveur peut prendre un certain temps. Tant que l’élément n’est pas synchronisé, l’utilisation de l’ID d’élément renvoie une erreur.Dans Outlook sur le web et outlook sur Windows, le compte de boîte aux lettres dans lequel un brouillon est enregistré varie lorsque
saveAsync
est appelé sur un message qui sera envoyé à partir d’un compte de boîte aux lettres partagé. Si l’expéditeur crée un message à partir de sa boîte aux lettres personnelle et sélectionne le compte de boîte aux lettres partagé dans le champ De ,saveAsync
enregistre le brouillon dans le dossier Brouillons de la boîte aux lettres personnelle de l’utilisateur. Si l’expéditeur ouvre le compte de boîte aux lettres partagé dans un onglet de navigateur distinct (via l’option Ouvrir une autre boîte aux lettres , par exemple) et y crée un nouveau message,saveAsync
enregistre le brouillon dans le dossier Brouillons de la boîte aux lettres partagée.
Erreurs :
-
InvalidAttachmentId
: l’identificateur de pièce jointe n’existe pas.
unloadAsync(options, callback)
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Lorsque plusieurs éléments de courrier sont sélectionnés, ferme l’élément actuellement chargé, afin qu’un autre élément de courrier sélectionné puisse être chargé pour traitement.
unloadAsync(options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
Paramètres
- options
- Office.AsyncContextOptions
Littéral d’objet qui contient la asyncContext
propriété . Affectez à la propriété tout objet auquel vous souhaitez accéder dans la asyncContext
fonction de rappel.
- callback
-
(asyncResult: Office.AsyncResult<void>) => void
Optional. Une fois la méthode terminée, la fonction passée dans le paramètre de rappel est appelée avec un seul paramètre, asyncResult
, qui est un Office.AsyncResult
objet .
Retours
void
Remarques
[ Ensemble d’API : préversion de boîte aux lettres ]
Niveau d’autorisation minimal : élément en lecture/écriture
Mode Outlook applicable : message Compose
Important:
Pour en savoir plus sur le traitement de plusieurs messages sélectionnés, voir Activer votre complément Outlook sur plusieurs messages.
Lorsqu’un élément de courrier sélectionné est chargé à l’aide
loadItemByIdAsync
de , vous devez appelerunloadAsync
après son traitement. Cette opération doit être effectuée avant d’appelerloadItemByIdAsync
sur un autre élément sélectionné.
unloadAsync(callback)
Notes
Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.
Lorsque plusieurs éléments de courrier sont sélectionnés, ferme l’élément actuellement chargé, afin qu’un autre élément de courrier sélectionné puisse être chargé pour traitement.
unloadAsync(callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
Paramètres
- callback
-
(asyncResult: Office.AsyncResult<void>) => void
Optional. Une fois la méthode terminée, la fonction passée dans le paramètre de rappel est appelée avec un seul paramètre, asyncResult
, qui est un Office.AsyncResult
objet .
Retours
void
Remarques
[ Ensemble d’API : préversion de boîte aux lettres ]
Niveau d’autorisation minimal : élément en lecture/écriture
Mode Outlook applicable : message Compose
Important:
Pour en savoir plus sur le traitement de plusieurs messages sélectionnés, voir Activer votre complément Outlook sur plusieurs messages.
Lorsqu’un élément de courrier sélectionné est chargé à l’aide
loadItemByIdAsync
de , vous devez appelerunloadAsync
après son traitement. Cette opération doit être effectuée avant d’appelerloadItemByIdAsync
sur un autre élément sélectionné.