设置系统参数

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

新增、查询系统参数并进行修改。系统参数创建后，可以在其他地方以“{!parameter_name}”方式引用。例如，在如下两个场景使用系统参数：

将系统公用邮箱设置为系统参数。
将系统定时数据清理的执行时间，设置为系统参数。例如，系统执行数据清理任务时，会自动查询是否配置了系统参数“bingo.expiretask.execute.time”（AstroZero已预置该系统参数），查询到后，会按照配置的时间来启动数据清理。

本章节介绍的是在应用内配置系统参数，还可以在环境配置中创建系统参数，相关操作请参考配置系统参数。两者的区别是在应用中配置的系统参数，可在打包发布应用时，将系统参数一起发布出去。在环境配置中，设置的系统参数无法随应用发布出去。

系统参数创建完成后，可在脚本、服务编排和工作流等中使用。

脚本：脚本代码引入系统参数的代码行中，引入“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 在自定义连接器中引入系统参数

用户使用AstroZero的脚本、服务编排、工作流等开发的内容是不会加密存储的。如果用户需要加密数据，请使用加密类型的系统参数。

参考如何创建系统参数中操作，新建加密类型的系统参数。
例如，新建加密参数appClientId，注意要勾选“是否加密”。

图5 新建appClientId系统参数
在脚本、服务编排和工作流中，使用上一步创建的系统参数。
- 脚本：脚本代码中引入系统参数的代码行中，引入系统库，并使用“sys.getParameter('appClientId')”引入系统参数。
```
import * as sys from 'sys'; 
......
        let cliendId = sys.getParameter('appClientId');
```
  图6 在脚本中引用参数appClientId
- 服务编排：在服务编排“全局上下文”中新增公式变量，表达式输入“SYSPARAMETER('appClientId')”，引入系统参数。
  图7 在服务编排中引用参数appClientId
- 工作流：在工作流的“全局上下文”中，新增文本类型的变量，图元配置中设置该变量，值输入“SYSPARAMETER('appClientId')”，引入系统参数。
  图8 在工作流中引用参数appClientId