获取 Exchange 邮件消息

UiPath.Mail.Exchange.Activities.GetExchangeMailMessages

从 Exchange 检索电子邮件消息。

属性

常见

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

Exchange 设置

• 邮件自动发现 - 使用 Exchange 服务器中的电子邮件地址自动搜索该服务器。仅当 Exchange 服务器启用了自动发现时，此方法才有效。
• “Exchange 版本”- 指定所使用的 Exchange 服务器的最低版本。此字段中显示的选项范围为 2007 至 2013 版本。请注意，版本号表示您支持的服务的最低级别。这意味着，如果您有 2016 Exchange 服务器，则可以选择“Exchange2013”选项。
• “服务器”- 要使用的电子邮件服务器主机。

登录

• “域”- 要连接的 Active Directory 域。
• “密码”- 用于检索邮件消息的 Exchange 帐户密码。
• “安全密码”- 所用 Exchange 帐户的密码，以安全字符串形式显示。
• “用户”- 用于检索邮件消息的 Exchange 帐户用户名。

其他

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

Office 365 设置

• 应用程序 ID - Azure Active Directory 应用程序的 ID。此字段仅支持字符串和 String 变量。
• 身份验证类型 - Office 365 的身份验证选项。可用选项包括：

  • “用户名和密码”- 标准用户名和密码登录。

    重要提示： 选择“ 用户名 和密码”身份验证时，“ 应用程序 ID”属性为必填项。这可确保使用 ROPC 身份验证而不是Exchange Online 中已弃用的基本身份验证。
  • “交互式”- 交互式令牌 (Auth 2.0)。
  • “Windows 集成”- 集成的 Windows 身份验证。
• 目录 ID - Azure Active Directory 的 ID。此字段仅支持字符串和 String 变量。

选项

• “按邮件 ID 筛选”- 仅返回具有指定邮件 ID 的邮件。如果进行此设置，系统将忽略“筛选器表达式”参数。此字段仅支持 String[] 变量。
  注意： 从 Exchange Server 2013开始，支持按邮件 ID 筛选。
• “筛选表达式 ” - 仅返回与筛选表达式匹配的邮件消息。
  注意： 从 Exchange Server 2010开始，可以使用筛选表达式。
• “获取附件”- 指定是否检索电子邮件消息中的附件。默认情况下，该复选框处于未选中状态。
  注意： 对于 Exchange Server 2007 SP1，该活动将返回所有附件，包括内联附件。 这是 Exchange API 的限制。
• “正文是 HTML”- 指定是否以 HTML 格式编写邮件消息正文。
• “标记为已读”- 指定是否将检索到的消息标记为已读。默认情况下，该复选框处于未选中状态。
• “仅限未读消息” - 指定是否仅检索未读消息。默认情况下，该复选框处于选中状态。
• OrderByDate - 按日期对邮件消息进行排序。 从以下两个选项中选择一个：“ 新旧优先” 、“ 最旧优先” 。 默认值为“ 最新优先”。
• “排名最前”- 待检索的消息数量 (根据“按日期排序”参数，从最新或最旧消息开始计算)。

输出

• “消息”- 作为“邮件消息”对象集合的已检索邮件消息。
  注意： 从 UiPath.Mail.Activities 版本 1.10.4 开始， MailMessage 对象公开：

  • 邮件消息的消息 ID，例如 MailMessage.Headers("Message-ID")。
  • 与邮件消息关联的类别，例如 MailMessage.GetCategories()。

目标

• “邮件文件夹”- 将从中检索邮件消息的邮件文件夹。
  重要提示：

  • 要从公用文件夹中检索电子邮件，“邮件文件夹” 字段 的值应与“收藏夹”中显示的公用文件夹的名称完全相同。
  • 使用公用文件夹时，如果邮箱中存在同名的个人文件夹，则活动将返回个人文件夹中的电子邮件。 为了返回公用文件夹中的电子邮件，必须重命名个人文件夹。
  • 该活动不支持“发布”项目。 如果公用文件夹中有“帖子”项目，则除非您指定正确的筛选表达式，否则该活动将失败，例如“ FilterExpression = “kind:emails”。
• “共享邮箱”- 用于检索与 Exchange 用户帐户关联的共享邮箱中的邮件消息。

筛选示例

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

查询	筛选器表达式
主题中包含“欢迎”的所有邮件消息	"subject:welcome"
主题中包含“welcome”且来自“[e-mail]”的所有邮件	"subject:welcome AND from:""[e-mail]"""
来自 example.com 的电子邮件帐户的所有邮件消息	"from:example.com"
正文中包含“请审核”的所有邮件	"body:please review"
所有带附件的邮件	"hasattachment:true"
附加 pdf 文件的所有具有高重要性的邮件	"importance:high AND attachment:.pdf"
类别为“红色类别”和“蓝色类别”的所有邮件	"category:Red category, Blue category"
会议类型的所有邮件消息（例如 日历邀请、回复）	"kind:meetings"
今天收到的所有邮件消息	"received:today"
2020 年 10 月 23 日收到的所有邮件消息	"received:10/23/2020"
自 2020 年 10 月 23 日以来收到的所有邮件消息	"received: >=10/23/2020"

注意：要了解如何指定筛选器表达式，请阅读在 Exchange 中使用 EWS 执行 AQS 搜索。