系统参数,分为公共参数,用户参数两种。
公共参数 ,由管理员设置,对所有用户起作用。公共参数支持按组织、账簿隔离。
典型例子,是系统管理 – 参数设置
用户参数 ,则由用户自行设定,记录用户的操作习惯,只对用户本人起作用。
典型例子,是单据选项
公共参数开发与读取
步骤1:新建系统参数对象
进入K/3 Cloud BOS集成设计平台,打开子系统,新建系统参数。
选择新建空白的系统参数对象:
图三:新建系统参数
步骤2:添加选项
系统参数设计界面,与单据设计界面完全一致。
把工具栏中的元素,拖放到设计界面即可添加新选项添加,随后,到属性表格中设置属性。
本案例,添加一个整数选项,并命名为F_JD_Month
图四:添加整数选项
特别建议:
建议保持选项的标识与绑定实体属性一致。
后续按照绑定实体属性读取选项值,这与在单据上取字段值有差异
步骤3:添加保存操作
因为新增的是空白系统参数对象,须自行添加保存操作。
可以在保存操作上,配置一些特别的保存校验。
图五:添加保存操作
步骤4:发布公共参数
K/3 Cloud允许在一个统一的参数配置界面配置公共参数。可以点击专用的发布公共参数菜单,把系统参数,发布到公共参数管理界面。
图六:系统参数发布菜单
图七:发布系统参数
特别说明:
系统参数发布,一个子系统,只支持显示一个系统参数对象;
另外,系统参数也可以发布一个普通的主控台菜单,效果是一样的。
步骤5:浏览发布效果
以管理员登录K/3 Cloud,打开参数设置界面,选择目标子系统,可以看到刚发布的系统参数界面。
图八:浏览发布效果
步骤6:读取系统参数
通过如下实例代码,读取配置的系统参数值:
单据参数开发与读取
步骤1:新建系统参数对象
K/3 Cloud预先提供了一个通用的单据参数对象,包括了一些常用的选项。
需要继承 BOS – 应用框架 – 系统参数 – 单据用户参数模板,创建新的单据参数对象,添加新选项。
图九:新建单据参数对象
步骤2:添加新的选项
建议在界面上,增加一个新的页签,放置本单特殊的参数,与系统通用的单据区分开。
本演示案例,增加一个复选框选项,命名为F_JD_NewOption
图十:添加新选项
步骤3:设定单据的用户参数对象
打开目标单据,修改”用户参数对象”属性,把新建的单据参数对象标识,复制过来
图十一:设置单据用户参数对象
步骤4:浏览效果
保存好单据设计后,就可以进入单据新增界面,打开单据选项,查看效果
图十二:设置单据选项
步骤5:读取单据参数
可以到this.Model.ParameterData属性中,获取单据参数。
图十三:读取单据选项
公共参数保存后,存储在数据表格 T_BAS_SysParameter,而用户参数,保存在T_BAS_UserParameter