华为云用户手册

代码编辑器 在代码编辑区域，在符号上单击鼠标右键，会出现如图2所示代码导航功能。除此之外，脚本编辑器还提供了智能提示、代码补全、显示光标的所在行和列信息等能力。 图2 代码导航 Go to Definition 在代码编辑区域，在符号上单击鼠标右键，选择Go To Definition，可以跳转到符号的定义代码部分。 Go to References 在代码编辑区域，在符号上单击鼠标右键，选择Go to References，可以查看符号在脚本中的引用情况。 Run 在代码编辑区域，在符号上单击鼠标右键，选择Run，执行脚本。 Go to Symbol 在代码编辑区域，单击鼠标右键，选择Go To Symbol，选择任意符号，可以跳转到该符号的定义代码部分。 Peek Definition 在代码编辑区域，在符号上单击鼠标右键，选择Peek Definition，可以查看代码的定义。 Peek References 在代码编辑区域，在符号上单击鼠标右键，选择Peek References，可以查看代码的引用。 Rename Symbol 在代码编辑区域，在符号上单击鼠标右键，选择Rename Symbol，可重命名所选符号。 Change All Occurrences 在代码编辑区域，选中一个字符串，单击鼠标右键，选择Change All Occurrences，可以批量修改代码中所有包含该字符串的内容。 Format Document/Format Selection 在代码编辑区域，选择一块代码，单击鼠标右键，选择Format Selection；或者直接在任意位置单击鼠标右键，选择Format Document，可以对代码进行格式化排版。 Fix lint issue 在代码编辑区域，选择一块代码，单击鼠标右键，选择Fix lint issue；或者直接在任意位置单击鼠标右键，选择Fix lint issue，可以对代码进行静态规范错误修复。 Cut/Copy 在代码编辑区域，选择代码单击鼠标右键，选择Copy，可以剪切或者拷贝所选代码。 Command Palette 在代码编辑区域，在符号上单击鼠标右键，选择Command Palette或者按F1，进入命令面板，可以执行很多编辑功能。 图3 命令面板 Hover 把鼠标停留在符号上，可以查看符号的定义概要。再按住Ctrl键，单击符号，可以查看符号更加详细的定义。 例如，鼠标停留在“useObject”上，显示如下图所示，可查看其定义概要。按Ctrl键，单击“useObject”，可查看更详细的定义。 图4 查看定义概要 图5 查看更详细的定义 Bracket matching 高亮显示与选择内容匹配的符号，如{}、()、[]等。 图6 Bracket mathching Errors & Warnings 编辑代码时，如果有语法错误，会在这个语法下面显示红色波浪线，鼠标移动上去，会显示具体错误。 图7 Errors&Warnings Go to Line 按“Ctrl + g”，再输入行号，可以跳转到指定的代码行。 Search and Replace 按“Ctrl + f”，输入关键字，可以搜索当前代码的内容。表示搜索的内容分别支持大小写匹配、全文匹配、正则表达式。 按Ctrl + h，输入关键字，可以查找并替换代码中的内容。 Code Complete 全局符号补全 图8 complete_symbol 对象成员补全 图9 complete_member 参数补全 图10 complete_parameter Comment Code 在代码编辑区域，选择一块代码，输入“ctrl + /”组合键，可以注释或去注释选择的代码块。 Save File 在代码编辑区域，“按Ctrl + s” ，或者单击右上角的保存图标，可以保存脚本。

脚本主要用什么语言和库 低代码平台的脚本引擎采用TypeScript语言。脚本执行时，TypeScript语言会被翻译成JavaScript语言，由JavaScript引擎执行。 在JavaScript es5的官方标准库外，低代码平台还扩展了10+预置标准库（即预置API），帮助您更高效地开发脚本，有关系统预置的标准库说明请参见脚本中预置的API。 库的使用方法举例： import * as http from 'http';

脚本用什么编辑器 AstroZero提供一个方便简洁的在线开发IDE，即脚本编辑界面，脚本编辑界面开发体验接近离线的开发工具，具有如下优势： 现代化的编辑界面，语法高亮显示。 智能提示，智能补全。 精确查看定义，代码预览，查找引用。 快速在线编译。 友好的语法错误提示。 可以使用console.log，写 日志分析 复杂的问题。 脚本编辑界面如图1所示，您可以在线编辑、测试和发布脚本。 图1 脚本编辑界面 按钮区域 脚本编辑页面常用的图标按钮区，具体功能说明如表1所示。 表1 图标说明 图标 说明 / 获取锁、释放锁。脚本在获取锁后，才能进行编辑。 / ，单击即可启用脚本，该图标高亮时，表示当前脚本已被启用。 ，单击即可禁用脚本，该图标非高亮时，表示当前脚本未启用。 说明： 脚本开发完成后，需要启用脚本。只有启用状态的脚本，才能在被其他资源（如服务编排、标准页面）调用时，搜索到。 保存脚本。 另存为脚本。 设置脚本属性，如可见性、是否开启允许覆盖等。 执行脚本。 / 操作回退、撤销回退。 对已开发好的脚本代码进行性能检查、兼容性检查和静态配置检查。 说明： 代码检查的具体操作，请参见脚本代码性能检查规则说明。 刷新当前引入的脚本到最新状态。 单击该图标，脚本编辑器可分屏显示。 脚本启用后，单击右上角的，可查看该组件的调用关系图。 版本对比。 切换版本。 代码编辑区域 在该区域开发代码，实现功能。代码编辑器提供智能提示、代码补全、显示光标的所在行和列信息等能力，更多介绍请参见提供AI代码补全功能。 脚本编辑页面同样支持离线编辑器中的常规快捷键操作，例如“Ctrl+S”可以保存当前修改，“Ctrl+H”可以调出查找替换对话框，您也可以根据自己的开发习惯，尝试各种快捷键操作。 测试区 运行代码后的显示区域。在“输入参数”页签输入参数后，单击测试区右侧的运行按钮，运行脚本。即可在“输出参数”页签，查看输出结果是否正确。在“问题”和“日志”页签，查看问题和日志。除此之外，还支持清除日志输出、运行脚本并动态检查和保存输入参数。

如何使用发送事件图元 在基本中，拖拽“发送事件”图元至画布中。 选中发送事件图元，单击，设置基本信息。 表1 基本信息参数说明 参数 参数说明 标签 图元的标签，用于在页面显示。系统会自动填入该值，格式为Event序号，序号从“0”开始，表示同类型图元序号。 名称 该图元的标识，请确保在当前服务编排中唯一。 描述 该图元的描述信息。 单击，在“发送事件”页面进行配置。 图1 配置发送事件图元 表2 发送事件图元配置参数说明 参数 参数说明 事件 选择待发送的事件。 分区字段 从事件中选择一个自定义参数用作Kafka的分区字段，则根据该字段值进行路由，相同的值将路由到同一个Kafka分区；如果不指定，则默认随机路由到不同Kafka分区，从而提升并发处理性能。 须知： 建议选择有区分度的关键字段，该字段必须是事件的自定义字段。 发送到外部 系统内部有配置与AstroZero相连Kafka的固定Topic“__BINGO_SYS_TOPIC”。 若不勾选“发送到外部”，表示将事件数据发到默认的Topic上。 若勾选“发送到外部”，表示将事件数据发送到与AstroZero相连Kafka的其他Topic上，此时需要配置其他的Topic。 默认不勾选。 延迟到事务结束（提交或回滚）后才发送 是否延迟到该服务编排事务结束后，才发送事件。 默认不勾选，表示流程执行到该图元时立即发送事件。 主题 当勾选“发送到外部”时，该参数才会显示，表示非系统配置的默认Topic。 需要从与AstroZero相连Kafka处，获取其他主题Topic。 目标/源 配置事件数据，为该事件自定义参数赋值，将“源”取值赋值到“目标”中。单击“新增行”，可添加并进行赋值。 目标：从下拉框中，选择事件的自定义参数。 源：从全局上下文拖拽变量或直接输入“{!变量名}”，给目标赋值。

操作步骤 参考登录经典应用设计器中操作，登录经典版应用设计器。 在需要设置水印的高级页面后，单击“...”，选择“设置”。 若页面已被锁定，请在编辑页面上方单击，先获取锁。 图1 选择“设置” 在“水印”页签，参考如何设置页面水印设置参数，单击“保存”。 图2 水印设置 图3 设置后效果 表1 参数说明 参数 说明 启用水印 是否给该页面启用水印。 重复渲染 当需要设置满页面水印时，开启该项。 水印内容 设置水印文本内容。 当前用户 当需要设置水印内容为当前用户名时，可开启该项。 开启后，“水印内容”中的文本不生效。 水印长度 水印矩形框的长度。 水印宽度 水印矩形框的宽度。 水平起始位置 当关闭“重复渲染”时，才可设置，表示单个水印在页面的水平起始位置。 垂直起始位置 当关闭“重复渲染”时，才可设置，表示单个水印在页面的垂直起始位置。 字体颜色 水印字体的颜色。 字体大小 水印字体的大小。 旋转角度 水印的旋转角度，取值范围-180~180，即逆时针或者顺时针旋转180度。 透明度 水印的透明度设置。

属性 数据绑定：通过建立不同类型的视图模型，将各种数据源和组件的返回值或者属性值进行关联，实现动态数据效果。 值绑定：设置组件绑定的数据模型，数据模型一般有以下几种。更多介绍，请参见值绑定。 自定义：由用户自定义的前端模型，可以在模型树上快速创建自定义字段。 对象：由后台对象模型映射创建，支持选择字段。 服务：由后台服务的出入参数模型创建，分别生成inputParam和outputParam节点。 事件：由后台事件的字段映射创建，并且支持websocket刷新模型数据。 属性值绑定，用于对该组件所有属性的动态设置。当某一属性被动态绑定时，以绑定值为准。更多介绍，请参见属性绑定。 基本属性：基本属性通过数据绑定后，在运行时以数据绑定的值为准。 配置菜单：单击“设置”，可设置菜单。 图标：配置菜单的图标。 文本内容：配置菜单的显示名称。 RUL类型：菜单跳转页面的URL类型，如“常量”、“选择页面”。 地址：当“URL类型”为“常量”时，需要配置跳转页面的具体URL地址。当“URL类型”为“选择页面”时，需要选择系统中创建的具体跳转页面。 链接目标：跳转后页面显示形式。 新窗口：在新窗口页，显示跳转页面。 当前框架：在当前框架，显示跳转页面。 父框架：在父框架区域，显示跳转页面。 整个窗口：在当前整个窗口，显示跳转页面。 分隔符：菜单名之间的分隔符。 跳转：单击面包屑组件的菜单标签，是否开启自动跳转，默认为开启。若不开启跳转，可在“事件”页签定义跳转的实现方法，即进行事件编排。 公共 控件名称：当前组件的名称。 隐藏：是否隐藏该组件，此方式为静态配置该组件的隐藏。还可以将该组件属性值“隐藏”配置为布尔类型模型字段，在自定义JS代码中来控制模型字段取值，从而设置该组件是否隐藏，这种动态设置优先级是最高的。 样式 布局：设置组件的宽度、高度等。 字体：设置字体大小、字体样式、颜色等。 背景：设置背景颜色、透明度。 边框：设置边框颜色、宽度等，单位为px。 阴影：设置阴影颜色、模糊、扩散等，单位为px。 高级设置 样式源码：组件具体样式代码，组件样式设置后，样式代码将自动显示在“样式源码”中，也可以自定义样式代码，对组件进行详细配置，自定义代码支持多行输入，并高亮显示样式参数。 样式类：当前组件使用的 CSS 样式类名，可在 CS S代码中进行引用。

运行服务编排 服务编排开发完成后，单击页面上方的，保存服务编排。 保存后，系统会对服务编排进行编译。如果有报错或者警告，请单击“确定”，在服务编排编辑器页面修改服务编排。修改后再次保存，直至无报错和警告。 保存成功后，单击页面上方的，运行服务编排。 在弹出的输入参数页面进行配置，单击“运行”。 如果有输入参数，请输入参数后，再单击“运行”。如果该服务编排没有输入参数，可直接单击“运行”。 表1 基本信息参数说明 参数 参数说明 请求头参数 请求消息头的参数配置，“键”为参数名，“值”为参数取值。 单击“请求头参数”前的，会显示映射区域“键”和“值”。若需要多个请求头参数，请单击“添加行”。 responseType('arraybuffer') 表示返回响应的类型。勾选时，表示返回响应是一个包含二进制数据的JavaScript ArrayBuffer。 输入参数 填写该服务编排运行实例的输入参数及取值。 检查输出页签的调试结果，是否符合预期。 图1 调试结果 表2 输出页签 调试结果 取值 查看日志 单击该按钮，可弹出“日志跟踪器”，显示该服务编排实例的运行日志。 结果 调试结果。 成功 '参数名'的值'%!v(BADINDEX)'无效或格式非法 输出 该服务编排的输出内容，检查输出是否和预期一致。 若输出结果符合预期，单击服务编排编辑器页面上方的，启用服务编排。 若发现输出结果不符合预期，单击服务编排编辑器页面右上方的“跟踪”，打开“跟踪器”页面，查看详细信息。 在“跟踪器”页面，查看服务编排执行的每一步的详细信息。检查哪一步的输出不符合预期，并进行调试。 图2 日志跟踪器

调试服务编排 在服务编排编辑页面，选中需要设置断点的图元，单击鼠标右键选择“设置断点”。 设置断点后，选中图元，单击鼠标右键选择“禁用断点”或者“移除断点”，可禁用或移除断点。 目前不支持在等待Wait图元，以及等待图元之后的所有图元，设置断点。 图3 设置断点 单击服务编排编辑器上方的，开始调试服务编排。 在弹出的输入参数页面进行配置，单击“运行”。 如果有输入参数，请输入入参，再单击“运行”。如果该服务编排没有输入参数，请直接单击“运行”。 在服务编排编辑器左侧，可看到调试页面，单击可执行到下一断点，单击可停止调试，查看执行到某一断点的参数变化是否符合预期。 图4 调试页面 左侧调试页面说明： 变量：展示执行到当前断点，服务编排中的变量取值情况，包括全局变量、某图元的输入输出变量等。 调用堆栈：执行到当前断点时，出现的调用堆栈。 正在调试：正在调试的服务编排名。当执行到子服务编排时，该处显示当前子服务编排名。 断点：展示设置的所有断点，选中某一断点，单击鼠标右键可出现“移除断点”、“移除所有断点”、“启用所有断点”或“禁用所有断点”。也可以单击该区域某一断点，进行启用或禁用该断点。 单击服务编排编辑器页面右上方的“跟踪”，打开“跟踪器”页面。 在弹出的页面，可查看服务编排执行的每一步的详细信息。 图5 查看详情信息 关闭跟踪器页签，单击，至执行完最后一个断点，调试结束。 重新设计问题图元以及前后逻辑，再次运行服务编排，直至结果符合预期。 单击服务编排设计器页面上方的，启用服务编排。 调试服务编排符合预期后，需要启用服务编排。启用后，服务编排才能在系统中使用。

配置Chart时的规则约束 规则1：在配置Chart时，Chart中应尽量避免包含密码等敏感信息。若需要配置敏感信息，用户需要自行对敏感信息进行加密，且Chart中不能包含解密敏感信息需要的密钥。 规则2：将Chart中的易变参数定义为全局变量，可避免因为参数变更时，修改并重新生成Chart包。 全局变量将用于生成Chart包中的“values.yaml”文件。在华为云CCE上部署Chart时，“values.yaml”文件的内容可以通过界面进行修改。因此，应将和环境相关的信息或其他易变参数定义为全局参数，例如镜像地址、pod实例数等。 规则3： 必须要为Ingress资源配置注解，注解中键为“nginx.ingress.kubernetes.io/ssl-redirect”，值为“false”。 华为云CCE的Kubernetes集群默认部署Nginx控制器，需要在Ingress上添加注解。如何添加注解，请参考Kubernetes资料。 AstroZero平台在调用Native服务的接口时，无法处理重定向的响应，必须给Ingress添加表1中的注解。 表1 注解1 注解中键 注解中值 nginx.ingress.kubernetes.io/ssl-redirect false Nginx控制器默认后端service使用http协议，如果后端service使用的是https协议，请添加表2中的注解。 表2 注解2 注解中键 注解中值 nginx.ingress.kubernetes.io/backend-protocol HTTPS nginx.ingress.kubernetes.io/secure-backends true 建议1：保持Chart简洁，建议一个Chart中工作负载不超过3个。 保持Chart简洁，可以降低部署、升级失败的概率，在升级时能更有效地控制升级的范围。 建议2 ：同一个Chart中，为所有图元的名称定义相同的前缀。 例如，某Chart中所有图元以“template-”为前缀，无状态负载的名称可以命名为“template-deployment”，ConfigMap的名称可以命名为“template-dbconfig”等。使用相同的前缀，可以使用户更方便识别Kubernetes资源的归属，同时降低命名冲突的可能性。 建议3：当全局变量的值是多行文本时，文本中出现的空行应不含任何空格字符。 全局变量将用于生成Chart包中的“values.yaml”文件，在yaml文件中，通过缩进表达层次关系，而空行中的空格字符会影响yaml文档的缩进排版。例如，当全局变量名为“dbConfig”，变量值为： jdbc.url: jdbc:mysql://127.0.0.1:3306/testdb jdbc.username: admin jdbc.password: {XXXXXXXX} jdbc.driver-class-name: org.mariadb.jdbc.Driver 生成的values.yaml内容为： dbConfig: |- jdbc.url: jdbc:mysql://127.0.0.1:3306/testdb jdbc.username: admin jdbc.password: {XXXXXXXX} jdbc.driver-class-name: org.mariadb.jdbc.Driver 当全局变量名为“dbConfig”，变量值为（第4行中包含一个空格字符）。 jdbc.url: jdbc:mysql://127.0.0.1:3306/testdb jdbc.username: admin jdbc.password: {XXXXXXXX} jdbc.driver-class-name: org.mariadb.jdbc.Driver 生成的values.yaml内容为： dbConfig: "jdbc.url: jdbc:mysql://127.0.0.1:3306/testdb\njdbc.username: admin\njdbc.password:\ \ changeit\n \njdbc.driver-class-name: org.mariadb.jdbc.Driver" 通过流水线部署Chart时，第一种格式的“values.yaml”文件，更容易通过脚本进行修改。

配置API时的规则约束 规则：在“API设计”页签，单击“开始设计API”，创建API时，API的命名空间应选择“局部命名空间”。 在创建API时，“命名空间”支持选择“局部命名空间”和“全局命名空间”。使用“局部命名空间”，可保证API的名称不会和其他Native服务的API名称出现冲突。而“全局命名空间”，是为了版本向前兼容而保留的。在AstroZero 1.2.10及之前的版本中，API无命名空间的概念，相当于API定义在全局名称空间中，因此，不同Native服务的API命名出现冲突的可能性比较大。

镜像开发中的规则约束 用户可自行开发镜像，并上传到CCE华为云容器中或使用第三方镜像仓库的镜像。在进行镜像开发时，需要遵循如下的规则约束： 规则1：容器镜像必须使用，1.11.2或以上版本的Docker客户端进行制作。 如何制作Docker镜像，请参考如何编写高效的Dockerfile。 规则2：Native服务向AstroZero平台开放的接口，必须是“application/json”格式的restful接口。 开放给AstroZero应用调用的Native服务接口，请求消息和响应消息的“Content-Type”都必须是“application/json”。 规则3：Native服务开放的接口应使用HTTP消息头进行认证，不要依赖于Cookie。 AstroZero会丢弃Native服务返回的Cookie信息，因此，Native不能使用Cookie来维持状态。 Native服务示例代码如下： LOG .info("Authentication begin."); String auth = request.getHeader("Authorization"); // next: verify auth 建议：服务的日志建议输出到一个独立的目录，且日志文件命名以“.log”、“.trace”或“.out”后缀结尾，方便后续使用华为云的 应用运维管理 （简称 AOM ），采集日志文件，并将日志展示在AOM的界面上。

属性 在属性中，设置自定义背景框组件的位置、边框、背景等。 图2 属性 基础 组件标题：设置组件的标题。 组件名称：设置组件的名称。 位置 距离左端：组件到页面左侧的距离，单位为px。 距离顶端：组件到页面顶部的距离，单位为px。 宽度：组件的宽度，单位为px。 高度：组件的高度，单位为px。 堆叠顺序：设置组件层叠显示顺序。组件的堆叠顺序默认都是“1”，数字越大，显示越靠前。当需要让组件置底时，可设置堆叠顺序为“0”。 自适应高度：组件的高度是否随宽度改变。 边框：设置组件的边框样式，如全边框或角边框。 背景 样式：设置背景的样式，如普通、居中、拉伸等。 图片链接：背景图片URL。 颜色：设置背景的颜色。

操作步骤 参考如何登录经典应用设计器中操作，登录经典版应用设计器。 在左侧菜单栏中，单击。 在“已发布”中，选中包后单击“下载”，下载应用的zip包到本地。 图1 下载应用的zip包 可以用该zip包安装定制应用到其他AstroZero环境，zip包含的文件请参见表1。 图2 应用配置 表1 应用zip包文件说明 文件名 说明 data 应用涉及的实例化数据，在应用“配置”内创建的数据，以及该应用使用的连接器Connector（例如发送短信连接器、ROMA连接器、Redis连接器等），会自动归档到该目录下。不归档非应用内创建的实例化数据。 例如，在应用配置（如图2）中，创建的系统参数、选项列表等，应用内即便使用了它们，也不会自动归档，需要手动导出对象然后归档到该目录下。手动导出的方法，请参见如何导入导出数据。 flow 应用涉及的服务编排。 pageresource 标准页面的相关信息。 picklist 应用涉及的选项列表，只包含在应用内创建的选项列表。 schema 应用涉及的对象的元数据。 script 应用涉及的脚本。 website 高级页面的相关信息，例如，Widget、library和站点信息等。 CustomAPI.yaml 自定义接口的yaml文件。 packageinfo.json 软件包的元数据描述文件，主要包含应用的软件包名字、描述信息以及作者信息等。

前提条件 已获取到应用或BO的安装包。安装包为开发者在开发环境中发布应用或者BO时生成的包，具体操作请参考如何将应用发布到“我的仓库”，打包编译时可根据以下实际场景选择“资产包”或“源码包”。 在其他开发环境中安装源码包应用。安装后，会显示在开发环境首页的“项目”页签下。 源码包是某用户开发应用后，打包编译时选择“源码包”发布出来的应用包，该类型包中的所有组件都不受保护和限制。源码包只能在开发环境中安装。 在其他开发环境、沙箱环境或运行环境中安装资产包应用。在其他开发环境安装资产包后，应用会显示在开发环境首页的“库”页签下。 资产包是某用户开发应用后，打包编译时选择“资产包”发布出来的应用包，该类型支持设置包中的组件在其他开发环境安装后是否受保护。在沙箱环境、运行环境安装的资产包中组件资产都是受保护的。

在标准页面中与BPM交互 在标准页面的自定义事件中，内置了一些交互的API ： 获取变量：context.$bpm.loadVariables(): Promise 提交任务、流程： context.$bpm.submitTask(variables: {[key: string]: any}): Promise 修改变量： context.$bpm.putVariables(variables: {[key: string]: any}): Promise 图2 在标准页面的事件代码中与BPM交互

应用的生命周期 应用的开发阶段 应用是一个工程，可以创建对象模型，编辑标准页面和高级页面，开发服务编排和脚本逻辑，开发商业应用业务流程等。在应用的开发环境里，可以快速实现底层逻辑。 应用的部署阶段 应用是一个可安装的包，可以实现不同租户间和不同环境间的迁移，用户只要下载和导入这个应用包就可以部署应用。 应用的运行阶段 应用是一个可预览的运行界面。在工程能力中，将详细介绍应用的工程能力、部署打包等能力。

如何使用自定义错误码 自定义错误码创建完成后，可在脚本中使用。在脚本中，调用抛出错误信息的error函数I18nError('ErrorCodeName','变量1','变量2')。该函数中，输入参数为错误码名称"t__testErrorCode"和错误码信息中所携带的变量（"val1"和"val2"）。 创建脚本。 在经典版应用设计器中，将鼠标放在某个文件夹上，单击加号，选择“脚本”。 图3 选择脚本 设置脚本的名称，模板选择“空脚本”，单击“添加”。 图4 创建一个空脚本 在脚本编辑器中，输入如下代码。 // test custom error func , get diff language error by user lang import * as error from 'error'; export class TestDemo { @action.method({ label: 'test', description: 'error code', input: 'No input', output: 'No output' }) public test() { //使用I18nError函数设定错误码和错误码信息携带变量 throw new error.I18nError('t__testErrorCode', ["val1", "val2"]); } } 其中，“t__testErrorCode”为自定义错误码名称，请根据实际情况配置。 单击，保存脚本后，单击，启用脚本。 按照如何开放API接口中操作，绑定上述开发的脚本，进行测试。 图5 自定义错误信息测试

自定义错误码 参考登录经典应用设计器中操作，登录经典版应用设计器。 在页面左下方，单击“配置”。 图1 选择配置 在自定义错误码页签，单击“新建”，进入新建错误码页面。 也可以单击“导入”，选择系统中已创建的错误码进行导入。 设置错误码参数，单击“保存”。 图2 新建错误码 名称：自定义的错误码，建议以字母开头，长度不超过64个字节，包括命名空间。 类别：新建错误码所属的分类。 Http状态码：选择Http协议状态码。 语言：根据需要，选择所需的语言类型。单击“新增”，可添加多语言错误码。若待添加的语言不存在，可单击语言后的。在提示信息中，单击“翻译工作台”，跳转至翻译工作台配置页面进行添加。 格式：错误码的信息描述，支持使用{Number}表示变量名。例如 ，{0} 表示第一个输出变量，{1} 表示第二个输出变量，以此类推。

如何设置数据系列 选中基本饼图组件，单击鼠标右键选择“高级设置”。 展开数据系列配置，单击旁边的“+”，添加数据系列。 在右侧“数据”页签，配置该数据系列的数据。 例如，在使用系统预置的静态数据基础上，添加如下加粗代码，配置新增数据系列的数据。也可以使用“动态数据”调用后台接口URL返回如下结构模型数据。 图6 两个数据系列不用圆心坐标设置 { "resCode": "0", "resMsg": "成功", "result": [{ "dataValue": [{ "name": "关键事件", "value": [{ "value": 635, "name": "工程管理" }, { "value": 310, "name": "社会环境" } ] }, { "name": "类别", "value": [{ "value": 435, "name": "计算机" }, { "value": 210, "name": "文学" } ] } ] }] } 配置添加的数据系列圆心坐标，如果不配置，两个数据系列会重叠。 设置完成后，单击“确定”。

属性 在属性中，设置基本饼图组件的位置、边框、背景等。 图2 属性 基础 组件标题：设置组件的标题。 组件名称：设置组件的名称。 位置 距离左端：组件到页面左侧的距离，单位为px。 距离顶端：组件到页面顶部的距离，单位为px。 宽度：组件的宽度，单位为px。 高度：组件的高度，单位为px。 堆叠顺序：设置组件层叠显示顺序。组件的堆叠顺序默认都是“1”，数字越大，显示越靠前。当需要让组件置底时，可设置堆叠顺序为“0”。 自适应高度：组件的高度是否随宽度改变。 边框：设置组件的边框样式，如全边框或角边框。 背景 样式：设置背景的样式，如普通、居中、拉伸等。 图片链接：背景图片URL。 颜色：设置背景的颜色。

如何导入导出数据 实例化数据可以通过AstroZero平台的“数据导出”功能，以对象的方式导出到本地。安装实例化数据，可以通过平台的“数据导入”功能实现。关于数据的导入导出操作，请参见如何导入导出数据。 数据修改后，升级没变化：不是同一条数据，即ID不一致。 对象存在，但数据导出里面找不到该表：开发界面里对象属性“允许API批量访问”未勾上。 报错“parsing request parameters content of JSON failed: 'record'”：表中存在lookup/masterdetail类型的字段，该字段的值必须为id，不能是普通的值。 报错“file server exception, receive response failed, TrackerTask RecvHeader recv resp status 28 != 0”：文件服务器异常，需要咨询运维处理。

什么是实例化数据包 实例化数据是应用需要自带的预设数据，用于支持应用的默认行为。 在AstroZero平台中，实例化数据包是由以下三种类型数据的整体或部分构成的数据压缩包： 系统对象数据 AstroZero系统定义的实例化数据主要是用户在开发应用过程中平台产生或用户使用平台功能生成的，在应用安装完成后能够进行配置的数据。 标准对象数据 AstroZero平台内部自带的或第三方提供的标准对象数据，标准对象实例化数据包括了平台内置的（例如Account、Contact）以及订购了基线应用所提供的对象的实例化数据。 自定义对象数据 由用户通过建立自定义对象，并通过界面或接口生成的记录数据。 应用在发布时，包含一些初始化的数据，可通过单击，使用SQL语句查询对象及对象的数据，详情可参考使用控制台分析查询SQL。

弹出消息对话框 该预置动作，用于弹出消息对话框。以单击“确定”按钮，弹出“创建实例成功”的消息对话框为例，进行介绍。 在标准页面设计界面，选中按钮组件。 在右侧“事件”页签中，单击，进入添加动作页面。 在“内置动作”，单击“弹出消息对话框”，设置相关参数，单击“创建”。 图4 关闭弹出页面 消息类型：弹出的消息类型，如成功、错误、警告和提示。 标题：消息对话框左上角，显示的标题。 消息内容：消息对话框中，显示的消息内容。 内容作为HTML渲染：内容是否作为HTML渲染。动态渲染HTML容易导致XSS攻击，开启此属性时，请确保传入的内容是可信的。 按钮：消息对话框中，显示的按钮名称。 弹出后延时自动关闭：弹出后，是否支持延时自动关闭。勾选后，需要设置延时秒数。 例如：勾选该参数，并设置延时3秒。效果为弹出消息对话框后，3秒后自动关闭该弹框。 返回标准页面开发界面，单击页面上方的，保存页面。 单击，预览页面，单击“确定”按钮，可预览按钮的事件效果。

弹出页面 以单击“提交”按钮，弹出“提交成功”的提示页面为例，进行介绍。 在标准页面设计界面，选中按钮组件。 在右侧“事件”页签中，单击，进入添加动作页面。 在“内置动作”中，单击“弹出页面”，配置目标页面、窗口选项，单击“创建”。 图2 弹出页面 目标页面：设置弹出的目标页面类型。 当前应用页面：当前应用中，已创建好的页面。 URL：某个页面的URL。 窗口可拖拽：窗口是否可来回拖拽。 窗口标题：弹出窗口的标题内容。 窗口位置：弹出窗口在屏幕的位置，如屏幕中央或屏幕顶部居中。 窗口宽度：窗口的宽度，单位像素。 窗口高度：窗口的高度，单位像素。 返回标准页面开发界面，单击页面上方的，保存页面。 单击，预览页面，单击“提交”按钮，可预览按钮的事件效果。

打开页面 以单击“立即体验”按钮，打开新的产品体验入口页面为例，进行介绍。 在标准页面设计界面，选中按钮组件。 在右侧“事件”页签中，单击，进入添加动作页面。 在“内置动作”中，单击“打开页面”，配置目标页面、打开方式等参数，单击“创建”。 图1 打开页面 目标页面：设置待打开的目标页面。 当前应用页面：当前应用中，已创建好的页面。 URL：某个页面的URL。 重新加载当前页面：加载刷新当前的页面。 打开方式：设置目标页面的打开方式，如在新标签页中打开或在当前窗口打开。 参数绑定：当打开的页面URL中，有参数时，可单击“添加”，设置页面URL路径中的参数。 返回标准页面开发界面，单击页面上方的，保存页面。 单击，预览页面，单击“立即体验”按钮，可预览按钮的事件效果。

排他网关 排他网关用来在流程中，实现一组分支的唯一决策。系统将按照“条件顺序”评估流出网关的分支，流程会执行第一个连线条件被评估为true（当多个条件为true时，将执行第一个决策）的分支，并且不再继续评估下面的分支。如果所有分支条件决策都为false且该网关定义了一个默认的连线，那么该默认分支将被执行。如果没有可到达的分支，抛出异常，流程被中断，在BPM设计上应避免这种情况发生。 图1 排他网关配置页面 图2 分支连线配置

对象类型及功能介绍 在低代码平台中，支持创建如下类型的对象。 标准对象：低代码平台预置的对象，对象名称和对象字段均已定义好，可以满足最基本的业务需要。 标准对象只允许用户扩展新字段，禁止修改/删除基线字段。 自定义对象：开发者自定义的对象，允许用户增/删/改对象和字段。更多介绍，请参见数据对象建模。 视图对象：与数据库中的View视图类似，用于对2个以上的对象进行关联查询，并把结果集以对象的形式展现，这样的对象称之为视图对象。视图对象中的数据只支持查询，不支持增/删/改。更多介绍，请参见如何创建视图对象。 聚合对象：由一个主对象和多个子对象构成的复合对象，实现不同对象之间建立关联关系。聚合对象对外展现为一个对象，从而简化对象管理。更多介绍，请参见如何创建聚合对象。

低代码平台中的对象 低代码平台中的对象（也可以称为Object）相当于传统方式开发业务系统时，数据库中创建的一个表。每个对象对应一张数据库表，用于保存业务系统需要的配置数据和业务数据。 对象可以存储组织或业务特有的数据，您可以围绕对象这一核心，定义相关的字段、字段校验规则、界面样式、字段变更时的触发事件等。如果把待开发的业务系统比作一部电影，对象就是电影中的各个角色，需要勾勒角色的外貌、性格特点、人物关系和所经历的剧情。 低代码平台预置了一部分标准对象（Standard Object），您可以为这些标准对象新增字段，但不能修改、删除预置字段。租户开发者也可以根据自己的业务需要，创建自定义对象（Custom Object），支持增、删、改自定义对象及自定义对象的字段。 创建一个自定义对象后，系统会为自定义对象自动创建一些标准字段（Standard Fields），如图1所示。 图1 自定义对象的标准字段

什么是执行后台逻辑 在标准页面执行后台逻辑，即在标准页面组件的事件中，调用其他服务补充和实现当前事件的行为。 例如，在员工信息录入页面中，在信息“提交”按钮的“点击”事件中，调用API，将表单中的员工信息发送到数据库进行保存。或者调用在标准页面中的服务编排或脚本，并对需要保存的信息进行预处理。 标准页面执行后台逻辑一般是通过调用标准页面服务和调用第三方接口两种方式实现。本章节主要介绍调用标准页面服务，关于标准页面调用第三方接口的内容请参见如何调用第三方接口。 标准页面的服务主要分为服务编排（Flow）、脚本（Script）和公共接口（API）三种，对应的页面模型为“服务”。 图1 页面模型（服务）

方式二：在组件的事件代码中，直接调用服务 除了将服务编排、脚本和API封装成模型调用外，还可以在组件的事件代码中，直接调用服务。 在代码编辑页面左侧，单击“服务类”下的“服务编排”按钮，获取调用服务编排的代码。通过简单的修改，如服务编排的名称，版本号，即可初始化并得到服务编排对象。 系统提供了多种内置API，用来操作服务编排对象。例如，run方法用来一次性执行完服务编排，也可以调用start、next、back、finish、resume、terminate等方法，实现在服务编排特定阶段执行回调方法。 图7 服务编排快捷代码 在代码编辑界面左侧，单击“服务类”下的“脚本编排”按钮，获取调用脚本编排的代码。通过简单的修改，如脚本编排的名称，即可初始化并得到脚本编排对象。调用平台内置run方法，来执行脚本。 图8 脚本编排快捷代码 在代码编辑界面左侧，单击“服务类”下的“服务请求”按钮，获取调用API请求的代码。通过将样例代码中的url替换成真实业务url，配置请求参数，请求方法和请求头信息，调用平台内置run方法即可请求API。 图9 服务请求快捷代码 对象、服务编排和脚本编排也可以配置成API，通过API的方式进行调用，更多内容请参见API接口。