自定义AstroZero接口错误码

为自定义接口定义错误码，帮助开发者快速定位问题，减少调试和解决问题的时间，提升用户体验。AstroZero支持对错误码信息进行多语言国际化配置，实现根据用户使用不同的语言，将错误码信息进行不同的展示。

除了在应用开发设计器中设置错误码，您还可以在环境配置中设置错误码，详情请参见管理应用中的错误码。两者的区别是在应用开发设计器中配置的错误码，可在打包发布应用时，将错误码一起打包发布出去。例如将应用打包发布到运行环境，错误码也会同步打包到运行环境，不需要在运行环境重复创建。在环境配置中设置的错误码，无法随应用发布出去。

自定义错误码

参考登录AstroZero新版应用设计器中操作，登录应用设计器。
在左侧导航栏中，选择“逻辑”，单击“更多 > 自定义错误码”。

图1 自定义错误码
在自定义错误码页签，单击“新建”，进入新建错误码页面。

也可以单击“导入”，选择系统中已创建的错误码进行导入。

设置错误码参数，单击“保存”。

图2 新建错误码

表1 自定义错误码参数说明
参数	说明
名称	自定义错误码的名称。命名要求如下：长度不能超过64个字符，包括前缀命名空间的长度。须知：名称前的内容为命名空间，在AstroZero中为了避免不同租户间数据的重名，租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间，创建后不支持修改。必须以字母开头，只能由字母、数字、下划线、中划线和点组成组成。
类型	新建错误码所属的分类。取值范围：1~64个字符。
Http状态码	在下拉框中选择Http协议状态码，如200、201等。
语言	根据需要，选择所需的语言类型。单击“新增”，可添加多语言错误码。若待添加的语言不存在，可单击语言后的。在提示信息中，单击“翻译工作台”，跳转至翻译工作台配置页面进行添加。如何添加语言，请参见设置AstroZero系统支持的语言。
格式	错误码的信息描述，支持使用{Number}表示变量名。例如，{0} 表示第一个输出变量，{1} 表示第二个输出变量，以此类推。

使用自定义错误码

自定义错误码创建完成后，可在脚本中使用。在脚本中，调用抛出错误信息的error函数I18nError('ErrorCodeName','变量1','变量2')。该函数中，输入参数为错误码名称“t__testErrorCode”和错误码信息中所携带的变量（"val1"和"val2"）。

创建脚本。

参考创建空白AstroZero脚本中操作，创建一个空白脚本。

在脚本编辑器中，输入如下代码。

// 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”为自定义错误码名称，请根据实际情况配置。