使用华为云Astro轻应用邮件模板发送邮件通知

应用场景

华为云Astro轻应用低代码平台提供了文档类模板创建能力，支持快速创建“Word文档”、“Excel文档”、“邮件”和“短信”四种类型的模板，以满足多样化的业务文档需求，提升文档的制作效率与规范性。

本实践以邮件模板为例进行介绍，基于该功能开发者可以预先设置好邮件格式和框架，避免每次都重复的编写。例如，商务沟通中的订单确认、会议邀请以及日常生活中的节日祝福、活动通知等，通过邮件模板只需设置收件人、主题、内容等关键信息，即可快速生成一封完整的邮件，从而节省大量的时间和精力。

方案优势

用户可以在服务编排中，通过拖、拉、拽的方式调用邮件模板节点、配置模板的输入输出参数，用于快速生成一份完整的邮件。

约束与限制

收件人、抄送和密送可以设置多个邮箱地址，多个邮箱之间用英文“;”隔开。收件人、抄送、密送和主题内容不能超过4096个字符。

操作流程

在华为云Astro轻应用中，通过邮件模板发送邮件的操作流程，如图1所示。

图1 使用邮件模板发送邮件操作流程

步骤一：创建SMTP邮箱服务连接器

在应用中创建一个SMTP邮箱服务连接器，实现邮件发送功能。SMTP即简单邮件传输协议，是一种提供可靠且有效电子邮件传输的协议。

1. 创建一个低代码应用。
   1. 参考授权用户使用华为云Astro轻应用并购买实例中操作，申请华为云Astro轻应用免费试用或购买商业实例。
   2. 实例购买后，在华为云Astro轻应用服务控制台的“主页”中，单击“进入首页”，进入应用开发页面。
   3. 在“应用”中，单击“新建低代码应用”或单击，进入新建低代码应用页面。

      首次创建应用时，请根据界面提示创建一个命名空间。命名空间一旦创建，不能修改和删除，创建前请确认好相关信息。建议使用公司或团队的缩写作为命名空间。

   4. 在新建低代码应用页面，应用类型选择“标准应用”，单击“确定”。
   5. 输入应用的标签和名称，单击“新建”，即可进入应用设计器。
      图2 创建一个空白应用
      

      表1 新建空白应用参数说明

      参数	说明	示例
      标签	新建应用的标签，长度不能超过80个字符。标签是应用在系统中的唯一标识，创建后不支持修改。	我的第一个应用
      名称	新建应用的名称，输入标签值后单击该参数的输入框，系统会自动生成应用的名称，同时自动在名称前，添加命名空间__。命名要求如下： 长度不能超过31个字符，包括前缀命名空间的长度。 名称前的内容为命名空间，在华为云Astro轻应用中为了避免不同租户间数据的重名，租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间，创建后不支持修改。 必须以英文字母开头，只能由英文字母、数字或单下划线组成，且不允许以下划线结尾。	A

2. 创建SMTP邮箱服务连接器。
   1. 在应用设计器的左侧导航栏中，选择“集成”，单击“连接器 > 连接器实例”。
      图3 单击连接器实例
      
   2. 在“类型 > 消息通知” 中，单击“SMTP邮箱服务”，再单击“+”，进入创建SMTP邮箱服务页面。
   3. 设置SMTP邮箱服务连接器的信息，单击“保存”。
      图4 创建SMTP邮箱服务连接器
      

      表2仅介绍本实践中使用到的参数，其他参数的解释请参见对接SMTP发送邮件。

      表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 发送邮件
      

      收件人可收到邮件，表示测试成功，如图6。

      图6 接收邮件内容
      

步骤二：创建邮件模板场景并配置模板

创建一个模板场景并在场景中添加一个邮件模板。在模板场景的配置中，添加邮件模板中需要替换的参数。模板场景是一个业务场景的集合，在模板场景中支持创建多个模板，模板之间共享数据结构。

1. 创建邮件模板场景。
   1. 在应用设计器的左侧导航栏中，选择“逻辑”，单击“更多 > 模板”。
      图7 单击模板
      
   2. 单击“添加模板场景”，设置模板场景的标签和名称，单击“确定”。
      图8 创建模板场景
      

      表4 新建模板场景参数说明

      参数	说明	示例
      标签	新建模板场景的名称，创建后可修改。 取值范围：1~80个字符。	通知
      名称	新建模板场景在系统中的标识，创建后不支持修改。命名要求如下： 长度不能超过64个字符，包括前缀命名空间的长度。 标识前模糊掉的内容为命名空间，在华为云Astro轻应用中为了避免不同租户间数据的重名，租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间，创建后不支持修改。 必须以英文字母开头，只能由英文字母，数字和下划线组成，且不能以下划线结尾。	notify

2. 在“配置 ”页签，选择步骤一：创建SMTP邮箱服务连接器中创建的连接器，单击“保存”。
   图9 选择连接器
   

3. 在“数据”页签，为通知模板添加表5中参数。
   此处添加的模板参数，对应通知模板中需要替换的内容。

   图10 为通知模板添加公司名称参数
   

   表5 待添加参数

   名称	唯一标识	数据类型
   公司名称	companyName	文本
   客户公司名称	customerCompanyName	文本
   姓名	name	文本

   图11 查看已添加的参数
   

4. 在“模板”页签，单击“添加”，创建邮件模板。
   图12 新建邮件模板
   

   表6 新建邮件模板参数说明

   参数	说明	示例
   标签	新建模板的名称，创建后可修改。 取值范围：1~80个字符。	问好模板
   名称	新建模板在系统中的标识，创建后不支持修改。命名要求如下： 长度不能超过63个字符，包括前缀命名空间的长度。 标识前模糊掉的内容为命名空间，在华为云Astro轻应用中为了避免不同租户间数据的重名，租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间，创建后不支持修改。 必须以英文字母开头，只能由英文字母，数字和下划线组成，且不能以下划线结尾。	emailModel
   模板类型	新建文档模板的类型。 Word文档：支持用户上传Word格式的文档模板，文档的大小建议小于10M。 Excel文档：支持用户上传Excel类型的文档模板。上传的Excel文档不能超过10个Sheet页，每个Sheet页中列不能超过200个，行不能超过1000个，单元格内字符串的长度不超过500个字符。 邮件：支持用户在模板编辑界面编写邮件模板。 短信：支持用户在模板编辑界面编写短信模板。	邮件

5. 编辑邮件模板。
   1. 在“模板”页签，单击4中创建模板后的，进入邮件模板页面。
      图13 进入模板编辑页面
      
   2. 单击页面右上方的“编辑”，进入模板编辑页面。
      图14 单击编辑
      
   3. 编辑邮件内容，邮件中的变量为3中添加的模板参数。
      图15 编辑邮件内容
      

      表7 邮件内容参数说明

      参数	说明	示例
      收件人	收件人的邮箱地址，长度不能超过4096个字符，涉及多个地址时请使用英文“;”隔开。	***.com
      主题	邮件的主题，长度不能超过4096个字符。	节日问候
      邮件内容	待发送邮件的具体内容，长度不能超过4096个字符。邮件内容请尽量简洁明了、逻辑清晰，确保信息能准确传达。	您好！ 我是${命名空间__name}，来自${命名空间__companyName}。 在这特别的日子里，我想向您及您的团队（${命名空间__customerCompanyName}）致以最诚挚的祝福，希望这一年里您的事业蒸蒸日上，生活幸福美满。 此致 敬礼！

   4. 内容编辑完成后，单击“保存”，再单击“启用”，启用邮件模板。

6. 返回邮件模板场景中，单击“启用”，启用模板场景。
   模板场景“状态”变为“启用”，表明模板场景启用成功。

   图16 查看模板创建状态
   

步骤三：在服务编排中调用模板发送邮件

创建一个服务编排，添加一个“调用模板”图元，实现邮件发送功能。

1. 在应用设计器的左侧导航栏中，选择“逻辑”，单击编排后的“+”。
2. 设置服务编排的标签和名称，单击“添加”。
   图17 新建服务编排
   

   表8 新建服务编排参数说明

   参数	说明	示例
   标签	服务编排的标签名，用于在界面展示，创建后可修改。 取值范围：1~64个字符。	邮件
   名称	服务编排在系统中的唯一标识，创建后不支持修改。命名要求如下： 长度不能超过64个字符，包括前缀命名空间的长度。 标识前模糊掉的内容为命名空间，在华为云Astro轻应用中为了避免不同租户间数据的重名，租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间，创建后不支持修改。 名称必须以英文字母开头，只能由英文字母、数字或单下划线组成，且不能以下划线结尾。	email

3. 创建全局上下文变量。
   1. 在服务编排设计页面，选中开始节点，单击。
   2. 在全局上下文中，单击变量后的，新建变量“variable0”。
   3. 单击“variable0”变量后的，选择“设置”。
   4. 将变量的“名称”设置为“companyName”，单击“保存”。
      图18 新建companyName变量
      
   5. 按照上述操作，创建表9中的变量。
      图19 查看已创建的变量
      

      表9 需要创建的全局上下文变量

      名称	数据类型
      companyName（已创建）	文本
      customerCompanyName	文本
      name	文本

4. 添加调用模板图元。
   1. 在“基本”中，拖拽“调用模板”图元到开始图元后。
      图20 拖拽调用模板图元到画布中
      
   2. 选中调用模板图元Template0，单击，设置调用模板。
      图21 设置调用模板图元
      

      表10 调用模板图元参数说明

      参数	说明	示例
      请选择模板场景	选择调用模板图元关联的模板场景，即1中创建的。	命名空间__notify
      请选择模板类型	选择待调用模板的类型。	邮件
      请选择文档模板	选择模板场景中创建的邮件模板，即4中创建的。	命名空间__emailModel

   3. 在“向模板传入数据”中，单击“新增行”，将3中创建的变量拖到服务编排入参中，作为服务编排的输入参数。
      图22 设置服务编排入参
      

5. 连接图元指定逻辑关系，即从开始图元连向调用模板图元。
   图23 指定图元逻辑关系
   

6. 单击页面上方的，保存服务编排。
7. 单击，进入服务编排调试页面。

   在输入参数中，输入如下内容，并单击“运行”。

   图24 调试服务编排
   

   {
       "companyName": "A公司",
       "customerCompanyName": "B公司",
       "name": "张三"
   }

   运行成功后，5中设置的邮件收件人，即可收到节日问候邮件，如图25。

   图25 节日问候邮件
   

8. 单击页面上方的，启用服务编排。