ESK数据交换平台之拍拍接口功能介绍.docx

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