ESK数据交换平台之拍拍接口功能介绍(doc 14页).doc

拍拍接口功能介绍目录一、概述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来测试.以/item/sellerSearchItemList.xhtml（卖家查找交易订单列表接口）, 五、设计拍拍接口模型第一步：业务系统配置 要从拍拍网取数据，必定涉及到业务系统的数据库。配置数据源，告诉系统你的业务系统数据库. 打开基础数据-数据源配置 增加编号：设置编号名称：设置名称数据源类型：对应的是什么类型的数据库数据库服务器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:调试执行模型点【调试】按纽,不写数据库，显示需要执行的脚本，对模型进行调试,调试成功后，再点【执行】按纽,六、查看传输日志进入日志分析模块七、传输模型作业调度进入【作业调度】-【作业计划】模