# 设置华为云Astro轻应用系统参数
#### 操作场景
与环境、业务要求等紧密相关的参数取值经常变化，可以将这样的参数设置为系统参数。华为云Astro轻应用提供统一的系统参数配置页面，便于集中维护与管理。当参数发生变化时，仅需要修改一次系统参数取值，引用该系统参数的地方都会更新成为修改后的值。
例如，华为云Astro轻应用预置的内置系统参数"bingo.expiretask.execute.time"，为系统执行数据清理任务的时间。当系统执行清理任务时，会自动查询该参数值，查询到后，会按照配置的时间来启动数据清理任务。开发者用户也可根据需求创建自定义的系统参数，创建后，可以在脚本、服务编排、工作流和数据接入中使用系统参数。如何使用系统参数，请参考[使用系统参数]。
本节介绍的是如何在环境配置中配置系统参数，用户还可以在应用开发工作台中配置系统参数（如[图1]）。两者的区别是在应用开发工作台中配置的系统参数，可在打包发布应用时，将系统参数一起打包发布出去。例如将应用打包发布到运行环境，系统参数也会同步打包到运行环境。不需要在运行环境重复创建。在环境配置中设置的系统参数，无法随应用发布出去。
图1在应用开发工作台中配置系统参数   
![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001918600410.png "点击放大")
#### 配置系统参数
1. 账号登录[华为云Astro轻应用服务控制台](https://console.huaweicloud.com/appcube/#/home)，单击"进入首页"，进入应用开发页面。
2. 在页面左上方单击![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001918425150.png)，选择"环境管理 \> 环境配置"，进入环境配置。
3. 在左侧导航栏中，选择"系统设置 \> 系统参数"。
4. （可选，当需要修改参数值时，可执行该步骤）查找具体要修改的系统参数，单击参数的名称，在参数详情页修改取值。 
   - 系统参数：展示用户自定义的系统参数，支持新增、删除和修改自定义的系统参数。
   
   - 内置系统参数：展示系统预置的参数，只支持修改预置的系统参数取值，不能删除预置的系统参数。
   
   
   
   
5. （可选，当需要自定义参数时，可执行该步骤）新建系统参数。 
   1. 在"系统参数"页签，单击"新建"。
   
   2. 配置相关参数后，单击"新建"。
      表1新建系统参数说明 
      | 参数     | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
      |:---|:---|
      | 使用命名空间 | 系统参数名称中是否加"命名空间__"前缀。 勾选该选项时，可确保跨账号全局唯一。                                                                                                                                                                                                                                                                                                                                                                       |
      | 唯一标识   | 新建系统参数的标识，标识是参数在系统中的唯一标识。 - 长度不能超过64个字符，包括前缀命名空间的长度。 名称前的内容为命名空间，在华为云Astro轻应用中为了避免不同租户间数据的重名，租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间，创建后不支持修改。   - 必须以英文字母开头，只能由英文字母、数字或单下划线组成，且不能以下划线结尾。   |
      | 标签     | 新建系统参数的标签。 取值范围：1\~64个字符。                                                                                                                                                                                                                                                                                                                                                                                                                  |
      | 值类型    | 系统参数的取值类型，如时间、文本、数字和布尔。                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
      | 值      | 参数取值，请根据所选的不同参数类型来设置参数取值。 文本类型的值可以设置是否加密。                                                                                                                                                                                                                                                                                                                                              |
      | 默认值    | 设置新建系统参数的默认值。                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
      | 描述     | 根据实际需求，输入系统参数的描述信息。                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
      | 是否加密   | 当值类型为"文本"时，该参数才会显示，表示值是否加密保存。                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
      | 权限     | 配置哪些权限可以读取该系统参数。                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
         
      
   
   
   
   
 
 #### 使用系统参数
开发应用时，可以在应用开发工作台导入环境配置中设置的系统参数。导入后，可在应用开发工作台中，使用该系统参数。下面以"A"应用为例，介绍如何导入系统参数。
1. 参考[登录华为云Astro轻应用应用设计器](https://support.huaweicloud.com/usermanual-astrozero/astrozero_05_9004.html)中操作，进入"A"应用设计器。
2. 在左侧导航栏中，选择"逻辑"，单击"更多 \> 系统参数"。
3. 单击"导入"，选择环境配置中已创建的系统参数进行导入。
4. 在脚本、服务编排或工作流中，使用系统参数。 
   - 脚本：引入系统参数的代码行中，引入"sys"系统库，并使用"sys.getParameter('*系统参数名* ')"引入系统参数。
     例如，在脚本中编辑如下代码，执行脚本，不用输入入参，查看"日志"页签打印的日志。
     ```
     import * as sys from 'sys'; 
     let sysParam = sys.getParameter('命名空间__APPName_MaxValue'); 
     console.log("MaxValue:", sysParam);
     ```
     图2在脚本中引入系统参数   
     ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001894299500.png "点击放大") 
   
   
   
   - 服务编排：在服务编排"全局上下文"中新增公式变量，表达式输入"SYSPARAMETER('*系统参数名* ')"，引入系统参数，注意数据类型保持一致。
     图3在服务编排中引入系统参数   
     ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001894139592.png "点击放大") 
   
   - 工作流：在工作流"全局上下文"中，新增相同数据类型的变量，数据映射图元配置中设置该变量，值输入"SYSPARAMETER('*系统参数名* ')"，引入系统参数。
     图4在工作流中引入系统参数   
     ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001961775533.png "点击放大") 
   
   - 自定义连接器：在自定义连接器的"动作"页签，单击"新建"。在"新建动作"页面的URL内，使用"{!*系统参数名* }"方式引入系统参数。
     图5自定义连接器中引入系统参数   
     ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001936099165.png "点击放大")