Office 365 Outlook

如果连接到 Office 365 Outlook,则除了其他任务之外,还可以显示、发送、删除和回复电子邮件。

可以通过添加控件(包括按钮和标签),在应用中执行这些功能。 例如,可以向应用添加要求输入电子邮件信息的输入文本框,相关信息包括收件人、主题和电子邮件正文。 然后,添加用于发送电子邮件的“发送”按钮。

本主题演示了如何将 Office 365 Outlook 添加为连接、如何将 Office 365 Outlook 添加为应用的数据源,以及如何在不同的控件中使用此数据。

重要提示:撰写本文时,尚不支持日历和联系人功能。

 

开始之前的准备工作

连接到 Office 365

  1. 添加数据连接并选择 Office 365 Outlook

    连接到 Office 365

  2. 选择“连接”,如果系统提示你登录,请输入你的工作帐户。

Office 365 Outlook 连接已创建并已添加到你的应用。 现在可供使用。

在你的应用中使用 Office 365 Outlook 连接

显示电子邮件

  1. 在“插入”菜单上,选择“库”,然后选择“文本库”控件。

  2. 将其 Items 属性设置为以下公式:

    Office365.GetEmails({fetchOnlyUnread:false})

    系统会自动使用一些电子邮件填充库控件。

  3. 在库中,将第一个标签的“Text”属性设置为“ThisItem.From”。 将第二个标签设置为“ThisItem.Subject”。 将第三个标签设置为“ThisItem.Body”。 还可以重设标签大小。

    系统会自动使用新属性填充库控件。

  4. 此函数有几个可选参数。 将库的“Items”属性设置为以下公式之一:

    Office365.GetEmails({fetchOnlyUnread:false})
    Office365.GetEmails({fetchOnlyUnread:false, top:2})
    Office365.GetEmails({folderPath:"Sent Items", fetchOnlyUnread:false, top:2})
    Office365.GetEmails({folderPath:"Sent Items", fetchOnlyUnread:false, top:2, searchQuery:"powerapps"})
    Office365.GetEmails({folderPath:"Deleted Items", fetchOnlyUnread:false, top:2, skip:3})

发送电子邮件

  1. 在“插入”菜单上,选择“文本”,然后选择“文本输入”。 执行上述操作三次,创建三个不同的文本输入控件。 在列中进行排列:

  2. 将它们分别重命名为:

    • inputTo
    • inputSubject
    • inputBody
  3. 在“插入”菜单上,选择“控件”,然后选择“按钮”。 将其 OnSelect 属性设置为以下公式:

    Office365.SendEmail(inputTo.Text, inputSubject.Text, inputBody.Text)

  4. 移动按钮,使其出现在所有其他控件下方,并将其 Text 属性设置为“发送电子邮件”。

  5. 按 F5,或选择“预览”按钮 ( )。 在“inputTo”中键入有效的电子邮件地址,并在其他两个“文本输入”控件中键入所需的任何内容。

  6. 选择“发送电子邮件”来发送邮件。 按 Esc 返回默认工作区。

删除电子邮件

  1. 在“插入”菜单上,选择“库”,然后选择“文本库”控件。

  2. 将其 Items 属性设置为以下公式:

    Office365.GetEmails({fetchOnlyUnread:false})

    系统会自动使用一些电子邮件填充库控件。

  3. 在库中,将第一个标签的“Text”属性设置为“ThisItem.Id”。 将第二个标签设置为“ThisItem.Subject”。 将第三个标签设置为“ThisItem.Body”。

  4. 选择库中的第一个标签,然后将其重命名为“EmailID”:

    关闭选项窗格

  5. 选择库中的第三个标签,然后添加一个“按钮”控件(使用“插入”菜单)。 将按钮的“OnSelect”属性设置为以下公式:

    Office365.DeleteEmail(EmailID.Text)

  6. 按 F5,或选择“预览”按钮 ( )。 选择库中的一封电子邮件,然后单击此按钮。

    注意 这将从收件箱中删除所选的电子邮件。 因此,请慎重选择。

  7. 按 Esc 返回默认工作区。

将电子邮件标记为已读

本节使用的控件与删除电子邮件中使用的控件相同。

  1. 将按钮的“OnSelect”属性设置为以下公式:

    Office365.MarkAsRead(EmailID.Text)

  2. 按 F5,或选择“预览”按钮 ( )。 选择一封未读电子邮件,然后单击此按钮。

  3. 按 Esc 返回默认工作区。

查看可用函数

此连接包括以下函数:

函数名称 说明
GetEmails 从文件夹中检索电子邮件
SendEmail 发送电子邮件
DeleteEmail 删除使用邮件 ID 的电子邮件
MarkAsRead 将电子邮件标记为已读
ReplyTo 回复电子邮件
GetAttachment 按 ID 检索邮件附件
OnNewEmail 收到新电子邮件时触发流
SendMailWithOptions 发送包含多个选项的电子邮件,并等待收件人回复其中一个选项。
SendApprovalMail 发送审批电子邮件,并等待收件人的回复。

GetEmails

获取电子邮件:从文件夹中检索电子邮件

输入属性

名称 数据类型 需要 说明
folderPath 字符串 要检索邮件的文件夹的路径(默认设置:“Inbox”)
top 整数 要检索的电子邮件数(默认值:10)
fetchOnlyUnread 布尔值 仅检索未读邮件? (默认值:true)
includeAttachments 布尔值 如果设置为 true,则同时检索电子邮件与附件。 (默认值:false)
searchQuery 字符串 搜索查询以筛选电子邮件
skip 整数 要跳过的电子邮件数(默认值:0)
skipToken 字符串 要提取新页面的跳过标记

输出属性

属性名称 数据类型 需要 说明
数组 接收可包含以下属性的电子邮件:
  • From(可选)
  • To(必需)
  • Subject(必需)
  • Body(必需)
  • Importance(可选):“低”、“正常”或“高”
  • HasAttachment(可选)
  • Id(可选)
  • IsRead(可选)
  • DateTimeReceived(可选)
  • Attachments(可选):收到附件。 附件属性包括 Id(必需)、ContentType(必需)、Name(必需),ContentBytes(必需)。
  • Cc(可选)
  • Bcc(可选)
  • IsHtml(可选)

SendEmail

发送电子邮件:用于发送电子邮件

输入属性

名称 数据类型 需要 说明
emailMessage 可包含以下属性的电子邮件实例:
  • Attachment(可选):发送附件。 Attachment 属性包括 Name(必需)和 ContentBytes(必需)。
  • From(可选)
  • Cc(可选)
  • Bcc(可选)
  • Subject(必需)
  • Body(必需)
  • Importance(可选):“低”、“正常”或“高”
  • IsHtml(可选):输入 true 或 false
  • To(必填):用逗号分隔电子邮件地址。

输出属性

无。

DeleteEmail

删除电子邮件:根据 ID 删除电子邮件

输入属性

名称 数据类型 需要 说明
messageId 字符串 要删除的邮件的 ID。

输出属性

无。

MarkAsRead

标记为已读:将电子邮件标记为已读

输入属性

名称 数据类型 需要 说明
messageId 字符串 要标记为已读的邮件的 ID

输出属性

无。

ReplyTo

回复邮件:回复电子邮件

输入属性

名称 数据类型 需要 说明
messageId 字符串 要回复的邮件的 ID
comment 字符串 回复批注
replyAll 布尔值 回复所有收件人

输出属性

无。

GetAttachment

获取附件:通过 ID 检索邮件附件

输入属性

名称 数据类型 需要 说明
messageId 字符串 邮件 ID
attachmentId 字符串 要下载的附件的 ID

输出属性

无。

OnNewEmail

收到新电子邮件:收到新电子邮件时触发流

输入属性

名称 数据类型 需要 说明
folderPath 字符串 要检索的电子邮件文件夹(默认值:Inbox、Inbox\ToMe 等。)
字符串 收件人电子邮件地址
from 字符串 发件人地址
importance 字符串 电子邮件的重要性(高、正常、低)(默认值:正常)
fetchOnlyWithAttachment 布尔值 仅检索带有附件的电子邮件
includeAttachments 布尔值 包含附件
subjectFilter 字符串 用于在主题中进行查找的字符串。

输出属性

属性名称 数据类型 需要 说明
数组

SendMailWithOptions

发送包含选项的电子邮件:发送包含多个选项的电子邮件,并等待收件人回复其中一个选项。

输入属性

名称 数据类型 需要 说明
optionsEmailSubscription 电子邮件选项的订阅请求,其中包括:
  • NotificationUrl(可选)
  • Message(可选)

输出属性

属性名称 数据类型 需要 说明
id 字符串
resource 字符串
notificationType 字符串
notificationUrl 字符串

SendApprovalMail

发送审批电子邮件:发送审批电子邮件,并等待收件人的回复。

输入属性

名称 数据类型 需要 说明
approvalEmailSubscription 审批电子邮件选项的订阅请求,其中包括:
  • NotificationUrl(可选)
  • Message(可选)

输出属性

属性名称 数据类型 需要 说明
id 字符串
resource 字符串
notificationType 字符串
notificationUrl 字符串

有用链接