# 为华为云Astro轻应用服务编排添加调用模板图元 #### 赋值图元的作用 华为云Astro轻应用低代码平台提供了文档类模板创建能力，支持快速创建"Word文档"、"Excel文档"、"邮件"和"短信"四种类型的模板，以满足多样化的业务文档需求，提升文档的制作效率与规范性。在服务编排中，通过配置该图元，可将应用中配置的模板生成文档。 #### 如何使用调用模板图元 1. 新建模板场景。 模板场景是一个业务场景的集合，支持创建多个模板，模板间共享数据结构。模板场景创建后，可在服务编排的流程中调用。 1. 参考[登录华为云Astro轻应用应用设计器](https://support.huaweicloud.com/usermanual-astrozero/astrozero_05_9004.html)中操作，登录应用设计器。 2. 在左侧导航栏中，选择"逻辑"。 3. 在"更多"中，选择"模板"，单击"添加模板场景"。 图1选择添加模板场景 ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000002101141329.png "点击放大") 4. 输入模板的标签和名称，单击"确定"。 图2新建模板场景 ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000002072187630.png "点击放大") 表1新建模板场景参数说明 | 参数 | 说明 | |:---|:---| | 标签 | 新建模板场景的标签名，用于在页面展示。 取值范围：1\~64个字符。 | | 名称 | 输入模板场景的名称，名称是模板场景在系统中的唯一标识，创建后不可修改。命名要求如下： - 长度不能超过64个字符，包括前缀命名空间的长度。 标识前的内容为命名空间，在华为云Astro轻应用中为了避免不同租户间数据的重名，租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间，创建后不支持修改。 - 名称必须以英文字母开头，只能由英文字母、数字或单下划线组成，且不能以下划线结尾。 | | 描述 | 请根据需要在文本框中，输入对该模板场景的描述信息。 取值范围：1\~255个字符。 | 5. 在创建的模板场景中，选择"配置"页签，配置文件存储的位置，单击"保存"。 图3配置文件存储信息 ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000002276132189.png "点击放大") 表2配置参数说明 | 参数 | 说明 | |:---|:---| | 生成的文件名 | 设置基于模板生成的文件名，支持"随机字符串"和"自定义名称"两种方式。设置为"自定义名称"时，可根据自身业务需求指定生成文件的名称。 | | 文件存储 \> 连接器类型 | 文件存储的连接器类型，当前仅支持"OBS"和"MINIO"两种。在华为云Astro轻应用中，通过创建OBS、MINIO连接器，可将数据存储到OBS和MINIO中，详细介绍请参见[对接OBS云对象存储实例](https://support.huaweicloud.com/usermanual-astrozero/astrozero_05_9217.html)、[对接MINIO存储对象或资产](https://support.huaweicloud.com/usermanual-astrozero/astrozero_05_9218.html)。 | | 文件存储 \> 连接器名称 | 在华为云Astro轻应用中创建OBS或MINIO连接器的名称，可在"集成 \> 连接器 \> 连接器实例 \> 存储 \> OBS/MINIO"中查看。 | | 文件存储 \> 连接器桶名 | 创建连接器时，配置的OBS或MINIO桶名称。 | | 文件存储 \> 文件存储位置 | 指定文件在OBS或MINIO桶中的存储路径。 | | 邮件发送 \> 连接器名称 | 在华为云Astro轻应用中创建SMTP邮件服务连接器的名称，可在"集成 \> 连接器 \> 连接器实例 \> 消息通知 \> SMTP邮件服务"中查看。如何创建SMTP邮件服务连接器，请参见[对接SMTP发送邮件](https://support.huaweicloud.com/usermanual-astrozero/astrozero_05_9228.html)。 | | 短信发送 \> 连接器名称 | 在华为云Astro轻应用中创建消息通知服务SMN连接器的名称，可在"集成 \> 连接器 \> 连接器实例 \> 消息通知 \> 消息通知服务SMN"中查看。如何创建SMN连接器，请参见[对接SMN发送短信](https://support.huaweicloud.com/usermanual-astrozero/astrozero_05_9226.html)。 | 2. 为模板添加参数。 此处添加的模板参数，对应文档模板中需要替换的内容。 1. 选择"数据"页签，单击"添加"，进入添加参数页面。 2. 设置参数的相关信息，单击"保存"。 图4新建模板参数 ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000002088510522.png "点击放大") 表3新建参数说明 | 参数 | 说明 | |:---|:---| | 名称 | 新建模板参数的名称，用于在页面展示。 取值范围：1\~64个字符。 | | 唯一标识 | 输入模板参数的标识，是模板参数在系统中的唯一标识，创建后不可修改。命名要求如下： - 长度不能超过64个字符，包括前缀命名空间的长度。 名称前的内容为命名空间，在华为云Astro轻应用中为了避免不同租户间数据的重名，租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间，创建后不支持修改。 - 名称必须以英文字母开头，只能由英文字母、数字或单下划线组成，且不能以下划线结尾。 | | 数据类型 | 在下拉框中选择新建模板参数的类型，支持文本、数字、币种金额、日期和日期/时间。 设置为"基本参数"时，才会显示该配置。 | | 对象 | 选择所需的对象，创建后参数会继承该对象的结构，如[图5]所示。 设置为"对象"时，才会显示该配置。 | | 描述 | 请根据需要在文本框中，输入对该模板参数的描述信息。 取值范围：1\~255个字符。 | 图5对象参数 ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000002124449233.png "点击放大") 3. 添加模板。 在模板场景中添加多种模板，这些模板可以预置在应用中，用于发送通知或生成文档。 1. 选择"模板"页签，单击"添加"，进入添加模板页面。 2. 设置模板标签和名称，单击"确定"。 图6设置模板参数 ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000002263115792.png "点击放大") 表4新建模板参数说明 | 参数 | 说明 | |:---|:---| | 标签 | 新建模板的标签名，用于在页面展示。 取值范围：1\~64个字符。 | | 名称 | 输入模板的名称，名称是模板在系统中的唯一标识，创建后不可修改。命名要求如下： - 长度不能超过64个字符，包括前缀命名空间的长度。 名称前的内容为命名空间，在华为云Astro轻应用中为了避免不同租户间数据的重名，租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间，创建后不支持修改。 - 名称必须以英文字母开头，只能由英文字母、数字或单下划线组成，且不能以下划线结尾。 | | 描述 | 请根据需要在文本框中，输入对该模板的描述信息。 取值范围：1\~255个字符。 | | 模板类型 | 新建模板的类型，支持如下几种类型，默认为"Word文档"。 - Word文档：支持用户上传Word格式的文档模板，文档的大小建议**小于10MB**。 - Excel文档：支持用户上传Excel类型的文档模板。上传的Excel文档不能超过10个Sheet页，每个Sheet页中**列** 不能超过200个，**行** 不能超过1000个，**单元格** **内**字符串的长度不超过500个字符。 - 邮件：支持用户在模板编辑界面编写邮件模板。 - 短信：支持用户在模板编辑界面编写短信模板。 | 3. 在"模板"页签，单击已创建模板后的![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000002124443593.png)，进入文档模板页面。 4. 根据[3.b]中设置的模板类型，设置相关参数。 - "模板类型"设置为"Word文档"时，单击"点击上传"，选择本地待上传的Word文档，查看上传后效果。 上传的Word文档必须为"**docx** "类型，且文档的大小建议**小于10M** **B** 。文档中如果有动态数据（变量），请使用"**${*参数*}** "来定义，生成文档内容时会将这些参数替换为对应数据的实际值。 图7上传Word文档 ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000002282673013.png "点击放大") - "模板类型"设置为"Excel文档"时，单击"点击上传"，选择本地待上传的Excel文档，查看上传后效果。 上传的Excel文档必须为**"xlsx"** 格式，且不能超过10个Sheet页，每个Sheet页中**列** 不能超过200个，**行** 不能超过1000个，**单元格** **内** 字符串的长度不超过500个字符。文档中如果有动态数据（变量），请使用**"${** ***参数*}"**来定义，生成文档内容时会将这些参数替换为对应数据的实际值。 图8上传Excel文档 ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000002247794166.png "点击放大") - "模板类型"设置为"邮件"时，单击"编辑"，设置邮件内容，单击"保存"。 图9设置邮件内容 ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000002263362548.png "点击放大") 表5设置邮件参数说明 | 参数 | 说明 | |:---|:---| | 收件人 | 邮件的收件人地址，长度不能超过4096个字符，涉及多个地址时请使用**英文";"**隔开。 | | 抄送 | 邮件的抄送人地址，长度不能超过4096个字符，涉及多个地址时请使用**英文";"**隔开。 | | 密送 | 邮件的密送人地址，长度不能超过4096个字符，涉及多个地址时请使用**英文";"**隔开。 | | 主题 | 邮件的主题，长度不能超过4096个字符。 | | 邮件内容 | 待发送邮件的具体内容，长度不能超过4096个字符。邮件内容尽量简洁明了、逻辑清晰，确保信息能准确传达。 | - "模板类型"设置为"短信"时，单击"编辑"，设置短信内容，单击"保存"。 图10设置短信内容 ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000002282673017.png "点击放大") 表6设置短信内容 | 参数 | 说明 | |:---|:---| | 收件人号码 | 收件人的手机号码，长度不能超过4096个字符。 | | 短信内容 | 发送的短信内容。 | 5. 预览符合预期后，单击页面右上方的"启用"，启用文档模板。 6. 返回文档模板场景中，单击"启用"，启用模板场景。 4. 使用调用模板图元。 1. 在服务编排设计页面，从基本中拖拽"调用模板"图元至画布中。 2. 选中调用模板图元，单击![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000002108066721.png)，设置基本信息。 表7基本信息参数说明 | 参数 | 说明 | |:---|:---| | 标签 | 设置图元的标签，用于在服务编排设计页面展示。系统会自动填入该值，格式为Template*序号*，序号从"0"开始，表示同类型图元序号。 | | 名称 | 设置图元的名称，名称为图元在服务编排中的标识，请确保在当前服务编排中唯一。命名要求如下： - 长度范围为1\~80个字符。 - 必须以英文字母开头，由英文字母，数字或单下划线组成，且不能以下划线结尾。 | | 描述 | 请根据实际需求，在输入框中输入图元的描述信息。 取值范围：1\~255个字符。 | 3. 单击![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000002072308144.png)，设置调用模板。 图11调用模板设置 ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000002282831477.png "点击放大") 表8调用模板图元设置说明 | 参数 | 说明 | |:---|:---| | 请选择模板场景 | 选择调用模板图元关联的模板场景，即[1]中创建的。 | | 请选择文档模板 | 选择模板场景中创建的文档模板，即[3]中创建的。 | | 连接器类型 | 保存生成文档的连接器类型，支持保存到默认空间（即[1.e]中创建模板场景时指定的连接器类型）或者重新设置。 | | 连接器名称 | 保存生成文档的连接器名称，支持保存到默认空间（即[1.e]中创建模板场景时指定的连接器名称）或者重新设置。 | | 连接器桶名 | 保存生成文档的连接器类型，支持保存到默认空间（即[1.e]中创建模板场景时指定的连接器桶名）或者重新设置。 | | 文件存储位置 | 生成文档存储的位置，支持保存到默认空间（即[1.e]中创建模板场景时指定的文件存储位置）或者重新设置。 | | 向模板传入数据 | 向模板中传入数据，将入参变量一次赋值给对应的模板参数。 | | 文档保存地址 | 将文档保存地址分配到变量中，便于在服务编排中引用。 | #### 相关文档 - [使用华为云Astro轻应用文件模板生成合同文档](https://support.huaweicloud.com/bestpractice-astrozero/astrozero_bestpractice_0015.html) - [使用华为云Astro轻应用邮件模板发送邮件通知](https://support.huaweicloud.com/bestpractice-astrozero/astrozero_bestpractice_0029.html)