更新时间:2022-04-26 GMT+08:00
分享

设置系统参数

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

场景描述

您可以新增、查询系统参数并进行修改。系统参数创建后,您可以在其他地方以{!parameter_name}方式引用。举两个系统参数的例子:
  • 将系统公用邮箱设置为系统参数。
  • 将系统定时数据清理的执行时间设置为系统参数。例如系统执行数据清理任务时,会自动查询是否配置了系统参数“bingo.expiretask.execute.time”(AppCube已预置该系统参数),查询到后,会按照配置的时间来启动数据清理

本节介绍的是在App内配置系统参数,您还可以在管理台下创建系统参数,相关操作请参考配置系统参数。两者的区别是在App里配置系统参数,可在打包发布App时,将系统参数一起发布出去,在管理台设置系统参数无法随App发布出去。

如何创建系统参数

  1. 在App视图下左侧菜单栏下方选择“配置”,在打开的页签选择“系统参数”
  2. 配置“显示名称”,该名称将会显示在运营配置页签。
  3. 单击“新建”。

    您也可单击“导入”,选择系统中已创建的系统参数进行导入。

  4. 配置相关参数,单击“新建”。

    表1 参数说明

    参数

    参数说明

    使用命名空间

    系统参数名称中是否加“命名空间__”前缀。

    勾选该选项时,可确保跨租户全局唯一。

    名称

    系统参数名称。

    名称需要能尽可能地表明参数的业务含义,避免与其它参数混淆。建议您使用“APP/BO名称_系统参数名称”来命名。

    例如:APPName_MaxValue。

    值类型

    系统参数取值类型。

    • 时间
    • 文本
    • 数字
    • 布尔

    参数取值。根据所选的不同参数类型来设置参数取值。

    文本类型的值可以设置是否加密。

    描述

    系统参数的简要说明。

    是否默认

    打包时是否保留当前参数的取值进行打包。

    是否加密

    当值类型为“文本”时,该参数才会显示。表示值是否加密保存。

    权限

    配置哪些权限可以读取该系统参数。

如何使用系统参数

在脚本、服务编排、流程编排BPM、数据接入中使用系统参数。
  • 脚本:脚本代码中引入系统参数的代码行中,引入“sys”系统库,并使用“sys.getParameter('系统参数名')”引入系统参数。
    例如脚本里编辑如下代码,执行脚本,不用输入入参,查看“日志”页签打印的日志。
    import * as sys from 'sys'; 
    let sysParam = sys.getParameter('命名空间__APPName_MaxValue'); 
    console.log("MaxValue:", sysParam);

  • 服务编排:在服务编排“全局上下文”中新增公式变量,表达式输入“SYSPARAMETER('系统参数名')”,引入系统参数,注意数据类型保持一致。

  • BPM:在BPM“全局上下文”中新增相同数据类型的变量,图元配置中设置该变量,值输入“SYSPARAMETER('系统参数名')”,引入系统参数。

  • 数据接入:在数据接入的输入源“添加5G消息”页面勾选“引用变量”,以“{!系统参数名}”方式引入系统参数。注意数据类型要符合数据接入定义的要求。
    图1 数据接入中引入系统参数
  • Rest服务连接器:在Rest服务类型(自定义连接器)的连接器中“动作”页签单击“新建”,在“新建REST Action”页面的URL内用“{!系统参数名}”方式引入系统参数。
    图2 “Rest服务”连接器中引入系统参数

如何在脚本、服务编排、BPM中加密数据?

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

  1. 参考如何创建系统参数,新建加密类型的系统参数,例如:appClientId。注意要勾选“是否加密”。

  2. 在脚本、服务编排、流程编排BPM中使用上一步创建的系统参数。

    • 脚本:脚本代码中引入系统参数的代码行中,引入系统库,并使用“sys.getParameter('appClientId')”引入系统参数。
      import * as sys from 'sys'; 
      ......
              let cliendId = sys.getParameter('appClientId');

    • 服务编排:在服务编排“全局上下文”中新增公式变量,表达式输入“SYSPARAMETER('appClientId')”,引入系统参数。

    • BPM:在BPM“全局上下文”中新增文本类型的变量,图元配置中设置该变量,值输入“SYSPARAMETER('appClientId')”,引入系统参数。

分享:

    相关文档

    相关产品

close