電子郵件動作
在部署任何電子郵件動作之前，您必須先設定用來處理要求的伺服器。 檢索電子郵件訊息和處理電子郵件訊息動作需要 IMAP 伺服器，而傳送電子郵件動作需要 SMTP 伺服器。
通用 IMAP 連接埠：
- 143 (未加密和 TLS)
- 993 (安全 IMAP)
通用 IMAP 伺服器：
- imap-mail.outlook.com (Outlook.com)
- outlook.office365.com (Office365.com)
- imap.mail.yahoo.com (Yahoo mail)
- imap.gmail.com (Google mail)
通用 SMTP 連接埠：
- 25 (未加密)
- 587 (未加密和 TLS)
- 465 (SSL)
通用 SMTP 伺服器：
- smtp-mail.outlook.com (Outlook.com)
- smtp.office365.com (Office365.com)
- smtp.mail.yahoo.com (Yahoo mail)
- smtp.gmail.com (Google mail)
若要擷取符合特定準則的電子郵件，請使用擷取電子郵件訊息動作。 下列範例只擷取收件匣中未讀取的訊息。
篩選器會進一步指定電子郵件應該來自 b.friday，主旨應包含報表，而正文應包含星期二。 此動作將在本機儲存所有符合指定準則的附件。
![[擷取電子郵件訊息] 動作的螢幕擷取畫面。](media/email/retrieve-email-messages-example.png)
使用處理電子郵件訊息動作來管理您的電子郵件，該動作需要擷取電子郵件訊息動作所建立的變數。 您可以選擇是否要移動或刪除電子郵件，或將電子郵件標記為已讀/未讀。
下方的傳送電子郵件動作會從 N. Varga 傳送電子郵件 到 B. Friday，並在密件副本欄位中包含發票。 主旨和本文包含 %ReportID% 變數，而附件是流程之前處理過的檔案。
![[傳送電子郵件] 動作的螢幕擷取畫面。](media/email/send-email-messages-example.png)
擷取電子郵件訊息
從 IMAP 伺服器擷取電子郵件訊息。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| IMAP server | 否 | 文字值 | IMAP 伺服器位址 (例如 imap.gmail.com) | |
| Port | 是 | 數值 | 993 | 要用於 IMAP 伺服器的連接埠。 通常此連接埠為 993 |
| Enable SSL | 無法使用 | 布林值 | 確判為真 | 指定是否使用安全連線與 IMAP 伺服器通訊 |
| User name | 否 | 文字值 | 要存取的電子郵件帳戶使用者名稱 | |
| 密碼 | 否 | 直接加密文字輸入或文字值 | 要存取的電子郵件帳戶密碼 | |
| 接受未受信任的憑證 | 無法使用 | 布林值 | 否 | 指定是否接受不受信任的憑證 |
| Mail folder | 否 | 文字值 | 要從其中擷取郵件的 IMAP 郵件資料夾名稱 (也稱為「信箱」) | |
| Retrieve | 無法使用 | 所有電子郵件、僅限未讀電子郵件訊息、僅限已讀電子郵件訊息 | 所有電子郵件訊息 | 指定是否擷取資料夾中的所有訊息，或只擷取未讀的訊息 |
| Mark As read | 無法使用 | 布林值 | 是 | 指定是否將擷取的訊息標示為已讀，或保留原狀 |
| "From" field contains | 是 | 文字值 | 將擷取其訊息的寄件者的完整電子郵件地址。 保留此屬性空白時，可擷取所有訊息而不管寄件者是誰 | |
| "To" field contains | 是 | 文字值 | 要擷取的電子郵件訊息收件者的完整電子郵件地址 (有多個地址時以空格分隔)。 保留此屬性空白，可擷取所有訊息而不論其收件者是誰 | |
| "Subject" contains | 是 | 文字值 | 要在電子郵件主旨中尋找的關鍵片語。 保留此屬性空白，可擷取所有電子郵件而不論其主旨為何 | |
| 'Body' contains | 是 | 文字值 | 要在電子郵件本文中尋找的關鍵片語。 保留此屬性空白，可擷取所有電子郵件而不論其內容為何 | |
| Save attachments | 無法使用 | 儲存附件、不要儲存附件 | 不要儲存附件 | 指定是否要儲存已擷取電子郵件的附件 |
| Save attachments into | 否 | 資料夾 | 要在其中儲存附件的資料夾 |
變數已產生
| 引數 | 類型 | 描述 |
|---|---|---|
| RetrievedEmails | 郵件訊息的清單 | 可供日後處理為郵件訊息物件清單的已擷取電子郵件 |
例外狀況
| 例外 | 描述 |
|---|---|
| 無法連接至 IMAP 伺服器 | 指示連接至 IMAP 伺服器時發生問題 |
| 無法驗證 IMAP 伺服器 | 指示驗證指定的 IMAP 伺服器時發生問題 |
| 指定的郵件資料夾不存在 | 指示找不到指定的郵件資料夾 |
| 無法儲存附件 | 指示儲存附件時發生問題 |
| 無法擷取電子郵件 | 指示擷取電子郵件時發生問題 |
處理電子郵件訊息
將由擷取電子郵件動作所取得的電子郵件 (或電子郵件清單) 移動、刪除及標示為未讀。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| IMAP server | 否 | 文字值 | IMAP 伺服器位址 (例如 imap.gmail.com) | |
| Port | 是 | 數值 | 993 | 要用於 IMAP 伺服器的連接埠。 通常此連接埠為 993 |
| Enable SSL | 無法使用 | 布林值 | 確判為真 | 指定是否使用安全連線與 IMAP 伺服器通訊 |
| Username | 否 | 文字值 | 要存取的電子郵件帳戶使用者名稱 | |
| 密碼 | 否 | 直接加密文字輸入或文字值 | 要存取的電子郵件帳戶密碼 | |
| 接受未受信任的憑證 | 無法使用 | 布林值 | 否 | 指定是否接受不受信任的憑證 |
| Email(s) to process | 否 | 郵件訊息的清單 | 要處理的電子郵件或電子郵件清單。 此參數應該包含由 [擷取電子郵件] 動作填入的變數 | |
| 選用 | 無法使用 | 從伺服器刪除電子郵件、標示電子郵件為未讀、將電子郵件移至郵件資料夾、將電子郵件標示為未讀並移至郵件資料夾 | 將電子郵件移至郵件資料夾 | 您要在指定的電子郵件訊息上執行的作業 |
| Mail folder | 否 | 文字值 | 電子郵件將移至其中的郵件資料夾名稱 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 無法連接至 IMAP 伺服器 | 指示連接至 IMAP 伺服器時發生問題 |
| 指定的郵件資料夾不存在 | 指示找不到指定的郵件資料夾 |
| 無法處理電子郵件 | 指示處理指定的電子郵件時發生問題 |
傳送電子郵件
建立並傳送新的電子郵件訊息。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| SMTP server | 否 | 文字值 | SMTP 伺服器位址 | |
| Server port | 是 | 數值 | 25 | 要用於伺服器的連接埠。 通常此連接埠為 25 |
| Enable SSL | 無法使用 | 布林值 | 誤判為真 | 指定是否要透過安全連線來與伺服器通訊 |
| SMTP Server needs authentication | 無法使用 | 布林值 | 否 | 指定伺服器是否需要驗證 |
| User name | 否 | 文字值 | 要存取的電子郵件帳戶使用者名稱 | |
| 密碼 | 否 | 直接加密文字輸入或文字值 | 要存取的電子郵件帳戶密碼 | |
| 接受未受信任的憑證 | 無法使用 | 布林值 | 否 | 指定是否接受不受信任的憑證 |
| From | 否 | 文字值 | 寄件者的電子郵件地址 | |
| Sender display name | 是 | 文字值 | 寄件者的顯示名稱 | |
| To | 否 | 文字值 | 收件者的電子郵件。 如果輸入的電子郵件不止一個，則地址清單應該以分號隔開 | |
| CC | 是 | 文字值 | 副本收件者的電子郵件。 如果輸入的電子郵件不止一個，則地址清單應該以分號隔開 | |
| BCC | 是 | 文字值 | 密件副本 (隱藏) 收件者的電子郵件。 如果輸入的電子郵件不止一個，則地址清單應該以分號隔開 | |
| Subject | 是 | 文字值 | 電子郵件的主旨 | |
| Body | 是 | 文字值 | 電子郵件的本文 | |
| Body Is HTML | 無法使用 | 布林值 | 否 | 指定電子郵件本文是否將解譯為 HTML 編碼 |
| Attachment(s) | 是 | 檔案的清單 | 任何附件、檔案或檔案清單的完整路徑。 如有多個檔案，應以雙引號 (") 括住並用空白字元隔開 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 不正確的電子郵件地址 | 指示指定的電子郵件地址無效 |
| 無法傳送電子郵件 | 指示傳送電子郵件時發生問題 |
| 找不到附件 | 指示找不到指定的附件 |