为华为云Astro轻应用服务编排添加调用模板图元

赋值图元的作用

华为云Astro轻应用低代码平台提供了文档类模板创建能力，支持快速创建“Word文档”、“Excel文档”、“邮件”和“短信”四种类型的模板，以满足多样化的业务文档需求，提升文档的制作效率与规范性。在服务编排中，通过配置该图元，可将应用中配置的模板生成文档。如何端到端的使用模板生成文档，请参见模板专项。

如何使用调用模板图元

1. 新建模板场景。
   模板场景是一个业务场景的集合，支持创建多个模板，模板间共享数据结构。模板场景创建后，可在服务编排的流程中调用。

   1. 参考登录华为云Astro轻应用应用设计器中操作，登录应用设计器。
   2. 在左侧导航栏中，选择“逻辑”。
   3. 在“更多”中，选择“模板”，单击“添加模板场景”。
      图1 选择添加模板场景
      
   4. 输入模板的标签和名称，单击“确定”。
      图2 新建模板场景
      

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

      参数	说明
      标签	新建模板场景的标签名，用于在页面展示。 取值范围：1~64个字符。
      名称	输入模板场景的名称，名称是模板场景在系统中的唯一标识，创建后不可修改。命名要求如下： 长度不能超过64个字符，包括前缀命名空间的长度。 标识前的内容为命名空间，在华为云Astro轻应用中为了避免不同租户间数据的重名，租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间，创建后不支持修改。 名称必须以英文字母开头，只能由英文字母、数字或单下划线组成，且不能以下划线结尾。
      描述	请根据需要在文本框中，输入对该模板场景的描述信息。 取值范围：1~255个字符。

   5. 在创建的模板场景中，选择“配置”页签，配置文件存储的位置，单击“保存”。
      图3 配置文件存储信息
      

      表2 配置参数说明

      参数	说明
      生成的文件名	设置基于模板生成的文件名，支持“随机字符串”和“自定义名称”两种方式。设置为“自定义名称”时，可根据自身业务需求指定生成文件的名称。
      文件存储 > 连接器类型	文件存储的连接器类型，当前仅支持“OBS”和“MINIO”两种。
      文件存储 > 连接器名称	在华为云Astro轻应用中创建OBS或MINIO连接器的名称，可在“集成 > 连接器 > 连接器实例 > 存储 > OBS/MINIO”中查看。
      文件存储 > 连接器桶名	创建连接器时，配置的OBS或MINIO桶名称。
      文件存储 > 文件存储位置	指定文件在OBS或MINIO桶中的存储路径。
      邮件发送 > 连接器名称	在华为云Astro轻应用中创建SMTP邮件服务连接器的名称，可在“集成 > 连接器 > 连接器实例 > 消息通知 > SMTP邮件服务”中查看。如何创建SMTP邮件服务连接器，请参见对接SMTP发送邮件。
      短信发送 > 连接器名称	在华为云Astro轻应用中创建消息通知服务SMN连接器的名称，可在“集成 > 连接器 > 连接器实例 > 消息通知 > 消息通知服务SMN”中查看。如何创建SMN连接器，请参见对接SMN发送短信。

2. 为模板添加参数。
   此处添加的模板参数，对应文档模板中需要替换的内容。

   1. 选择“数据”页签，单击“添加”，进入添加参数页面。
   2. 设置参数的相关信息，单击“保存”。
      图4 新建模板参数
      

      表3 新建参数说明

      参数	说明
      名称	新建模板参数的名称，用于在页面展示。 取值范围：1~64个字符。
      唯一标识	输入模板参数的标识，是模板参数在系统中的唯一标识，创建后不可修改。命名要求如下： 长度不能超过64个字符，包括前缀命名空间的长度。 名称前的内容为命名空间，在华为云Astro轻应用中为了避免不同租户间数据的重名，租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间，创建后不支持修改。 名称必须以英文字母开头，只能由英文字母、数字或单下划线组成，且不能以下划线结尾。
      数据类型	在下拉框中选择新建模板参数的类型，支持文本、数字、币种金额、日期和日期/时间。 设置为“基本参数”时，才会显示该配置。
      对象	选择所需的对象，创建后参数会继承该对象的结构，如图5所示。 设置为“对象”时，才会显示该配置。
      描述	请根据需要在文本框中，输入对该模板参数的描述信息。 取值范围：1~255个字符。

      图5 对象参数
      

3. 添加模板。

   在模板场景中添加多种模板，这些模板可以预置在应用中，用于发送通知或生成文档。

   1. 选择“模板”页签，单击“添加”，进入添加模板页面。
   2. 设置模板标签和名称，单击“确定”。
      图6 设置模板参数
      

      表4 新建模板参数说明

      参数	说明
      标签	新建模板的标签名，用于在页面展示。 取值范围：1~64个字符。
      名称	输入模板的名称，名称是模板在系统中的唯一标识，创建后不可修改。命名要求如下： 长度不能超过64个字符，包括前缀命名空间的长度。 名称前的内容为命名空间，在华为云Astro轻应用中为了避免不同租户间数据的重名，租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间，创建后不支持修改。 名称必须以英文字母开头，只能由英文字母、数字或单下划线组成，且不能以下划线结尾。
      描述	请根据需要在文本框中，输入对该模板的描述信息。 取值范围：1~255个字符。
      模板类型	新建模板的类型，支持如下几种类型，默认为“Word文档”。 Word文档：支持用户上传Word格式的文档模板，文档的大小建议小于10MB。 Excel文档：支持用户上传Excel类型的文档模板。上传的Excel文档不能超过10个Sheet页，每个Sheet页中列不能超过200个，行不能超过1000个，单元格内字符串的长度不超过500个字符。 邮件：支持用户在模板编辑界面编写邮件模板。 短信：支持用户在模板编辑界面编写短信模板。

   3. 在“模板”页签，单击已创建模板后的，进入文档模板页面。
   4. 根据3.b中设置的模板类型，设置相关参数。
      • “模板类型”设置为“Word文档”时，单击“点击上传”，选择本地待上传的Word文档，查看上传后效果。
        上传的Word文档必须为“docx”类型，且文档的大小建议小于10MB。文档中如果有动态数据（变量），请使用“${参数}”来定义，生成文档内容时会将这些参数替换为对应数据的实际值。

        图7 上传Word文档
        

        • “模板类型”设置为“Excel文档”时，单击“点击上传”，选择本地待上传的Excel文档，查看上传后效果。

          上传的Excel文档必须为“xlsx”格式，且不能超过10个Sheet页，每个Sheet页中列不能超过200个，行不能超过1000个，单元格内字符串的长度不超过500个字符。文档中如果有动态数据（变量），请使用“${参数}”来定义，生成文档内容时会将这些参数替换为对应数据的实际值。

          图8 上传Excel文档
          
        • “模板类型”设置为“邮件”时，单击“编辑”，设置邮件内容，单击“保存”。
          图9 设置邮件内容
          

          表5 设置邮件参数说明

          参数	说明
          收件人	邮件的收件人地址，长度不能超过4096个字符，涉及多个地址时请使用英文“;”隔开。
          抄送	邮件的抄送人地址，长度不能超过4096个字符，涉及多个地址时请使用英文“;”隔开。
          密送	邮件的密送人地址，长度不能超过4096个字符，涉及多个地址时请使用英文“;”隔开。
          主题	邮件的主题，长度不能超过4096个字符。
          邮件内容	待发送邮件的具体内容，长度不能超过4096个字符。邮件内容尽量简洁明了、逻辑清晰，确保信息能准确传达。

        • “模板类型”设置为“短信”时，单击“编辑”，设置短信内容，单击“保存”。
          图10 设置短信内容
          

          表6 设置短信内容

          参数	说明
          收件人号码	收件人的手机号码，长度不能超过4096个字符。
          短信内容	发送的短信内容。

   5. 预览符合预期后，单击页面右上方的“启用”，启用文档模板。
   6. 返回文档模板场景中，单击“启用”，启用模板场景。

4. 使用调用模板图元。
   1. 在服务编排设计页面，从基本中拖拽“调用模板”图元至画布中。
   2. 选中调用模板图元，单击，设置基本信息。

      表7 基本信息参数说明

      参数	说明
      标签	设置图元的标签，用于在服务编排设计页面展示。系统会自动填入该值，格式为Template序号，序号从“0”开始，表示同类型图元序号。
      名称	设置图元的名称，名称为图元在服务编排中的标识，请确保在当前服务编排中唯一。命名要求如下： 长度范围为1~80个字符。 必须以英文字母开头，由英文字母，数字或单下划线组成，且不能以下划线结尾。
      描述	请根据实际需求，在输入框中输入图元的描述信息。 取值范围：1~255个字符。

   3. 单击，设置调用模板。
      图11 调用模板设置
      

      表8 调用模板图元设置说明

      参数	说明
      请选择模板场景	选择调用模板图元关联的模板场景，即1中创建的。
      请选择文档模板	选择模板场景中创建的文档模板，即3中创建的。
      连接器类型	保存生成文档的连接器类型，支持保存到默认空间（即1.e中创建模板场景时指定的连接器类型）或者重新设置。
      连接器名称	保存生成文档的连接器名称，支持保存到默认空间（即1.e中创建模板场景时指定的连接器名称）或者重新设置。
      连接器桶名	保存生成文档的连接器类型，支持保存到默认空间（即1.e中创建模板场景时指定的连接器桶名）或者重新设置。
      文件存储位置	生成文档存储的位置，支持保存到默认空间（即1.e中创建模板场景时指定的文件存储位置）或者重新设置。
      向模板传入数据	向模板中传入数据，将入参变量一次赋值给对应的模板参数。
      文档保存地址	将文档保存地址分配到变量中，便于在服务编排中引用。

相关文档

• 使用华为云Astro轻应用文件模板生成合同文档
• 使用华为云Astro轻应用邮件模板发送邮件通知