> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kasoftware.com/llms.txt
> Use this file to discover all available pages before exploring further.

# appSendEmail

> 使用應用程式“通知”設定中的 SMTP 伺服器配置傳送電子郵件，支援純文字、HTML 和檔案附件。

使用“設定”頁面中[通知](../../getting-started/administration/settings/alerts)部分的伺服器資訊（例如 SMTP 伺服器、使用者和密碼）傳送電子郵件。

## 必需的參數

* **To**：電子郵件接收地址清單，以逗號分隔。
* **Subject**：發出郵件的標題。
* **Message**：要傳送電子郵件的純文字正文（如果訊息為 HTML，請勿使用）。
* **Html**：要傳送電子郵件的 HTML 正文（如果訊息為純文字，請勿使用）。

## 可選的參數

* **CC**：電子郵件抄送（CC）地址清單，以逗號分隔。
* **Attachment#**：與要附加到訊息的檔案對應的檔案路徑陣列。若要覆蓋磁碟上附件的名稱，可以使用 AttachmentName#。或者，在使用 AttachmentData# 參數建立附件時，使用此參數為附件提供檔名。
* **AttachmentData#**：base64 編碼的資料 blob 陣列，被視為附件檔案的內容。使用此參數時，還必須使用 Attachment# 參數為附件檔案命名。
* **AttachmentName#**：用於為郵件附件命名的檔名陣列（僅在使用 Attachment# 從檔案路徑重新命名附件時使用）。

## 範例

### 傳送簡單的電子郵件

以下是 appSendEmail 操作的簡單範例。該指令碼使用應用程式“通知”索引標籤上配置的電子郵件帳戶，將電子郵件傳送到 `email.To` 中列出的兩個電子郵件地址。

```xml theme={null}
<!-- Send Simple Email -->
<arc:set attr="email.To" value="foo@bar.com,janedoe@foo.com"/>
<arc:set attr="email.CC" value="jimmysmith@bar.com"/>
<arc:set attr="email.Subject" value="Lorem ipsum dolor sit amet."/>
<arc:set attr="email.Message" value="File [FileName] was processed in the connector [ConnectorId]."/>
<arc:call op="appSendEmail" in="email"/>
```

### 傳送帶有附件的電子郵件

此範例使用 Attachment# 和 AttachmentData# 屬性在電子郵件中建立附件。

```xml theme={null}
<!-- Send Email with Attachments -->
<arc:set attr="email.To" value="foo@bar.com,bar@foo.com"/>
<arc:set attr="email.Subject" value="Lorem ipsum dolor sit amet."/>
<arc:set attr="email.Message" value="This is a test."/>
<arc:set attr="email.Attachment#1" value="foo.txt"/>
<arc:set attr="email.AttachmentData#1" value="TG9yZW0gaXBzdW0gZG9sb3Igc2l0IGFtZXQsIGNvbnNlY3RldHVyIGFkaXBpc2NpbmcgZWxpdC4gRG9uZWMgcG9ydHRpdG9yIGlkIG1pIG5lYyBpbXBlcmRpZXQuIE51bGxhLg=="/>
<arc:set attr="email.Attachment#2" value="bar.txt"/>
<arc:set attr="email.AttachmentData#" value="TG9yZW0gaXBzdW0gZG9sb3Igc2l0IGFtZXQsIGNvbnNlY3RldHVyIGFkaXBpc2NpbmcgZWxpdC4gTnVsbGEgYXVndWUgbWFzc2EsIGZyaW5naWxsYSBuZWMgbHVjdHVzIG5lYy4="/>
<arc:call op="appSendEmail" in="email"/>
```