Méthodes du connecteur de messagerie

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 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.

    Configuration d’ensemble

    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.

    Tableau 1. Paramètres de la méthode SetConfig
    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

    GetMails

    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.

    Tableau 2. Paramètres de méthode GetMails
    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

    MarkAsRead

    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.

    Tableau 3. Paramètres de méthode MarkAsRead
    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)

    Marquer comme non lu

    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.

    Tableau 4. Paramètres de méthode MarkAsRead
    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)

    ReadMail

    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.

    Tableau 5. Paramètres de méthode ReadMail
    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

    ReplyMail

    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.

    Tableau 6. Paramètres de méthode ReplyMail
    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.

    Pour inclure plusieurs pièces jointes, séparez les chemins d’accès par des virgules.

    SaveAllAttachments

    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.

    Tableau 7. Paramètres de méthode SaveAllAttachments
    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

    Envoyer le courrier

    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.

    Tableau 8. Paramètres de méthode SendMail
    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.

    Pour inclure plusieurs pièces jointes, séparez les chemins d’accès par des virgules.