简要描述:
- 导入前上传excel文件到服务器,并将数据添加到数据里,
接口版本:
版本号 | 制定人 | 制定日期 | 修订日期 |
---|---|---|---|
0.0.1 | 宋德美 | 2024-22-22 |
请求URL:
- /gw/fs/uploadExcel
请求方式:
- POST
请求头:
参数名 | 是否必须 | 类型 | 说明 |
---|---|---|---|
Content-Type | 是 | string | 请求类型: application/json |
Token | 是 | 登录token |
请求参数:
参数名 | 是否必须 | 类型 | 说明 |
---|---|---|---|
config | 是 | string | excel与临时表的配置 |
table | 是 | string | 临时表表名 |
返回示例:
正确时返回:
{
"code": 200,
"data": {
"import_id": "3kgwnbueluir6ghfflsyhxvg7mdit75p",
"key": "uploads/excels/202411/024fac27f9b8817819185138.xlsx",
"url": "http://sppic.sx.com/uploads/excels/202411/024fac27f9b8817819185138.xlsx"
}
}
错误时返回:
{
"code": -1,
"msg": "Auth fail: token is invalid",
"data": null
}
返回参数说明:
参数名 | 类型 | 说明 |
---|---|---|
import_id | string | 导入ID,查询进度使用此id |
key | string | 文件相对位置 |
url | int | 文件访问地址 |
。。。 |
备注:
- config格式:如下,为一个数组,数据内的每个字段含义如下
title: 对应excel里的表头,即第一行的内容
field:对应数据库里的字段名
type:字段类型,支 持:varchar,int,float,date,datetime,text 其中如果是date或datetime类型的,如果没有传,为插入null,int如果没有值,会插入0其他为空,如果日期转换失败,会导入失败,
type有两个特殊值:key、const,如果自己生成了导入id的,可以将生在怕导入id作为type为cost的,接口将原封不动的插入数据库。如果是key ,则会将本次导入的导入id【32位字符串】插入对应的field字段内
max_length:字段最大长度,如果是varchar,text且excel里超长,则会截取到max_length,一个中文算1个长度
required:是否必填,bool类型,如果传true则如果excel里没有,则导入失败。
!实际使用中尽量简单处理
[
{
"title": "",
"field": "import_id",
"type": "key"
},
{
"title": "abc",
"field": "eid",
"type": "const"
},
{
"title": "妈妈姓名",
"field": "customer_name",
"type": "varchar",
"max_length":50
},
{
"title": "妈妈手机",
"field": "customer_tel",
"type": "varchar",
"required":true
},
{
"title": "登记日期",
"field": "dj_day",
"type": "datetime"
},
{
"title": "宝宝生日",
"field": "baby_birthday",
"type": "date"
}
]
作者:宋德美 创建时间:2024-11-22 14:41
最后编辑:宋德美 更新时间:2024-12-08 14:43
最后编辑:宋德美 更新时间:2024-12-08 14:43