华为云用户手册

场景介绍 工作流体现的是一个具体的业务场景，通过一系列不同功能节点中的触发事件和执行动作编排而成，AI原生应用引擎通过将传统工具API和大模型编排在一起实现复杂的工作流。工作流可在用户创建Agent时调用，Agent使用过程中，当起始节点触发，后续动作即可自动执行，完成一系列复杂的任务。 本实践中，工作流主要完成如下任务：根据用户输入的城市，获取该城市的实时天气及实时空气质量，调用大模型生成旅游行程规划，最后以短信的形式发送旅游行程规划信息到用户手机。

通过控制台申请资源 AppStage支持使用控制台完成资源申请，或者在华为云申请资源，然后接入至AppStage运维中心。 申请虚拟机：需要在华为云购买E CS 虚拟机，然后将主机接入AppStage运维中心。 申请CCE集群：需要在华为云购买CCE集群，然后将容器集群接入AppStage运维中心。 申请数据库：需要在华为云购买数据库，然后将数据库接入AppStage运维中心，当前只支持RDS(for MySQL)、GeminiDB Cassandra、 GaussDB (for openGauss)/TaurusDB接入AppStage运维中心。

配置流水线（以添加业务包构建任务为例） 在流水线的“任务编排”页面，单击，新建阶段。 单击，在“编辑阶段”页面，修改“阶段名称”为“构建阶段”，并将“总是运行”设置为“是”（选择“是”，表示流水线执行时，该阶段下的任务默认选中必须执行且不可取消；选择“否”，表示流水线执行时，该阶段下的任务默认选中但可以取消。），然后单击“确定”。 在流水线的“构建阶段”，单击“新建任务”。 在“新建任务”页面的右侧区域，选择“构建”页签，单击“Build构建”后的“添加”，将此插件添加到任务中。 在“任务配置”页面右侧区域“请选择需要调用的任务”处单击“点击创建”，如图6所示。 图6 Build构建任务配置 在“新建构建任务”页面的“基本信息”页面，自定义任务名称（以“adadss-build”为例），归属项目默认为当前服务，源码源选择“Repo”，选择对应的代码仓库（以创建好的“adadss”仓库为例）以及分支“master”，单击“下一步”。 在“构建模板”页面，选择“空白构建模板”模板，然后单击“下一步”，进入“构建步骤”的“图形化”页签，该页面的“构建环境配置”和“代码下线配置”无需配置，保持默认配置即可。 配置构建步骤“Maven构建”。 返回“构建步骤”页签，单击“点击添加构建步骤”，在右侧“添加步骤”页面搜索“Maven构建”，鼠标移至插件卡片并单击“添加”，如图7所示。 图7 Maven构建 执行maven构建命令将业务代码打包，不同项目有所不同。 参考示例：mvn -Dassembly clean compile package -Dmaven.test.skip=true -U -T4 若某些jar包依赖不到，可将仓库地址添加在setting配置的公有依赖仓库。 配置镜像构建。 登录华为云 容器镜像服务 控制台，在左侧导航栏选择“我的镜像”，单击右上角“页面上传”，在“页面上传”对话框，创建组织（必须使用华为云账号），单击“选择镜像文件”，选择已经准备好的基础镜像tar包，单击“开始上传”，待任务进度显示“上传完成”，表示镜像文件上传成功。 基础镜像tar包仅需上传一次，后续可直接从镜像文件列表中选取。 在镜像仓库找到9.a上传的基础镜像，参照图8复制镜像地址。 图8 复制镜像地址 将9.b复制的镜像地址粘贴到Dockerfile文件中第一行FROM命令后，如图9所示。 图9 将镜像地址粘贴到Dockerfile文件中 返回华为云容器 镜像服务 控制台镜像列表中单击镜像tar包名称，进入镜像详情页面，选择“Pull/Push指南”页签，单击“操作步骤”中的“生成登录指令”。 在“登录指令”对话框中的“临时登录指令”框的指令末尾处单击，复制临时登录指令，如图10所示。 图10 复制临时登录指令 返回“构建步骤”页面，单击“添加步骤”，在右侧“添加步骤”页面搜索“执行Docker命令”，鼠标移至该插件卡片并单击“添加”。 单击“执行Docker命令”步骤，在右侧“命令”参数下单击“添加”添加docker命令，在“命令”下拉框中选择“login”，参数框中输入9.e获取的临时登录指令中login后的部分，例如“-u cn-north-7@K5X8GVN5B4H4B8KB9SDO -p 1dd00acee886bd05886cded19f5af1cb1e96326e4354fc0f3f493f12a3586518 swr.cn-north-7.myhuaweicloud.com”，登录环境以便Dockerfile文件中可正常获取基础镜像。 在“操作”列单击“+”继续添加docker命令，“命令”下拉框中选择“build”，并在参数框中输入命令，指定代码仓中的Dockerfile文件并构建镜像。 例如构建helloworldservice:23.11.02.1镜像，可输入“-t helloworldservice:23.11.02.1 -f ./deploy_docker/Dockerfile .”，其中“./deploy_docker/Dockerfile”为Dockerfile文件目录。 工作目录一般为根目录。 在“操作”列单击“+”继续添加docker命令，“命令”下拉框中选择“save”，并在参数框中输入命令，将镜像包保存为tar包。 例如将elloworldservice:23.11.02.1镜像包保存为helloworldservice.23.11.02.1.tar包，可输入“-o helloworldservice.23.11.02.1.tar helloworldservice:23.11.02.1”。至此，添加docker命令完成，如图11所示。 图11 执行docker命令 返回“构建步骤”页面，单击“添加步骤”，在右侧“添加步骤”页面搜索“Maven构建”，鼠标移至插件卡片并单击“添加”。执行zip命令，将tar包与业务代码中的package.json文件直接压缩成一个zip包。 如下命令，将helloworldservice.23.11.02.1.tar和package.json文件压缩为helloworldservice_23.11.02.1.zip包。 zip helloworldservice_23.11.02.1.zip helloworldservice.23.11.02.1.tar package.json 继续单击“添加步骤”，添加“上传文件到OBS”插件，在“上传文件到OBS”页面，参照表3配置相关参数，配置完成后单击右上角“新建”，配置构建任务完成。 表3 “上传文件到OBS”(业务包）步骤配置的参数说明 参数名称 参数说明 步骤显示名称 构建步骤的名称，默认为“上传文件到OBS”，保持默认或自定义修改均可。 授权用户 在下拉列表选择： 当前用户：上传到当前租户的OBS桶。 其他用户：可以通过选择 IAM 账号的方式上传到指定租户的OBS桶。 IAM账号 “授权用户”选择“其他用户”时需配置此参数，配置步骤如下： 单击“管理IAM账号”，进入“服务扩展点管理”页面。 单击“新建服务扩展点”，选择“IAM账户”，弹出“新建服务扩展点”对话框，填写以下参数，补充租户下用户的AK、SK即可： 连接名称：服务扩展点的名称。例如“obs权限”。 Access Key Id：访问密钥ID（AK），获取访问密钥AK/SK。 Secret Access Key：秘密访问密钥（SK），获取访问密钥AK/SK。 信息填写完成，单击“确定”。 构建产物路径 路径为10的zip包的相对路径或输入*模糊匹配（如“./DemoServiceB/*.zip”） 桶名 用户自定义构建结果上传到的目标OBS桶名。 OBS存储目录 用户自定义构建结果在OBS上的存储目录 OBS存储文件名 非必填项，构建结果在OBS上的存储文件名（不包含目录），留空时可上传多个文件，取构建产物文件名为OBS存储文件名；不为空时只能上传单个文件，如 application.jar。 是否上传文件夹 非必填项，可选择是否开启上传文件夹。 OBS头域 非必填项，上传文件时加入一个或多个自定义的响应头，当用户下载此对象或查询此对象元数据时，加入的自定义响应头会在返回消息的头域中出现。如：“键”填写成“x-frame-options”，“值”填写成“false”，即可禁止OBS中存放的网页被第三方网页嵌入。 返回5的“任务配置”页面，在“请选择需要调用的任务”下拉列表中选择已配置完成的构建任务，“仓库”下拉列表选择创建代码仓库中已创建的仓库，其他参数无需配置，保持默认即可。 单击“确定”，添加业务包构建任务完成。 单击“任务编排”页面右上角“保存”，保存流水线的任务配置。

配置流水线（以添加代码检查任务为例） 在流水线的“任务编排”页面，单击，新建阶段，如图3所示。 图3 新建阶段 单击，在“编辑阶段”页面，修改“阶段名称”为“代码检查”，并将“总是运行”设置为“否”（选择“是”，表示流水线执行时，该阶段下的任务默认选中必须执行且不可取消；选择“否”，表示流水线执行时，该阶段下的任务默认选中但可以取消。），然后单击“确定”。 在流水线的“代码检查”阶段，单击“新建任务”。 在“新建任务”页面的右侧区域，选择“代码检查”页签，单击“CodeArtsCheck代码检查”后的“添加”，将此插件添加到任务中，如图4所示。 图4 代码检查 在“任务配置”页面右侧区域“请选择需要调用的任务”处单击“点击创建”，如图5所示，进入“新建任务”页面，参照表2配置参数信息（此处以创建Repo源码源检查任务为例），配置完成后单击“新建任务”。 图5 创建代码检查任务 表2 参数说明 参数项 描述 归属项目 任务所属项目。默认填写，无需设置。 代码源 选择Repo，从代码托管拉取代码进行检查。 任务名称 代码检查任务名称，可自定义。 仓库 选择需要检查的代码仓库。 分支 填写需要检查的仓库分支名称。 检查语言 选择需要检查的代码语言。 返回5的“任务配置”页面，在“请选择需要调用的任务”下拉列表中选择已配置完成的代码检查任务，“仓库”下拉列表选择创建代码仓库中已创建的仓库，其他参数无需配置，保持默认即可。 单击“确定”，添加代码检查任务完成。 单击“任务编排”页面右上角“保存”，保存流水线的任务配置。

AppStage最佳实践汇总 本文汇总了基于应用平台AppStage常见应用场景的操作实践，为每个实践提供详细的方案描述和操作指导，帮助您深入了解AppStage的各个功能。 表1 AppStage最佳实践一览表 最佳实践 说明 一站式应用开发、应用托管以及应用运维 介绍如何使用应用平台AppStage一站式功能，完成基于应用维度提供的开发、测试、版本发布、托管部署、运维监控的全场景全生命周期管理。 基于运维数仓的数据开发与应用 介绍如何通过AppStage运维中心完成对业务实时数据的接入、处理、开发与应用。 基于Spring Cloud框架进行应用上云 以Spring Cloud Demo项目为例，带您体验使用AppStage的开发中心、运维中心进行工程创建、代码开发、打包发布、部署上线的全过程。 AI原生应用引擎 以使用工作流规划旅游行程为例，体验如何使用AI原生应用引擎工作流完成一个具体的业务场景。

了解高级页面 AstroZero前端页面有标准页面、高级页面和表单三种。本节主要带您了解、学习并使用高级页面。 标准页面：对于一般的业务应用系统，其功能主要是针对业务数据的增、删、改、查，前端界面的样式相对简单的页面场景，此时，推荐您使用平台提供的“标准页面”。您可以通过拖、拉、拽页面组件，再加上少量事件代码，即可拼装出所需页面，具体介绍请参见标准页面。 高级页面：对于一些样式比较复杂的页面，例如网站、电商、园区大屏等，您可以使用平台提供的“高级页面”。 高级页面是由一个或者多个Widget（即组件）拼装而成。如图1所示，组件是可复用的页面组成元素，一个页面由一个或多个组件拼装而成。如果将一个页面看成拼图游戏的完整图案，那么组件就相当于拼图的每一小块。 图1 页面与widget（组件）的关系 Widget的运行依赖Library（库），如果缺少相应的Library（库），则Widget不能正常运行。因此在加载widget前，需要先加载必要的Library。 在操作前端页面时，经常会需要调用后台数据，例如即将开发的登录页面，需要获取业务用户信息。这时需要通过桥接器调用后台的服务编排、Script等获取后台数据。因此，在引用widget时，经常需要配置桥接器。 AstroZero高级页面中的组件分为系统预置组件和自定义组件： 系统预置组件，可以直接使用。 登录组件属于自定义组件。本示例中已经为您提供了开发好的组件包，您只需要上传到站点中即可使用。自定义登录组件的开发方法，请参考（可选）开发自定义登录组件。

拖拽组件并关联模型 单击“设计视图”，切换到页面设计视图。 图12 切换到设计视图组件列表 将左侧组件区的“表单”拖拽到右侧“页面内容”中，在“元数据表单配置向导”弹窗底部，单击“取消”，创建一个空的表单控件。 当前不单独定义数据源，因此需要单击“取消”数据绑定。 图13 拖拽表单到页面并取消数据绑定 组装参数区域。 从左侧组件列表中，拖一个“容器”到上一步创建的“表单”。 从左侧组件列表中，拖一个“分栏”到上一步创建的“容器”中。 “分栏”默认有2个“栏”，即当前栅格中包含1行1列的区域。 选中“分栏”，在右侧属性的“行布局”中，单击，将分栏设置为3栏。 图14 设置分栏为3栏 在右侧“属性”页签中，单击“新增行”后面的图标，新增一行，如图15所示。设置后，分栏组件被设置为2行（分栏）3列（栏）。 图15 设置表格内的行列数 从左侧组件区的拖一个“输入框”到分栏组件的第1行（分栏）第1栏，并在右侧“属性”页签中将“标签”修改为“设备编码”。 图16 设备编码 分别向第1行第2栏、第2行第1栏、第2行第3栏中拖一个“输入框”，并设置“标签”为“设备名称”、第2行第1栏“设备型号”、第2行第3栏“详细地址”。 从左侧组件列表中，拖一个“下拉框”到分栏组件的第1行第3栏，并在右侧“属性”页签中将“标签”修改为“设备品牌”。 从左侧组件列表中，拖一个“级联选择框”到分栏组件的第2行第2栏，并将“标签”修改为“省/市/区”。 组装页面标题。 在左侧组件区拖拽一个“标题”组件到上一步创建的“容器”前面，并在右侧“属性”页签中将“标题内容”修改为“设备详情”，并设置“样式”的“高级设置”为“:root{text-align:center;font-size:20px;}”。 组装按钮区域。 在左侧组件区拖拽一个“容器”到3中创建的“容器”后（注意要在表单里面，两个容器在同级），并在右侧“属性”页签中将“水平对齐方式”修改为“中”，即居中对齐。 图17 拖拽容器 图18 设置居中对齐 从左侧组件区拖拽一个“按钮”到刚创建的“容器”中，并在右侧“属性”页签中，将“显示名称”修改为“保存”，将“类型”修改为“主要按钮”。 拖拽一个按钮到“保存”按钮右边，并设置为“取消”按钮，类型设置为“默认按钮”。 单击界面上方的，保存页面，可以在属性面板底部查看组件树。 图19 组装完成后页面的组件树 为页面组件关联模型。 选中“设备名称”输入框。 在右侧“属性”页签中单击，为“设备名称”输入框绑定“equipmentForm”自定义模型中的“name”参数，如图20所示。 数据绑定后，当在前台界面输入内容时，系统就会把输入框中的内容，赋值给“name”。 图20 输入框数据绑定 重复上一步，为“设备编码”、“设备型号”、“详细地址”文本输入框绑定“equipmentForm”自定义模型中的对应参数。 选中“设备品牌”下拉选择框，在右侧“属性”页签中单击，为选择框绑定“equipmentForm”自定义模型中的“HW__equipmentBrand__CST”参数。 选中“设备品牌”下拉选择框，在右侧“基本属性”中，单击“选项列表”的，在弹窗中输入“equipmentBrand”，在联想记录中，选择设备对象字段“HW__equipmentBrand__CST”，为选择框添加下拉选项关联的字段，如图21所示。 图21 为下拉选择框定义可选项 图22 输入字段搜索 图23 关联字段 选中“省/市/区”级联框，在右侧“属性”页签中单击，为级联框绑定“equipmentForm”自定义模型中的“cascaderAddress”参数。 单击属性值绑定后的“+”，将“属性”设置为“选择数据”，“模型字段”绑定到“cascaderOptions”，如图24所示。 数据绑定后，级联选择框的选项来自“cascaderOptions”；同时，当在前台界面选择省/市/区时，系统就会把选择结果赋值给“equipmentForm.cascaderAddress”。 图24 级联框数据绑定 单击页面上方的，保存页面。

定义模型 进入创建“设备维修管理系统”应用中创建的应用。 在“Equipment”中，将鼠标放在“Page”目录上，单击界面上出现的“+”，选择“标准页面”。 在“标签”和“名称”文本框中输入“editEquipment”，单击“添加”。 平台实际创建的页面名称为“HW__editEquipment”，包含前缀“HW__”，对应首次创建应用时定义的命名空间。新建创建的页面，默认是当前用户锁定状态，可以进行编辑保存等操作。 当编辑已有标准页面时，为防止编辑时多人篡改，编辑前请单击进行锁定。 定义与“省/市/区”级联框的可选项相关联的自定义模型。 在页面底部单击“模型视图”，进入模型视图页面，单击“新增模型”。 添加自定义模型，模型名称“cascaderOptions”，单击“下一步”，如图4所示。 图4 定义级联框用到的自定义模型 设置保持不变，单击“下一步”。 方法保持不变，单击“确定”。 单击页面上方的，保存设置。 定义与页面上各个输入框、选择框相关联的自定义模型。 在“模型视图”中，单击“新增模型”。 添加自定义模型，模型名称“equipmentForm”，单击“下一步”，如图5所示。 图5 定义页面组件需要关联的自定义模型 单击“新增节点”，逐一添加与页面元素对应的参数（name、HW__equipmentSN__CST、HW__equipmentBrand__CST、HW__equipmentModel__CST、cascaderAddress、HW__installationDetailAddress__CST），单击“下一步”，如图6所示。 为简化后续事件脚本，除cascaderAddress外，请确保其他5个参数的参数名与设备对象（HW__Equipment__CST）的字段名保持一致。注意这里的下划线是两个，要与表1里的字段保持一致，HW__需要修改为实际的命名空间前缀。 图6 添加模型包含的参数 方法保持不变，单击“确定”。 单击页面上方的，保存设置。 定义与API（editEquipment:1.0.0）关联的服务模型。 在“模型视图”中，单击“新增模型”。 添加服务模型，模型名称“editEquipment”，来源选择“服务”，单击“下一步”，如图7所示。 图7 定义服务模型 指定模型与API“editEquipment”关联，单击“下一步”，如图8所示。 关联API后，系统会自动显示API中脚本的输入、输出参数。 图8 为模型关联Script 方法保持不变，单击“确定”。 系统自动添加了执行的方法，如图9所示。未来，将在事件脚本中执行这个方法，即执行模型关联的API中的脚本。 图9 为模型定义方法 单击页面上方的，保存设置。 定义与API（queryEquipmentDetail）关联的服务模型。 在“模型视图”中，单击“新增模型”。 添加服务模型，模型名称“queryEquipmentDetail”，“来源”选择“服务”，单击“下一步”。 指定模型与API“queryEquipmentDetail”，单击“下一步”。 图10 为模型关联Script 方法保持不变，单击“确定”。 单击页面上方的，保存设置。 图11 新增的页面模型

背景信息 工作队列是在业务场景中，用来记录可以受理相同具体业务的用户群体。 这种记录一直保留在队列中，直到用户接受它们并进行处理，或它们被转移到另一个队列。您可以指定每个队列支持的对象集合，以及允许从队列检索记录的用户组（用户、业务用户等）。 创建工作队列主要包含两方面内容： 添加队列的成员。 队列成员可以是单个用户、公共组、单个角色或带有下级角色的角色，以及业务用户；如果队列的成员是角色，此队列将包含角色中所有的用户。 配置队列支持的对象。 配置了支持的对象后，涉及特定数据对象的触发器、待审批任务才能进入该队列。

操作步骤 在应用中，单击下方“服务”，进入公共接口创建页面。 图1 创建公共接口入口 单击“新建”，进入新建公共接口页面。 图2 公共接口创建 创建“编辑设备”脚本“HW__editEquipment”的公共接口。 设置接口参数信息，设置标签和操作名称为“editEquipment”，版本为“1.0.0”，URL为“/editEquipment”，“类型”选择“脚本”，“资源”为“HW__editEquipment”，方法为“POST”，然后单击“保存”。 如果在“资源”下拉框中，未找到需要关联的脚本，请检查相关脚本是否已启用。 图3 设置“编辑设备”脚本的公共接口参数 在应用开发页面，单击左下角的“服务”，进入公共接口页面，查看上一步中新建的自定义接口URL“/service/HW__MyApp/1.0.0/editEquipment”，后续开发页面时，会使用这个URL。 图4 查看自定义接口URL 参照上一步，创建“按ID查询设备详情”脚本“HW__queryEquipmentDetail”的公共接口，详细接口信息如图5所示。 标签和操作名称为“queryEquipmentDetail”，版本为“1.0.0”，URL为“/queryEquipmentDetail”，“类型”选择“脚本”，“资源”为“HW__queryEquipmentDetail”，“方法”为“GET”。 图5 “HW__queryEquipmentDetail”的公共接口参数

验证并发布 测试新增逻辑能否正常执行。 单击编辑器上方的，执行脚本。 在界面底部输入测试数据，单击测试窗口右上角执行图标。 测试报文样例如下，equipmentId可参考创建“编辑设备”脚本验证新增设备时生成的设备ID： { "equipmentId": "cQue000000e1qnhgtCng"} 执行成功，会在“输出”页签返回查询结果，返回结果是上一节中新增的设备信息。 图1 查询返回的设备信息 测试成功，单击编辑器上方的，启用脚本。

操作步骤 进入创建“设备维修管理系统”应用中创建的应用。 在“Equipment”中，将鼠标放在“Script”目录上，单击界面上出现的“+”，选择“脚本”。 在弹窗中，选中“创建一个新脚本”，在“名称”文本框中输入“queryEquipmentDetail”，单击“添加”。 系统实际创建的脚本名称为“HW__queryEquipmentDetail”，“HW__”前缀由租户命名空间namespace决定。新建创建的脚本，默认是当前用户锁定状态，可以进行编辑保存等操作。 当编辑已有脚本时，为防止编辑时多人篡改，编辑前请单击进行锁定。 在代码编辑器中插入如下脚本代码。 脚本中红色内容请替换为实际的对象名、字段名。 /***************************** * 本脚本用于按设备ID查询设备详情 * ***************************/import * as db from 'db';//导入处理object相关的标准库import * as context from 'context';//导入上下文相关的标准库//定义入参结构@action.object({ type: "param" })export class ActionInput { @action.param({ type: 'String', required: true }) equipmentId: string;//设备ID}//定义出参结构@action.object({ type: "param" })export class ActionOutput { @action.param({ type: 'Any', label: 'equipment' }) equipment: object;//设备对象}@useObject(['HW__Equipment__CST'])//使用数据库对象HW__Equipment__CST@action.object({ type: "method" })export class QueryEquipmentDetail { @action.method({ input: 'ActionInput', output: 'ActionOutput' }) public queryEquipmentDetail(input: ActionInput): ActionOutput { let out = new ActionOutput(); //新建出参ActionOutput类型的实例，作为返回值 let error = new Error(); //新建错误类型的实例，用于在发生错误时保存错误信息 try { //必填校验 if (!input.equipmentId || input.equipmentId == "") { error.name = "EQM"; error.message = "Equipment id is required."; throw error; } //获取HW__Equipment__CST这个Object的操作实例 let s = db.object('HW__Equipment__CST'); //查询字段(全部) let option = {}; //查询条件 let condition = { "conjunction": "AND", "conditions": [{ "field": "id", "operator": "eq", "value": input.equipmentId }] }; //调用按条件查询Equipment__CST的接口 let record = s.queryByCondition(condition, option); //如果查询到数据 if (record && record[0]) { //拼接前台省市区级联选择器的数据模型 let cascaderAddress = []; if (record[0].HW__installationSiteProvince__CST) { cascaderAddress.push(record[0].HW__installationSiteProvince__CST); if (record[0].HW__installationSiteCity__CST) { cascaderAddress.push(record[0].HW__installationSiteCity__CST); if (record[0].HW__installationSiteArea__CST) { cascaderAddress.push(record[0].HW__installationSiteArea__CST); } } } record[0].cascaderAddress = cascaderAddress; //将结果挂入输出对象中 out.equipment = record[0] } } catch (error) { console.error(error.name, error.message); context.setError(error.name, error.message); } return out; }} 单击编辑器上方的，保存脚本。

了解服务编排 在传统的开发中程序员一般是基于代码进行开发，程序员需要学习内容较多，开发效率相对低一些，开发门槛也高。AstroZero的服务编排功能，类似于编程中一段有流程、条件处理、判断逻辑的程序。这段程序有输入参数和输出参数、可以独立成为一个对外调用的方法。同时，在程序内部，也可以调用其他的方法。 AstroZero中的服务编排是将原来基于代码编程改变为用图形化，拖拉拽的方式去编程。如图1所示，服务编排界面是图形化、模板化的，您甚至不需要任何编程经验，将左侧面板区的组件拖拽到右侧画布、做必要的配置，就可以完成服务编排的开发。 图1 服务编排界面 服务编排界面中，可以编排如下组件： 基本组件：在服务编排引用脚本或者另一个服务编排，增/改/删/查记录，以及发送邮件、发送事件等。 逻辑组件：在服务编排中实现变量赋值Assignment、循环Loop、跳出循环Break、决策Decision和等待Wait。 商业对象：将封装好的BO能力作为服务编排中的一个节点。 连接器：将短信发送、支付等第3方连接器作为当前服务编排中的一个节点。 除了图形化编排，AstroZero也支持服务编排的在线测试验证，以及问题跟踪调试，方便您及时发现并解决问题。 服务编排测试通过、发布后，既可以直接被前端页面调用，也可以作为restful接口被第三方系统调用，也可以包装成公共接口后被调用。本节中主要是将服务编排包装成一个公共接口后，供页面调用，“管理设备”功能中涉及的业务逻辑，以及服务编排与脚本关系如表1下所示，详细操作方式及说明请参见创建业务逻辑。

操作步骤 进入创建“设备维修管理系统”应用中创建的应用。 在“Equipment”目录中，将鼠标放在“Script”上，单击界面上出现的“+”，在弹出菜单中选择“脚本”。 在弹窗中，选中“创建一个新脚本”，在“名称”文本框中输入“editEquipment”，单击“添加”。 系统实际创建的脚本名称为“HW__editEquipment”，“HW__”前缀由租户命名空间namespace决定。新建创建的脚本，默认是当前用户锁定状态，可以进行编辑保存等操作。 当编辑已有脚本时，为防止编辑时多人篡改，编辑前请单击，进行锁定。 在代码编辑器中，插入如下脚本代码。 脚本中红色内容请替换为实际的对象名、字段名。 //本脚本用于新增或者修改设备信息import * as db from 'db';//导入处理object相关的标准库import * as context from 'context';//导入上下文相关的标准库//定义入参结构，入参包含1个参数：equipment对象，为必填字段@action.object({ type: "param" })export class ActionInput { @action.param({ type: 'Any', required: true, label: 'equipment' }) equipment: object;}//定义出参结构，出参包含1个参数，记录equipment的id@action.object({ type: "param" })export class ActionOutput { @action.param({ type: 'String' }) equipmentId: string;}//使用数据对象HW__Equipment__CST@useObject(['HW__Equipment__CST'])@action.object({ type: "method" })export class EditEquipment { //定义接口类，接口的入参为ActionInput，出参为ActionOutput @action.method({ input: 'ActionInput', output: 'ActionOutput' }) public editEquipment(input: ActionInput): ActionOutput { let out = new ActionOutput(); //新建出参ActionOutput类型的实例，作为返回值 let error = new Error(); //新建错误类型的实例，用于在发生错误时保存错误信息 try { let equipment = input.equipment; //将入参赋值给equipment变量，方便后面使用 let s = db.object('HW__Equipment__CST'); //获取HW__Equipment__CST这个Object的操作实例 delete equipment['cascaderAddress']; //删除入参中不需要插入HW__Equipment__CST对象的多余属性 //新增设备 if (!equipment['id']) { //必填校验 if (!equipment['HW__equipmentSN__CST']) { error.name = "EQM"; error.message = "Field 'HW__equipmentSN__CST' is required."; throw error; } let equipmentId = s.insert(equipment); //向HW__Equipment__CST插入一条数据，返回数据的唯一标识即设备ID if (equipmentId && equipmentId != "") { out.equipmentId = equipmentId; } else { error.name = "EQM"; error.message = "Equipment Cannot Be Added."; throw error; } } //编辑修改设备 else { let id = equipment['id']; delete equipment['id']; let count = s.update(id, equipment); //根据设备ID，编辑更新HW__Equipment__CST的一条数据 if (count && count == 1) { out.equipmentId = id; } else { error.name = "EQM"; error.message = "Equipment Cannot Be Updated."; throw error; } } } catch (error) { console.error(error.name, error.message); context.setError(error.name, error.message); } return out; }} 单击编辑器上方的，保存脚本。

验证并发布 测试新增逻辑能否正常执行。 单击编辑器上方的，执行脚本。 如图1所示，在界面底部输入测试数据，单击测试窗口右上角执行图标。 图1 测试脚本 测试报文采用json格式，样例如下（报文中加粗斜体内容请替换为实际的字段名）： { "equipment": { "name": "百草园A栋1单元1号", "HW__equipmentSN__CST": "3217890001" } } 执行成功，会在“输出”页签返回equipmentId。请保存这个返回结果，后续的测试中会用到。 { "equipmentId": "cQue000000e1qnhgtCng" } 如果执行失败，请检查之前设备对象、脚本，以及测试报文三者中的对象名、字段名是否一致。 到设备对象布局页面（Equipment Records），预览页面，检查数据是否插入成功。 在“Equipment”目录的“Object”下，单击设备对象“HW__Equipment__CST”，在“布局”页签下，单击“Equipment Records”后的预览图标。 图2 对象布局页面 在页面中，检查设备列表中是否包含刚插入的测试数据。 如果已新增数据，为了后续测试方便，建议多创建几条数据。 测试修改逻辑能否正常执行。 单击编辑器上方的，执行脚本。 在界面底部输入测试数据，单击测试窗口右上角执行图标。 如下样例报文中的加粗id值，请修改为图1的返回结果，加粗斜体字段名请替换为实际的字段名。以下报文是修改name字段。 { "equipment": { "id": "cQuXXXXXXXXng", "name": "百草园B栋2单元2号", "HW__equipmentSN__CST": "3217890001" } } 刷新设备对象布局页面（Equipment Records）的预览页面，查看测试数据是否符合预期。 测试成功，单击编辑器上方的，启用脚本。

操作步骤 进入创建“设备维修管理系统”应用中创建的应用。 在“Equipment”目录中，将鼠标放在“Script”上，单击界面上出现的“+”，在弹出菜单中选择“脚本”。 选中“创建一个新脚本”，在“名称”文本框中输入“deleteEquipment”，单击“添加”。 当编辑已有脚本时，为防止编辑时多人篡改，编辑前请单击进行锁定。 在代码编辑器中插入如下脚本代码。 脚本中红色内容请替换为实际的对象名、字段名。 //本脚本用于删除设备import * as db from 'db';//导入处理object相关的标准库import * as context from 'context';//导入上下文相关的标准库//定义入参结构，入参包含1个参数：Equipment对象，为必填字段@action.object({ type: "param" })export class ActionInput { @action.param({ type: 'String', required: true, label: 'String' }) id: string;}//定义出参结构，出参包含1个参数，Equipment的记录id@action.object({ type: "param" })export class ActionOutput { @action.param({ type: 'String' }) id: string;}//使用数据对象HW__Equipment__CST@useObject(['HW__Equipment__CST'])@action.object({ type: "method" })export class DeleteEquipment { //定义接口类，接口的入参为ActionInput，出参为ActionOutput @action.method({ input: 'ActionInput', output: 'ActionOutput' }) public deleteEquipment(input: ActionInput): ActionOutput { let out = new ActionOutput(); //新建出参ActionOutput类型的实例，作为返回值 let error = new Error(); //新建错误类型的实例，用于在发生错误时保存错误信息 try { let id = input.id; let s = db.object('HW__Equipment__CST'); //获取HW__Equipment__CST这个Object的操作实例 //查询条件 let condition = { "conjunction": "AND", "conditions": [{ "field": "id", "operator": "eq", "value": id }] }; let isDeleted = s.deleteByCondition(condition); if (isDeleted) { out.id = id; } else { error.name = "EQERROR"; error.message = "删除设备失败！"; throw error; } } catch (error) { console.error(error.name, error.message); error.Error(error.name, error.message); } return out; }} 单击脚本编辑器上方的，保存脚本。

样例代码解读 通过下面详细的脚本代码内容解读，使您对脚本有一个更具体的认识。 一般情况下，编写脚本的大致流程为： 按需引入平台标准库。 图2 引入平台标准库 定义出参、入参结构。 图3 定义入参 图4 定义出参 定义方法以及使用的对象。 图5 定义方法及使用对象 进行数据库操作。 图6 数据库相关操作 下面通过解读以下脚本样例，了解一个脚本的总体结构框架、编写要求。 import * as decimal from 'decimal';@action.object({type: "param"})export class ActionInput { @action.param({type: 'String', required: true, label: 'your name', description: 'please input your name'}) name: string; @action.param({type: 'Number', required: true, min: 1, max: 100, message: 'age must during [1, 100]'}) age: decimal.Decimal; @action.param({type: 'Date', pattern: 'yyyy-MM-dd'}) birthday: Date; @action.param({type: 'String', isCollection: true}) schools: string[]; @action.param({type: 'Boolean'}) married: boolean; @action.param({type: 'MyObject'}) obj: MyObject;}@action.object({type: "param"})export class MyObject { @action.param({type: 'String'}) something: string; @action.param({type: 'Number'}) otherthing: decimal.Decimal;}@action.object({type: "param"})export class ActionOutput { @action.param({type: 'String', isCollection: true}) greets: string[];}@action.object({type: "method"})export class ActionDemo { @action.method({ label: 'greeting something', description: 'greeting something.', input: 'ActionInput', output: 'ActionOutput' }) public greet(inarg: ActionInput): ActionOutput { console.log('name = ', inarg.name); console.log('age = ', inarg.age); console.log('birthday = ', inarg.birthday); console.log('schools = ', inarg.schools); console.log('married = ', inarg.married); console.log('obj = ', inarg.obj); let out = new ActionOutput(); out.greets = ['hello', 'hi', 'how are you', 'how old are you', 'long time no see']; return out; }} 上述示例脚本包括三部分内容： 导入标准库或其他模块。 示例中第1行，表示将使用平台提供的decimal库。 import * as decimal from 'decimal'; 除了平台预置标准库，还可以声明对其他自定义模块的引用。例如，已经提前开发了一个脚本circle，可以用如下方式加载。 import * as circle from './circle'; 定义输入、输出变量。 脚本可以有多个输入、输出参数，也可以没有。所有的输入或输出参数必须封装在一个class中，作为实例成员。 本例中，脚本有6个输入参数，被封装为ActionInput。每个参数都必须定义其参数类型，同时还可以定义是否必填、标签、最大值、最小值等可选属性。 @action.object({type: "param"})export class ActionInput { @action.param({type: 'String', required: true, label: 'your name', description: 'please input your name'}) name: string; @action.param({type: 'Number', required: true, min: 1, max: 100, message: 'age must during [1, 100]'}) age: decimal.Decimal; @action.param({type: 'Date', pattern: 'yyyy-MM-dd'}) birthday: Date; @action.param({type: 'String', isCollection: true}) schools: string[]; @action.param({type: 'Boolean'}) married: boolean; @action.param({type: 'MyObject'}) obj: MyObject;} 因为第6个输入参数“obj”的参数类型为自定义对象，所以还需要给出“MyObject”的定义。 @action.object({type: "param"})export class MyObject { @action.param({type: 'String'}) something: string; @action.param({type: 'Number'}) otherthing: decimal.Decimal;} 脚本有1个输出参数，被封装为ActionOutput。 @action.object({type: "param"})export class ActionOutput { @action.param({type: 'String', isCollection: true}) greets: string[];} 定义方法。 样例中，ActionDemo是外部调用的class，使用export导出。ActionDemo定义了一个action method，使用action.method装饰，表明调用脚本时从此方法入口。greet是class的实例方法，其输入、输出参数就是前面定义的ActionInput和ActionOutput。 在一个脚本文件里面，action.method只能使用一次。 @action.object({type: "method"})export class ActionDemo { @action.method({ label: 'greeting something', description: 'greeting something.', input: 'ActionInput', output: 'ActionOutput' }) public greet(inarg: ActionInput): ActionOutput { console.log('name = ', inarg.name); console.log('age = ', inarg.age); console.log('birthday = ', inarg.birthday); console.log('schools = ', inarg.schools); console.log('married = ', inarg.married); console.log('obj = ', inarg.obj); let out = new ActionOutput(); out.greets = ['hello', 'hi', 'how are you', 'how old are you', 'long time no see']; return out; }} 脚本编辑页面不支持单步调试，样例里的console.log可实现在日志里打印过程输出，方便代码调试。

了解应用目录及菜单 一个业务系统通常包括前端页面、后台逻辑和数据库表。因此，AstroZero采用类似的结构管理应用程序。 如图1所示，应用管理页面包含三部分（红框1、红框2和红框3）： 红框1中是当前应用的页面、模型和逻辑。在后续章节中，开发的页面、对象及后台逻辑，推荐按以下规划的方式，将应用资源分别放在对应的目录下： Object：数据对象 Script：脚本 Flow：服务编排 Bpm：BPM Page：前端页面 红框2中是应用管理功能，例如预览应用、编译打包、发布应用等。 红框3中是应用设置功能，例如设置应用导航、页面设置等。 红框4中是AstroZero应用开发环境的导航菜单，单击“首页”可返回开发环境首页。 图1 应用的管理目录 父主题： 创建应用

业务场景 设备维修管理系统应用中，包含以下两类用户： 系统管理员用户：管理应用的用户，用于新增业务用户，添加用户权限、添加设备信息、管理工单和监控设备。 本示例以登录AstroZero开发应用的账号，作为管理员账号。 业务用户：使用“设备维修管理系统”应用的用户，分别是客服人员、派单员及维修人员。 设备运维管理和维修场景的业务流程： 系统管理员进行电梯信息的管理和维护，如增加电梯基本信息，修改电梯基本信息等，对业务用户的管理，如新增系统业务用户，并为其分配权限等。 电梯客服人员受理用户投诉，并创建维修单。 派单人员收到客服人员的维修单后，派发给维修工程师。 维修工程师进行现场修理，并在处理完成后关闭维修单。

模型视图 标准页面是通过数据模型驱动的，页面所有的逻辑都是围绕数据模型展开的。在将模型与前台页面组件或者后台逻辑绑定后，开发者只需要关注模型数据的实例化和处理，不需要关注页面的渲染和展示。 在页面底部，单击“模型视图”，即可从“设计视图”切换到“模型视图”，在模型视图下，可以查看、编辑以及管理数据模型，如图6所示。 图6 模型视图 模型定义 标准页面支持表1中四类模型，每类模型都包含参数定义和方法定义。方法是在模型上定义的API，通常会在前端组件关联的事件脚本（例如页面加载事件、鼠标单击事件）中调用这些API，以实现一定的逻辑。 表1 模型说明 模型分类 模型说明 模型参数的定义 模型方法的定义 API调用方法 自定义模型 自定义模型是由开发者自由定义的模型。 参数由开发者自定义，可以添加子节点。 开发者自定义方法。 $model.ref("modelName").actionName(); 对象模型 对象模型是直接与Object对象表映射生成的。 系统自动获取Object所有的字段，开发者可以从中选择部分字段作为参数。 平台自动生成查询、保存、删除和统计4个方法。 $model.ref("modelName").query(param); $model.ref("modelName").save(); $model.ref("modelName").delete(); $model.ref("modelName").count(); 服务模型 服务模型是与后台服务映射生成的，当前支持与服务编排或Script映射。 参数根据后台服务的入参、出参映射生成为inputParam和outputParam节点。 平台自动生成了run方法 ，用于执行模型关联的服务编排或者Script。 $model.ref("modelName").run(); 事件模型 事件模型是与后台事件的字段映射生成的，并且支持websocket刷新模型数据。 参数根据后台事件的字段映射生成。 平台自动生成了run方法 ，用于执行模型关联的服务编排或者Script。 $model.ref("modelName").run(); 除了在模型中定义的方法，AstroZero还提供了如下标准API： 获取模型数据：$model.ref("modelName").getData(); 设置模型数据：$model.ref("modelName").setData(); 设置模型字段值：$model.ref("modelName").setValue(key,value); 模型绑定 模型与前端组件的绑定分为值绑定和属性绑定，绑定会在指定组件上创建双向数据绑定。 典型的值绑定场景有：表单、表格、列表视图对应的model绑定，以及输入框、下拉框等基础组件对应的value绑定，类似Vue的v-model。 典型的属性绑定场景有：下拉框的选项值、步骤条的步骤值等，类似Vue的v-bind。 如图7所示的例子中，实现了表格DataGrid组件与值的绑定。 图7 数据绑定

设计视图 标准页面中预置了多种组件，在开发页面时，可以直接从左侧组件区域，将这些组件拖拽到右侧“页面内容”中。 图1 标准页面编辑界面（UI Builder） 配置组件属性 了解组件使用场景及配置方法 在配置使用组件前，可以将光标放在每个组件上后，组件右上角将显示帮助信息的问号图标。单击问号图标，即可进入该组件介绍页面，了解并学习AstroZero预置前端组件的使用场景及参数配置方法。 图2 组件帮助信息入口 选中组件，查看组件属性 在“设计视图”中，选中一个页面组件，可以在右侧“属性”页签，设置该组件的绑定数据、样式等属性，如图3所示。在设计视图中选中一个文本框，可以在右侧修改这个文本框的标签名、样式、绑定的数据模型等。 图3 设置组件的属性 页面及组件的事件代码 在“设计视图”中，选中任意组件，可以在右侧“事件”页签，设置组件的关联事件。例如，可以选择一个“按钮”，然后在按钮的“点击”事件中，添加相应的事件代码，实现在单击按钮后将界面输入保存到数据库中。 图4 编辑组件的关联事件 利用组件导航，快速选中组件 当选中某个组件时，页面上方会在组件导航上显示它的html标签层级。因此，在组件数量比较多，位置较为紧密时，可以直接单击标签层级，快速选择组件，也可以快速切换组件。例如，在上图的组件导航中单击“页面”，可以直接选中页面上的最外层页面组件。 利用组件树，快速选中组件 在组件数量比较多，位置较为紧密时，也可以单击页面右下角的“组件树”，展开组件树，在组件树中，直接单击标签层级，快速选择组件，也可以快速切换组件。 图5 利用组件树快速选中组件

实现原理 图1 用户登录服务编排大致设想 如图1所示，用户登录服务编排业务逻辑实现过程如下： 通过调用“用户登录”脚本，查询登录账户密码，然后使用“决策”图元进行判断，判断当前登录的账号密码是否正确。 如果判断账户密码错误，直接执行“账户密码错误”，判断账户密码正确，则使用“决策”图元，继续判断是否有验证码。 如果判断当前登录没有验证码，则直接执行登录，判断当前有验证码，则继续判断验证码是否正确。 如果判断验证码正确，则执行登录操作，判断验证码错误，则执行验证失败。

操作步骤 “用户登录”服务编排开发的大致过程：先拖拽1个脚本图元，3个决策图元以及3个赋值图元，再分别配置各个图元属性，然后配置各个图元之间连线类型，最后保存启用。 在“我的应用”中，单击“设备维修管理系统”，进入应用。 在“User”目录中，将鼠标放在“Flow”上，单击界面上出现的“+”，在弹出菜单中选择“服务编排”。 选中“创建一个新的服务编排”，在“标签”和“名称”文本框中输入“login”，并设置类型为“Autolaunched Flow”，单击“添加”。 定义服务编排用到的变量。 单击，展开全局上下文，再单击“变量”后的，设置参数名称为“username”，如图2所示。 图2 新增变量 重复上一步，定义其他变量。 需要定义的变量如表1所示。 表1 服务编排变量说明 变量名称（唯一标识） 数据类型 username（上一步已创建） 文本 password 文本 msg 文本 userId 文本 loginMsg 文本 captcha 文本 profile 文本 单击“公式”后的，在左侧公式弹窗中，设置“名称”为“portalUserLogin”，“表达式”为“PORTALUSER LOG IN({!username})”，单击“保存”。 图3 添加公式变量“portalUserLogin” 参考上一步，创建公式变量“verifyCode”，需要定义的变量如表2所示。 表2 公式变量说明 名称 表达式 verifyCode VERIFYCODEWITHTYPE({!captcha},"login") 拖拽图元到服务编排画布，并配置图元的基本属性。 从图元区分别拖拽脚本（1个）、决策（3个）、赋值（3个）图元到画布中，排列，如图4所示。 图4 拖拽脚本（1个）、决策（3个）、赋值（3个）图元 选中“Script0”图元，在右侧基本信息中，设置“标签”为“查询用户”。 参考5.b，设置其他图元的“标签”属性，具体值如表3所示。 表3 图元基本属性 名称（变量唯一标识，不需要修改） 标签 Script0（上一步已设置） 查询用户 Decision0 判断账号密码 Decision1 判断是否包含验证码 Decision2 校验验证码 Assignment0 账号密码错误 Assignment1 执行登录 Assignment2 验证失败 图5 修改后图元 配置“查询用户”脚本图元。 单击，指定图元对应的脚本名称 （HW__login），并配置脚本的输入输出参数。 单击“全局上下文”，显示变量列表，从“变量”中，拖拽“username”、“password”、“captcha”到“输入参数”下对应的“源”输入框中。 在“输出参数”下，单击5次“新增行”，依次添加下拉选项中的输出参数字段，并从“变量”中拖拽相应的字段到“目标”输入框下，字段与变量对应关系如图6所示。 请直接从全局上下文拖拽“变量”到对应的输入输出参数下，请勿手动输入，手动输入的值系统可能不识别。 图6 拖拽脚本的输入输出参数 配置“判断账号密码”决策图元。 选择“判断账号密码”图元，在右侧单击图标，修改“默认”的“名称”为“loginFail”。 图7 修改“默认”结果名称 单击“新增”，增加一个可编辑的结果，修改结果为“loginSuccess”，在“可视”下单击“新增行”，并拖拽变量中的“msg”到“资源”下，设置“比较符”为“==”，“值”为“"登录成功！"”。 请直接从全局上下文拖拽变量“msg”到“资源”下，请勿手动输入，手动输入的值系统可能不识别。 "登录成功！"需要与“login”脚本中的输出参数一致。 图8 修改可编辑的结果 配置“判断是否包含验证码”决策图元。 选择“判断是否包含验证码”图元，在右侧单击图标，修改“默认”的“名称”为“hasVerifyCode”。 图9 修改“默认”结果名称 单击“新增”，增加一个可编辑的结果，修改结果为“noVerifyCode”，在“可视”下单击“新增行”，并拖拽变量中的“captcha”到“资源”下，设置“比较符”为“==”，“值”为“""”。 图10 修改可编辑的结果 配置“校验验证码”决策图元。 选择“校验验证码”图元，在右侧单击图标，修改“默认”的“名称”为“verifyCodeFail”。 图11 修改“默认”名称 单击“新增”，增加一个可编辑的结果，修改结果为“verifyCodeSuccess”，在右侧选择“公式”，并从全局上下文中，拖拽“verifyCode”到“公式”下。 图12 修改可编辑的结果 配置“账号密码错误”赋值图元。 选择“账号密码错误”图元，在右侧单击图标，单击“新增行”，从全局上下文的“系统变量”中，拖拽“$Flow.ResMsg”到“赋值”下，并设置“操作符”为“=”，拖拽“msg”到“值”；然后再拖拽“系统变量”下的“$Flow.ResCode”到“赋值”的“变量”下，设置“操作符”为“=”，设置“值”为“"1"”。 请直接从全局上下文拖拽变量到“赋值”下的对应位置，请勿手动输入，手动输入的值系统可能不识账。 图13 配置“账号密码错误”图元 配置“执行登录”赋值图元。 选择“执行登录”图元，在右侧单击图标，单击5次“新增行”。 从全局上下文，拖拽“msg”等字段到“赋值”的“变量”下，并设置“操作符”为“=”，然后再拖拽“值”下的各个值，具体字段对应关系，如图14所示。 图14 拖拽“执行登录”赋值的变量及值 请直接从全局上下文拖拽变量到“值”下的对应位置，请勿手动输入，手动输入的值系统可能不识别。 表4 变量与值对应关系 变量 操作符 值 loginMsg = portalUserLogin msg = msg profile = profile username = username userId = userId 配置“验证失败”赋值图元。 选择“验证失败”图元，在右侧单击图标，单击“新增行”，从全局上下文“系统变量”，拖拽“$Flow.ResMsg”、“$Flow.ResCode”到“赋值”下，并设置操作符为“=”，分别设置“值”为“"验证码错误！"”、“"1"”。 表5 赋值 变量 操作符 值 $Flow.ResMsg = "验证码错误！" $Flow.ResCode = "1" 图15 配置“验证失败”赋值图元 拖拽图元连线，并配置连线属性。 在画布上，把鼠标放在起点图元图元上，从“+”拖动鼠标，在起点图元和“查询用户”图元间增加连线；即将当前脚本设置为服务编排的起始节点。 依次在“查询用户”、“判断账号密码”、“判断是否包含验证码”、“执行登录”图元直接拖拽连线。 图16 拖拽连线 单击“判断账号密码”与“判断是否包含验证码”图元之间的连线，在右侧属性单击，在“连线”中修改“连线类型”为“loginSuccess”。 图17 选中连线 图18 修改连线类型 单击“判断是否包含验证码”与“执行登录”图元之间的连线，在右侧属性单击，在“连线”中修改“连线类型”为“noVerifyCode” 从“判断账号密码”图元上拖拽一条连线到“账号密码错误”图元。 从“判断是否包含验证码”图元上拖拽一条连线到“校验验证码”图元。 从“校验验证码”图元上拖拽一条连线到“验证失败”图元。 从“校验验证码”图元上拖拽一条连线到“执行登录”图元，并设置该连线的“连线类型”为“verifyCodeSuccess”。 连线拖拽完成，如图19所示。 图19 拖拽图元连线 定义服务编排的输入、输出参数，并保存服务编排。 鼠标在画布空白处点一下，单击右侧，设置服务编排的输入输出参数，如图20所示。 图20 拖拽服务编排的输入输出参数 单击服务编排页面上方的，保存服务编排。 系统会弹出窗口，显示编译结果。 测试服务编排能否正常执行。 单击服务编排编辑器上方的，执行服务编排。 在“Flow Run”界面中输入测试数据，单击“运行”。其中,“test_cs”、“{XXXXXXXX}”为用户注册脚本中测试数据。 { "username": "test_cs", "password": "{XXXXXXXX}", "captcha": "" } 执行成功，界面上会返回设备对象中的全部信息，样例如下： { "interviewId": "002N000000jjQ95dKbCK", "outputs": { "loginMsg": "null", "msg": "登录成功！", "profile": "cs", "userId": "10gg0XXXXXXXXXXXXX", "username": "test_cs" }} （可选）在服务编排编辑器单击“跟踪”，可以查看到上一步的执行日志，方便定位错误。 测试成功，单击服务编排编辑器上方的，启用发布服务编排。

背景信息 本示例中创建了3种业务用户的业务权限，主要是在AstroZero预置的Portal User Profile权限基础上，进行自定义业务用户权限配置和拓展实现的。在AstroZero的权限配置功能中，基于某个权限配置的新创建的Profile，将会继承原Profile的全部权限。 在后续有新的业务用户注册时，只需要将业务用户添加到对应的权限配置中，即可获取该权限配置中的权限。 权限配置创建的大致流程：

步骤四：创建工作流 基于工作流中HR类流程模板，创建工作流，并设置各泳道责任人。 创建工作流。 在BTA新版应用设计器的“开始”页面中，单击“新建工作流”。 在新建工作流页面，单击“基于模板”，设置标签、名称和描述信息。 图12 添加工作流 单击“选择模板”，选择“HR”中的“出差申请”模板后，单击“创建”。 图13 选择出差申请模板 创建完成后，自动进入出差申请工作流编辑页面。在设置工作流前，您可以先通过表2了解出差申请工作流中各节点的功能。 图14 出差申请工作流开发页面 表2 出差申请工作流中各节点功能介绍 编号 节点 功能说明 1 提交申请 开始节点，调用一个标准表单TravelRequest，供出差申请人提交出差申请。 2 数据映射 将出差申请标准表单中的请求字段映射到对象中。 3 申请审批 用户任务，将对象中的字段渲染到标准表单Approve并且确定审批人。 4 审批网关 审批人进行通过或拒绝两种操作。 5 数据映射 申请拒绝后，将Approve标准表单中的字段映射回TravelRequest标准表单。 6 重新填写请求 刷新TravelRequest表单中的内容，重新提交出差申请。 7 数据映射 将TravelRequest表单中的字段值映射到Approve中，重新发起审批申请。 8 发送邮件 审批通过，发送邮件将结果告知出差申请人。 9 流程结束 结束节点，执行到此整个工作流执行结束。 设置工作流，配置各泳道处理人。 在进行工作流设计前，请先参照工作流中内容对工作流设计界面进行全面的了解。 在工作流开发页面，单击“Process Owner”泳道，配置工作队列为“Employee”。 图15 配置员工为申请人 单击“Reviewer”泳道，配置工作队列为“Manager”。 图16 配置主管为审批人 单击泳道“Process Owner”上的“重新填写请求”用户任务元素，设置任务标题为“待重新提交”。 执行该操作的目的是，后续在“我的待办”中可以看到“待重新提交”的任务状态。 图17 配置为待重新提交 单击泳道“Reviewer”上的“申请审批”用户任务元素，设置任务标题为“待主管审批”。 执行此操作的目的是，后续在“我的待办”中可以看到“待主管审批”的任务状态。 图18 配置为待主管审批 单击，保存工作流。 单击，启用工作流。

步骤3：创建空白应用 创建应用是在AstroZero开发环境开发项目的第一步，也是端到端构建软件应用的入口。 以华为账号登录AstroZero服务控制台。 在实例列表中，单击“进入首页”，进入应用开发页面。 在左侧导航栏中，单击“应用”，进入低代码应用页面。 单击新建低代码应用后的，进入新建空白应用页面。 图9 进入创建轻应用入口 在新建低代码应用中，选择“标准应用”，单击“确定”。 设置应用标签和名称，此处均设置为BTA。 图10 设置轻应用标签和名称 图10名称前模糊掉的内容为命名空间，在AstroZero中为了避免不同租户间数据的重名，租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间，创建后不支持修改，请谨慎定义。 单击“新建”，进入BTA新版应用设计器。 图11 BTA新版应用设计器

操作流程 在AstroZero中开发出差审批应用的流程，如图2所示。 图2 出差审批应用开发流程 步骤一：添加业务用户并进行授权 本示例中的应用包括主管和员工两种角色的业务用户。创建出差审批应用前，需要将员工、主管添加到AstroZero中。 步骤二：创建队列 队列是AstroZero中的一种成员集，即在实际业务场景中，用来记录一类具有相同权限和任务对象的成员集。本示例中需要创建2个队列，用于在工作流中区分不同角色在流程中处理的任务。 步骤3：创建空白应用 创建应用是在AstroZero开发环境开发项目的第一步，也是端到端构建软件应用的入口。 步骤四：创建工作流 基于工作流中HR类流程模板，创建工作流，并设置各泳道责任人。 步骤五：配置BTA应用 在应用配置中，定义出差审批应用的导航菜单栏。 步骤六：业务功能调测 验证出差审批流程是否按照预期执行，即员工提交出差申请，主管对申请进行审批，分别测试审批通过、拒绝与重填。

方案概述 AstroZero低代码平台基于业界BPMN 2.0标准，实现了自己的业务流程管理系统，即工作流。AstroZero中的工作流是一套图形化的流程编排引擎，着重于构建带有用户交互行为的业务流程，例如审批流、工单派发流程等。本实践通过创建一个出差审批应用，帮助您快速熟悉AstroZero中的工作流。 员工出差是企业运营中最常见的业务场景，涉及到一系列的管理流程，例如出差申请、审批、行程安排、费用报销等。本实践以一个简单的员工出差场景，即员工在出差前需要提交一个出差申请审批的电子流程，员工提交出差申请后，主管处理审批或拒绝提交人申请，向您介绍如何使用AstroZero中的工作流。本示例中的出差审批应用主要包括如下功能： 基于工作流模板创建出差电子流。 发送邮件。 图1 出差审批应用最终效果图

背景与知识 “用户管理”功能包括业务新增业务用户、查看删除业务用户、添加业务用户权限集三部分。 在业务场景中，会区分不同业务用户，业务用户对应了不同的用户权限，本示例应用中包含的业务用户，即是使用设备管理应用的用户，分别是客服人员、派单员及维修人员。 在AstroZero开发的应用的所有业务用户，最终都会存储到平台的业务用户表中，即PortalUser表。业务用户在登录应用后的访问权限是通过Profile进行控制管理的，可基于平台预置的Portal User Profile进行自定义业务用户权限。 图1 业务用户 父主题： 用户管理功能开发

操作流程 将AstroZero中的应用发布成 WeLink 轻应用的流程，如图2所示。 图2 开发WeLink轻应用流程 步骤一：准备账号并完成绑定 在AstroZero的环境配置中，将AstroZero和WeLink进行绑定。 步骤二：添加WeLink用户为AstroZero开发者 如果需要WeLink用户在AstroZero开发环境中具备开发者权限，请添加WeLink用户为AstroZero开发者用户，并赋予开发者权限。 步骤三：创建AstroZero调查问卷应用 在AstroZero开发环境中创建“调查问卷应用”，设置应用在移动端显示效果，并为Welink用户设置业务访问权限。 步骤四：编译发布应用 将在AstroZero上创建的应用发布到WeLink上。 步骤五：在WeLink移动端测试应用 应用发布后，可以在WeLink手机端搜索并验证已发布的轻应用，也可以在企业WeLink管理员界面直接扫码进入轻应用。 步骤6：（可选）将运行环境中应用发布到WeLink 如果您购买的是AstroZero商用版实例，还支持将AstroZero开发环境中的应用发布到运行环境，由运行环境发布到WeLink。