配置系统参数

使用说明

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

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

配置系统参数

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

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

      表1 参数说明

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

如何使用系统参数

开发应用时，可以在应用开发工作台导入环境配置中设置的系统参数。导入后，可在应用开发工作台中，使用该系统参数。下面以“A”应用为例，介绍如何导入系统参数。

1. 进入“A”应用开发新版设计器。
2. 在左侧导航栏中，选择“逻辑”，单击“设置 > 系统参数”。
3. 单击“导入”，选择环境配置中已创建的系统参数进行导入。
4. 在脚本、服务编排或工作流中，使用系统参数。
   • 脚本：引入系统参数的代码行中，引入“sys”系统库，并使用“sys.getParameter('系统参数名')”引入系统参数。
     例如，在脚本中编辑如下代码，执行脚本，不用输入入参，查看“日志”页签打印的日志。

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

     图1 在脚本中引入系统参数
     
   • 服务编排：在服务编排“全局上下文”中新增公式变量，表达式输入“SYSPARAMETER('系统参数名')”，引入系统参数，注意数据类型保持一致。
     图2 在服务编排中引入系统参数
     
   • 工作流：在工作流“全局上下文”中，新增相同数据类型的变量，图元配置中设置该变量，值输入“SYSPARAMETER('系统参数名')”，引入系统参数。
     图3 在工作流中引入系统参数
     
   • 自定义连接器：在自定义连接器的“动作”页签，单击“新建”。在“新建动作”页面的URL内，使用“{!系统参数名}”方式引入系统参数。
     图4 自定义连接器中引入系统参数