Excel2Json

更新 2019-07-16

• Присоединена поддержка объединённых ячеек.
• Исправлена ошибка: если первая ячейка столбца не имеет тип String, то невозможно выполнить синтаксический анализ.

Обзор

Excel2Json — это небольшой инструмент для прямого экспорта таблиц Excel в формат JSON.

Использование

1. Загрузите все файлы из папки Release и скопируйте их в локальный каталог, например D:\Tools\Excel2Json.
2. Измените файл Run.bat:
   • EXCEL_FOLER — папка, где находится файл Excel.
   • EXPORT_JSON_FOLDER — папка для экспорта файла JSON.
3. Также можно преобразовать отдельный файл Excel прямо из командной строки с помощью команды java -jar Excel2Json-1.1.jar.

Например:

java -jar Excel2Json-1.1.jar C:\example.xls D:\out\example.json

Sheet

Без символов

Безсимвольные таблицы экспортируются как базовые модели. Пример на рисунке выше будет иметь следующую структуру JSON:

{
  "normal": [
    {
      "name": "xxx",
      "ID": "ID_001",
      "age": 15,
      "info": [
        {
          "arg2": "yy",
          "arg1": "xx"
        },
        {
          "arg2": 23,
          "arg1": 1.1
        }
      ],
      "info2": [
        "ID001",
        "ID002",
        15
      ]
    }
  ]
}

— Первая колонка в Excel используется для обозначения того, будет ли строка экспортирована. Первая строка используется в качестве имени ключа второго уровня. Вторая строка используется в качестве параметров для анализа ключа второго уровня.

— Имя листа — normal, поэтому структура JSON первого уровня использует normal в качестве ключа, а внутри него находится массив.

— 4A, 5A, 6A отмечены знаком #, поэтому текущая строка не экспортируется. Аналогично, G1 также отмечен знаком #, так что он также не экспортируется.

— E1, F1 отмечены знаком @, и их содержимое анализируется в виде массива. Элементы массива разделяются символом ;, а параметры внутри элементов разделяются запятыми. Если внутри есть только один элемент, его можно опустить (например, F2), и тогда внутренний элемент будет непосредственно добавлен в массив.

С символом

Если строка или столбец начинаются с символа #, текущий лист не будет экспортирован. То же самое относится и к внутренним строкам и столбцам.

С символом $

Если строка начинается с символа $, то внутри неё считывается информация только из первых четырёх столбцов, начиная со второй строки. В этих столбцах:

— Первый столбец: указывает, будет ли текущая строка прочитана. — Второй столбец: имя внутреннего ключа. — Третий столбец: параметры для анализа внутреннего ключа. — Четвёртый столбец: конкретное значение.

Пример:

{
  "eranInfo": {
    "gender": 1,
    "name": "Eran",
    "icon": "icon.png",
    "ID": "function test(){alert(\"Called\");}",
    "age": 18,
    "info": [
      {
        "arg2": "yy",
        "arg1": "xx"
      },
      {
        "arg2": 23,
        "arg1": 1.1
      }
    ],
    "info2": [
      "ID001",
      "ID002",
      15
    ]
  }
}

С символом !

Строки, начинающиеся с символа !, обычно используются в многоязычных файлах Excel. Программа экспортирует данные аналогично строкам, начинающимся с символа $. Однако каждая колонка будет экспортироваться в отдельный файл JSON. Например, если имя файла Excel — I18N, то таблица на рисунке будет экспортирована в файлы I18N_zh_CN.json и I18N_en_US.json.

Структура экспортируемого JSON:

{
  "I18N": {
    "Common_OK": "好",
    "TF_GiftBtn": "礼物",
    "info": [
      {
        "arg2": "yy",
        "arg1": "xx"
      },
      {
        "arg2": 23,
        "arg1": 1.1
      }
    ],
    "info2": [
      "ID001",
      "ID002",
      15
    ]
  }
}

Внутренний ключ первого уровня в этом файле — это имя файла Excel.