设置AstroZero系统参数

操作场景

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

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

配置系统参数

1. 账号登录AstroZero服务控制台，单击“进入首页”，进入应用开发页面。
2. 在页面左上方单击，选择“环境管理 > 环境配置”，进入环境配置。
3. 在左侧导航栏中，选择“系统设置 > 系统参数”。
4. （可选，当需要修改参数值时，可执行该步骤）查找具体要修改的系统参数，单击参数的名称，在参数详情页修改取值。
   • 系统参数：展示用户自定义的系统参数，支持新增、删除和修改自定义的系统参数。
   • 内置系统参数：展示系统预置的参数，只支持修改预置的系统参数取值，不能删除预置的系统参数。

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

      表1 新建系统参数说明

      参数	说明
      使用命名空间	系统参数名称中是否加“命名空间__”前缀。 勾选该选项时，可确保跨账号全局唯一。
      唯一标识	新建系统参数的标识，标识是参数在系统中的唯一标识。 长度不能超过64个字符，包括前缀命名空间的长度。 说明： 名称前的内容为命名空间，在AstroZero中为了避免不同租户间数据的重名，租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间，创建后不支持修改。 必须以英文字母开头，只能由英文字母、数字或单下划线组成，且不能以下划线结尾。
      标签	新建系统参数的标签。 取值范围：1~64个字符。
      值类型	系统参数的取值类型，如时间、文本、数字和布尔。
      值	参数取值，请根据所选的不同参数类型来设置参数取值。 文本类型的值可以设置是否加密。
      默认值	设置新建系统参数的默认值。
      描述	根据实际需求，输入系统参数的描述信息。
      是否加密	当值类型为“文本”时，该参数才会显示，表示值是否加密保存。
      权限	配置哪些权限可以读取该系统参数。

使用系统参数

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

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

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

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