Skip to content

Latest commit

 

History

History
executable file
·
157 lines (129 loc) · 3.5 KB

README.md

File metadata and controls

executable file
·
157 lines (129 loc) · 3.5 KB
Raw

xlsxParser (English Document)

让复杂的excel转化为你想要的json。

使用说明

  • 目前只支持.xlsx格式。
  • 本项目是基于nodejs的，请先安装nodejs环境。
  • 执行命令
# Clone this repository
git clone https://github.com/sliencio/xlsxParser.git
# Go into the repository
cd xlsxParser
# Install dependencies
npm install
  • 配置config.json
{
  "xlsx": {
    //类型所在行
    "typeRow":2,
    //标题所在行
    "headRow": 3,
    //xlsx路径
    "src": "./excel/**/[^~$]*.xlsx",
    //输出路径
    "outPath": "./json",
    //array 分割符
    "arrayFlag":",",
    //子表的连接符号
    "sonCon": ".",
    //兄弟表连接符号
    "brotherCon": "&"
  },
  "json": {
    //是否压缩json
    "compress": false
  }
}

运行

linux 或者 unix

  bash export.sh

window

​ 双击 export.bat 即可

导出文件

​ 读取 ./excel/ 路径下的所有xlsx 文件，导出到路径 ./json/ 下，json文件名以sheet名命名

示例1 基本功能(参考./excel/basic.xlsx)

excel

输出如下(子表：item.extro :)：(兄弟表：item&brother) {数组子表 item.attrs}

{
  "1001": {
    "id": "1001",
    "Des": "这是机枪",
    "name": "机枪",
    "attack": 150,
    "expAdd": 10,
    "extro": {
      "id": "1001",
      "extro": "机枪的额外属性"
    },
    "attrs": [
      {
        "id": "1001",
        "value": 10,
        "name": "名称1"
      },
      {
        "id": "1001",
        "value": 15,
        "name": "名称2"
      },
      {
        "id": "1001",
        "value": 20,
        "name": "名称3"
      },
      {
        "id": "1001",
        "value": 25,
        "name": "名称4"
      },
      {
        "id": "1001",
        "value": 30,
        "name": "名称5"
      },
      {
        "id": "1001",
        "value": 35,
        "name": "名称6"
      }
    ],
    "life": 200
  }
}

支持以下数据类型

  • number 数字类型。
  • boolean 布尔。
  • string 字符串。
  • date 日期类型。
  • object 对象，同JS对象一致。
  • array 数组，同JS数组一致。
  • id 主键类型(当表中有id类型时，json会以hash格式输出，否则以array格式输出)。
  • id[] 主键数组，只存在于从表中。

表头规则

  • 基本数据类型(string,number,bool)时候，一般不需要设置会自动判断，但是也可以明确声明数据类型。
  • 字符串类型：命名形式 列名string 。
  • 数字类型：命名形式 列名number 。
  • 日期类型：列名date 。日期格式要符合标准日期格式。比如YYYY/M/D H:m:s or YYYY/M/D 等等。
  • 布尔类型：命名形式 列名bool 。
  • 数组：命名形式 列名[]。
  • 对象：命名形式 列名{}。
  • 主键：命名形式列名id ,表中只能有一列。
  • 主键数组：命名形式列名id[]，表中只能有一列，只存在于从表中。
  • 列名字以!开头则不导出此列。

sheet规则

  • sheet名字以！开头则不导出此表。
  • 从表的名字 主表名字 . 子表 主表名字 & 兄弟表，主表必须在子表或者兄弟表的前面。

注意事项

  • 关键符号都是英文半角符号，和JSON要求一致。
  • 对象写法同JavaScript中对象写法一致
  • 数组写法同JavaScript中数组写法一致

补充

  • 可在windows/mac/linux下运行。
  • 项目地址 xlsxParser