9.4.2 数据源-模板数据接口

填表公式:数据源-模板数据接口/序号列表用法/文本列表用法/系统预设数据接口用法

1.什么是数据源

“数据源”可从模板的数据接口、系统内设的全局数据接口、新建表单、打开表单、导入excel、摄像头扫码、上传文件、询问对话框、本表单明细等获取数据,并将获取到的数据传给后续的操作中使用。返回的数据是一个二维表(结构类似明细表),一行表示一条记录,一列表示一个数据项。

2.作用

①“数据源”的作用是给后续的操作提供数据
②数据源中有多少条记录,则驱动操作执行多少次。首先会取出二维表中第一条记录,驱动操作的执行一次,在操作中可以访问该条记录参与计算,操作完成后,“数据源”会取下一条记录继续驱动操作执行,以此类推,直至读取完数据源中所有的记录。例如“数据源”有三条记录,则操作将执行三次。

3.类型

数据接口可以作为操作的数据源,为后续操作提供数据。在“数据源”上选择“模板数据接口”,单击【…】按钮后,在弹出的“选择数据接口”对话框中选择需要调用的数据接口,左侧为模板类型,右侧为模板类型中对应的数据接口。
有2类数据数据接口:
全局系统预设的数据接口。左侧模板类型选择“全局”,右侧勾选“系统预设”即为全局的系统预设的数据接口,一共有19个系统预设的数据接口。
模板的数据接口。必须先在对应的模板中设计好数据接口,然后再调用,使用时先在左侧选择“模板”,右侧显示该模板的数据接口。

4.参数说明

①参数绑定:当模板数据接口中选择具体的数据接口时,自动带入数据接口的自定义参数,数据接口没有参数时,显示为空白;
参数名:数据接口的自定义参数名称,数据接口中有多个参数时,显示多行(如下图);
绑定参数值:给数据接口的自定义参数赋值,实现动态查询,可以是本表单的某个数据项或者表达式计算后的结果,起到匹配参数和过滤数据源的作用。
必填:勾选必填后,当参数的“绑定参数值”为空时不执行查询;
多参数
分页参数:需要分页显示时才设置,可将数据接口查询结果,根据“每页显示的行数”分页,并显示指定的页,详细使用方参见 分页统计报表
支持分页加载:勾选该项后,数据源中会增加4个系统数据项(_nowNO 是指数据源的几条记录,是否支持分页加载都会显示)
_pageIndex 第几页 ,当前查询“数据源”的第几页
_pageSize 每页行数 ,一次查询多少记录
_pageCount 总页数 ,按照“每页行数”设置,查询的所有结果可分为多少页
_totalCount 总记录条数 ,查询结果一共有多少条记录
页码:按照设置的“每页行数”显示第几页的查询结果;
每页行数:设置每页显示多少条查询的结果;
③显示对话框:默认勾选,会以对话框的方式显示数据源查询后的结果,手动选择记录,只有被选择的记录才会被使用;若不勾选该项,数据源所有过滤后的记录都会被使用;
④记录为空时不显示对话框: 勾选“显示对话框”才可见该项。若勾选该项,数据源查询结果为空时不显示对话框;若不勾选该项,数据源查询结果为空时仍然显示对话框。
⑤可多选: 勾选【显示对话框】才可见该项。若勾选该项,可在数据源查询结果对话框中多选记录;若不勾选该项,每次只能在数据源查询结果对话框中选择其中的一条记录。
⑥多条记录合为一条:被选中的多条记录会合并成一条记录显示,若为文本的数据项,结果以“,”连接,若是数值的数据项,结果为相加后的计算值。

5.示例

5.1 模板的数据接口

我们以《采购申请单》中单击“供应商”的【…】按钮后,弹出对话框单选供应商,给“供应商”赋值为例。
①“采购申请单”模板样式如下,并将“供应商”的单元格类型设置是为“组合按钮”;
②添加“供应商”的 单元格按钮单击事件。单击【填表公式】,在弹出的“填表公式管理”对话框中找到“单元格按钮单击”事件,添加数据项“供应商”。
③添加赋值操作。选中“供应商”的单元格按钮单击事件,单击【添加公式】按钮,在“请选择操作”对话框中选择“赋值”公式。
④给供应商赋值时,需要显示供应商列表以供选择,因此需要设计数据接口-供应商信息列表。该数据接口的数据由《供应商信息》模板提供数据,进入“供应商信息”模板设计界面,新建一个“公开”的“列表选择”数据接口。
⑤完善赋值操作。将公式名称改为“赋值_供应商名称”;“数据源”选择“模板数据接口”单击右侧【…】,在弹出的对话框左侧选择模板“供应商信息”,右侧选择数据接口“供应商信息”。需要显示供应商列表,以便单选,勾选“显示对话框”;对目标表“本表单”的“供应商”赋值“数据源.名称”。
⑥应用效果。在“采购申请单”中,单击【供应商】,弹出“供应商列表”,单选后将选中的供应商名称填写到表单。

5.2 全局系统预设数据接口

左侧模板类型选择“全局”,右侧勾选“系统预设”即为全局的系统预设的数据接口,一共有19个系统预设的数据接口,我们以“序号列表”和“文本列表”为例。
5.2.1 序号列表
序号列表:该数据接口有2个参数“开始序号”和“结束序号”,可生成从开始序号到结束序号的序号列表。当该数据接口被调用作为数据源后,序号列表结果中有多少条记录,则驱动操作执行多少次。比如开始序号输入“1”,结束序号输入“4”,结果为从1-4的序号,一共有4条记录,则将驱动操作执行4次。
5.2.2 文本列表
文本列表:该数据接口有3个参数“字符串”、“分隔符号”和“是否去重”,可将字符串根据分割符号拆分成若干文本列表,勾选“是否去重”后,重复文本只显示一条记录。当该数据接口被调用作为数据源后,文本列表结果中有多少条记录,则驱动操作执行多少次。
比如字符串输入“北京,上海,武汉”,分隔符号输入“,”,结果为3条记录的文本列表,则将驱动操作执行3次。
2022-09-23
4541
Baidu
map