用户数据同步导出文件接口

日期:2016-09-19 16:13:21  点击数:

1、接口说明:

用户数据信息与门户网站间的信息同步。
门户网站每天凌晨同步前台增量用户数据,形成文件并上传到服务器;
凌晨两点各系统到服务器取走文件并处理后,并生成反馈文件上传到服务器指定目录中;
 

2、输入参数:

请求文件名按如下规则命名: JXEDU_USERINFO_xxxx_yyyymmdd_iiii.REQ;
回执文件名按如下规则命名: JXEDU_USERINFO_xxxx_yyyymmdd_iiii.RSP;
1.       yyyymmdd为文件生成日期,xxxx为接入系统标识。其中请求文件xxxx为定值:0000
2.       Iiii为序列号(0000~9999);
每个文件大小不要超过20M,10万行数据即可。
请求文件头:
属性名
属性描述
类型
长度
说明
TOTALNUM
总记录数
String
F10
当前文件的总记录数
 
换行
String
F1
 
如不足最大长度,左补‘0’填充。例如,当前文件中只有一条记录,则文件头内容为“0000000001”。
请求文件体:
序列号

属性
描述
类型长度
备注
1
UserNo
用户ID
VARCHAR(30)
非空,唯一标识
2
nameEntity
用户名
VARCHAR(64)
 
3
passwordEntity
用户名密码
VARCHAR(64)
 
4
nameSpellingEntity
姓名全拼
VARCHAR(64)
 
5
emailEntity
 邮箱
VARCHAR(64)
 
6
phoneEntity
手机
VARCHAR(32)
 
7
telNoEntity
固定电话
VARCHAR(32)
 
8
institutional
组织机构
VARCHAR(100)
 
9
institutionalId
组织接口编码
VARCHAR(16)
 
10
Sexy
性别
VARCHAR(2)
男或女
11
operKind
操作类型
VARCHAR(1)
1:增;2:删除;3:修改
12
CreateTime
生成时间
DATE
格式:yyyy-mm-dd hh:mm:ss
13
ModifyTime
修改时间
DATE
格式:yyyy-mm-dd hh:mm:ss
14
ifStop
是否停用
VARCHAR(1)
0:no;1:yes
15
loginEntity
登陆名
VARCHAR(64)
 
 
各字段之间用分隔符“|”分割
 
 

3、输出参数:

当文件格式及内容正确时,回执文件只需填写“F000,<请求文件名>。
当发生文件级错误(F00X)的时,回执文件只需要填写“<错误代码>,<请求文件名>”即可,当出现多个文件级错误时,回执文件记录多行“<错误代码>,<请求文件名>”,各行之间以换行分隔。
其他业务错误情况下(F10X),回执文件分为文件头和文件体,文件头和文件体以换行分隔。文件头为:“TOTAL_ERR_NUM=<错误记录条数>”;文件体中填写错误明细,即业务冲突的部分,格式为<错误代码>,<原记录内容>,其中原记录内容指是的是原文件中对应行的具体信息。
F104至F108的错误代码只针对订单日对账。
注:以上描述中的尖括号“<”与“>”,只为说明方便使用,文件中一律不应出现。
 
错误代码
意义
F001
文件无法打开,或格式编码错误
F002
总记录数与实际不符
F100
必填字段为空或格式错误
F103
入库失败
F119
其他错误状态