获取 IMAP 邮件列表

UiPath.Mail.IMAP.Activities.GetIMAPMailMessages

描述

从指定服务器检索 IMAP 电子邮件消息。

备注：

在 1.24 之前的版本中，此活动称为“获取 IMAP 邮件消息” 。

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows - 旧版配置

常见

• “显示名称”- 活动的显示名称。
• “超时(毫秒)”- 指定最长等待时间（以毫秒为单位），如果超出该时间后活动并未运行，系统便会抛出错误。默认值为 30000 毫秒（30 秒）。

主机

• “邮件文件夹”- 将从中检索邮件消息的邮件文件夹。
• “服务器”- 要使用的电子邮件服务器主机。
• “端口”- 用于接收电子邮件消息的端口。
  备注：

  Using an IP address in the Server field instead of a DNS name only works when there are no SSL connections or if there is an SSL certificate issued for the IP address.

登录

• “客户端名称” - IMAP 客户端实现的“名称”属性。
• 客户端版本- IMAP 客户端实现的版本属性。
• “电子邮件”- 用于接收邮件消息的电子邮件帐户。
• Password - The password of the email account used to get the message. If UseOAuth is selected, the value of this parameter must be an OAuth2 access token.
• “安全密码” - 所用电子邮件帐户的密码，以安全字符串形式显示。如果选中“使用 OAuth” ，则此参数的值必须是 OAuth2 访问令牌。
• 使用 OAuth - 指示是否使用 OAuth2 访问令牌而不是密码。默认情况下，未选择此选项。

其他

• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。

选项

• “删除消息”- 指定是否应将已读邮件消息标记为删除。
• FilterExpression - Returns only those mail messages matching the filter expression.
• FilterExpressionCharacterSet - The MIME name of the character set to be used for the filter expression.
  备注：

  字符集提供了可用的有效 MIME 名称列表。

• Ignore CRL - Specifies whether to ignore the Certificate Revocation List validation when connecting. This field only accepts Boolean values and variables. If left empty, the default False value is used.
• “标记为已读”- 指定是否将已检索的邮件消息标记为已读。默认情况下，清除该复选框。
• “仅未读消息”- 指定是否只检索未读邮件消息。系统会默认选中该复选框。
• OrderByDate - Order mail messages by date. Choose one of two options: Newest First, OldestFirst. The default value is Newest First.
• “安全连接”- 指定用于连接的 SSL 和/或 TLS 加密。
• Top - The number of messages to be retrieved, starting from either the newest or the oldest, depending on the OrderByDate parameter.

输出

• “消息”- 作为“邮件消息”对象集合的已检索邮件消息。

Windows、跨平台配置

• 连接 - 在 Integration Service 中为邮件连接器建立的连接。
• 电子邮件文件夹 - 将从中检索邮件消息的邮件文件夹。
• 其他筛选器 - 仅返回与筛选器表达式匹配的邮件消息。

常见

• “超时(毫秒)”- 指定最长等待时间（以毫秒为单位），如果超出该时间后活动并未运行，系统便会抛出错误。默认值为 30000 毫秒（30 秒）。

连接详情

• 使用 Integration Service - 是否使用 Integration Service 连接。默认值为“True”。设置为 False 时，将显示服务器连接字段。
• “服务器” - 要使用的电子邮件服务器主机。此字段支持String类型的输入。
• “端口” - 用于接收电子邮件消息的端口。此字段支持Int32类型的输入。
• 使用 OAuth - 指示是否使用 OAuth2 访问令牌而不是密码。默认情况下，未选择此选项。
• “电子邮件” - 用于接收邮件消息的电子邮件帐户。此字段支持String类型的输入。
• “密码” - 用于接收邮件消息的电子邮件帐户密码。如果已启用“使用 OAuth”，则此参数的值必须是 OAuth2 访问令牌。此字段支持String类型的输入。
• 安全密码- 所用电子邮件帐户的密码，以安全字符串形式显示。如果选中“使用 OAuth”，则此参数的值必须是 OAuth2 访问令牌。
• 忽略 CRL - 指示连接时是否忽略证书吊销列表验证。布尔值。默认值为 False。
• “安全连接” - 指定用于连接的 SSL 和/或 TSL 加密。
• “客户端名称” - 为 IMAP 客户端实现的“名称” 属性指定值。
• 客户端版本- 指定 IMAP 客户端实现的“版本”属性的值。

选项

• 从首个开始的电子邮件限制- 要检索的邮件数量，从列表顶部开始计算。此字段支持Int32类型输入。
• 仅限未读 - 指定是否仅检索未读消息。默认值：True。
• 标记为已读 - 指定是否将检索到的邮件标记为已读。
• 删除消息 - 指定是否应将已读邮件消息标记为删除。
• 按日期排序 - 按日期对邮件消息进行排序。选择以下两个选项之一：由新到旧、由旧到新。默认值为由新到旧。
• 筛选器表达式字符集- 要用于筛选器表达式的字符集的 MIME 名称。字符集提供了可用的有效 MIME 名称列表。

输出

• “电子邮件列表” - 作为UiPathMailMessage对象集合的已检索邮件。

筛选示例

下表为查询 IMAP 邮件消息时可能有用的筛选器示例：

查询	筛选器表达式
主题中包含“欢迎光临”的所有邮件消息	"SUBJECT ""Welcome"""
主题中包含“欢迎”且来自“ [e-mail] ”的所有邮件消息	"主题 ""欢迎"" 来自[e-mail] "
主题中包含“欢迎”且并非来自“ [e-mail] ”的所有邮件	"主题 ""欢迎"" 并非来自[e-mail] "
正文中包含“请审核”的所有邮件	"BODY ""Please review"""
所有带标志的邮件消息（即））已标记的标志设置）	"FLAGGED"
自 2021 年 2 月 23 日以来的所有邮件消息	"SINCE 23-Feb-2021"
2021 年 2 月 23 日或 2021 年 1 月 23 日收到的所有未送达报告邮件	OR（在 2021 年 2 月 23 日发件人[e-mail] ）（2021 年 1 月 23 日发件人： [e-mail] ）”
今天所有未回复的邮件，来自包含“examples.com”的电子邮件地址	"UNANSWERED ON " + DateTime.Today.ToString("dd-MMM-yyyy") + " FROM examples.com"

备注：

在此处了解有关如何指定筛选器表达式的更多信息。