获取 IMAP 邮件列表

UiPath.Mail.IMAP.Activities.GetIMAPMailMessages

描述

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

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

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows - 旧版配置

常见

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

主机

• “邮件文件夹”- 将从中检索邮件消息的邮件文件夹。
• “服务器”- 要使用的电子邮件服务器主机。
• “端口”- 用于接收电子邮件消息的端口。
  注意： 仅当没有 SSL 连接或没有为 IP 地址颁发的 SSL 证书时，才可以在“ 服务器 ” 字段中使用 IP 地址代替 DNS 名称。

登录

• “客户端名称”- IMAP 客户端实现的“名称”属性。
• 客户端版本- IMAP 客户端实现的版本属性。
• “电子邮件”- 用于接收邮件消息的电子邮件帐户。
• “密码”- 用于接收邮件消息的电子邮件帐户密码。如果选中“使用 OAuth”，则此参数的值必须是 OAuth2 访问令牌。
• “安全密码”- 所用电子邮件帐户的密码，以安全字符串形式显示。 如果选中“使用OAuth ”，则此参数的值必须是 OAuth2 访问令牌。
• “使用 OAuth ”- 指示是否使用 OAuth2 访问令牌而不是密码。 默认情况下，未选择此选项。

其他

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

选项

• 删除消息 - 指定是否应将已读邮件消息标记为删除。
• “筛选表达式 ” - 仅返回与筛选表达式匹配的邮件消息。

• “筛选 表达式字符集” - 要用于筛选表达式的字符集的 MIME 名称。

  注意： 可以使用的有效 MIME 名称列表可在 字符集中找到。
• 忽略 CRL - 指定在连接时是否忽略证书吊销列表验证。 此字段仅接受 Boolean 值和变量。 如果留空，则使用默认的 False 值。
• “标记为已读”- 指定是否将检索到的消息标记为已读。默认情况下，该复选框处于未选中状态。
• “仅限未读消息” - 指定是否仅检索未读消息。默认情况下，该复选框处于选中状态。
• OrderByDate - 按日期对邮件消息进行排序。 从以下两个选项中选择一个：“ 最新优先”、“ 最旧优先”。 默认值为“ 最新优先”。
• “安全连接”- 指定用于连接的 SSL 和/或 TLS 加密。
• 排名最前 - 待检索的消息数量 (根据按日期排序参数，从最新或最旧消息开始计算)。

输出

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

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"""
主题中包含“Welcome”且来自“[e-mail]”的所有邮件	"SUBJECT ""Welcome"" FROM [e-mail]"
主题中包含”欢迎”且并非来自 “[e-mail]” 的所有邮件	"SUBJECT ""Welcome"" NOT FROM [e-mail]"
正文中包含“请审核”的所有邮件	"BODY ""Please review"""
所有已标记的邮件消息（即 \)\)已标记的标志集）	"FLAGGED"
自 2021 年 2 月 23 日以来的所有邮件消息	"SINCE 23-Feb-2021"
2021 年 2 月 23 日或 2021 年 1 月 23 日收到的所有未送达报告邮件	"OR (ON 23-Feb-2021 FROM [e-mail]) (ON 23-Jan-2021 FROM [e-mail])"
今天所有未回复的邮件，来自包含“examples.com”的电子邮件地址	"UNANSWERED ON " + DateTime.Today.ToString("dd-MMM-yyyy") + " FROM examples.com"

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