拍拍接口功能介绍
目录
一、概述 ....................................................................................................................................................................................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 来测试.以
交易订单列表接口）,
五、设计拍拍接口模型
第一步：业务系统配置
要从拍拍网取数据，必定涉及到业务系统的数据库。配置数据源，告诉系统你的业务系统数据库.
打开[基础数据]-数据源配置
增加
编号：设置编号
名称：设置名称
数据源类型：对应的是什么类型的数据库
数据库服务器 IP:数据库服务器所在的 IP
数据库服务器端口：端口
数据库名：数据库名称
用户：数据库用户
密码：数据库密码
增加完后进入 view 视图，可以通过点击[数据库测试连接]测试你的配置是否正确.
第二步：定义拍拍店铺
打开[拍拍接口]-【拍拍店铺】
第三步：设置固定字段
如果业务系统,有些字段是需要固定的。你可以在此处先设置好固定字段，然后在数据模型设置的时候选择，
也可以不设置，直接在数据模型设置的时候固定，相比较而言，这里设置有一个好处处是，不易出错。
进入：[基础数据]-固定值配置
第四步：设置对照字段
对于同一个对象，可能分别在拍拍网和业务系统中设置的编号不同,传输的时候，需要自动转换.对于需要转换的
字段，需要先设置。举例如下：对于客户 A，可能在 A 系统编号为 00A,但在 B 里面编号是 00B,传输的时候，就要
自动将 00A 变为 00B.
进入：[基础数据]-[对照表]
点增加，设置一个对照类型，比如：客户编号对照
增加完后设置对照明细
上面设置好以后，表示：客户 A 在源数库中的值为 aaa,目标数据库中的值要为 aaaa,
传输的时候要自动按照上面转换.
第五步：设计拍拍模型
1:增加模型主表:
点增加按纽,
编号：模型编号:
名称:模型名称
店铺：设置拍拍卖家
目标数据源：设置业务系统
模型处理类：目前只能选择拍拍模型处理类
模型映射：选择拍拍返回的数据第一次对应的映射，注意增加的时候是空，因为你只时还没有增加映射。
调用方法名:设置调用拍拍网的 API 方法
2:增加模型映射
点增加映射按纽：
编号：映射的编号
名称：映射的名称
表名：对照的物理表名，如果没有，就为空。
主键名：表的主键
取值主键名：表的主键对应的是拍拍网返回的数据集中的哪个值
检查标志：是否对数据进行重复性检查，只有在表名不为空的时候才有效.
检查失败的处理方式：当检查到有重复的时候，系统的处理方式.
4:增加映射字段：
点增加明细按纽:
标题：字段的中文名称：
字段处理器：
固定值处理类：处理固定字段用的，选择此处理器后，需要设置常量值
对照值处理类:处理对照字段用的，选择此处理器后，需要设置对照值
字段处理器:从拍拍网返回的值中取对应的字段取值
变量处理器：从系统变量中取值
自动增长主键处理器:有的系统基本上所有表的主键都是整型，并且不是自增长，由系统自动产生，
当传输的时候，需要自动生成主键的时候，需要调用此处理器
SQL 处理器: 通过当前的值，返回另外一个或多个值来插入.比如说拍拍网的 sku_id 是一个值，业务系统
可能是三个值。
自定义单据编号处理器：系统自定义一个单据编号
数据集处理器：处理拍拍网返回的一个数据集，这时候，你需要选择这个数据集的映射模型
源字段：拍拍网返回的数据集中的字段名称
目标字段：物理表的字段名称
字段类型：目标字段类型,有整数，字符串，实数，日期 4 种.
变量值：设置取的变量名称,对应变量处理器
数据集：设置数据集，对应数据集处理器
常量值：可以选择也可以直接接设置,对应固定值处理器
对照值：选择框,对应对照值处理器
SQL:对应 SQL 处理器,固定变量为：${value} 表示来源表中当前的值
5:设置参数
参数主要用于调用 API 方法
参数名：参数的名称
标题：参数的中文名称
参数类型：
固定：就是将参数值直接传给拍拍
变量：系统变量
当前时间往前推 X 分钟：工作调度的时候要注意
当前时间：取调用的当前时间
参数值：与参数类型相对应的
6:设置执行脚本
点增加脚本：
名称：脚本名称
数据源：这个脚本对哪个数据源执行
参数：脚本所需要的参数
内容：实际脚本
数据源${dtl}：dtl 是模型映射的编号,参数就是实际取哪些值，在脚本里面需要用到的，通俗一点讲，${dtl}就是我
们这次传输保存在数据库表里的所有明细，billno,tbsprodid,tbscolorid,tbssizeid,就是明细表的一些字段.注：如果${dtl}
有 100 条，上面的脚本执行 100 次
7:调试执行模型
点【调试】按纽,不写数据库，显示需要执行的脚本，对模型进行调试,调试成功后，再点【执行】按纽,
六、查看传输日志
进入[日志分析]模块
七、传输模型作业调度
进入【作业调度】-【作业计划】模块,点增加按纽
具体功能介绍请参阅【作业调度功能】,强调以下两点：
调度对象:必须选择：淘宝拍拍作业：
自定义属性 1:写上你需要作业的传输模型，多个模型编号之间用逗号隔开.
注：ESK 数据交换平台软件是永久免费，基本没有限制，非注册版没有作业调度功能
软件下载及咨询加 QQ 群:180028274
