Méthodes du connecteur d’e-mail

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 7 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 du connecteur de messagerie dans l’automatisation.

    La méthode GetMails récupère les messages du serveur de messagerie et les transmet à d’autres méthodes en tant qu’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 qui contient plusieurs messages, l’automatisation doit utiliser une méthode For Each ou For Loop pour itérer chaque message de la collection.

    Définir la configuration

    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 en savoir plus sur le mode de 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 Obligatoire? Notes
    Nom d\’utilisateur Nom d’utilisateur pour se connecter au serveur de messagerie Données entrantes Chaîne (aucun) Oui
    Mot de passe Mot de passe pour se connecter au serveur de messagerie Données entrantes Chaîne (aucun) Oui
    UseDefaultCredentials Envoie les informations d’identification par défaut de l’utilisateur actuellement connecté au serveur SMTP. Données entrantes Booléen Faux Non
    Serveur SmtpMail Nom du serveur SMTP Données entrantes 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 modifier la valeur par défaut.
    ImapMailServer Nom du serveur IMAP Données entrantes 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 modifier la valeur par défaut.
    SSL Utiliser le protocole Secure Socket Layer Données entrantes Booléen Vrai Non
    Port SmtpPort Numéro de port SMTP Données entrantes Entier 587 Non
    Port ImapPort Numéro de port IMAP Données entrantes Entier 993 Non

    GetMails (Obtenir des e-mails)

    Renvoie les messages du serveur de messagerie pour une 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 à partir duquel ils sont collectés.

    Pour en savoir plus sur le mode de définition des paramètres, reportez-vous à la section Configurer les propriétés du port.

    Tableau 2. Paramètres de la méthode GetMails
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire? Notes
    Foldername Nom du dossier IMAP à partir duquel 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é, entrez 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 de courrier en tant qu’objet Données sortantes Objet Objet Oui

    MarkAsRead

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

    Pour en savoir plus sur le mode de définition des paramètres, reportez-vous à la section Configurer les propriétés du port.

    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 courrier Objet d’e-mail à partir duquel le message correspondant est marqué comme lu Données dans Objet Objet Oui
    Foldername Nom du dossier IMAP à partir duquel 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é, entrez 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 le mode de définition des paramètres, reportez-vous à la section Configurer les propriétés du port.

    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 courrier Objet d’e-mail à partir duquel l’e-mail correspondant est marqué comme non lu. Données dans Objet Objet Oui
    Foldername Nom du dossier IMAP à partir duquel 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é, entrez la hiérarchie des dossiers à l’aide de barres obliques inverses (par exemple, Projet\Réunions)

    ReadMail (Courrier électronique)

    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 le mode de définition des paramètres, reportez-vous à la section Configurer les propriétés du port.

    Tableau 5. Paramètres de la méthode ReadMail
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire? Notes
    Objet courrier MailObject qui donne les détails du dernier message reçu Données dans Objet Objet Oui
    Objet Objet du message Données sortantes Chaîne Aucun Non
    Détails Corps du message Données sortantes Chaîne Aucun Non
    Expéditeur Expéditeur du message Données sortantes Chaîne Aucun Non
    CC Destinataires marqués en CC Données sortantes Chaîne Aucun Non
    BCC Destinataires marqués en Cci Données sortantes Chaîne Aucun Non
    Nombre de pièces jointes Nombre de pièces jointes dans le message Données sortantes Entier Aucun 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 en savoir plus sur le mode de définition des paramètres, reportez-vous à la section Configurer les propriétés du port.

    Tableau 6. Paramètres de la méthode ReplyMail
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire? Notes
    Objet courrier Objet de message contenant les détails du message Données dans Objet Objet Oui
    Répondre à tous Répond à tous les destinataires dans les champs À et Cc du message Données dans Booléen Faux Non
    BCC Répond à tous les destinataires dans le champ Cci du message Données dans Chaîne Aucun Non
    Détails Corps du message de réponse Données dans Chaîne Aucun Non
    IsHtmlBody (en anglais seulement) Option pour 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 Aucun 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.

    Enregistrer toutes les pièces jointes

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

    Pour en savoir plus sur le mode de définition des paramètres, reportez-vous à la section Configurer les propriétés du port.

    Tableau 7. Paramètres de la méthode SaveAllAttachments
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire? Notes
    Objet courrier Message à partir duquel la méthode télécharge les pièces jointes Données entrantes Objet Objet Oui
    Chemin d’accès du dossier Chemin d’accès du répertoire dans lequel les pièces jointes sont téléchargées Données entrantes Chaîne Aucun Oui

    Sendmail

    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 le mode de définition des paramètres, reportez-vous à la section Configurer les propriétés du port.

    Tableau 8. Paramètres de la méthode SendMail
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire? Notes
    Adresse de destination Adresse à laquelle envoyer le message Données dans Chaîne Aucun Oui
    CC Adresses à inclure dans le champ CC Données dans Chaîne Aucun Non
    BCC Adresses à inclure dans le champ Cci Données dans Chaîne Aucun Non
    Objet Objet du message Données dans Chaîne Aucun Non
    Détails Corps du message Données dans Chaîne Aucun Non
    IsHtmlBody (en anglais seulement) Option pour 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 Aucun 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.