获取邮件

UiPath.MicrosoftOffice365.Activities.Mail.GetMail

描述

使用 Microsoft Graph 的 “获取消息 ” API 和 “列出消息 API”，从指定邮箱 (邮箱) 检索匹配的消息。

执行搜索后，该活动将返回匹配的 Office365Message 对象（结果）的数组，您可以在后续活动（例如，“ 转发邮件” 和 “ 移动邮件”）中将其用作输入变量。

作用域

此活动需要以下作用域：

• Mail.Read AND User.Read

或

• Mail.ReadWrite AND User.Read

或

• Mail.Read.Shared AND User.Read

或

• Mail.ReadWrite.Shared AND User.Read

或

• Mail.Read AND User.ReadWrite

或

• Mail.ReadWrite AND User.ReadWrite

或

• Mail.Read.Shared AND User.ReadWrite

或

• Mail.ReadWrite.Shared AND User.ReadWrite

项目兼容性

Windows - Legacy | Windows

配置

属性

常见

• “显示名称”- 活动的显示名称。此属性支持 String 变量和字符串格式的值。

输入

• “帐户 ” -（可选）要与之交互的电子邮件地址。 这可能包括当前用户有权访问的任何共享邮箱。 如果留空，则假定为当前用户的帐户。 此属性支持 String 变量和字符串格式的值。
  备注： 对于 ApplicationIdAndSecret 和 ApplicationIdAndCertificate 身份验证类型，“帐户” 字段是必填字段。
• “邮件文件夹” - 从中检索邮件的邮件文件夹。 输入您在 Outlook 应用程序中显示的文件夹（例如， “收件箱”、 “已发送邮件”、 “已删除邮件”等）。 子文件夹使用 “父文件夹/子文件夹/另一个子文件夹”格式。 此属性支持 String 变量和字符串格式的值。

其他

• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。该字段仅支持“布尔值”。

选项

• 电子邮件 ID - 要查找的电子邮件的 ID。 指定后，系统会考虑 Account、 Get As HTML和 Mark As Read 参数，而忽略 Only Unread Messages、 Order By Date、 Query和 Top 参数。 如果找到具有指定 ID 的电子邮件，则输出数组将仅包含一个元素。 如果未找到，该活动将引发异常。 此属性支持 String 变量和字符串格式的值。
• “获取为 HTML” - 如果选中，则以 HTML 格式返回邮件正文。 此字段支持布尔值。
• 标记为已读 - 如果选中，则返回的邮件将标记为已读。 此字段支持布尔值。
• “仅未读消息” - 如果选中，则仅返回未读消息。 此字段支持布尔值。 默认值为 True。
• “按日期 排序” - 返回的消息按日期排序。 可用选项为 “最新优先” 和 “最旧优先”。
• 查询 - 用于筛选返回的电子邮件的查询。 如果查询未完成，则返回所有电子邮件。 使用 $filter OData 查询参数输入 String 。 以下是一些示例输入：
  • "from/emailAddress/address eq '[e-mail]'"
  • "subject eq 'Office365 Quickstart'"
  • "subject eq 'Office365 Quickstart' and from/emailAddress/address eq '[e-mail]'"
  • "categories/any(a:a eq 'Red category')"
• “顶部” - 要检索的最大电子邮件数量。 此字段仅支持整数和 Int32 变量。 默认值为 50 （未显示）。

输出

• “结果 ” - 返回用户收件箱中的所有电子邮件。 此字段仅支持 Office365Message[] 变量。 如果您计划在后续活动中使用输出数据，则为必需。

  您为此属性创建的变量也将用于“ 转发邮件” 和“ 移动邮件” 活动（作为“ 消息” 输入属性值）。 使用此变量作为输入属性值时，请在数组中指定要使用的项目（例如， foundMessages(0)）。

  Office365Messageobject 包含多个可在其他活动中使用的 属性 。
  Body.Content 属性仅以 HTML 格式返回。

工作方式

以下步骤和消息序列图是活动从设计时（即活动依赖项和输入/输出属性）到运行时如何工作的示例。

1. 完成步骤。
2. 将“ Microsoft Office 365 作用域 ”活动添加到您的项目中。
3. 在 Microsoft Office 365 作用域活动中添加获取邮件活动。
4. 输入“输入”属性的值。
5. 为“输出”属性创建并输入 Office365Message[] 变量。

6. 运行活动。

   • 您的输入属性值将发送到 GetMessage 和 ListMessages API。
   • API 会将 Office365Message[] 值返回到您的输出属性变量。