3.1概述

接口泛指实体把自己提供给外界的一种抽象化物(可以为另一实体),用以由内部操作分离出外部沟通方法,使其能被内部修改而不影响外界其他实体与其交互的方式。

1.数据接口作用

提供数据的,通过数据接口,可以把模板的数据提供给本模板或者其他模板使用

2.应用场景举例

1.在《合同管理》中录入合同时,需要列出所有的客户列表以供选择,或者输入客户编号,自动带出客户名称等信息,这个时候弹窗选择(图2)或自动带出来的内容(客户的发票信息)就是通过数据接口来实现,可单选或者多选。
图2:选择客户填写合同
2.填写采购单时,模糊输入商品编号或者商品名称,显示符合的商品列表选择商品填写表单。
图3:模糊输入商品编号或者商品名称列出符合条件的商品填写表单
3.进行商品销售统计时,根据已填写的年月,单击【查询】汇总商品销售情况。
图4:汇总商品销售情况

3.数据接口类型

在模板设计界面的“公式设置区”,打开“数据接口”进入数据接口界面;

3.1数据接口类型

云表中一共有5类数据接口:列表选择、自动编号、下拉列表、树形列表和系统变量。
①列表选择类型数据接口,查询的结果为多列的二维数据集,数据信息最多;
②自动编号,根据所给规则自动生成一串唯一的文本,比如订单号、学号、工号等;
③下拉列表,查询的结果为单列下拉数据;
④树形列表,根据3种不同的树形构建规则,构建树形,方便选择,比如商品分类树,省市区树;
⑤系统变量是系统内置的,可获取当前日期相关信息和当前用户相关信息
数据接口类型

3.2使用范围

根据使用范围分为为私有、公开和全局。
①私有:私有的数据接口只能在本模板自己调用,譬如:常用的自动编号数据接口。当然,数据接口的使用范围可更改。
②公开:公开的数据接口不仅可以被本模板自己调用,还能被其他模板调用,譬如:可用商品列表,省列表,客户列表 等这些数据接口一般都会给其他模板调用。
③全局:包含了系统预设的数据接口,不属于任何一个单独的模板。可兼容之前未细分时的数据规范,外部数据源的数据接口一般为全局的数据接口。

4.数据接口组成元素

数据接口主要分为三部分:数据源、数据列、过滤条件。
图5:设计数据接口界面
① 数据源:是指数据接口提供的数据来源于哪里,它可以从其他保存数据的模板获取数据,比如客户信息列表的数据源来源于《客户档案》模板;也可以从模板的明细获取数据,比如采购明细列表的数据源于《采购单.商品明细》(图6),还可以是数据的集合获取数据,比如商品销售统计的数据源于《销售单.商品明细》和《商品档案》2个模板(图7)。
图6:数据源为采购单.商品明细
图7:数据源为销售单.商品明细和商品档案
②数据列:是指本次查询想要的结果,它可以直接调用数据源的数据项,也可以是数据源数据项进行处理后的值。如图8,数据列【商品编号】直接调用商品档案.商品编号数据项,数据列【合计数量】是数据项 销售单.明细.数量 调用函数处理后的结果
图8:数据列
③过滤条件:是指通过什么条件,对数据源模板中的所有表单进行筛选。它包含自定义参数和过滤条件,关于自定义参数与过滤条件的使用方法具体可参见 12.2 查询模板:过滤条件。

5.数据接口的用意

①规范化管理,改变数据规范全部堆积在一起的状态。譬如:想要获取客户相关的信息,在数据接口界面找到《客户档案》表下的数据接口,就能很轻松的找到。
②协同开发更安全可靠。模板内部无论怎么变,只要对外提供的数据接口不变,即可让其他人安全调用。譬如:一个公司内部有两名开发人员,一个人开发OA模块,一个人开发业务模块。某天,开发OA的开发人员把员工信息表的数据项增加减少或修改了,他只要把此模板数据接口中的数据项进行相应修改即可。开发业务模块的开发人员不需要知道这里面的变化,只要调用数据接口是对的就行。
③权限管控。可针对模板的设计添加权限控制,譬如:A开发者开发的模板,可以自己设计是否允许别人设计,如果不允许别人设计,也能保证此模板提供的数据接口完全不让其他人修改。
④用系统的思维进行开发,思路更。比如做了一个《客户档案》的模板,可预计《客户信息》将对外提供什么样的数据接口,比如“根据客户编号查询客户信息”、“客户信息列表”等等。此时,在设计模板的时候可以先将这些接口做好。当然,也可以在设计的过程中需要时,再回到《客户信息》模板设计数据接口;

6.数据接口使用规则

①表单模板的数据接口,数据源必须包含本模板且不允许删除,同时可以关联其他表单;全局的数据接口数据源是空白的。
②设计模板期可调用其他模板的数据接口,且能调试该接口,但是编辑其他模板的数据接口时,系统会自动打开该数据接口所属的模板的设计界面,并进行修改。
③数据接口作为模板的一部分,模板必须保存才会生效。譬如:设计B模板时,发现需要在A模板中添加新的数据接口,此时回到A模板进行设计,设计之后必须保存A模板,再返回B模板,选中数据接口选择窗口的“刷新”,即能看到A模板及新建的数据接口;
2022-06-22
4340
Baidu
map