1.16 有参数的数据接口填写基本信息

在填写采购入库单时，需要引用采购订单的信息，比如供应商、采购日期、采购员等。传统做法是手动输入或切换到采购订单模板去复制，步骤多且容易出错。

能不能在入库单中输入采购单号后，系统自动把采购订单的基本信息带过来？本教程讲解如何通过有参数数据接口，将输入的采购单号作为参数，查询对应的采购订单信息并自动填入入库单中。

首先需要在采购订单模板中创建两个数据接口：一个用于选择采购订单（无参数），一个用于根据单号查询订单详情（有参数）。

① 打开"采购订单"模板设计页面，在数据接口中新建一个列表选择数据接口，命名为"采购订单列表"。数据源选择本模板，数据列选择"采购单号"。

② 同样在采购订单中，在数据接口中新建一个列表选择数据接口，命名为"采购订单查询"。数据源选择本模板，数据列勾选需要带出的字段（如"供应商"、"采购日期"、"采购员"等）。

③ 点击"添加参数"，参数名称设为"采购单号"，类型选择"文本"。

④ 设置过滤条件：采购订单模板中的"采购单号"字段 等于 参数"采购单号"。

（2）在入库单中设置列表选择

目标： 让用户可以通过列表选择采购订单单号。

① 打开"采购入库单"模板，打开数据表管理，选中"来源单号"数据项，在填写规范中选择列表选择的数据接口，数据接口选择"采购订单列表"。

使用效果： 点击"来源单号"，弹出采购订单列表，选中后自动填入单号。

目标： 选中采购单号后，自动触发查询并带出采购订单的详细信息。

① 在填表公式中选择"值变化"事件，添加数据项选择"来源单号"。

② 在该数据项下点击"添加公式"，选择"赋值公式"。

目标： 调用采购订单查询接口，将查询结果填入入库单。

① 在赋值公式的数据源设置中，选择"模板数据接口"，选择"采购订单查询"数据接口。

② 将参数"采购单号"绑定到当前表单的"来源单号"字段。

③ 建立字段对应关系，将数据接口中的"供应商"对应到入库单的"供应商"字段，"供应商编号"对应到"供应商编号"，"来源类型"手动输入为"采购订单"。

使用效果： 在入库单中选中采购单号后，系统自动查询该采购订单的详细信息并填入入库单对应字段。

❓ 常见问题： 如果填写单号后没有自动带出数据，检查：①值变化事件有没有添加"来源单号"数据项？②过滤条件中的字段名是否匹配？③数据接口的参数绑定是否正确？

（1）数据接口需要在数据来源的模板（采购订单）中创建，不是在当前表单中新建。

（2）通过值变化事件监听"来源单号"字段，填入采购单号后自动触发查询。

（3）有参数数据接口需要添加参数并设置过滤条件，将用户输入的采购单号作为查询条件。

（4）建立字段对应关系后，采购订单的供应商、日期、采购员等信息自动填入入库单对应字段。