Méthodes de connecteur de messagerie

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 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. Cette méthode doit précéder toutes les autres méthodes du 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 d’e-mail.

    Pour plus d’informations sur la définition des paramètres, reportez-vous à la section Configurer les propriétés des ports.

    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 Obligatoire? 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 Envoie les informations d’identification par défaut de l’utilisateur actuellement connecté au serveur SMTP. Données dans Booléen Faux Non
    Serveur de messagerie Smtp Nom du serveur SMTP Données dans Chaîne smtp.gmail.com Non L’accès à Gmail à l’aide du connecteur d’e-mail n’est actuellement pas pris en charge. Assurez-vous de changer la valeur par défaut.
    Serveur ImapMailServer Nom du serveur IMAP Données dans Chaîne imap.gmail.com Non L’accès à Gmail à l’aide du connecteur d’e-mail 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 en vue d’une utilisation par d’autres méthodes. Vous pouvez définir la méthode pour récupérer les messages lus (visibles) ou non lus (non vus) et spécifier le dossier dans lequel ils sont collectés.

    Pour plus d’informations sur la définition des paramètres, reportez-vous à la section Configurer les propriétés des ports.

    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 Obligatoire? Notes
    Nom de 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 les messages non lus (non vus) ou lus (vus) Données dans Mode de filtre Invisible Oui
    Retour Renvoie la collection d’e-mails en tant qu’objet Sortie de données Objet Objet Oui

    Marquer comme lu

    Marque les messages d’un dossier spécifié comme lus.

    Pour plus d’informations sur la définition des paramètres, reportez-vous à la section Configurer les propriétés des ports.

    Tableau 3. Paramètres de la méthode MarkAsRead
    Paramètre Description Type de port Type de données Valeur par défaut Obligatoire? Notes
    Objet de boîte de réception Objet d’e-mail sur lequel le message correspondant est marqué comme lu Données dans Objet Objet Oui
    Nom de 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 plus d’informations sur la définition des paramètres, reportez-vous à la section Configurer les propriétés des ports.

    Tableau 4. Paramètres de la méthode MarkAsRead
    Paramètre Description Type de port Type de données Valeur par défaut Obligatoire? Notes
    Objet de boîte de réception Objet d’e-mail basé sur l’e-mail correspondant qui est marqué comme non lu. Données dans Objet Objet Oui
    Nom de 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 plus d’informations sur la définition des paramètres, reportez-vous à la section Configurer les propriétés des ports.

    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 Obligatoire?
    Objet de boîte de réception 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

    Courrier de réponse

    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 plus d’informations sur la définition des paramètres, reportez-vous à la section Configurer les propriétés des ports.

    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 Obligatoire? Notes
    Objet de boîte de réception 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 entourant le chemin.

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

    Enregistrer toutes les pièces jointes

    Enregistre toutes les pièces jointes d’un message sur le lecteur local.

    Pour plus d’informations sur la définition des paramètres, reportez-vous à la section Configurer les propriétés des ports.

    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 Obligatoire?
    Objet de boîte de réception 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 un e-mail

    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 plus d’informations sur la définition des paramètres, reportez-vous à la section Configurer les propriétés des ports.

    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 Obligatoire? Notes
    Adresse cible 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 entourant le chemin.

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