ESK数据交换平台之拍拍接口功能介绍(一)

拍拍接口功能介绍

目录

一、概述2

二、数据交换模型定义2

三、特色2

四：学会使用拍拍工具2

五、设计拍拍接口模型4

第一步：业务系统配置4

第二步：定义拍拍店铺5

第三步：设置固定字段6

第四步：设置对照字段6

第五步：设计拍拍模型7

1：增加模型主表：7

2：增加模型映射8

4：增加映射字段：9

5：设置参数10

6：设置执行脚本10

7：调试执行模型11

六、查看传输日志12

七、传输模型作业调度12

一、概述

本接口为拍拍网和业务系统之间的数据交换提供保障，方便解决拍拍网和业务系统之间数据传输，维护

繁杂的问题。

J自定义数据交换模型；

J数据结构在逻辑转换时可目定义编码对照方案，SQL对照方案；

J可以通过客户端来执行数据传输任务；

J所有数据传输任务都记录日志信息

J传输任务时受事务控制

J通过作业调度，可以自定义传输时间和传输频率.

二、数据交换模型定义

我们把拍拍网的局部数据抽取到本地的业务系统所需要的所有元素，我们称之为模型.这些模型包括

J访问拍拍网所需要的API及参数

J访问业务系统的数据库连接设置

J字段转换的对照列表，

J转换后需要执行的脚本或存储过程

三、特色

本数据接口平台的突出优点就是灵活、高效、实时.

(1)平安性：接口的平安性将影响到各后台信息支持系统的数据和系统平安，该接口平台具有有效的权限

控制、认证等平安手段，保证所有相关系统的平安性。

(2)高效性：传输时采用多线程机制，保证接口平台具有较高的访问效率，尤其在较大并发客户访问时，

不会成为系统应用的瓶颈。

(3)一致性(实时性)：接口平台的数据信息与原系统同步更新，以保证效劳质量。

(4)灵活性：接口平台具有灵活性，便于将来与不同的信息系统进行连接，并且易于维护和升级。

a)支持多种数据库；

b)支持多种查询方法：sql语句、存储过程；

c)支持对多个查询结果进行加减乘除等操作，方便对结果数据进行维护；

d)构造sql语句灵活多变，支持精确查询及模糊查询

四：学会使用拍拍工具

从工作台或者是菜单进入拍拍工具

拍拍工具

返叵类型I列表▼

拍拍店铺：I田

API:(比如：/item/sellerSearchItemList.xhtml)

输入参数：(比如:pdgeIndex=l&pdgeSize=40&sellerUin=QQ号8distltem=l

力执行

从右边翻开API文档，可以随便找一些API来测试.以（卖家查找交易订单列表接口），

拍拍工具

返回类型列表▼

拍拍店铺：拍拍店铺

API:(比如：/item/sellerSearchItemList.xhtml)

http://api/item/sellerSearchltemList.xhtml

输入参数:(比如:pdgeIndex=18tpdgeSize=40&sellerUin=QQ号8distltem=l

pageIndex=l&pageSize=40&sellerUin=^^qq^-&listlcem=l

力执行

查询结具

找到1褥记录显示1到1

IcrrorMcjsageIcountTotalIitemListerrocCodepageSizeIsdlerUinIpogclndcx

464数据集：itemList0408550010511

数据集:itemList

找到40条记录.显示1到40

cityIdpicLinkIsutetescIguaranteeZDayslitemLocalCodeIstockListIitemCode

http:Mmg7paipaiimgcom/aae9821Mtem-一口饰出

29240E82D04F-售中051123DD847F63200000000040100000223C9360

DE47F63200000000040100000223C936.0jpg

htto：//f98e2l75imem-一口饰出

29240E82CED2-售中0511180DB47F63200000000040100000223BB6A0

DE47F63200000000040100000223BB6A.OJPQ

http4mg0paipaiimgcom/714c8cO2/rtem-一口价出

29240E82D22O-管中053018DDB47F63200000000040100000223B8860

DE47F63200000000040100000223B8860.jpg

骸1多通2示1到1

lament|onfcr_«mount>

800致慧：or啊即刖而11248仗71般

HSK：orderamounts

Itttenumpace(ksoount_ieeptjwentnun.tdLd^»t_1©e

SM£1800000800112481907182132595000

五、设计拍拍接口模型

第一步：业务系统配置

要从拍拍网取数据，必定涉及到业务系统的数据库。配置数据源，告诉系统你的业务系统数据库.

翻开［基础数据］-数据源配置

曲萱询(F3)口增加(F2)

数据源配置

找到2条记录，显示1到2

增加

U保存(F10)仁返回(ESC)

数据源配置

编号|000_________________

堪称国0_________

数据源类型SQLSERVER▼

数据库服务器IP127.001____________

数据库服务器端口1433_______________

数据库名esk2________________

.用尸sa__________________

密码

编号：设置编号

名称：设置名称

数据源类型：对应的是什么类型的数据库

数据库效劳器IP：数据库效劳器所在的IP

数据库效劳器端口：端口

数据库名：数据库名称

用户：数据库用户

密码：数据库密码

增加完后进入view视图，可以通过点击［数据库测试连接］测试你的配置是否正确.

一测试数据库连接「修改(F4)X删除(F5)◎返回(ESC)

第二步：定义拍拍店铺

翻开［拍拍接口］-【拍拍店铺】

*俣存(F10)；返回(ESC)

扫报店铺

'名称饰店搐'类盟上用型3

'亶用环境标志拍拍环境spid|29230000ea03e5af084

secretKey|3trg7g2bekOI7xDI7uzyttltoken|db47f6320f27e5af084d

uin|W12•API处理芟I拍拍常用API处理类▼1

备注例试

第三步：设置固定字段

如果业务系统，有些字段是需要固定的。你可以在此处先设置好固定字段，然后在数据模型设置的时候选择,

也可以不设置，直接在数据模型设置的时候固定，相比较而言，这里设置有一个好处处是，不易出错。

进入：［基础数据］-固定值配置

施查询(F3)二I增加(F2)

第四步：设置对照字段

对于同一个对象，可能分别在拍拍网和业务系统中设置的编号不同，传输的时候，需要自动转换.对于需要转

换的字段，需要先设置。举例如下：对于客户A,可能在A系统编号为00A,但在B里面编号是OOB,传输的时候,

就要自动将00A变为00B.

进入：［基础数据］-［对照表］

曲查询(F3)口增加(F2)

点增加，设置一个对照类型，比方：客户编号对照

U保存(F1D)值返回(ESC)

过照值配置

'编号时名称客尸编号对照

—

增加完后设置对照明细

区增加明细(F2)上修改(F4)*删除(F5)。返回(ESC)

上面设置好以后，表示：客户A在源数库中的值为aaa,目标数据走中的值要为aaaa,

传输的时候要自动按照上面转换.

第五步：设计拍拍模型

曲克i尊(F3)上佶二增加(F2)

拍拍模型

找到1条记录.显示1到1出《»>20________▼

编号名栋店锚目标致富强税型处理交

P001取交易订单拍拍I3镭es微据库拍回复型处理芟

1：增加模型主表:

点增加按纽,

U保存(F10)匕返回(ESC)

编号：模型编号：

名称:模型名称

店铺：设置拍拍卖家

目标数据源：设置业务系统

模型处理类：目前只能选择拍拍模型处理类

模型映射：选择拍拍返回的数据第一次对应的映射，注意增加的时候是空，因为你只时还没有增加映射。

调用方法名：设置调用拍拍网的API方法

2：增加模型映射

a增加映射

，调试/执行，琪登下栽◎返回(ESC)

拍拍模型

找到3条记录，显示1到

名廊|袤名|主工龄查标志

deaiLlsi交易数据集

如零吉单明细bill削15

master零自主衣billmaster15

点增加映射按纽:

1保存(F10)后返回(ESC)

*001'名称；开始两回6掇据集|

主健名I取值主穰名I________|

表名I检查标志□

检查失败的处理方式强差忽略报诸

编号：映射的编号

名称：映射的名称

表名：对照的物理表名，如果没有，就为空。

主键名：表的主键

取值主键名：表的主键对应的是拍拍网返回的数据集中的哪个值

检查标志：是否对数据进行重复性检查，只有在表名不为空的时候才有效.

检查失败的处理方式：当检查到有重复的时候，系统的处理方式.

4：增加映射字段:

3附加舜a(F2]Q||修改(F4)|三删除(F5)◎返回(ESC)

编号II名称

王键名II取值主健名IJ

表名I________I检查标志■

检查失败的处理方式覆盖铉略报情

找到2条稼.显示1到2出《|'20

标基源字段名称目标字段名称I字段芟型|变量值|对照名称I

品牌列表brands整数数据集处理器

类目列表item_cats整数次据集史理器

点增加明细按纽：

乂保存(F10)0关闭(ESC)

标题：字段的中文名称：

字段处理器：

固定值处理类：咒理固定字段用的，选择此处理器后，需要设置常量值

对照值处理类:处理对照字段用的，选择此处理器后，需要设置对照值

字段处理器:从拍拍网返回的值中取对应的字段取值

变量处理器：从系统变量中取值

自动增长主键处理器:有的系统根本上所有表的主键都是整型，并且不是自增长，由系统自动产生，

当传输的时候，需要自动生成主键的时候，需要调用此处理器

SQL处理器：通过当前的值，返回另外一个或多个值来插入.比方说拍拍网的sku_id是一个值，业务

系统可能是三个值。

自定义单据编号处理器：系统自定义一个单据编号

数据集处理器：处埋拍拍网返回的一个数据集，这时候，你需要选择这个数据集的映射模型

源字段：拍拍网返回的数据集中的字段名称

目标字段：物理表的字段名称

字段类型：目标字段类型，有整数，字符串，实数，日期4种.

变量值：设置取的变量名称，对应变量处理器

数据集：设置数据集，对应数据集处理器

常量值：可以选择也可以直接接设置，对应固定值处理器

对照值：选择框，对应对照值处理器

SQL：对应SQL处理器，固定变量为：${value)表示来源表中当前的值

5：设置参数

v增加吸肘.增加手数g增加照本世复制M它值限(F4)X删除(F5)

[.««][•我行||一8»下一◎返回(ESC)

拍拍模型

，用嫡箭

杈型映JH参数定义执行照本

找到3条记录.显示1到3

隹号名徐表名|主发险查标志

deaiList交后数据集■

dti零售单明细0illdtl15■

master零吉主表billmaster15■

参数主要用于调用API方法

乂保存(F10)乂继读新增(F2)国关闭(ESC)

参数名：参数的名称

标题：参数的中文名称

参数类型：

固定：就是将参数值直接传给拍拍

变量：系统变量

当前时间往前推X分钟：工作调度的时候要注意

当前时间：取调用的当前时间

参数值：与参数类型相对应的

6：设置执行脚本

点增加脚本:

。保存(F10)][Q继续新增(回|国关闭(ESC)]

'名称计篁明细的商品单价和分

数据源${dtl}参数billno.tbsprodid.tbscolo

updatebilldtH5setunitprice=amt1/qty1,discount=(stdprice,qty1-amt1)

wherebillno^billno}'andtbsprodid=S{tbsprodid)

andtbscolorid=${tbscolorid}andtbssizeid=${tbssizeid}

内容

名称：脚本名称

数据源：这个脚本对哪个数据源执行

参数：脚本所需要的参数

内容：实际脚本

数据源${dtl}：dtl是模型映射的编号，参数就是实际取哪些值，在脚本里面需要用到的，通俗一点讲，${dtl}

就是我们这次传输保存在数据库表里的所有明细，billno,tbsprodid,tbscolorid,tbssizeid,就是明细表的一些

字段.注：如果${dtl}有100条，上面的脚本执行100次

7：调试执行模型

点【调试】按纽，不写数据库，显示需要执行的脚本，对模型进行调试,调试成功后，再点【执行】按纽,

Q增加映射增加参数。增加解本