# 使用华为云Astro轻应用邮件模板发送邮件通知 #### 应用场景 华为云Astro轻应用低代码平台提供了文档类模板创建能力，支持快速创建"Word文档"、"Excel文档"、"邮件"和"短信"四种类型的模板，以满足多样化的业务文档需求，提升文档的制作效率与规范性。 本实践以**邮件** **模板**为例进行介绍，基于该功能开发者可以预先设置好邮件格式和框架，避免每次都重复的编写。例如，商务沟通中的订单确认、会议邀请以及日常生活中的节日祝福、活动通知等，通过邮件模板只需设置收件人、主题、内容等关键信息，即可快速生成一封完整的邮件，从而节省大量的时间和精力。 #### 方案优势 用户可以在服务编排中，通过拖、拉、拽的方式调用邮件模板节点、配置模板的输入输出参数，用于快速生成一份完整的邮件。 #### 约束与限制 收件人、抄送和密送可以设置多个邮箱地址，多个邮箱之间用英文";"隔开。收件人、抄送、密送和主题内容不能超过4096个字符。 #### 操作流程 在华为云Astro轻应用中，通过邮件模板发送邮件的操作流程，如[图1]所示。 图1使用邮件模板发送邮件操作流程 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002263537710.png) #### 步骤一：创建SMTP邮箱服务连接器 在应用中创建一个SMTP邮箱服务连接器，实现邮件发送功能。SMTP即简单邮件传输协议，是一种提供可靠且有效电子邮件传输的协议。 1. 创建一个低代码应用。 1. 参考[授权用户使用华为云Astro轻应用并购买实例](https://support.huaweicloud.com/usermanual-astrozero/astrozero_05_9046.html)中操作，申请华为云Astro轻应用免费试用或购买商业实例。 2. 实例购买后，在华为云Astro轻应用服务控制台的"主页"中，单击"进入首页"，进入应用开发页面。 3. 在"应用"中，单击"新建低代码应用"或单击![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002134818046.png "点击放大")，进入新建低代码应用页面。 首次创建应用时，请根据界面提示创建一个命名空间。命名空间一旦创建，不能修改和删除，创建前请确认好相关信息。建议使用公司或团队的缩写作为命名空间。 4. 在新建低代码应用页面，应用类型选择"标准应用"，单击"确定"。 5. 输入应用的标签和名称，单击"新建"，即可进入应用设计器。 图2创建一个空白应用 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002170372113.png "点击放大") 表1新建空白应用参数说明 | 参数 | 说明 | 示例 | |:---|:---|:---| | 标签 | 新建应用的标签，长度不能超过80个字符。标签是应用在系统中的唯一标识，创建后不支持修改。 | 我的第一个应用 | | 名称 | 新建应用的名称，输入标签值后单击该参数的输入框，系统会自动生成应用的名称，同时自动在名称前，添加***命名空间***__。命名要求如下： - 长度不能超过31个字符，包括前缀命名空间的长度。 名称前的内容为命名空间，在华为云Astro轻应用中为了避免不同租户间数据的重名，租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间，创建后不支持修改。 - 必须以英文字母开头，只能由英文字母、数字或单下划线组成，且不允许以下划线结尾。 | A | 2. 创建SMTP邮箱服务连接器。 1. 在应用设计器的左侧导航栏中，选择"集成"，单击"连接器 \> 连接器实例"。 图3单击连接器实例 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002262991142.png) 2. 在"类型 \> 消息通知" 中，单击"SMTP邮箱服务"，再单击"+"，进入创建SMTP邮箱服务页面。 3. 设置SMTP邮箱服务连接器的信息，单击"保存"。 图4创建SMTP邮箱服务连接器 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002262955712.png "点击放大") [表2]仅介绍本实践中使用到的参数，其他参数的解释请参见[对接SMTP发送邮件](https://support.huaweicloud.com/usermanual-astrozero/astrozero_05_9228.html)。 表2新建SMTP邮箱服务参数说明 | 参数 | 说明 | 示例 | |:---|:---|:---| | 名称 | 新建SMTP邮箱服务连接器的名称，创建后不支持修改。命名要求如下： - 长度不能超过64个字符，包括前缀命名空间的长度。 标识前模糊掉的内容为命名空间，在华为云Astro轻应用中为了避免不同租户间数据的重名，租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间，创建后不支持修改。 - 必须以英文字母开头，只能由英文字母，数字和下划线组成，且不能以下划线结尾。 | smtp | | SMTP服务地址:端口 | 邮箱开通SMTP功能时，配置的服务器地址和端口号。 常用邮箱开启SMTP后，SMTP服务器地址及端口请参见[表3]。 | smtp.163.com:465 | | 用户名 | 邮箱的用户名，如果未修改过，默认为邮箱地址。 | example@163.com | | 密码 | 邮箱开通SMTP功能时，生成的授权密码，是一段随机字符串。 | - | | 发件人邮箱地址 | 发送电子邮件的邮箱地址，通常格式为**用户名** **@** **域名**。 | zhangsan@163.com | 表3常用邮箱SMTP服务器地址及端口 | 邮箱 | SMTP服务器地址 | 服务端口 | |:---|:---|:---| | 163邮箱 | smtp.163.com | - SSL协议时，配置为465或者994 - 其他协议时，配置为25 | | 126邮箱 | smtp.126.com | 25 | | YEAH邮箱 | smtp.yeah.net | 25 | | QQ企业邮箱 | - 国内用户：smtp.exmail.qq.com - 海外用户：hwsmtp.exmail.qq.com | 使用SSL协议，端口为465 | | SINA邮箱 | smtp.sina.com | 25 | 3. 测试邮件是否能正常发送。 1. 在连接器详情页面，单击测试中的"发送邮件"。 2. 输入收件人、主题和邮件内容，单击"发送"。 图5发送邮件 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002297678909.png "点击放大") 收件人可收到邮件，表示测试成功，如[图6]。 图6接收邮件内容 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002262965796.png "点击放大") #### 步骤二：创建邮件模板场景并配置模板 创建一个模板场景并在场景中添加一个邮件模板。在模板场景的配置中，添加邮件模板中需要替换的参数。模板场景是一个业务场景的集合，在模板场景中支持创建多个模板，模板之间共享数据结构。 1. 创建邮件模板场景。 1. 在应用设计器的左侧导航栏中，选择"逻辑"，单击"更多 \> 模板"。 图7单击模板 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002263068886.png) 2. 单击"添加模板场景"，设置模板场景的标签和名称，单击"确定"。 图8创建模板场景 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002263162018.png "点击放大") 表4新建模板场景参数说明 | 参数 | 说明 | 示例 | |:---|:---|:---| | 标签 | 新建模板场景的名称，创建后可修改。 取值范围：1\~80个字符。 | 通知 | | 名称 | 新建模板场景在系统中的标识，创建后不支持修改。命名要求如下： - 长度不能超过64个字符，包括前缀命名空间的长度。 标识前模糊掉的内容为命名空间，在华为云Astro轻应用中为了避免不同租户间数据的重名，租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间，创建后不支持修改。 - 必须以英文字母开头，只能由英文字母，数字和下划线组成，且不能以下划线结尾。 | notify | 2. 在"配置 "页签，选择[步骤一：创建SMTP邮箱服务连接器]中创建的连接器，单击"保存"。 图9选择连接器 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002297725717.png "点击放大") 3. 在"数据"页签，为通知模板添加[表5]中参数。 此处添加的模板参数，对应通知模板中需要替换的内容。 图10为通知模板添加公司名称参数 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002263635098.png "点击放大") 表5待添加参数 | 名称 | 唯一标识 | 数据类型 | |:---|:---|:---| | 公司名称 | companyName | 文本 | | 客户公司名称 | customerCompanyName | 文本 | | 姓名 | name | 文本 | 图11查看已添加的参数 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002297791597.png "点击放大") 4. 在"模板"页签，单击"添加"，创建邮件模板。 图12新建邮件模板 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002263170690.png "点击放大") 表6新建邮件模板参数说明 | 参数 | 说明 | 示例 | |:---|:---|:---| | 标签 | 新建模板的名称，创建后可修改。 取值范围：1\~80个字符。 | 问好模板 | | 名称 | 新建模板在系统中的标识，创建后不支持修改。命名要求如下： - 长度不能超过63个字符，包括前缀命名空间的长度。 标识前模糊掉的内容为命名空间，在华为云Astro轻应用中为了避免不同租户间数据的重名，租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间，创建后不支持修改。 - 必须以英文字母开头，只能由英文字母，数字和下划线组成，且不能以下划线结尾。 | emailModel | | 模板类型 | 新建文档模板的类型。 - Word文档：支持用户上传Word格式的文档模板，文档的大小建议小于10M。 - Excel文档：支持用户上传Excel类型的文档模板。上传的Excel文档不能超过10个Sheet页，每个Sheet页中**列** 不能超过200个，**行** 不能超过1000个，**单元格** **内**字符串的长度不超过500个字符。 - 邮件：支持用户在模板编辑界面编写邮件模板。 - 短信：支持用户在模板编辑界面编写短信模板。 | 邮件 | 5. 编辑邮件模板。 1. 在"模板"页签，单击[4]中创建模板后的![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002297565857.png)，进入邮件模板页面。 图13进入模板编辑页面 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002263343600.png "点击放大") 2. 单击页面右上方的"编辑"，进入模板编辑页面。 图14单击编辑 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002297810377.png "点击放大") 3. 编辑邮件内容，邮件中的变量为[3]中添加的模板参数。 图15编辑邮件内容 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002263581960.png "点击放大") 表7邮件内容参数说明 | 参数 | 说明 | 示例 | |:---|:---|:---| | 收件人 | 收件人的邮箱地址，长度不能超过4096个字符，涉及多个地址时请使用英文";"隔开。 | \*\*\*.com | | 主题 | 邮件的主题，长度不能超过4096个字符。 | 节日问候 | | 邮件内容 | 待发送邮件的具体内容，长度不能超过4096个字符。邮件内容请尽量简洁明了、逻辑清晰，确保信息能准确传达。 | 您好！ 我是${命名空间__name}，来自${命名空间__companyName}。 在这特别的日子里，我想向您及您的团队（${命名空间__customerCompanyName}）致以最诚挚的祝福，希望这一年里您的事业蒸蒸日上，生活幸福美满。 此致 敬礼！ | 4. 内容编辑完成后，单击"保存"，再单击"启用"，启用邮件模板。 6. 返回邮件模板场景中，单击"启用"，启用模板场景。 模板场景"状态"变为"启用"，表明模板场景启用成功。 图16查看模板创建状态 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002298209685.png "点击放大") #### 步骤三：在服务编排中调用模板发送邮件 创建一个服务编排，添加一个"调用模板"图元，实现邮件发送功能。 1. 在应用设计器的左侧导航栏中，选择"逻辑"，单击编排后的"+"。 2. 设置服务编排的标签和名称，单击"添加"。 图17新建服务编排 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002298052773.png "点击放大") 表8新建服务编排参数说明 | 参数 | 说明 | 示例 | |:---|:---|:---| | 标签 | 服务编排的标签名，用于在界面展示，创建后可修改。 取值范围：1\~64个字符。 | 邮件 | | 名称 | 服务编排在系统中的唯一标识，创建后不支持修改。命名要求如下： - 长度不能超过64个字符，包括前缀命名空间的长度。 标识前模糊掉的内容为命名空间，在华为云Astro轻应用中为了避免不同租户间数据的重名，租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间，创建后不支持修改。 - 名称必须以英文字母开头，只能由英文字母、数字或单下划线组成，且不能以下划线结尾。 | email | 3. 创建全局上下文变量。 1. 在服务编排设计页面，选中开始节点，单击![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002262754218.png)。 2. 在全局上下文中，单击变量后的![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002297284237.png)，新建变量"variable0"。 3. 单击"variable0"变量后的![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002262651156.png)，选择"设置"。 4. 将变量的"名称"设置为"companyName"，单击"保存"。 图18新建companyName变量 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002297411185.png "点击放大") 5. 按照上述操作，创建[表9]中的变量。 图19查看已创建的变量 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002298068373.png) 表9需要创建的全局上下文变量 | 名称 | 数据类型 | |:---|:---| | companyName（已创建） | 文本 | | customerCompanyName | 文本 | | name | 文本 | 4. 添加调用模板图元。 1. 在"基本"中，拖拽"调用模板"图元到开始图元后。 图20拖拽调用模板图元到画布中 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002262651160.png "点击放大") 2. 选中调用模板图元Template0，单击![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002297411189.png)，设置调用模板。 图21设置调用模板图元 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002298071297.png "点击放大") 表10调用模板图元参数说明 | 参数 | 说明 | 示例 | |:---|:---|:---| | 请选择模板场景 | 选择调用模板图元关联的模板场景，即[1]中创建的。 | *命名空间*__notify | | 请选择模板类型 | 选择待调用模板的类型。 | 邮件 | | 请选择文档模板 | 选择模板场景中创建的邮件模板，即[4]中创建的。 | *命名空间*__emailModel | 3. 在"向模板传入数据"中，单击"新增行"，将[3]中创建的变量拖到服务编排入参中，作为服务编排的输入参数。 图22设置服务编排入参 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002263619702.png "点击放大") 5. 连接图元指定逻辑关系，即从开始图元连向调用模板图元。 图23指定图元逻辑关系 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002298190433.png) 6. 单击页面上方的![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002297284249.png "点击放大")，保存服务编排。 7. 单击![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002262651168.png "点击放大")，进入服务编排调试页面。 在输入参数中，输入如下内容，并单击"运行"。 图24调试服务编排 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002298192961.png) ``` { "companyName": "A公司", "customerCompanyName": "B公司", "name": "张三" } ``` 运行成功后，[5]中设置的邮件收件人，即可收到节日问候邮件，如[图25]。 图25节日问候邮件 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002298755701.png "点击放大") 8. 单击页面上方的![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002262651172.png "点击放大")，启用服务编排。