简要描述:

  • 导入前上传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