如何开发系统参数

概要说明


系统参数，分为公共参数，用户参数两种。

公共参数 ，由管理员设置，对所有用户起作用。公共参数支持按组织、账簿隔离。
典型例子，是系统管理 – 参数设置
用户参数 ，则由用户自行设定，记录用户的操作习惯，只对用户本人起作用。

典型例子，是单据选项

公共参数开发与读取

步骤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