--- sourceDocument: Australie Workflow Data Fabric sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/integrate-applications Release : - australia ft:locale : - fr-FR ft:publication_title : - Australie Workflow Data Fabric ft:clusterId : - crint bundleId : - crint workflow : - Creator --- # Méthodes du connecteur de messagerie # Méthodes du connecteur de messagerie {#ariaid-title1} * Rversion finale: Australia * * Mis à jour 12 mars 2026 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 minutes de lecture Les méthodes du connecteur de messagerie récupèrent, envoient et répondent aux e-mails, et peuvent télécharger des pièces jointes. Utilisez d'abord la méthode SetConfig pour configurer la connexion à votre serveur de messagerie. Utilisez la méthode SetConfig pour configurer les propriétés du serveur de messagerie et les informations d'identification d'accès. Cette méthode doit précéder toutes les autres méthodes de connecteur d'e-mail dans l'automatisation. La méthode GetMails récupère les messages du serveur de messagerie et les transmet à d'autres méthodes sous la forme d'un objet contenant un ou plusieurs messages. Les méthodes ReadMail, ReplyMail et SaveAllAttachments fonctionnent sur un seul message à la fois. Lorsque ces méthodes reçoivent un objet contenant plus d'un message, l'automatisation doit utiliser une méthode For Each ou For Loop pour itérer chaque message de la collection. * Pour plus d'informations sur l'utilisation de la méthode For Each, reportez-vous à la section [Utiliser le composant Pour chaque](https://servicenow-prod.fluidtopics.net/gMOtw6y_eeHXI9cRYC9GXA "Parcourez chaque élément d’une collection dans l’ordre du premier au dernier à l’aide du composant For Each dans le Studio de conception de bureau de RPA. La collection peut être un tableau, une liste ou une table."). * Pour plus d'informations sur l'utilisation de la méthode For Loop, reportez-vous à la section [Utiliser le composant For Loop](https://servicenow-prod.fluidtopics.net/Ty7xUCgIySBK4JUH_MYsBA "Exécuter un code de manière récurrente pour effectuer des tâches de nature répétitive avec le composant For Loop dans le Studio de conception de bureau de RPA. La boucle For est un composant de flux de contrôle permettant de spécifier des itérations."). {#email-connector-methods__ul_rkc_ss4_lzb} ## Configuration d'ensemble {#email-connector-methods__section_psc_jv2_mtb} Configure la connexion au serveur de messagerie afin que l'automatisation puisse fonctionner avec les messages. Remarque : Vous devez exécuter cette méthode avant d'exécuter toute autre méthode dans le connecteur de messagerie. Pour en savoir plus sur la définition des paramètres, reportez-vous à la section [Configurer les propriétés du port](https://servicenow-prod.fluidtopics.net/6JvHcl7ZXkWp0SovDjJ3XQ "Configurez la façon dont les données sont transmises aux champs d’entrée d’un composant ou d’une méthode dans Studio de conception de bureau de RPA."). {#email-connector-methods__table_qrp_jx2_mtb__entry__7} | Paramètre | Description | Type de port de données | Type de données | Valeur par défaut | Requis ? | Notes | |-|-|-|-|-|-|-| | Nom d'utilisateur | Nom d'utilisateur pour se connecter au serveur de messagerie | Données dans | Chaîne | (aucun) | Oui | | | Mot de passe | Mot de passe pour se connecter au serveur de messagerie | Données dans | Chaîne | (aucun) | Oui | | | UseDefaultCredentials (en anglais seulement) | Envoie les informations d'identification par défaut de l'utilisateur actuellement connecté au serveur SMTP. | Données dans | Booléen | Faux | Non | | | Serveur SmtpMailServer | Nom du serveur SMTP | Données dans | Chaîne | smtp.gmail.com | Non | L'accès à Gmail à l'aide du connecteur de messagerie n'est actuellement pas pris en charge. Assurez-vous de changer la valeur par défaut. | | Serveur ImapMail | Nom du serveur IMAP | Données dans | Chaîne | imap.gmail.com | Non | L'accès à Gmail à l'aide du connecteur de messagerie n'est actuellement pas pris en charge. Assurez-vous de changer la valeur par défaut. | | SSL | Utiliser le protocole Secure Socket Layer | Données dans | Booléen | Vrai | Non | | | SmtpPort | Numéro de port SMTP | Données dans | Entier | 587 | Non | | | ImapPort | Numéro de port IMAP | Données dans | Entier | 993 | Non | | [Tableau 1. Paramètres de la méthode SetConfig] {#email-connector-methods__table_qrp_jx2_mtb} ## GetMails {#email-connector-methods__section_rw5_4mk_mtb} Renvoie les messages du serveur de messagerie pour utilisation par d'autres méthodes. Vous pouvez définir la méthode pour récupérer les messages lus (vus) ou non lus (non vus) et spécifier le dossier dans lequel ils sont collectés. Pour en savoir plus sur la définition des paramètres, reportez-vous à la section [Configurer les propriétés du port](https://servicenow-prod.fluidtopics.net/6JvHcl7ZXkWp0SovDjJ3XQ "Configurez la façon dont les données sont transmises aux champs d’entrée d’un composant ou d’une méthode dans Studio de conception de bureau de RPA."). {#email-connector-methods__table_uvc_1nk_mtb__entry__7} | Paramètre | Description | Type de port de données | Type de données | Valeur par défaut | Requis ? | Notes | |-|-|-|-|-|-|-| | Nom du dossier | Nom du dossier IMAP dans lequel la méthode extrait la collection (par exemple, boîte de réception) | Données dans | Chaîne | Boîte de réception | Oui | Pour spécifier un dossier IMAP imbriqué, saisissez la hiérarchie des dossiers à l'aide de barres obliques inverses (par exemple, Projet\\Réunions) | | Filtre | Définir pour obtenir uniquement des messages non lus (non vus) ou lus (vus) | Données dans | Mode de filtre | Non vu | Oui | | | Retour | Renvoie la collecte d'e-mails en tant qu'objet | Sortie de données | Objet | Objet | Oui | | [Tableau 2. Paramètres de méthode GetMails] {#email-connector-methods__table_uvc_1nk_mtb} ## MarkAsRead {#email-connector-methods__section_uhb_31l_mtb} Marque les messages d'un dossier spécifié comme lus. Pour en savoir plus sur la définition des paramètres, reportez-vous à la section [Configurer les propriétés du port](https://servicenow-prod.fluidtopics.net/6JvHcl7ZXkWp0SovDjJ3XQ "Configurez la façon dont les données sont transmises aux champs d’entrée d’un composant ou d’une méthode dans Studio de conception de bureau de RPA."). {#email-connector-methods__table_zhf_kbl_mtb__entry__7} | Paramètre | Description | Type de port | Type de données | Valeur par défaut | Requis ? | Notes | |-|-|-|-|-|-|-| | Objet de messagerie | Objet d'e-mail sur la base duquel le message correspondant est marqué comme lu | Données dans | Objet | Objet | Oui | | | Nom du dossier | Nom du dossier IMAP dans lequel l'objet d'e-mail est extrait | Données dans | Chaîne | Boîte de réception | Oui | Pour spécifier un dossier IMAP imbriqué, saisissez la hiérarchie des dossiers à l'aide de barres obliques inverses (par exemple, Projet\\Réunions) | [Tableau 3. Paramètres de méthode MarkAsRead] {#email-connector-methods__table_zhf_kbl_mtb} ## Marquer comme non lu {#email-connector-methods__section_l3t_hcl_mtb} Marque les messages d'un dossier spécifié comme non lus. Pour en savoir plus sur la définition des paramètres, reportez-vous à la section [Configurer les propriétés du port](https://servicenow-prod.fluidtopics.net/6JvHcl7ZXkWp0SovDjJ3XQ "Configurez la façon dont les données sont transmises aux champs d’entrée d’un composant ou d’une méthode dans Studio de conception de bureau de RPA."). {#email-connector-methods__table_phg_mcl_mtb__entry__7} | Paramètre | Description | Type de port | Type de données | Valeur par défaut | Requis ? | Notes | |-|-|-|-|-|-|-| | Objet de messagerie | Objet d'e-mail basé sur l'e-mail correspondant qui est marqué comme non lu. | Données dans | Objet | Objet | Oui | | | Nom du dossier | Nom du dossier IMAP dans lequel l'objet d'e-mail est récupéré. | Données dans | Chaîne | Boîte de réception | Oui | Pour spécifier un dossier IMAP imbriqué, saisissez la hiérarchie des dossiers à l'aide de barres obliques inverses (par exemple, Projet\\Réunions) | [Tableau 4. Paramètres de méthode MarkAsRead] {#email-connector-methods__table_phg_mcl_mtb} ## ReadMail {#email-connector-methods__section_iqz_tfl_mtb} Lit un message et renvoie ses détails, y compris l'objet, le corps, l'expéditeur (de), les destinataires dans le champ CC, les destinataires dans le champ CCI et le nombre de pièces jointes. Pour en savoir plus sur la définition des paramètres, reportez-vous à la section [Configurer les propriétés du port](https://servicenow-prod.fluidtopics.net/6JvHcl7ZXkWp0SovDjJ3XQ "Configurez la façon dont les données sont transmises aux champs d’entrée d’un composant ou d’une méthode dans Studio de conception de bureau de RPA."). {#email-connector-methods__table_uts_bgl_mtb__entry__6} | Paramètre | Description | Type de port de données | Type de données | Valeur par défaut | Requis ? | |-|-|-|-|-|-| | Objet de messagerie | MailObject qui donne les détails du dernier message reçu | Données dans | Objet | Objet | Oui | | Objet | Objet du message | Sortie de données | Chaîne | Néant | Non | | Détails | Corps du message | Sortie de données | Chaîne | Néant | Non | | Expéditeur | Expéditeur du message | Sortie de données | Chaîne | Néant | Non | | Cc | Destinataires marqués en CC | Sortie de données | Chaîne | Néant | Non | | Cci | Destinataires marqués en Cci | Sortie de données | Chaîne | Néant | Non | | Nombre de pièces jointes | Nombre de pièces jointes dans le message | Sortie de données | Entier | Néant | Non | [Tableau 5. Paramètres de méthode ReadMail] {#email-connector-methods__table_uts_bgl_mtb} ## ReplyMail {#email-connector-methods__section_l11_gyy_mtb} Répond automatiquement à un message. Utilisez les paramètres pour définir le corps du message et d'autres détails. Vous pouvez inclure des pièces jointes. Pour en savoir plus sur la définition des paramètres, reportez-vous à la section [Configurer les propriétés du port](https://servicenow-prod.fluidtopics.net/6JvHcl7ZXkWp0SovDjJ3XQ "Configurez la façon dont les données sont transmises aux champs d’entrée d’un composant ou d’une méthode dans Studio de conception de bureau de RPA."). {#email-connector-methods__table_hm3_kmz_mtb__entry__7} | Paramètre | Description | Type de port de données | Type de données | Valeur par défaut | Requis ? | Notes | |-|-|-|-|-|-|-| | Objet de messagerie | Objet de message contenant les détails du message | Données dans | Objet | Objet | Oui | | | Répondre à tous | Réponses à tous les destinataires dans les champs À et CC du message | Données dans | Booléen | Faux | Non | | | Cci | Réponses à tous les destinataires dans le champ CCI du message | Données dans | Chaîne | Néant | Non | | | Détails | Corps du message de réponse | Données dans | Chaîne | Néant | Non | | | IsHtmlBody | Option permettant d'indiquer si le corps de la réponse est au format HTML | Données dans | Booléen | Faux | Non | | | Pièces jointes | Pièces jointes au message de réponse | Données dans | Chaîne | Néant | Non | Pour joindre un fichier : 1. Collez le chemin d'accès au fichier dans le champ. 2. Supprimez les guillemets qui entourent le chemin d'accès. {#email-connector-methods__ol_v5m_j4z_mtb} Pour inclure plusieurs pièces jointes, séparez les chemins d'accès par des virgules. | [Tableau 6. Paramètres de méthode ReplyMail] {#email-connector-methods__table_hm3_kmz_mtb} ## SaveAllAttachments {#email-connector-methods__section_mz4_gyy_mtb} Enregistre toutes les pièces jointes d'un message sur le lecteur local. Pour en savoir plus sur la définition des paramètres, reportez-vous à la section [Configurer les propriétés du port](https://servicenow-prod.fluidtopics.net/6JvHcl7ZXkWp0SovDjJ3XQ "Configurez la façon dont les données sont transmises aux champs d’entrée d’un composant ou d’une méthode dans Studio de conception de bureau de RPA."). {#email-connector-methods__table_vbt_5zy_mtb__entry__6} | Paramètre | Description | Type de port de données | Type de données | Valeur par défaut | Requis ? | |-|-|-|-|-|-| | Objet de messagerie | Message à partir duquel la méthode télécharge les pièces jointes | Données dans | Objet | Objet | Oui | | Chemin d'accès du dossier | Chemin d'accès au répertoire vers lequel les pièces jointes sont téléchargées | Données dans | Chaîne | Néant | Oui | [Tableau 7. Paramètres de méthode SaveAllAttachments] {#email-connector-methods__table_vbt_5zy_mtb} ## Envoyer le courrier {#email-connector-methods__section_r4g_xqz_mtb} Envoie un message. Utilisez les paramètres pour définir le corps du message et d'autres détails. Vous pouvez inclure des pièces jointes. Remarque : Utilisez la méthode SetConfig pour définir l'adresse De. Pour en savoir plus sur la définition des paramètres, reportez-vous à la section [Configurer les propriétés du port](https://servicenow-prod.fluidtopics.net/6JvHcl7ZXkWp0SovDjJ3XQ "Configurez la façon dont les données sont transmises aux champs d’entrée d’un composant ou d’une méthode dans Studio de conception de bureau de RPA."). {#email-connector-methods__table_qvr_frz_mtb__entry__7} | Paramètre | Description | Type de port de données | Type de données | Valeur par défaut | Requis ? | Notes | |-|-|-|-|-|-|-| | Adresse d'arrivée | Adresse à laquelle envoyer le message | Données dans | Chaîne | Néant | Oui | | | Cc | Adresses à inclure dans le champ CC | Données dans | Chaîne | Néant | Non | | | Cci | Adresses à inclure dans le champ CCI | Données dans | Chaîne | Néant | Non | | | Objet | Objet du message | Données dans | Chaîne | Néant | Non | | | Détails | Corps du message | Données dans | Chaîne | Néant | Non | | | IsHtmlBody | Option permettant d'indiquer si le corps de la réponse est au format HTML | Données dans | Chaîne | Faux | Non | | | Pièces jointes | Pièces jointes de message | Données dans | Chaîne | Néant | Non | Pour joindre un fichier : 1. Collez le chemin d'accès au fichier dans le champ. 2. Supprimez les guillemets qui entourent le chemin d'accès. {#email-connector-methods__ol_jsq_kb4_lzb} Pour inclure plusieurs pièces jointes, séparez les chemins d'accès par des virgules. | [Tableau 8. Paramètres de méthode SendMail] {#email-connector-methods__table_qvr_frz_mtb}