获取 Outlook 邮件消息

UiPath.Mail.Outlook.Activities.GetOutlookMailMessages

从 Outlook 检索电子邮件消息。

属性

输入

• “邮件文件夹”- 将从中检索邮件消息的邮件文件夹。
• 帐户 - 用于访问待检索邮件消息的帐户。

选项

• 筛选器 - 用作待检索邮件消息的筛选器的字符串。接受 JET 查询或 DASL 查询。
• 按邮件 ID筛选 - 仅返回与指定邮件 ID 匹配的邮件。 您可以从 MailMessage 对象中检索消息 ID，例如 MailMessage.Headers("Message-ID")。 如果设置，则忽略“ 筛选 ”选项。
• “标记为已读”- 指定是否将检索到的消息标记为已读。默认情况下，该复选框处于未选中状态。
• “仅限未读消息” - 指定是否仅检索未读消息。默认情况下，该复选框处于选中状态。
• “OrderByDate” - 按日期对邮件消息进行排序。 可用选项为 “最新优先” 和 “最旧优先”。

• 排名最前 - 待检索的消息数量 (根据按日期排序参数，从最新或最旧消息开始计算)。

  重要：如果该字段为空，则活动不会返回任何邮件消息。

常见

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

输出

• 邮件消息 - 作为 MailMessage 对象集合的已检索邮件消息。
  备注：

  从 UiPath.Mail.Activities 版本 1.10.4 开始， MailMessage 对象公开：

  • 邮件消息的消息 ID，例如 MailMessage.Headers("Message-ID")。
  • 与邮件消息关联的类别，例如 MailMessage.GetCategories()。
  • 要跟踪电子邮件中的内联附件数量，您需要访问第一个 备用视图 ，然后从该视图获取所有 链接资源 的计数。 例如 item.AlternateViews(0).LinkedResources.Count。

其他

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

筛选示例

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

查询	筛选器表达式
主题为“产品路线图”的所有邮件	"[Subject] = 'Product Roadmap'"
主题为“将我不能为我能”的所有邮件	“[Subject] = 'Turn I can't to I can'”（添加单引号作为转义字符）
主题为“职位申请：‘业务分析师’职位”的所有邮件消息	"[Subject] = 'Job application: ""Business Analyst"" position'"（添加双引号作为转义字符）
主题中包含“业务分析师”字符串的所有邮件消息	"@SQL=""urn:schemas:httpmail:subject"" like '%business analyst%'"
主题以“job”开头的所有邮件消息	"@SQL=""urn:schemas:httpmail:subject"" like 'job%'"
来自“Anthony Young”的所有邮件消息	"[SenderName] = 'Anthony Young'" "[From] = 'Anthony Young'"
来自“[e-mail]”的所有邮件	"[SenderEmailAddress] = '[e-mail]'"
正文中包含“UiPath IT Automation”字符串的所有邮件消息	"@SQL=""urn:schemas:httpmail:textdescription"" like '%UiPath IT Automation%'"
正文以“UiPath.Mail.Activities”字符串开头的所有邮件消息	"@SQL=""urn:schemas:httpmail:textdescription"" like 'UiPath.Mail.Activities%'"
标记有“审核”的所有邮件	"[FlagRequest] = 'Review'"
标记有“跟进”或“审核”的所有邮件	"[FlagRequest] = 'Follow up' OR [FlagRequest] = 'Review'"
截止日期为本周的所有邮件	"[Due date] = 'This week'"
截止日期为明天的所有邮件	"[Due date] = 'Tomorrow'"
截止日期为 2021 年 1 月 21 日的所有邮件	"[Due Date] = '01/21/2021'"
所有具有高重要性的邮件	"[Importance] = High"
所有机密邮件	"[Sensitivity] = Confidential"
类别为“红色类别”和“蓝色类别”的所有邮件	"[Categories] = 'Red category' AND [Categories] = 'Blue category'" "[Categories] = 'Red category, Blue category'"
今天收到的所有邮件消息	"[Received] >= '" + DateTime.Today.ToString("d") + " 00:00AM'" "[ReceivedTime] >= '" + DateTime.Today.ToString("d") + " 00:00AM'"
昨天收到的所有邮件消息	"[Received] >= '" + DateTime.Today.AddDays(-1).ToString("d") + " 00:00AM' AND [Received] < '"+ DateTime.Today.ToString("d") + " 00:00AM'"
自昨天 22:00 以来收到的所有邮件消息	"[ReceivedTime] >= '" + DateTime.Now.AddDays(-1).ToString("d") +" 22:00'"
过去一小时内收到的所有邮件消息	"[ReceivedTime] >= '" + DateTime.Now.AddHours(-1).ToString("MM/dd/yyyy HH:mm tt") + "'"
自前 15 分钟内收到的所有邮件消息	"[ReceivedTime] >= '" + DateTime.Now.AddMinutes(-15).ToString("MM/dd/yyyy HH:mm tt") + "'"
过去 15 分钟内发送的所有邮件（邮件文件夹应设置为“已发送邮件”）	"[SentOn] >= '" + DateTime.Now.AddMinutes(-15).ToString("MM/dd/yyyy HH:mm tt") + "'"

有关更多信息，请查看以下页面：

• Outlook 对象模型：Items.Find 方法
• 搜索 Outlook 数据概述
• 自定义日期和时间格式字符串