# 配置系统参数
#### 使用说明
与环境、业务要求等紧密相关的参数取值经常变化，可以将这样的参数设置为系统参数。AstroZero提供统一的系统参数配置页面，便于集中维护与管理。当参数发生变化时，仅需要修改一次系统参数取值，引用该系统参数的地方都会更新成为修改后的值。
例如，AstroZero预置的内置系统参数"bingo.expiretask.execute.time"，为系统执行数据清理任务的时间。当系统执行清理任务时，会自动查询该参数值，查询到后，会按照配置的时间来启动数据清理任务。开发者用户也可根据需求创建自定义的系统参数，创建后，可以在脚本、服务编排、流程编排BPM和数据接入中使用系统参数，具体使用方法可参考[如何使用系统参数]。
本节介绍的是如何在管理中心配置系统参数，用户还可以在应用开发工作台中配置系统参数（相关操作请参考[设置系统参数](https://support.huaweicloud.com/usermanual-astrozero/astrozero_05_0022.html)）。两者的区别是在应用开发工作台中配置的系统参数，可在打包发布应用时，将系统参数一起打包发布出去。例如，将应用打包发布到运行环境，系统参数也会同步打包到运行环境，不需要在运行环境重复创建。在管理中心设置的系统参数，无法随应用发布出去。
#### 配置系统参数
1. 参考[登录管理中心](https://support.huaweicloud.com/usermanual-astrozero/astrozero_06_2092.html)中操作，登录AstroZero管理中心。
2. 在左侧导航栏中，选择"系统管理 \> 系统参数"。
3. （可选，当需要修改参数值时，可执行该步骤）查找具体要修改的系统参数，单击参数名，在参数详情页修改取值。 
   - 系统参数：展示用户自定义的系统参数，支持新增、删除和修改自定义的系统参数。
   
   - 内置系统参数：展示系统预置的参数，可修改预置的系统参数取值，但不能删除预置的系统参数。
   
   
   
   
4. （可选，当需要自定义参数时，可执行该步骤）新建系统参数。 
   1. 在"系统参数"页签，单击"新建"。
   
   2. 配置相关参数，单击"新建"。
      表1参数说明 
      | 参数     | 参数说明                                                                                                                                                                                                                            |
      |:---|:---|
      | 使用命名空间 | 系统参数名称中是否加"命名空间__"前缀。 勾选该选项时，可确保跨华为账号全局唯一。                                                                                                                     |
      | 名称     | 新建系统参数的名称。 名称需要能尽可能的表明参数的业务含义，避免与其它参数混淆。建议使用"*APP/BO名称* _*系统参数名称*"来命名。 例如：APPName_MaxValue。 |
      | 值类型    | 系统参数取值类型。                                                                                                                                                                                                                       |
      | 值      | 参数的取值，请根据所选的不同参数类型来设置参数取值。 文本类型的值，可以设置是否加密。                                                                                            |
      | 描述     | 系统参数的简要说明。                                                                                                                                                                                                                      |
      | 是否默认   | 打包时，是否保留当前参数的取值进行打包。                                                                                                                                                                                                            |
      | 是否加密   | 当值类型为"文本"时，该参数才会显示，表示值是否加密保存。                                                                                                                                                                                                   |
      | 权限     | 配置哪些权限，可以读取该系统参数。                                                                                                                                                                                                               |
         
      
   
   
   
   
 
 #### 如何使用系统参数
在应用开发时，您也可在应用开发工作台导入管理台设置的系统参数，导入后，可在应用开发工作台中使用该系统参数。以在"A"应用为例，介绍如何导入系统参数。
1. 参考[如何登录经典应用设计器](https://support.huaweicloud.com/usermanual-astrozero/astrozero_05_5025.html)中操作，进入"A"应用开发界面。
2. 在"A"应用开发界面左侧菜单栏下方，选择"配置"，在打开的页签选择"系统参数"。
3. 单击"导入"，选择管理中心已创建的系统参数进行导入。
4. 在脚本、服务编排、流程编排BPM和数据接入中，使用系统参数。 
   - 脚本：引入系统参数的代码行中，引入"sys"系统库，并使用"sys.getParameter('*系统参数名* ')"引入系统参数。
     例如，脚本里编辑如下代码，执行脚本，不用输入入参，查看"日志"页签打印的日志。
     ```
     import * as sys from 'sys'; 
     let sysParam = sys.getParameter('命名空间__APPName_MaxValue'); 
     console.log("MaxValue:", sysParam);
     ```
     ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001933048208.png "点击放大")
     
   
   
   
   - 服务编排：在服务编排"全局上下文"中，新增公式变量，表达式输入"SYSPARAMETER('*系统参数名* ')"，引入系统参数，注意数据类型保持一致。
     ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001933048200.png "点击放大")
     
   
   - BPM：在BPM"全局上下文"中新增相同数据类型的变量，图元配置中设置该变量，值输入"SYSPARAMETER('*系统参数名* ')"，引入系统参数。
     ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001933048204.png "点击放大")
     
   
   - "Rest服务"连接器：在"Rest服务"类型的连接器中，单击"新建"，在"新建REST Action"页面的URL内用"{!*系统参数名* }"方式引入系统参数。
     图1"Rest服务"连接器中引入系统参数   
     ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001933048216.png "点击放大")