配置错误码
使用说明
调用接口出错后,用户可根据每个接口对应的错误码来定位错误原因。AstroZero支持用户自定义错误码,并支持对错误码描述进行多语言国际化配置,实现根据语言的不同将错误码描述信息进行不同的展示。
除了在环境配置中设置错误码,用户还可以在应用开发设计器中设置错误码,详情请参见如何自定义错误码。两者的区别是在应用开发设计器中配置的错误码,可在打包发布应用时,将错误码一起打包发布出去。例如将应用打包发布到运行环境,错误码也会同步打包到运行环境,不需要在运行环境重复创建。在环境配置中设置的错误码,无法随应用发布出去。
创建错误码
- 参考登录环境配置中操作,登录AstroZero环境配置。
- 在主菜单中,选择“维护”。
- 在左侧导航栏中,选择“全局元素 > 错误码”。
- 在自定义错误码页面,单击“新建”。
- 自定义错误码:展示用户自定义的错误码,AstroZero支持增加、删除和修改自定义的错误码。
- 系统错误码:展示AstroZero预置的错误码,可查看预置的错误码和错误原因,但不能删除。
- 配置错误码参数,单击“保存”。
图1 新建错误码
表1 错误码参数说明 参数
参数说明
名称
新建错误码的名称,如“Error001”。
系统会根据“名称”和“语言”匹配错误码进行展示,请保证“名称”+“语言”唯一。
类别
错误码所属的分类。
Http状态码
Http协议状态码。
语言
请根据实际需求,从下拉列表中选择语言类型。
- 单击“新增”,支持创建多语言错误码。
- 单击语言后的,会显示“请在翻译工作台中添加支持的语言”。单击“翻译工作台”跳转到对应页面,在翻译工作台中,可添加系统支持的语言。
格式
错误码信息描述,长度不能超过255个字节。在描述中,可以用{Number}表示变量名。例如,{0}表示第一个输出变量,{1}表示第二个输出变量,以此类推。
例如:配置为“这个是{0}的报错:{1}!”。
如何使用错误码
在应用开发时,用户也可以根据需要在应用开发设计器中,导入租户下其他的错误码。导入后,可在应用开发设计器中,使用该错误码。以在“A”应用为例,介绍如何导入错误码。
- 进入“A”应用新版设计器。
- 在左侧菜单栏中,选择“逻辑”,单击页面下方的“自定义错误码”。
图2 选择自定义错误码
- 在自定义错误码页签,单击“导入”,选择租户下已有的错误码进行导入。
- 在脚本中,使用错误码。
这里通过新建脚本,将上文创建的错误码抛出,在脚本中增加抛出错误信息的context函数setI18nError('错误码名称','变量1','变量2')为例。
- 参考创建空白脚本中操作,创建一个空白脚本。
- 在脚本编辑器中,录入如下代码,并单击上方按钮区域的,保存脚本。
import*as context from'context'; context.setI18nError('命名空间__Error001','测试用例','脚本使用错误码的用例解读')
- 测试执行脚本。
- 单击脚本编辑器上方的,启用脚本。
- 在服务编排中,使用错误码。
在“全局上下文”中,新建公式变量,使用表达式SETI18NERROR(ErrorCodeName','变量1','变量2')方式引入错误码。图4 服务编排里使用错误码
目前工作流中的错误码,由工作流调用的脚本和服务编排抛出。