ESK数据交换平台之拍拍接口功能说明.docVIP

PAGE / NUMPAGES 拍拍接口功能介绍 目录 TOC \o 1-3 \h \z \u 一、概述 2 二、数据交换模型定义 2 三、 特色 2 四：学会使用拍拍工具 3 五、设计拍拍接口模型 5 第一步：业务系统配置 5 第二步：定义拍拍店铺 6 第三步：设置固定字段 6 第四步：设置对照字段 7 第五步：设计拍拍模型 8 1:增加模型主表: 8 2:增加模型映射 9 4:增加映射字段： 10 5:设置参数 11 6:设置执行脚本 12 7:调试执行模型 12 六、查看传输日志 13 七、传输模型作业调度 13 一、概述 本接口为拍拍网和业务系统之间的数据交换提供保障，方便解决拍拍网和业务系统之间数据传输，维护繁杂的问题。 √自定义数据交换模型； √数据结构在逻辑转换时可自定义编码对照方案，SQL对照方案； √可以通过客户端来执行数据传输任务； √所有数据传输任务都记录日志信息 √传输任务时受事务控制 √通过作业调度，可以自定义传输时间和传输频率. 二、数据交换模型定义 我们把拍拍网的部分数据抽取到本地的业务系统所需要的所有元素，我们称之为模型.这些模型包括 √访问拍拍网所需要的API及参数 √访问业务系统的数据库连接设置 √字段转换的对照列表， √转换后需要执行的脚本或存储过程 特色 本数据接口平台的突出优点就是灵活、高效、实时. (1) 安全性：接口的安全性将影响到各后台信息支持系统的数据和系统安全，该接口平台具有有效的权限控制、认证等安全手段，保证所有相关系统的安全性。 (2) 高效性：传输时采用多线程机制，保证接口平台具有较高的访问效率，尤其在较大并发客户访问时，不会成为系统应用的瓶颈。 (3) 一致性（实时性）：接口平台的数据信息与原系统同步更新，以保证服务质量。 (4) 灵活性：接口平台具有灵活性，便于将来与不同的信息系统进行连接，并且易于维护和升级。 a) 支持多种数据库； b) 支持多种查询方法：sql语句、存储过程； c) 支持对多个查询结果进行加减乘除等操作，方便对结果数据进行维护； d) 构造sql语句灵活多变，支持精确查询及模糊查询 四：学会使用拍拍工具 从工作台或者是菜单进入拍拍工具 从右边打开API文档，可以随便找一些API来测试.以/item/sellerSearchItemList.xhtml（卖家查找交易订单列表接口）, 五、设计拍拍接口模型 第一步：业务系统配置 要从拍拍网取数据，必定涉及到业务系统的数据库。配置数据源，告诉系统你的业务系统数据库. 打开[基础数据]-数据源配置 增加 编号：设置编号 名称：设置名称 数据源类型：对应的是什么类型的数据库 数据库服务器IP:数据库服务器所在的IP 数据库服务器端口：端口 数据库名：数据库名称 用户：数据库用户 密码：数据库密码 增加完后进入view视图，可以通过点击[数据库测试连接]测试你的配置是否正确. 第二步：定义拍拍店铺 打开[拍拍接口]-【拍拍店铺】 第三步：设置固定字段 如果业务系统,有些字段是需要固定的。你可以在此处先设置好固定字段，然后在数据模型设置的时候选择，也可以不设置，直接在数据模型设置的时候固定，相比较而言，这里设置有一个好处处是，不易出错。 进入：[基础数据]-固定值配置 第四步：设置对照字段 对于同一个对象，可能分别在拍拍网和业务系统中设置的编号不同,传输的时候，需要自动转换.对于需要转换的字段，需要先设置。举例如下：对于客户A，可能在A系统编号为00A,但在B里面编号是00B,传输的时候，就要自动将00A变为00B. 进入：[基础数据]-[对照表] 点增加，设置一个对照类型，比如：客户编号对照 增加完后设置对照明细 上面设置好以后，表示：客户A在源数库中的值为aaa,目标数据库中的值要为aaaa, 传输的时候要自动按照上面转换. 第五步：设计拍拍模型 1:增加模型主表: 点增加按纽, 编号：模型编号: 名称:模型名称 店铺：设置拍拍卖家 目标数据源：设置业务系统 模型处理类：目前只能选择拍拍模型处理类 模型映射：选择拍拍返回的数据第一次对应的映射，注意增加的时候是空，因为你只时还没有增加映射。 调用方法名:设置调用拍拍网的API方法 2:增加模型映射 点增加映射按纽： 编号：映射的编号 名称：映射的名称 表名：对照的物理表名，如果没有，就为空。 主键名：表的主键 取值主键名：表的主键对应的是拍拍网返回的数据集中的哪个值 检查标志：是否对数据进行重复性检查，只有在表名不为空的时候才有效. 检查失败的处理方式：当