Get IMAP Email List

UiPath.Mail.IMAP.Activities.GetIMAPMailMessages

描述

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

Note: This activity is called Get IMAP Mail Messages in versions older than 1.24.

项目兼容性

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、跨平台配置

• Connection - The connection established in Integration Service for the Mail connector.
• Email folder - The mail folder from which the messages are to be retrieved.
• Additional filters - Returns only those mail messages matching the filter expression.

常见

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

选项

• Limit emails to first - The number of messages to be retrieved, starting from the top of the list. This field spports Int32 type input.
• Unread only - Specifies whether to retrieve only unread messages. Default value: True.
• Mark as read - Specifies whether to mark retrieved messages as read.
• Delete messages - Specifies if the read messages should be marked for delete.
• Order by date - Order mail messages by date. Choose one of two options: Newest First, OldestFirst. The default value is Newest First.

• FilterExpressionCharacterSet - The MIME name of the character set to be used for the filter expression. The list of valid MIME names that can be used is available at Character Sets.

输出

• Email list - The retrieved messages as a collection of UiPathMailMessage objects.

筛选示例

下表为查询 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"

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