数据接口:树形列表

来自企业管理软件文档中心
跳转至: 导航搜索

使用简介

  • 生活中,我们很常见的一种以父子层次结构来组织对象的图案就是树状图。树状图可以很直观的展示出数据之间的从属关系。在云表中,我们可以制作数据接口树形列表来表现数据项之间的从属关系,后期我们可以根据需要调用该树形列表数据接口。
  • 下面让我们一起来学习如何设置数据接口——树形列表吧。

基本设置

NSXLBA1.png


名称

  • 首先要输入树形列表的名称,可任意取名(建议据需要引用树形列表的数据项进行命名,便于后期调用。如:地区树形列表、员工树形列表等),主要作用是便于我们直观的区分数据接口的用途。

访问权限

  • 我们可以通过设置访问权限来实现树形列表数据接口仅限本模板使用,或被多个模板同时使用的功能。在新建数据接口时,我们可以选择数据接口是私有还是公开,也可以在创建完成后再次修改访问权限(重新设置私有或公开)。需要注意的是,前期设置了访问权限后,在模板表单中的数据项里调用该数据接口,然后又重新设置了访问权限,这时,我们曾调用数据接口的数据项还是可以使用数据接口,若是之后别的数据项调用该数据接口,便只能由后期设置的访问权限决定是否可以调用该数据接口。
  • 私有:只有本模板可调用此数据接口;
  • 公开:本系统的所有模板都可调用此数据接口。

数据来源

  • 我们在设置树形列表时,首先需要确定此树形列表中数据的来源。在树形列表数据接口中默认使用本模板为数据来源,且不允许更改。

来自数据表

数据表

  • 当我们在使用树形列表进行取值时,首先需要确定数据要从哪个模板的哪个表单中取值。当数据表选择本模板时,表示是从本模板的所有表单中来获取数据,若我们想从表单的明细表中获取数据,那数据表可以选择本模板的某个明细表,系统会把本模板的所有表单的所有明细表记录全部列出来。

树形构建

  • 在使用树形列表数据接口前,我们需要先构建树形,也就是使数据根据分类形成一个树形列表。在构建树形时有三种方法:多数据项分级、编码长度分级以及自我繁殖。
多数据项分级
  • 多数据项分级是根据数据项来确定树形列表是由几级构成。树形列表中有两个数据项时,树形列表就有两级;有三个数据项时,那么树形列表就有三级......以此类推。使用多数据项分级构建树形时,需要两个或两个以上的数据项。
  • 我们从本模板中提取数据,选择构造方式为多数据项分级。共有三个数据项参与树形的构建。第一级为“省份”数据项,第二级为“市”数据项,第三级为“区”数据项。如图所示操作:


NSXLBA2.png


NSXLBA3.png


NSXLBA4.png


  • 大部分时候,“分级数据项”和“显示数据项”选择相同就好,但有时候也不相同。例如上例中,若省份有省份编号,市、区有市、区编号,构造树的时候,第一级节点的分级数据项可以使用省份编号,而显示数据项使用省份,第二级分级数据项使用市编号,显示数据项使用市,第三级分级数据项使用区编号,显示数据项用区。
编码长度分级
  • 编码长度分级是通过对数据项的长度进行层次的划分。
  • 比如下表中,依据每条记录的编号进行分级,编号的划分层次的规则是【3,2,2】,即编码的前面三位数字作为一级,中间两位数字作为二级,最后两位数字作为三级;【2,2】即编码的前面两位数字作为一级,后面两位数字作为二级。
  • 可根据自己的需求制定树形层次划分的规则。


NSXLBA5.png


  • 从本模板中提取数据,选择构造方式为编码长度分级,如图所示进行操作:


NSXLBA6.png


NSXLBA7.png


自我繁殖
  • 自我繁殖是根据两个数据项的父子关系来构造树形列表的层次。通过由子节点自动寻找父节点,以末端构建到根部的方式构建一个树形列表。使用自我繁殖构建树形时,只需要两个数据项即可。
  • 从本模板中提取数据,选择构造方式为自我繁殖,如图所示进行操作:


NSXLBA8.png


  • 例如:第17张表单中子节点为天河区,父节点为广州市。通过父节点广州市我们可以找到上一级,第23张表单,子节点为广州市,父节点为广东省。通过父节点广东省我们可以找到上一级,第3张表单,子节点为广东省,父节点为中国。如图所示:


NSXLBA9.png


  • 通过这种用数据项间的关系,便可构建出树形列表。如图所示:


NSXLBA10.png


过滤设置

  • 我们在使用树形列表时,若是不加限制条件,那么所有数据都会显示在树形列表中。当我们需要在树形列表中显示有特定的限制条件的数据时,这时我们可以设置含有条件的过滤来过滤出我们需要的数据。
过滤表达式
NSXLBA11.png


  • 通过添加参数,并设置参数与此树形列表中数据项的关系来进行数据的筛选。此筛选适用于条件多变化的情况。
  • 按钮添加参数、删除参数是指根据需求添加或删除一个自定义的参数,对数据接口当前可以返回的数据进行过滤的自定义参数;按钮上移、下移则是指在显示过滤条件时所显示的自定义参数的先后位置。可以根据需求设置参数名(过滤的参数名)、数据类型(过滤的参数的数据类型)、必填(勾选上时,之后引用该数据接口,参数一定要赋值才可以进行筛选;若是不勾选,则会返回参数为空的时候的值)、默认值(赋予参数的文本过滤初始默认值,若之后的引用并未赋予数据项表达式条件值,则会自动使用该默认值。
  • 过滤条件:单击按钮编辑,进行设置过滤的条件,使添加的参数与此树形列表中的数据项产生关联(如“=”“<”“>”“<>”等),形成一个数据筛选的条件。如果未设置过滤条件,则自定义参数无实际意义。
  • 当我们添加一个参数“省份”,并填写过滤条件为:本模板.省份=自定义参数.省份。根据下图进行操作:


NSXLBA12.png


  • 接着在调用此数据接口的模板中,绑定自定义参数.省份=调用此数据接口的省份数据项。


NSXLBA13.png


  • 于是,在填写表单时,我们可以得到如下图所示的效果:


NSXLBA14.png


NSXLBA15.png


过滤项
NSXLBA16.png


  • 对需要过滤的数据项进行赋值条件(通过比较取值来过滤)。此筛选适用于条件固定的情况。

字段名是指比较取值的数据项的名称;比较可以选择“<”“>”“=”“<=”“>=”“<>”等的关联符号;取值1&取值2就* 是我们所需要与数据项进行关联比较的值。

不继承数据源的策略限制

  • 勾选不继承数据源的策略限制后,在调用该树形列表数据接口时,不受权限中的策略限制(仅限于数组过滤,对隐藏区没有影响);不勾选不继承数据源的策略限制,在调用该树形列表数据接口时,会受到权限中的策略限制(仅限于数组过滤,对隐藏区没有影响),也就是说可能导致无法使用所需要的数据。

默认规范方式

只选最底层节点

  • 当我们在使用树形列表时,会存在两个或两个以上的节点,有时我们只需要最底层的节点,而上层节点只针对数据进行分类,不需要选择和填报。这时,我们可以勾选只选最底层节点

填报时允许手工输入

  • 勾选填报允许手工输入后,在数据表管理中调用此数据接口时,默认首选允许手工填入+对话框选择(允许手工输入和对话框选择输入);否则,默认首选为对话框选择(仅允许对话框选择输入,不允许手工输入)。

视图尺寸宽高

  • 当我们调用树形列表数据接口时,弹出的对话框宽高不合适,我们可以通过设置窗口大小&数值来改变对话框的大小。


填表公式

全局树形列表

  • 除了在模板中的数据接口-树形列表建立全局数据接口外,还可以在左侧目录树的【我的系统】--【系统管理】--【数据接口】--【树形列表】中建立全局的树形列表数据接口。 一般被多个模板引用的数据接口建立在全局比较好,方便设计者进行管理。


案例试炼

树形列表在填写规范中的应用

  • 使用者通过使用树形列表进行填写表单,可以更加省时省力。只需直接选择树形列表中需要填入的数据即可,无需键盘输入。而且,树形列表可以直观的显示出数据之间的关系。
  • 首先建立一个列表选择数据接口。访问权限设置为公开。如图所示进行操作:


NSXLBA17.png


  • 在此数据接口中,添加两个参数“省份”和“城市”,且省份参数的默认值为“省”,城市的默认值为“市”。过滤条件为:本模板.省份 形如 自定义参数.省份 并且 本模板.市 形如 自定义参数.城市。如图所示进行操作:


NSXLBA18.png


  • 在模板设计页面中,进入数据表管理,点击要调用树形列表的数据项的填写规范处。选择刚刚创建的树形列表。
  • 在此例中我们用树形列表填写“省份”、“城市”和“区”这三个数据项。首先在省份的填写规范处选择刚刚创建的树形列表。然后在右侧的填写规范处,绑定参数值不进行绑定。目的是为了在调用此树形列表时,不对自定义参数进行赋值,让自定义参数使用默认值,省份的默认值为“省”,城市的默认值为“市”,又因为过滤条件为本模板.省份 形如 自定义参数.省份 并且 本模板.市 形如 自定义参数.城市,所以在提* * 取数据时会提取树形列表中的所有数据。


NSXLBA19.png


NSXLBA20.png


  • 然后在城市的填写规范处选择刚刚创建的树形列表。然后在右侧的填写规范处,绑定参数值这里只对“省份”参数进行绑定。目的:在调用此树形列表时,会根绝前面填写的省份进行过滤,而城市由默认值“市”会取出过滤的省份下的所有城市。


NSXLBA21.png


  • 最后在区的填写规范处选择刚刚创建的树形列表。然后在右侧的填写规范处,绑定参数值这里对“省份”和“城市”这两个参数进行绑定。目的是为了在调用此树形列表时,会根据前面填写的省份和城市进行过滤。


NSXLBA22.png


NSXLBA23.png


树形列表在列表选择中的应用

请参考(列表选择 中分类树部分)

树形列表在总表中的应用

  • 生活中,我们在读一本书时,都会先看目录,或者通过目录可以快速找到我们需要的章节,这样可以极大的节省阅读时漫无目的的查询需要章节的时间。
  • 在云表中也有这个“目录”功能的存在。在总表中查看数据时,可以通过在左侧添加目录树的方式对数据进行过滤。如图所示:


NSXLBA24.png


NSXLBA25.png


NSXLBA26.png


  • 在总表的左侧添加目录树前,需要在本模板中构建一个树形列表。如图所示进行操作:


NSXLBA27.png


NSXLBA28.png


NSXLBA29.png


NSXLBA30.png