睿码主数据
当前版本:2.6.1

接口取数

1.概述

在录入主数据时,支持从第三方取数。比如,这里有一个城市主数据,在【城市信息】视图中,输入城市id字段后会自动调用天气预报接口获取对应的城市名称,天气,以及时间。

本章节我们通过实现上面示例来讲解如何从接口取数。

2.操作步骤

2.1新建接口数据源

在【数据集成】-【数据源】-【接口数据源】中新建天气预报接口数据源,其配置如下图,具体创建方法见《创建数据源》章节。

注:字段映射这里得按需正确获取和选择字段,这些字段是后面接口取数时接口的响应字段。

2.2新建接口取数

在建好接口数据源后,我们需要在【主数据模型】的【表单设计】中,进行接口取数设置。点击【接口取数】,进入接口取数设置列表,点击【新建】可新建接口取数设置,同一表单可设置多条接口取数设置。

【接口数据源】这里我们选择刚刚新建的接口数据源,在此页面点击新建也可跳转到接口数据源界面。

【请求参数设置】这里是给接口的请求参数赋值。接口数据源中的请求参数cityid其值等于城市信息表中的城市id字段。

【响应参数设置】这里是将接口返回参数和表单的字段进行对应。

【确定】完成接口取数设置。

2.3验证接口取数

2.3.1自动触发

新增或编辑主数据时,在城市信息表中输入城市id,结束编辑(移走鼠标焦点)后会自动触发接口取数,城市名称、天气、时间这三个字段会自动取值。

2.3.2手动触发

也可以通过点击表单填报页面下方的【接口取数】按钮手动触发接口取数。

2.3.3返回数据有多条

当接口返回的数据有多条时,会出现一个弹框,显示获取到的所有数据,可手动选择(选中并确定)我们需要的一条数据回填到对应的表单字段中。

注:在第一次进入数据申请页面,会自动触发接口取数,如果请求参数对应的字段设置有默认值,且该默认值能通过接口获取到数据,这些数据将会自动的填充到表单中,反之,如果没有设置默认值或者设置的默认值在这个接口中匹配不到对应的数据就会给出提示,如下图。

附件列表

5

文档内容仅供参考
如果您需要解决具体问题,还可以登录亿信社区
在提问求助板块提问,30分钟内帮您解决问题

如果您认为本词条还有待完善,请编辑

上一篇表单设置

下一篇主数据产品介绍

请先登录