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 屬性設定為 "Send email"

  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 使用訊息識別碼來刪除電子郵件訊息
MarkAsRead 將電子郵件訊息標示為已讀取
ReplyTo 回覆電子郵件訊息
GetAttachment 透過識別碼擷取訊息附件
OnNewEmail 在新的電子郵件送達時觸發流程
SendMailWithOptions 使用多個選項傳送電子郵件,並使用其中一個選項來等待收件者回應。
SendApprovalMail 傳送核准電子郵件,並等待收件者的回應。

GetEmails

取得電子郵件:從資料夾擷取電子郵件

輸入屬性

名稱 資料類型 必要 說明
folderPath 字串 要擷取訊息的資料夾路徑 (預設值:'Inbox')
top 整數 要擷取的電子郵件數目 (預設值:10)
fetchOnlyUnread 布林值 僅擷取未讀取的訊息嗎? (預設值:true)
includeAttachments 布林值 如果設定為 true,也會擷取附件與電子郵件訊息。 (預設值:false)
searchQuery 字串 搜尋查詢以篩選電子郵件
skip 整數 要跳過的電子郵件數目 (預設值:0)
skipToken 字串 跳過權杖以提取新頁面

輸出屬性

屬性名稱 資料類型 必要 說明
陣列 接收可包含下列屬性的電子郵件訊息︰
  • From (選擇性)
  • To (必要)
  • Subject (必要)
  • Body (必要)
  • Importance (選擇性):"Low"、"Normal" 或 "High"
  • HasAttachment (選擇性)
  • Id (選擇性)
  • IsRead (選擇性)
  • DateTimeReceived (選擇性)
  • Attachments (選擇性):接收附件。 Attachment 屬性包括 Id (必要)、ContentType (必要)、Name (必要)、ContentBytes (必要)。
  • Cc (選擇性)
  • Bcc (選擇性)
  • IsHtml (選擇性)

SendEmail

傳送電子郵件:傳送電子郵件訊息

輸入屬性

名稱 資料類型 必要 說明
emailMessage 可包含下列屬性的電子郵件訊息執行個體︰
  • Attachment (選擇性):傳送附件。 Attachment 屬性包括 Name (必要) 和 ContentBytes (必要)。
  • From (選擇性)
  • Cc (選擇性)
  • Bcc (選擇性)
  • Subject (必要)
  • Body (必要)
  • Importance (選擇性):"Low"、"Normal" 或 "High"
  • IsHtml (選擇性):輸入 true 或 false
  • To (必要):使用逗號區隔電子郵件地址。

輸出屬性

無。

DeleteEmail

刪除電子郵件:透過識別碼來刪除電子郵件訊息

輸入屬性

名稱 資料類型 必要 說明
messageId 字串 要刪除的訊息的識別碼。

輸出屬性

無。

MarkAsRead

標示為已讀取:將電子郵件訊息標示為已讀取

輸入屬性

名稱 資料類型 必要 說明
messageId 字串 要標示為已讀取的訊息的識別碼

輸出屬性

無。

ReplyTo

回覆訊息:回覆電子郵件訊息

輸入屬性

名稱 資料類型 必要 說明
messageId 字串 要回覆的訊息的識別碼
comment 字串 回覆註解
replyAll 布林值 回覆所有收件者

輸出屬性

無。

GetAttachment

取得附件:透過識別碼擷取訊息附件

輸入屬性

名稱 資料類型 必要 說明
messageId 字串 訊息的識別碼
attachmentId 字串 要下載的附件的識別碼

輸出屬性

無。

OnNewEmail

有新電子郵件時:在新的電子郵件送達時觸發流程

輸入屬性

名稱 資料類型 必要 說明
folderPath 字串 要擷取的電子郵件資料夾 (預設值:Inbox、Inbox\ToMe 等)
字串 收件者電子郵件地址
from 字串 寄件者地址
importance 字串 電子郵件的重要性 (高、標準、低) (預設值︰Normal)
fetchOnlyWithAttachment 布林值 僅擷取包含附件的電子郵件
includeAttachments 布林值 包含附件
subjectFilter 字串 要在主旨中尋找的字串。

輸出屬性

屬性名稱 資料類型 必要 說明
陣列

SendMailWithOptions

使用選項傳送電子郵件:使用多個選項傳送電子郵件,並使用其中一個選項來等待收件者回應。

輸入屬性

名稱 資料類型 必要 說明
optionsEmailSubscription 電子郵件選項的訂閱要求,包括︰
  • NotificationUrl (選擇性)
  • Message (選擇性)

輸出屬性

屬性名稱 資料類型 必要 說明
id 字串
resource 字串
notificationType 字串
notificationUrl 字串

SendApprovalMail

傳送核准電子郵件:傳送核准電子郵件,並等待收件者的回應。

輸入屬性

名稱 資料類型 必要 說明
approvalEmailSubscription 核准電子郵件的訂閱要求,包括︰
  • NotificationUrl (選擇性)
  • Message (選擇性)

輸出屬性

屬性名稱 資料類型 必要 說明
id 字串
resource 字串
notificationType 字串
notificationUrl 字串

有用連結