9.4.2 数据源-模板数据接口

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

①“数据源”的作用是给后续的操作提供数据

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

数据接口可以作为操作的数据源，为后续操作提供数据。在“数据源”上选择“模板数据接口”，单击【…】按钮后，在弹出的“选择数据接口”对话框中选择需要调用的数据接口，左侧为模板类型，右侧为模板类型中对应的数据接口。

有2类数据数据接口：

★全局系统预设的数据接口。左侧模板类型选择“全局”，右侧勾选“系统预设”即为全局的系统预设的数据接口，一共有19个系统预设的数据接口。

★模板的数据接口。必须先在对应的模板中设计好数据接口，然后再调用，使用时先在左侧选择“模板”，右侧显示该模板的数据接口。

①参数绑定：当模板数据接口中选择具体的数据接口时，自动带入数据接口的自定义参数，数据接口没有参数时，显示为空白；

参数名：数据接口的自定义参数名称，数据接口中有多个参数时，显示多行（如下图）；

绑定参数值：给数据接口的自定义参数赋值，实现动态查询，可以是本表单的某个数据项或者表达式计算后的结果，起到匹配参数和过滤数据源的作用。

必填：勾选必填后，当参数的“绑定参数值”为空时不执行查询；

②分页参数：需要分页显示时才设置，可将数据接口查询结果，根据“每页显示的行数”分页，并显示指定的页，详细使用方参见 分页统计报表

支持分页加载：勾选该项后，数据源中会增加4个系统数据项（_nowNO 是指数据源的几条记录，是否支持分页加载都会显示）

_pageIndex 第几页 ，当前查询“数据源”的第几页

_pageSize 每页行数 ，一次查询多少记录

_pageCount 总页数 ，按照“每页行数”设置，查询的所有结果可分为多少页

_totalCount 总记录条数 ，查询结果一共有多少条记录

页码：按照设置的“每页行数”显示第几页的查询结果；

每页行数：设置每页显示多少条查询的结果；

③显示对话框：默认勾选，会以对话框的方式显示数据源查询后的结果，手动选择记录，只有被选择的记录才会被使用；若不勾选该项，数据源所有过滤后的记录都会被使用；

④记录为空时不显示对话框：勾选“显示对话框”才可见该项。若勾选该项，数据源查询结果为空时不显示对话框；若不勾选该项，数据源查询结果为空时仍然显示对话框。

⑤可多选：勾选【显示对话框】才可见该项。若勾选该项，可在数据源查询结果对话框中多选记录；若不勾选该项，每次只能在数据源查询结果对话框中选择其中的一条记录。

⑥多条记录合为一条：被选中的多条记录会合并成一条记录显示，若为文本的数据项，结果以“，”连接，若是数值的数据项，结果为相加后的计算值。

我们以《采购申请单》中单击“供应商”的【…】按钮后，弹出对话框单选供应商，给“供应商”赋值为例。

①“采购申请单”模板样式如下，并将“供应商”的单元格类型设置是为“组合按钮”；

②添加“供应商”的单元格按钮单击事件。单击【填表公式】，在弹出的“填表公式管理”对话框中找到“单元格按钮单击”事件，添加数据项“供应商”。

③添加赋值操作。选中“供应商”的单元格按钮单击事件，单击【添加公式】按钮，在“请选择操作”对话框中选择“赋值”公式。

④给供应商赋值时，需要显示供应商列表以供选择，因此需要设计数据接口-供应商信息列表。该数据接口的数据由《供应商信息》模板提供数据，进入“供应商信息”模板设计界面，新建一个“公开”的“列表选择”数据接口。

⑤完善赋值操作。将公式名称改为“赋值_供应商名称”；“数据源”选择“模板数据接口”单击右侧【…】，在弹出的对话框左侧选择模板“供应商信息”，右侧选择数据接口“供应商信息”。需要显示供应商列表，以便单选，勾选“显示对话框”；对目标表“本表单”的“供应商”赋值“数据源.名称”。

⑥应用效果。在“采购申请单”中，单击【供应商】，弹出“供应商列表”，单选后将选中的供应商名称填写到表单。

更多案例详见 值变化事件-示例-综合应用

左侧模板类型选择“全局”，右侧勾选“系统预设”即为全局的系统预设的数据接口，一共有19个系统预设的数据接口，我们以“序号列表”和“文本列表”为例。

序号列表：该数据接口有2个参数“开始序号”和“结束序号”，可生成从开始序号到结束序号的序号列表。当该数据接口被调用作为数据源后，序号列表结果中有多少条记录，则驱动操作执行多少次。比如开始序号输入“1”，结束序号输入“4”，结果为从1-4的序号，一共有4条记录，则将驱动操作执行4次。

文本列表：该数据接口有3个参数“字符串”、“分隔符号”和“是否去重”，可将字符串根据分割符号拆分成若干文本列表，勾选“是否去重”后，重复文本只显示一条记录。当该数据接口被调用作为数据源后，文本列表结果中有多少条记录，则驱动操作执行多少次。

比如字符串输入“北京，上海，武汉”，分隔符号输入“，”，结果为3条记录的文本列表，则将驱动操作执行3次。