自定义错误码

使用说明

AstroZero低代码平台支持对错误码信息，进行多语言国际化配置。通过配置错误码，实现根据用户使用的语言不同，将错误码信息进行不同的展示。

本章节主要介绍如何在应用内配置错误码，您还可以在管理中心配置错误码，相关操作请参考配置错误码。两者的区别是在应用中配置的错误码，可在打包发布应用时，将错误码一起发布出去，在管理中心设置错误码无法随应用发布出去。

如何创建错误码

1. 参考如何进入经典开发环境中操作，进入经典版开发环境。
2. 在“首页 > 项目 > 我的应用”中，单击对应的应用，进入应用开发页面。
3. 在页面左下角，选择“配置”，进入应用配置页面。
4. 在“自定义错误码”页签，设置“显示名称”，该名称将会显示在运营配置页签。
5. 单击“新建”，新建错误码，也可以单击“导入”，选择系统中已创建的错误码进行导入。
6. 配置错误码参数，单击“保存”。
   图1 新建错误码
   

   表1 错误码参数说明

   参数	参数说明
   名称	用户自定义的错误码名称，长度不能超过64个字节，包括命名空间。 例如：配置为“Error001”。 系统会根据“名称”和“语言”匹配错误码进行展示，请确保“名称”、“语言”是唯一的。
   类别	新增错误码所属的分类。
   Http状态码	Http协议状态码。
   语言	请根据实际情况从下拉列表中，选择语言类型。 单击“新增”，支持创建多语言错误码。 若支持的语言未在下拉框中显示，可单击语言后的，再单击“翻译工作台”，跳转到翻译工作台配置页面，添加支持的语言。
   格式	新增错误码的信息描述，长度不能超过255个字节。 在描述中，可以用{Number}表示变量名。例如， {0} 表示第一个输出变量，{1} 表示第二个输出变量，以此类推。 例如：配置为“这个是{0}的报错：{1}！”。

如何使用错误码

• 在脚本里使用
  通过新建脚本，将上文创建的错误码抛出，在脚本中增加抛出错误信息的context函数setI18nError('错误码名称','变量1','变量2')。

  1. 在应用开发页面，创建一个新脚本。

     鼠标放在应用开发工作台的某一文件夹旁会出现加号，单击加号，选择“脚本”。选择“创建一个新脚本”，输入脚本名称，单击“添加”。

  2. 在脚本编辑器中录入如下代码，并单击上方按钮区域的，保存脚本。

     import*as context from'context';
     context.setI18nError('命名空间__Error001','测试用例','脚本使用错误码的用例解读')

  3. 测试执行脚本。
     单击代码编辑器上方的，执行脚本。在页面底部，单击测试窗口右上角的图标。在“输出参数”页签，可查看到抛出的错误码信息，如图2所示。

     图2 运行脚本后显示界面
     
  4. 单击代码编辑页面上方的，启用脚本。
• 在服务编排里使用
  在“全局上下文”中，新建公式变量，使用表达式SETI18NERROR(ErrorCodeName','变量1','变量2')方式引入错误码。

  图3 服务编排里使用错误码
  

  

  目前BPM中错误码，由BPM调用的脚本和服务编排抛出。