数据集构件



点击控制业务数据集维护，进入该模块的维护界面，该模块功能主要是维护下拉数据集，供控制业务字段信息维护模块的当输入方式是……选择时，可以任意的选择你在此维护好的数据集，使你定制的该模块的当前字段为下拉选择得到相应的值。如图所示：

该界面的字段信息：

• 下拉数据集名称：是该下拉数据集的标识。

• 下拉方式：0：下拉单列；1：下拉表格；2：下拉树；3：下拉树表格

数据集SQL中可以带参数，由“下拉数据集参数取值方式”决定参数取值。          对于下拉树和下拉树表格的构造树SQL中可以带@level_和@empID_两个内定参   数。@level_代表数的层数，从1开始（0为根节点只有一个根）。@empID_为用户编号。其他参数由“下拉数据集参数取值方式” 决定参数取值。该项是必选项，默认为下拉单列方式。对于下拉树和下拉树表格情况，关联父物理字段名前加上“@”后面加上“_”能以参数的形式出现在SQL中，每次树节点展开时都要取一下本节点的父节点，会把父节点键值传给该参数（以字符串形式替换该参数）），参数值从0开始，0表示第一层节点的键值（只有一个节点），第一层节点不能选中，其他层的键值是从SQL结果集中得到的节点键值赋值给每个节点。

对于“下拉树”的下拉方式有两种情况，为单选下拉树或复选下拉树。这取决于字段的输入方式，当字段的输入方式选择为“数据树下拉框选择”时为单选下拉树，当字段的输入方式选择为“复选下拉树选择(逗号分隔)”时为复选下拉树。对于单选下拉树“可选字段名”指定字段的返回逻辑值表示该节点是否允许选择；对于复选下拉树“可选字段名”指定字段的返回逻辑值表示该节点是否出现复选框，True时出现复选框，否则不出现复选框。

• 查询sql语句：写sql返回一个结果集为下拉列表的信息。如果是Oracle数据库，可以写一个存储过程名称，写法为：@ORACLE-PACK_:+存储过程名，系统发现@ORACLE-PACK_:就认为是Oracle返回结果集的存储过程。

• 返回文本字段：当下拉方式是下拉单列时，要填写页面显示的文本字段及返回字段值，为下拉框的显示值；当为下拉树时，为树节显示文本的字段名。下拉表格用不到该字段，下拉表格的相应字段为“表格键字段名”。

• 返回值字段：下拉框的隐藏值，对于下拉单列选择后返回的键值。对于下拉树和下拉表格不用该字段，下拉表格的相应字段为 “表格显示值字段名”。

• 关联主键物理字段名：当下拉列表是树的方式时，要填写关联主键物理字段名及关联父物理字段名，可以唯一识别记录集的主键。

• 关联父物理字段名：当是树型时要输入的父结点的信息，关联父物理字段名前加上“@”后面加上“_”能以参数的形式出现在SQL中，每次树节点展开时都要取一下本节点的子节点，会把节点键值传给该参数，每次树节点展开时都要取一下本节点的父节点，会把父节点键值传给该参数（以字符串形式替换该参数），参数值从0开始，0表示第一层节点的键值（只有一个节点），第一层节点不能选中，其他层的键值是从SQL结果集中得到的节点键值赋值给每个节点。

• 表格查询SQL语句：对于带表格的数据集的SQL,如：下拉树表格中的表格。对于下拉表格的情况，SQL填写在这里，“查询SQL语句”中不用写SQL;这里的SQL有两部分组成，第一句用于计算页数，第二句用于查询数据。如：SELECT CEILING(count(*)/15.0) FROM T_a;SELECT TOP 15 * FROM (SELECT ROW_NUMBER() OVER(ORDER BY a) ASz,a,b,c,d FROM T_a  ) AS w WHEREw.z>@pageNo_,这里规定每页为15条数据。

• 表格字段名：表格字段可以是多个，之间用分号隔开。如：FieldName1;FieldName2;FieldName3。在具有下拉表格的样式中，显示多个表格字段（显示多列）。它与"表格字段汉字名列表"、“表格字段宽列表”、“表格字段隐藏显示属性列表”对应，用于下拉树表格和下拉表格。对于下拉表格，“返回文本字段”和“返回值字段”都要在该表格字段名列表中出现。

• 表格字段汉字名：表格字段汉字名可以是多个，之间用分号隔开。如：ChineseName1;ChineseName2;ChineseName3。在具有下拉表格的样式中，显示多个表格字段（显示多列）。它与"表格字段名列表"、表格字段宽列表”、“表格字段隐藏显示属性列表”对应，用于下拉树表格和下拉表格。

• 表格键字段名：对于下拉表格选择后返回的键值。

• 表格显示值字段名：用于下拉树表格中的表格，当选中表格某行后，带回来的显示值字段，带回来后在有选择框功能的单元格中显示该值。“表格键字段名”为带回来的键值，“返回文本字段”在树表格中用于树结点的文本。

• 可选字段名：即是否可选择树节点字段名，在是树的情况下使用，这个字段只能是布尔类型，只能是True或False，在为True时树节点可选择或出现复选框，在为False时树节点不可选择或不出现复选框。对于单选下拉树“可选字段名”指定字段的返回逻辑值表示该节点是否允许选择；对于复选下拉树“可选字段名”指定字段的返回逻辑值表示该节点是否出现复选框，True时出现复选框，否则不出现复选框。

• 表格字段宽列表：表格字段宽可以是多个，之间用分号隔开。如：20;40;40。单位是像素，即px，加起来后为表格宽度，在具有下拉表格的样式中，显示多个表格字段（显示多列）。它与"表格字段汉字名列表"、“表格字段名列表”、“表格字段隐藏显示属性列表”对应，用于下拉树表格和下拉表格。

• 表格字段隐藏显示列表：表格字段隐藏显示属性可以是多个，之间用分号隔开。如：0;1;1:0。0为隐藏,1为显示，只能为0或1，它与"表格字段汉字名列表"、“表格字段名列表”、“表格字段宽列表”对应，用于下拉树表格和下拉表格。

• 排序字段名列表：排序字段可以是多个，之间用分号隔开。如：OrderFieldName1;OrderFieldName2;OrderFieldName3，在具有下拉表格的样式中，用户点击表格列时，用表格字段名列表对应的排序字段替代表格查询SQL中的#Order$变量进行排序。它与"表格字段名列表"、"表格字段汉字名列表"、“表格字段宽列表”、“表格字段隐藏显示属性列表”对应，分号隔开的个数相等。用于下拉树表格和下拉表格。对于下拉表格，“返回文本字段”和“返回值字段”都要在该表格字段名列表中出现。

• 默认排序字段名：用于下拉树表格和下拉表格，在表格查询SQL中对该字段进行排序的默认字段名。模块启动时用默认字段名替代查询SQL中的#Order$变量进行对数据排序。

该模块的操作有新增、修改和删除操作。

新增操作：点击【新增】按钮，界面进入新增状态。维护好数据集的各种属性后点击【确定】按钮完成新增操作。

修改操作：点击【修改】按钮，界面进入修改状态。重新维护数据集的各种属性，完成后点击【确定】按钮。完成修改操作。

不同的下拉方式需要维护的属性不同，各种下拉方式需要维护的属性如下。

A、下拉单列：下拉数据集名称、查询SQL语句、返回文本字段和返回值字段。

B、下拉表格或下拉树表格：下拉数据集名称、查询SQL语句、表格字段名、表格字段汉字名、表格键字段名、表格显示值字段名和表格查询SQL语句、表格字段隐藏显示属性列表、表格字段宽列表。

C、下拉树：下拉数据集名称、查询SQL语句、返回文本字段、关联主键字段和关联父字段。

删除操作：选中要删除的数据集，点击【删除】按钮，系统弹出确认操作对话框。点击【确定】完成删除操作，点击【取消】取消本次删除操作。