Méthodes de connecteur d’e-mail

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 7 minutes de lecture

    • Les méthodes du connecteur de messagerie récupèrent, envoient et répondent aux messages électroniques, 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 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 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 qui contient plusieurs messages, l’automatisation doit utiliser une méthode For Each ou For Loop pour itérer chaque message de la collection.

    Configuration définie

    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 le mode de 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 SmtpMail 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 modifier 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 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 dans Booléen Vrai Non
    Port SmtpPort Numéro de port SMTP Données dans Entier 587 Non
    Port d’ImapPort Numéro de port IMAP Données dans Entier 993 Non

    GetMails (en anglais seulement)

    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 rassemblés.

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

    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
    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é, entrez la hiérarchie des dossiers à l’aide de barres obliques inversées (par exemple, Projet\Réunions)
    Filtre Définir pour obtenir uniquement les messages non lus (non vus) ou lus (vus) Données dans FilterMode (en anglais seulement) Invisible Oui
    Retour Renvoie la collection de courrier 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 le mode de 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 courrier Objet d’e-mail à partir duquel le message correspondant est marqué comme lu Données dans Objet Objet Oui
    Nom du dossier Nom du dossier IMAP que l’objet d’e-mail 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 inversées (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 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 courrier L’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 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 inversées (par exemple, Projet\Réunions)

    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 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 courrier 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 Aucun Non
    Corps Corps du message Sortie de données Chaîne Aucun Non
    Expéditeur Expéditeur du message Sortie de données Chaîne Aucun Non
    CC Destinataires marqués en CC Sortie de données Chaîne Aucun Non
    BCC Destinataires marqués en Cci Sortie de données Chaîne Aucun Non
    Nombre de pièces jointes Nombre de pièces jointes dans le message Sortie de données 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 des ports.

    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 de 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
    Corps Corps du message de réponse Données dans Chaîne Aucun Non
    IsHtmlBody (en anglais seulement) 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 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.

    SaveAllAttachments (en anglais seulement)

    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 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 courrier 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 dans lequel les pièces jointes sont téléchargées Données dans Chaîne Aucun 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 en savoir plus sur le mode de définition des paramètres, reportez-vous à la section Configurer les propriétés des ports.

    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
    Corps Corps du message Données dans Chaîne Aucun Non
    IsHtmlBody (en anglais seulement) 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 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.