网络
虚拟私有云 VPC
弹性公网IP EIP
弹性负载均衡 ELB
NAT网关 NAT
云专线 DC
虚拟专用网络 VPN
云连接 CC
VPC终端节点 VPCEP
企业路由器 ER
企业交换机 ESW
全球加速 GA
企业连接 EC
云原生应用网络 ANC
安全与合规
安全技术与应用
Web应用防火墙 WAF
企业主机安全 HSS
云防火墙 CFW
安全云脑 SecMaster
DDoS防护 AAD
数据加密服务 DEW
数据库安全服务 DBSS
云堡垒机 CBH
数据安全中心 DSC
云证书管理服务 CCM
威胁检测服务 MTD
态势感知 SA
认证测试中心 CTC
边缘安全 EdgeSec
应用中间件
微服务引擎 CSE
分布式消息服务Kafka版
分布式消息服务RabbitMQ版
分布式消息服务RocketMQ版
API网关 APIG
分布式缓存服务 DCS
多活高可用服务 MAS
事件网格 EG
管理与监管
统一身份认证服务 IAM
消息通知服务 SMN
云监控服务 CES
应用运维管理 AOM
应用性能管理 APM
云日志服务 LTS
云审计服务 CTS
标签管理服务 TMS
配置审计 Config
应用身份管理服务 OneAccess
资源访问管理 RAM
组织 Organizations
资源编排服务 RFS
优化顾问 OA
IAM 身份中心
云运维中心 COC
资源治理中心 RGC
解决方案
高性能计算 HPC
SAP
混合云灾备
开天工业工作台 MIW
Haydn解决方案工厂
数字化诊断治理专家服务
云生态
云商店
合作伙伴中心
华为云开发者学堂
华为云慧通差旅
开发与运维
软件开发生产线 CodeArts
需求管理 CodeArts Req
流水线 CodeArts Pipeline
代码检查 CodeArts Check
编译构建 CodeArts Build
部署 CodeArts Deploy
测试计划 CodeArts TestPlan
制品仓库 CodeArts Artifact
移动应用测试 MobileAPPTest
CodeArts IDE Online
开源镜像站 Mirrors
性能测试 CodeArts PerfTest
应用管理与运维平台 ServiceStage
云应用引擎 CAE
开源治理服务 CodeArts Governance
华为云Astro轻应用
CodeArts IDE
Astro工作流 AstroFlow
代码托管 CodeArts Repo
漏洞管理服务 CodeArts Inspector
联接 CodeArtsLink
软件建模 CodeArts Modeling
Astro企业应用 AstroPro
CodeArts盘古助手
华为云Astro大屏应用
计算
弹性云服务器 ECS
Flexus云服务
裸金属服务器 BMS
云手机服务器 CPH
专属主机 DeH
弹性伸缩 AS
镜像服务 IMS
函数工作流 FunctionGraph
云耀云服务器(旧版)
VR云渲游平台 CVR
Huawei Cloud EulerOS
云化数据中心 CloudDC
网络
虚拟私有云 VPC
弹性公网IP EIP
弹性负载均衡 ELB
NAT网关 NAT
云专线 DC
虚拟专用网络 VPN
云连接 CC
VPC终端节点 VPCEP
企业路由器 ER
企业交换机 ESW
全球加速 GA
企业连接 EC
云原生应用网络 ANC
CDN与智能边缘
内容分发网络 CDN
智能边缘云 IEC
智能边缘平台 IEF
CloudPond云服务
安全与合规
安全技术与应用
Web应用防火墙 WAF
企业主机安全 HSS
云防火墙 CFW
安全云脑 SecMaster
DDoS防护 AAD
数据加密服务 DEW
数据库安全服务 DBSS
云堡垒机 CBH
数据安全中心 DSC
云证书管理服务 CCM
威胁检测服务 MTD
态势感知 SA
认证测试中心 CTC
边缘安全 EdgeSec
大数据
MapReduce服务 MRS
数据湖探索 DLI
表格存储服务 CloudTable
可信智能计算服务 TICS
推荐系统 RES
云搜索服务 CSS
数据可视化 DLV
数据接入服务 DIS
数据仓库服务 GaussDB(DWS)
数据治理中心 DataArts Studio
湖仓构建 LakeFormation
智能数据洞察 DataArts Insight
应用中间件
微服务引擎 CSE
分布式消息服务Kafka版
分布式消息服务RabbitMQ版
分布式消息服务RocketMQ版
API网关 APIG
分布式缓存服务 DCS
多活高可用服务 MAS
事件网格 EG
开天aPaaS
应用平台 AppStage
开天企业工作台 MSSE
开天集成工作台 MSSI
API中心 API Hub
云消息服务 KooMessage
交换数据空间 EDS
云地图服务 KooMap
云手机服务 KooPhone
组织成员账号 OrgID
云空间服务 KooDrive
管理与监管
统一身份认证服务 IAM
消息通知服务 SMN
云监控服务 CES
应用运维管理 AOM
应用性能管理 APM
云日志服务 LTS
云审计服务 CTS
标签管理服务 TMS
配置审计 Config
应用身份管理服务 OneAccess
资源访问管理 RAM
组织 Organizations
资源编排服务 RFS
优化顾问 OA
IAM 身份中心
云运维中心 COC
资源治理中心 RGC
区块链
区块链服务 BCS
数字资产链 DAC
华为云区块链引擎服务 HBS
解决方案
高性能计算 HPC
SAP
混合云灾备
开天工业工作台 MIW
Haydn解决方案工厂
数字化诊断治理专家服务
价格
成本优化最佳实践
专属云商业逻辑
云生态
云商店
合作伙伴中心
华为云开发者学堂
华为云慧通差旅
其他
管理控制台
消息中心
产品价格详情
系统权限
客户关联华为云合作伙伴须知
公共问题
宽限期保留期
奖励推广计划
活动
云服务信任体系能力说明
开发与运维
软件开发生产线 CodeArts
需求管理 CodeArts Req
流水线 CodeArts Pipeline
代码检查 CodeArts Check
编译构建 CodeArts Build
部署 CodeArts Deploy
测试计划 CodeArts TestPlan
制品仓库 CodeArts Artifact
移动应用测试 MobileAPPTest
CodeArts IDE Online
开源镜像站 Mirrors
性能测试 CodeArts PerfTest
应用管理与运维平台 ServiceStage
云应用引擎 CAE
开源治理服务 CodeArts Governance
华为云Astro轻应用
CodeArts IDE
Astro工作流 AstroFlow
代码托管 CodeArts Repo
漏洞管理服务 CodeArts Inspector
联接 CodeArtsLink
软件建模 CodeArts Modeling
Astro企业应用 AstroPro
CodeArts盘古助手
华为云Astro大屏应用
存储
对象存储服务 OBS
云硬盘 EVS
云备份 CBR
高性能弹性文件服务 SFS Turbo
弹性文件服务 SFS
存储容灾服务 SDRS
云硬盘备份 VBS
云服务器备份 CSBS
数据快递服务 DES
云存储网关 CSG
专属分布式存储服务 DSS
数据工坊 DWR
地图数据 MapDS
键值存储服务 KVS
容器
云容器引擎 CCE
云容器实例 CCI
容器镜像服务 SWR
云原生服务中心 OSC
应用服务网格 ASM
华为云UCS
数据库
云数据库 RDS
数据复制服务 DRS
文档数据库服务 DDS
分布式数据库中间件 DDM
云数据库 GaussDB
云数据库 GeminiDB
数据管理服务 DAS
数据库和应用迁移 UGO
云数据库 TaurusDB
人工智能
AI开发平台ModelArts
华为HiLens
图引擎服务 GES
图像识别 Image
文字识别 OCR
自然语言处理 NLP
内容审核 Moderation
图像搜索 ImageSearch
医疗智能体 EIHealth
企业级AI应用开发专业套件 ModelArts Pro
人脸识别服务 FRS
对话机器人服务 CBS
语音交互服务 SIS
人证核身服务 IVS
视频智能分析服务 VIAS
城市智能体
自动驾驶云服务 Octopus
盘古大模型 PanguLargeModels
IoT物联网
设备接入 IoTDA
全球SIM联接 GSL
IoT数据分析 IoTA
路网数字化服务 DRIS
IoT边缘 IoTEdge
设备发放 IoTDP
企业应用
域名注册服务 Domains
云解析服务 DNS
企业门户 EWP
ICP备案
商标注册
华为云WeLink
华为云会议 Meeting
隐私保护通话 PrivateNumber
语音通话 VoiceCall
消息&短信 MSGSMS
云管理网络
SD-WAN 云服务
边缘数据中心管理 EDCM
云桌面 Workspace
应用与数据集成平台 ROMA Connect
ROMA资产中心 ROMA Exchange
API全生命周期管理 ROMA API
政企自服务管理 ESM
视频
实时音视频 SparkRTC
视频直播 Live
视频点播 VOD
媒体处理 MPC
视频接入服务 VIS
数字内容生产线 MetaStudio
迁移
主机迁移服务 SMS
对象存储迁移服务 OMS
云数据迁移 CDM
迁移中心 MGC
专属云
专属计算集群 DCC
开发者工具
SDK开发指南
API签名指南
DevStar
华为云命令行工具服务 KooCLI
Huawei Cloud Toolkit
CodeArts API
云化转型
云架构中心
云采用框架
用户服务
账号中心
费用中心
成本中心
资源中心
企业管理
工单管理
客户运营能力
国际站常见问题
支持计划
专业服务
合作伙伴支持计划
我的凭证
华为云公共事业服务云平台
工业软件
工业数字模型驱动引擎
硬件开发工具链平台云服务
工业数据转换引擎云服务
文档首页/ 华为云Astro轻应用/ 最佳实践/ 模板专项/ 使用AstroZero文件模板生成合同文档

使用AstroZero文件模板生成合同文档

更新时间:2025-01-02 GMT+08:00
分享

应用场景

AstroZero低代码平台提供了一个文件模板功能,基于该功能开发者可以根据不同客户设置不同类型的打印模板。例如,用户在商品订单管理系统中,基于商品、价格等信息,自动生成了商品订单列表。在处理完自己的订单后,可以使用模板功能将订单信息同步到合同模板中,生成合同文档,用于签订线下合同。同样,在财务领域,可以使用文档模板来生成定制化的发票和收据。对于需要发送正式邀请的场合,文档模板可以用来创建和打印专业的商务信函。

方案优势

用户可以在服务编排中,通过拖、拉、拽的方式调用文档模板节点、配置模板的输入输出参数,用于生成具体的文档。同时可以将该服务编排包装成开放接口供第三方使用,也可以在AstroZero的标准页面中直接调用供业务用户下载。

约束与限制

用户上传Word文档后(文档中包含使用${参数}定义的文本类型的变量),只能预览该文档模板或生成具体的文档,不能直接在界面上对其进行修改。如果需要,只能在本地更改Word模板样式后重新上传。

目前模板功能只支持生成docx类型的文档模板,并且只支持文本类的变量替换,无法动态替换二维码、图片等内容。

操作流程

在AstroZero中,通过文件模板生成具体合同文档的操作流程,如图1所示。

图1 使用文件模板生成合同文档操作流程

步骤一:创建文档模板场景并配置模板

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

  1. 创建一个低代码应用。

    1. 参考授权用户使用AstroZero并购买实例中操作,申请AstroZero免费试用或购买商业实例。
    2. 实例购买后,在AstroZero服务控制台的“主页”中,单击“进入首页”,进入应用开发页面。
    3. “应用”中,单击“新建低代码应用”或单击,进入新建低代码应用页面。
    4. 在新建低代码应用页面,应用类型选择“标准应用”,单击“确定”
    5. 输入应用的标签和名称,单击“新建”,即可进入应用设计器。
      图2 创建一个空白应用
      表1 新建空白应用参数说明

      参数

      说明

      示例

      标签

      新建应用的标签,长度不能超过80个字符。标签是应用在系统中的唯一标识,创建后不支持修改。

      我的第一个应用

      名称

      新建应用的名称,输入标签值后单击该参数的输入框,系统会自动生成应用的名称,同时自动在名称前,添加命名空间__。命名要求如下:

      • 长度不能超过31个字符,包括前缀命名空间的长度。

        名称前的内容为命名空间,在AstroZero中为了避免不同租户间数据的重名,租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间,创建后不支持修改。

      • 必须以英文字母开头,只能由英文字母、数字或单下划线组成,且不允许以下划线结尾。

      A

  2. 创建文件模板场景。

    1. 在应用设计器的左侧导航栏中,选择“逻辑”,单击更多 > 模板
      图3 单击模板
    2. 单击“添加模板场景”,设置模板场景的标签和名称,单击“确定”
      图4 创建模板场景
      表2 新建模板场景参数说明

      参数

      说明

      示例

      标签

      新建模板场景的名称,创建后可修改。

      取值范围:1~80个字符。

      文档模板

      名称

      新建模板场景在系统中的标识,创建后不支持修改。命名要求如下:

      • 长度不能超过64个字符,包括前缀命名空间的长度。

        标识前模糊掉的内容为命名空间,在AstroZero中为了避免不同租户间数据的重名,租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间,创建后不支持修改。

      • 必须以英文字母开头,只能由英文字母,数字和下划线组成,且不能以下划线结尾。

      docModel

  3. “配置”页签,设置模板文件的存储位置,单击“保存”

    图5 设置文件存储
    表3 文件存储参数说明

    参数

    说明

    示例

    连接器类型

    文件存储的连接器类型,当前仅支持“OBS”“MINIO”两种。在AtroZero中,通过创建OBS、MINIO连接器,可将数据存储到OBS和MINIO中,详细介绍请参见对接OBS云对象存储实例对接MINIO存储AstroZero对象或资产

    OBS

    连接器名称

    在AstroZero中创建OBS或MINIO连接器的名称,可在集成 > 连接器 > 连接器实例 > 存储 > OBS/MINIO中查看。

    命名空间__OBS_Connector

    连接器桶名

    创建连接器时,配置的OBS或MINIO桶名称。如何查看OBS桶信息,请参见查看桶信息

    template-obs

    文件存储位置

    指定文件在OBS或MINIO桶中的存储路径。

    docTemplate

  4. “模板”页签,单击“添加”,创建合同模板。

    图6 新建合同模板
    表4 新建模板参数说明

    参数

    说明

    示例

    标签

    新建模板的名称,创建后可修改。

    取值范围:1~80个字符。

    合同档模板

    名称

    新建模板在系统中的标识,创建后不支持修改。命名要求如下:

    • 长度不能超过63个字符,包括前缀命名空间的长度。

      标识前模糊掉的内容为命名空间,在AstroZero中为了避免不同租户间数据的重名,租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间,创建后不支持修改。

    • 必须以英文字母开头,只能由英文字母,数字和下划线组成,且不能以下划线结尾。

    contractModel

  5. “数据”页签,为合同文档模板添加表5中参数。

    此处添加的模板参数,对应文档模板中需要替换的内容。
    图7 为合同模板添加公司名称参数
    表5 待添加参数

    名称

    唯一标识

    数据类型

    公司名称

    companyName

    文本

    合同金额

    amount

    数字

    订单数目

    orderNum

    数字

    合同签订人

    person

    文本

    合同日期

    date

    日期

    合同名称

    contractName

    文本

    乙方公司名称

    otherCompanyName

    文本

  6. 上传文档模板。

    1. “模板”页签,单击4中创建模板后的,进入合同文档模板页面。
      图8 进入模板编辑页面
    2. 单击“点击上传”,选择本地待上传的word文档,查看上传后效果。
      说明:

      上传操作执行成功后,在3中配置的OBS桶中可查看到已上传的word文档,如图11所示。

      图9 上传word文档
      图10 查看文档上传后效果
      图11 在OBS桶中查看文档是否上传

      本实践中待上传的word文档内容如下,实际使用时请根据自身的业务需求进行上传。

                                       ${命名空间__contractName}
       
      第一条合同目的
      本合同旨在规定${命名空间__companyName} 向乙方购买商品/服务的具体条款和条件。
       
      第二条商品/服务描述
      商品/服务的详细描述,包括但不限于型号、规格、数量、单价等。
      订单数目:${命名空间__orderNum}
       
      第三条价格条款
      商品/服务的总额为 ${命名空间__amount} 元。
       
      第四条质量保证
      乙方保证所提供的商品/服务符合约定的质量标准
       
      第五条违约责任
      如一方违反合同条款,违约方应赔偿对方因此遭受的所有损失。
       
      第六条生效条件
      本合同自双方授权代表签字盖章之日起生效。
       
      甲方:${命名空间__companyName}
      乙方:${命名空间__otherCompanyName}
       
      合同签订人:${命名空间__person}
      日期:${命名空间__date}
    3. 单击页面右上方的“预览”,输入参数,预览效果。

      例如,在“输入参数”中输入如下模板参数,查看合同中对应参数是否被替换。

      {
          "命名空间__contractName": "买卖合同",
          "命名空间__companyName": "xx有限公司"
      }
      图12 合同中参数已被替换
    4. 预览符合预期后,单击页面右上方的“启用”,启用文档模板。

  7. 返回文档模板场景中,单击“启用”,启用模板场景。

    图13 启用模板场景

步骤二:创建对象存储模板中内容和模板实例

创建一个对象并在对象中添加字段,用于存储文档模板中的内容和后续生成的模板实例。

  1. 在应用设计器的左侧导航栏中,选择“数据”,单击对象中的“+”
  2. 设置对象的名称和唯一标识,单击“确定”

    图14 创建对象docObject
    表6 新建docObject对象参数说明

    参数

    说明

    示例

    对象名称

    新建对象的名称,创建后可修改。

    取值范围:1~80个字符。

    文档模板对象

    唯一标识

    新建对象在系统中的标识,创建后不支持修改。命名要求如下:

    • 长度不能超过63个字符,包括前缀命名空间的长度。

      标识前模糊掉的内容为命名空间,在AstroZero中为了避免不同租户间数据的重名,租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间,创建后不支持修改。

    • 必须以英文字母开头,只能由英文字母,数字和下划线组成,且不能以下划线结尾。

    docObject

  3. 在已创建的对象中,单击,进入对象详情页面。

    图15 选择编辑按钮

  4. “字段”页签,单击“添加”,为对象添加companyName字段。

    图16 添加companyName字段
    表7 添加companyName字段参数说明

    参数

    说明

    示例

    显示名称

    新建字段的名称,创建后可修改。

    取值范围:1~63个字符。

    公司名称

    唯一标识

    新建字段在系统中的标识,创建后不支持修改。命名要求如下:

    • 长度不能超过63个字符,包括前缀命名空间的长度。
    • 必须以英文字母开头,只能由英文字母,数字和单下划线组成,且不能以下划线结尾。

    companyName

    字段类型

    单击,在弹出的页面中,根据页面提供的参数解释,选择新建字段所属的类型。

    文本

    数据长度

    允许输入字段的长度。

    64

  5. 按照上述操作,为对象继续添加表8中字段。

    图17 查看对象中字段
    表8 待添加对象字段

    名称

    唯一标识

    数据类型

    公司名称(已添加)

    companyName

    文本

    合同金额

    amount

    数字

    订单数目

    orderNum

    数字

    合同签订人

    person

    文本

    合同日期

    date

    日期

    合同名称

    contractName

    文本

    乙方公司名称

    otherCompanyName

    文本

    合同模板实例

    modedoc

    文本(数据长度设置为255)

步骤三:创建服务编排生成文档

创建一个服务编排,添加“生成文档”“记录创建”两个图元,用于根据合同中参数创建具体的文档。

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

    图18 新建服务编排
    表9 新建服务编排参数说明

    参数

    说明

    示例

    标签

    服务编排的标签名,用于在界面展示,创建后可修改。

    取值范围:1~64个字符。

    根据合同模板创建具体文档实例

    名称

    服务编排在系统中的唯一标识,创建后不支持修改。命名要求如下:

    • 长度不能超过64个字符,包括前缀命名空间的长度。

      标识前模糊掉的内容为命名空间,在AstroZero中为了避免不同租户间数据的重名,租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间,创建后不支持修改。

    • 名称必须以英文字母开头,只能由英文字母、数字或单下划线组成,且不能以下划线结尾。

    docFlow

  3. 创建全局上下文变量。

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

      名称

      数据类型

      companyName(已创建)

      文本

      amount

      数字

      orderNum

      数字

      person

      文本

      date

      日期

      contractName

      文本

      otherCompanyName

      文本

      modedoc

      文本

    6. 选中开始节点,设置节点的输入参数和输出参数。
      图21 设置入参和出参

  4. 添加生成文档节点。

    1. “基本”图元中,拖拽“生成文档”图元到开始图元后。
      图22 拖拽生成文档图元到画布中
    2. 选中生成文档图元,单击,设置生成文档。
      图23 设置生成文档图元
      表11 生成文档图元设置说明

      参数

      说明

      示例

      请选择模板场景

      选择生成文档图元关联的模板场景,即2中创建的。

      命名空间__docModel

      请选择文档模板

      选择模板场景中创建的文档模板,即4中创建的。

      命名空间__docModel

      连接器类型

      根据选择的文档模板自动进行关联。

      OBS

      连接器名称

      根据选择的文档模板自动进行关联。

      命名空间__OBS_Connector

      连接器桶名

      根据选择的文档模板自动进行关联。

      template-obs

      向模板传入数据

      向模板中传入数据,将入参变量一次赋值给对应的模板参数。

      3中创建的变量

      文档保存地址

      将出参modelDoc变量放入文档保存地址,用于存放生成的文档名。

      modedoc

  5. 添加创建记录节点。

    1. “基本”图元中,拖拽“记录创建”图元到“生成文档”图元后。
      图24 添加记录创建图元
    2. 选中记录创建图元,单击,将入参、出参变量都存入步骤二:创建对象存储模板中内容和模板实例中创建的对象中。
      图25 记录创建设置

  6. 连接图元指定逻辑关系,即从开始图元连向生成文档图元,从生成文档图元连向记录创建图元。

    图26 指定图元逻辑关系

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

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

    {
        "companyName": "A公司",
        "amount": "10",
        "orderNum": "2",
        "person": "张三",
        "date": "2024-11-05",
        "contractName": "新采购合同",
        "otherCompanyName": "B公司"
    }

    执行成功后,提示如下信息。登录OBS服务控制台,在3中配置的路径下会生成图27中的合同文档。将合同文档下载到本地,查看合同中内容,如图29所示,可发现合同中的内容已被替换。

    图27 服务编排执行成功
    图28 查看新生成的合同文档
    图29 查看合同内容

  9. 单击页面上方的,启用服务编排。

步骤四:创建下载文档的脚本

创建一个脚本,用于根据文档名下载OBS桶中生成的合同文档。

  1. 在应用设计器的左侧导航栏中,选择“逻辑”,单击脚本后的“+”
  2. 新建一个空白的脚本,名称设置为“docScript”,单击“添加”

    图30 创建脚本docScript

  3. 在脚本编辑器中,输入示例代码。

    本示例代码主要用于下载文档,示例中的“命名空间__OBS_Connector”3中配置的连接器名称,“docTemplate”3中配置的文件存储位置。

    import * as context from 'context';//导入上下文相关的标准库
    import * as objectstorage from 'objectstorage';
    
    
    //定义入参结构
    @action.object({ type: "param" })
    export class ActionInput {
        @action.param({ type: 'String', required: true, label: 'String' })
        docName: string;
    }
    //定义出参结构
    @action.object({ type: "param" })
    export class ActionOutput {
        @action.param({ type: 'Any' })
        buf: any;
    }
    
    @action.object({ type: "method" })
    export class CreateWorkOrder {    //定义接口类,接口的入参为ActionInput,出参为ActionOutput
        @action.method({ input: 'ActionInput', output: 'ActionOutput' })
        public createWorkOrder(input: ActionInput): ActionOutput {
            let out = new ActionOutput();    //新建出参ActionOutput类型的实例,作为返回值
            let error = new Error();    //新建错误类型的实例,用于在发生错误时保存错误信息
            try {
                // OBS桶路径,和模板配置中的一致
                let path = "docTemplate/";
                // 调用连接器下载,NS1__OBS_Connector为调用连接器名称
                let obsCli = objectstorage.newClient(objectstorage.StoreType.OBS, "命名空间__OBS_Connector");
                let data = obsCli.getObject(path + input.docName);
                out.buf = data;
            } catch (error) {
                console.error(error.name, error.message);
                context.setError(error.name, error.message);
            }
            return out;
        }
    }

  4. 单击,保存脚本。
  5. 运行测试脚本。

    1. 单击编辑器上方的,执行脚本。
    2. 设置输入参数,单击测试窗口右上角的,查看返回消息。
      {
          "docName": "1730874683589013855743152260007e733dd-80ea-19f1-b7a0-93fdcd20a541_命名空间__contractModel.docx"
      }

      其中,“1730874683589013855743152260007e733dd-80ea-19f1-b7a0-93fdcd20a541_命名空间__contractModel.docx”步骤三:创建服务编排生成文档中生成的文档,即通过脚本根据文档名下载OBS桶中的实际合同文档。

      图31 查看输出参数

  6. 脚本测试完成后,单击页面上方的,启用该脚本。

步骤5:通过标准页面调用服务编排和脚本实现文档的生成和下载

设计一个标准页面,通过调用服务编排和脚本,在前端页面实现合同文档的生成和下载等功能。

  1. 新建一个标准页面。

    1. 在应用设计器中,选择“界面”,单击页面后的“+”,新建一个标准页面。
    2. 设置标准页面的标签和名称,单击“添加”
      图32 添加标准页面
      表12 新建标准页面参数说明

      参数

      说明

      示例

      标签

      输入标准页面的标签名,用于在页面显示,创建后可修改。

      取值范围:1~64个字符。

      文档模板标准页

      名称

      输入标准页面的名称,名称是标准页面在系统中的唯一标识,创建后不可修改。命名要求如下:

      • 长度不能超过64个字符,包括前缀命名空间的长度。

        标识前模糊掉的内容为命名空间,在AstroZero中为了避免不同租户间数据的重名,租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间,创建后不支持修改。

      • 必须以英文字母开头,只能由英文字母、数字或单下划线组成,且不能以下划线结尾。

      docModePge

  2. 新增对象模型。

    1. 在标准页面底部,单击“模型视图”,将页面从设计视图切换到模型视图。
    2. 单击“新增模型”,输入模型名称(flowDemo)、“来源”选择“服务”,单击“下一步”
      图33 新增服务编排对象模型
    3. 选择步骤三:创建服务编排生成文档中创建的服务编排,单击“下一步”,再单击“确定”,完成模型的创建。
      图34 选择目标服务编排
    4. 再次单击“新增模型”,输入模型名称(scriptDemo)、“来源”选择“服务”,单击“下一步”
      图35 新增脚本对象模型
    5. 选择步骤四:创建下载文档的脚本中创建的脚本,单击“下一步”,再单击“确定”,完成模型的创建。
      图36 选择目标脚本

  3. 设计一个标准页面,用于生成和下载合同文档。

    1. 在标准页面底部,单击“设计视图”,从模型视图切换到设计视图。
    2. 从基本组件中,拖拽输入框(4个)、数字输入框(2个)和日期选择器到标准页面的画布中,布局如图37
      图37 拖拽组件到画布
    3. 选中组件,修改组件的标签,修改后效果如图38所示。
      图38 修改组件标签
    4. 选中公司名称输入框,在属性 > 数据绑定中,单击“值(value)绑定”后的
      图39 选择值绑定
    5. 选择2.b模型中的“companyName”,单击“确定”
      图40 绑定companyName
    6. 按照上述操作,分别为其他组件绑定模型。

      “合同名称”绑定“flowdemo.inputParam.contractName”“合同签订人”绑定“flowdemo.inputParam.person”“乙方公司名称”绑定“flowdemo.inputParam.otherCompanyName”“合同金额”绑定“flowdemo.inputParam.amount”“订单数目”绑定“flowdemo.inputParam.orderNum”“订单日期”绑定“flowdemo.inputParam.date”

  4. 为标准页面添加一个按钮组件。

    1. 基本组件 > 基本中,拖拽一个按钮组件到订单日期组件下方,并将按钮的“显示名称”修改为“提交合同参数并生成文档实例”
      图41 添加按钮组件
    2. 选中按钮组件,在“事件”页签中,单击“点击”后的,进入添加动作页面。
    3. 在自定义动作中,输入如下示例代码,单击“创建”
      本示例代码实现的功能:根据服务编排模型中设置的合同参数,生成对应的合同文档。其中,“flowDemo”2.b中创建的服务编排模型。
      $model.ref('flowDemo').run().then(function(data){
          console.log(data);
          context.$message.success('Submitted successfully.');
      }).catch(function(error){
          context.$message.error('Submission failed:' + error.resMsg);
      });

  5. 为标准页面添加一个表格组件。

    1. 基本组件 > 布局中,拖拽一个表格组件到按钮组件下方。
      图42 添加表格组件
    2. 选中表格组件,在属性 > 数据绑定中,单击“值(value)绑定”后的
    3. 单击“新建模型”,输入模型名称(obj)、“来源”选择“对象”,单击“下一步”
      图43 设置模型基本信息
    4. 选择步骤二:创建对象存储模板中内容和模板实例中创建的对象和字段,单击“下一步”,再单击“确定”
      图44 模型设置
    5. 在选择模型中,选中创建的模型,将对象模型绑定到表格上。
      图45 为表格绑定模型
    6. 选中表格组件,为表格添加一个操作列。
      图46 为表格添加操作列
    7. 单击新建操作列后的,在操作按钮中,单击“添加操作按钮”
      图47 添加操作按钮
    8. 单击,单击“动作列表”后的,为按钮添加事件。
      图48 为按钮添加动作
    9. 在自定义动作中,输入如下示例代码,单击“创建”
      本示例代码主要实现的功能:根据合同模板实例的字段名,从OBS中下载服务编排生成的文档。其中,“命名空间__modedoc__CST”为合同模板实例的字段名,“scriptDemo”2.d中创建的脚本对象模型。
      // base64解码函数
      function base64DecodeToBinary(base64String) {
        // 解码Base64字符串
        const binaryString = atob(base64String);
        // 将解码后的字符串转换为二进制数据
        const len = binaryString.length;
        const bytes = new Uint8Array(len);
        for (let i = 0; i < len; i++) {
          bytes[i] = binaryString.charCodeAt(i);
        }
        // 将Uint8Array转换为Blob
        const blob = new Blob([bytes]);
        return blob;
      }
      // 获取表格中的行数据,命名空间__modedoc__CST为表格中合同模板实例的字段名
      var rowData = context.$component.current.$attrs.row;
      const docName = rowData.命名空间__modedoc__CST;
      // 设置脚本入参
      let originData = $model.ref('scriptDemo').getData();
      originData.inputParam.docName = docName;
      $model.ref('scriptDemo').setData(originData);
      //运行脚本,从OBS中下载服务编排生成的文档
      $model.ref('scriptDemo').run().then(function(data){
          const decodedString = base64DecodeToBinary(data.buf);
          const url = URL.createObjectURL(decodedString);
          let link = document.createElement('a');
          link.href = url;
          // 设置下载的文档名称,命名空间__modedoc__CST为表格中合同模板实例的字段名
          link.setAttribute('download', rowData.命名空间__modedoc__CST);
          document.body.appendChild(link);
          link.click();
          URL.revokeObjectURL(link.href);
          document.body.removeChild(link);
          context.$message.success('DownLoad successfully.');
      }).catch(function(error){
          console.log('error is', error);
          context.$message.error('DownLoad failed:' + error.resMsg);
      });
    10. 将操作按钮的“标签”设置为“下载文档”,同时将基本属性中的“列标题”设置为“下载”
      图49 更改操作列标题和操作的标签
    11. 返回标准页面,在属性 > 表格区块中,单击工具栏后的“添加”,为表格添加一个工具栏。
      图50 为表格添加工具栏

  6. 标准页面设计完成后,单击页面上方的,保存标准页面。

步骤六:验证合同文档生成和下载功能

  1. 在标准页面上方,单击,进入预览页面。
  2. 输入合同内容,单击“提交合同参数并生成文档实例”

    图51 输入合同内容

  3. 提示“Submitted successfully”后,单击“刷新”,即可查看到提交的合同数据。

    图52 查看提交的合同数据

  4. 单击数据后的“下载文档”,将合同文档下载到本地并查看文档内容。

    图53 合同文档被下载到本地
    图54 查看下载到本地合同的内容

提示

您即将访问非华为云网站,请注意账号财产安全

文档反馈

文档反馈

意见反馈

0/500

标记内容

同时提交标记内容