> ## 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"/>
```