Imap收取邮件

描述：通过IMAP协议，收取邮件

注意

• 邮箱需要开启“IMAP服务”

• 收取邮件的顺序是从收件箱由上往下，即从接收时间最近的邮件开始

• 注意IMAP协议收取邮件与POP3协议收取邮件的区别，POP3协议下的相关操作不会反馈到邮件服务器上，而IMAP协议下客户端与服务器是双向通信的，即IMAP协议下的相关操作不仅反馈到客户端，服务器端也同步更新

IMAP收取邮件

属性说明

通用属性

• 前置延时- 指可设置组件功能执行之前等待的时间，单位为“毫秒”
• 后置延时- 指可设置组件功能执行后等待的时间，单位为“毫秒”
• 备注- 指对组件进行备注说明，以便于理解和快速定位

目标属性

• 服务器- 收取电子邮件的邮箱所对应的IMAP服务器地址，输入格式为字符串；默认为空
• 端口- IMAP服务器所对应的服务端口号，输入格式为int整型
• 账号姓名- 输入收取邮件的邮件地址，输入格式为字符串；默认为空
• 密码- 输入邮箱的密码，密码将以加密的暗文方式显示；默认为空，如为空，则运行时会抛出异常
• SSL- 选择IMAP服务是否使用ssl协议加密，可选项包括：True，False；“True”选项指使用ssl协议加密，“False”选项指不使用ssl协议加密，是否使用ssl协议加密，会影响到IMAP服务的端口号；默认为“False”
• 收件箱名称- 输入需要收取的邮件所在的收件箱名称，一般邮箱默认收件箱为”Inbox“；默认为”Inbox“
• 附件保存路径- 邮件中附件保存的目录，输入格式为字符串， 也可点击文件夹图标进行目录的浏览选择；默认为空
• 发送邮箱过滤- 根据文本内容筛选邮件发件人地址，输入格式为字符串，只有发件人邮箱地址中包含该字符串的邮件才被收取；默认为空
• 主题过滤- 根据文本内容筛选邮件主题，输入格式为字符串，只有邮件主题中包含该字符串的邮件才被收取；默认为空
• 内容过滤- 根据文本内容筛选邮件正文内容，输入格式为字符串，只有邮件正文中包含该字符串的邮件才被收取；默认为空
• 附件过滤- 根据文本内容筛选邮件附件，输入格式为字符串，只有邮件附件名称中包含该字符串的邮件才被收取；默认为空
• 收取未读状态- 可选项包括：True，False；“True”选项指仅收取未读邮件，“False”选项指收取所有邮件；默认为“True”
• 变为已读状态- 可选项包括：True，False；“True”选项指把收取的邮件状态变为已读，“False”选项指不改变邮件的状态；默认为“True”
• 删除消息- 可选项包括：True，False；“True”选项指把收取的邮件从邮箱中删除，“False”选项指不删除邮件；默认为“False”
• 起始时间- 如果需要限定收取邮件的时间范围，输入限定范围的起始时间；默认为空
• 截止时间- 如果需要限定收取邮件的时间范围，输入限定范围的截止时间；默认为空
• 选择数目- 输入收取邮件的个数限制，输入类型为int整型；如果设置了邮件过滤条件，也只从此限制范围内进行过滤筛选；默认为5，即只收取最新的5封邮件

返回值

• 返回值- 返回以邮件对象为元素的列表；邮件对象包括邮件的发送人（sender）、发送时间（received_time）、邮件主题（subject）、内容（body）以及附件（attachments：附件保存在本地的路径组成的列表）等属性

使用示例

执行逻辑

添加【Imap收取邮件】组件，“服务器”属性填写：“imap.mxhichina.com”，“端口”属性填写：993，“账号姓名”属性填写邮件地址：'send_mail_1@i-search.com.cn'，“密码”属性填写邮箱密码，“ssl”属性选择：“True”,“附件保存路径”属性填写目录：'C:/iS-RPA'，其它属性保持默认

image-20241028144542034

使用【For循环】组件，把“Imap收取邮件”组件的输出与“For循环”组件的“集合”属性相连，即循环“Imap收取邮件”组件输出邮件列表中的每个邮件对象元素；然后连接两个组件--->添加【输出】组件，“输出”属性填写：“i.body”，即输出邮件对象的”body“属性，也即邮件正文内容；然后与【For循环】组件的”循环过程“相连接--->运行此流程

image-20241211150628000

输出结果

运行流程后，将从指定邮箱'send_mail_1@i-search.com.cn'收取最新的5封未读邮件，并依次输出5封邮件的正文内容

image-20241028144746889