配置系统参数

使用说明

与环境、业务要求等紧密相关的参数取值经常变化，可以将这样的参数设置为系统参数。AstroZero提供统一的系统参数配置页面，便于集中维护与管理。当参数发生变化时，仅需要修改一次系统参数取值，引用该系统参数的地方都会更新成为修改后的值。

例如，AstroZero预置的内置系统参数“bingo.expiretask.execute.time”，为系统执行数据清理任务的时间。当系统执行清理任务时，会自动查询该参数值，查询到后，会按照配置的时间来启动数据清理任务。开发者用户也可根据需求创建自定义的系统参数，创建后，可以在脚本、服务编排、流程编排BPM和数据接入中使用系统参数，具体使用方法可参考如何使用系统参数。

配置系统参数

1. 参考登录管理中心中操作，登录AstroZero管理中心。
2. 在左侧导航栏中，选择“系统管理 > 系统参数”。
3. （可选，当需要修改参数值时，可执行该步骤）查找具体要修改的系统参数，单击参数名，在参数详情页修改取值。
   • 系统参数：展示用户自定义的系统参数，支持新增、删除和修改自定义的系统参数。
   • 内置系统参数：展示系统预置的参数，可修改预置的系统参数取值，但不能删除预置的系统参数。

4. （可选，当需要自定义参数时，可执行该步骤）新建系统参数。
   1. 在“系统参数”页签，单击“新建”。
   2. 配置相关参数，单击“新建”。

      表1 参数说明

      参数	参数说明
      使用命名空间	系统参数名称中是否加“命名空间__”前缀。 勾选该选项时，可确保跨华为账号全局唯一。
      名称	新建系统参数的名称。 名称需要能尽可能的表明参数的业务含义，避免与其它参数混淆。建议使用“APP/BO名称_系统参数名称”来命名。 例如：APPName_MaxValue。
      值类型	系统参数取值类型。
      值	参数的取值，请根据所选的不同参数类型来设置参数取值。 文本类型的值，可以设置是否加密。
      描述	系统参数的简要说明。
      是否默认	打包时，是否保留当前参数的取值进行打包。
      是否加密	当值类型为“文本”时，该参数才会显示，表示值是否加密保存。
      权限	配置哪些权限，可以读取该系统参数。

如何使用系统参数

在应用开发时，您也可在应用开发工作台导入管理台设置的系统参数，导入后，可在应用开发工作台中使用该系统参数。以在“A”应用为例，介绍如何导入系统参数。

1. 参考如何登录经典应用设计器中操作，进入“A”应用开发界面。
2. 在“A”应用开发界面左侧菜单栏下方，选择“配置”，在打开的页签选择“系统参数”。
3. 单击“导入”，选择管理中心已创建的系统参数进行导入。
4. 在脚本、服务编排、流程编排BPM和数据接入中，使用系统参数。
   • 脚本：引入系统参数的代码行中，引入“sys”系统库，并使用“sys.getParameter('系统参数名')”引入系统参数。
     例如，脚本里编辑如下代码，执行脚本，不用输入入参，查看“日志”页签打印的日志。

     import * as sys from 'sys'; 
     let sysParam = sys.getParameter('命名空间__APPName_MaxValue'); 
     console.log("MaxValue:", sysParam);

     

   • 服务编排：在服务编排“全局上下文”中，新增公式变量，表达式输入“SYSPARAMETER('系统参数名')”，引入系统参数，注意数据类型保持一致。

     

   • BPM：在BPM“全局上下文”中新增相同数据类型的变量，图元配置中设置该变量，值输入“SYSPARAMETER('系统参数名')”，引入系统参数。

     

   • 数据接入：在数据接入的输入源“添加5G消息”页面，勾选“引用变量”，以“{!系统参数名}”方式引入系统参数。注意数据类型要符合数据接入定义的要求。
     图1 数据接入中引入系统参数
     
   • “Rest服务”连接器：在“Rest服务”类型的连接器中，单击“新建”，在“新建REST Action”页面的URL内用“{!系统参数名}”方式引入系统参数。
     图2 “Rest服务”连接器中引入系统参数