TableML-GUI篇(C# 编译/解析 Excel/CSV工具)

项目状况

本文接上篇TableML Excel编译/解析工具，本文主要介绍GUI工具的使用，及配置项，若是你想了解此工具更加详细的说明，请阅读上篇文章。

项目地址：https://github.com/zhaoqingqing/TableML

 

项目介绍和更新日志

项目介绍

TableML, Table Markup Language, 基于电子表格的标记语言，

相似JSON, XML, INI，TableML能够做为软件项目的配置标记语言，

与之不一样的是，您可使用Excel等电子表格编辑软件来配置TableML，自由地添加图标、注释、VB脚本和预编译指令，再由TableML编译器导出干净的TSV格式的配置表表格，编辑方便，使用简单。

目前提供C#版本的运行时、编译器、代码生成器。

 

更新日志

https://github.com/zhaoqingqing/TableML/blob/custom/update_log.md

 

实现原理和功能介绍

技术原理

使用C#语言开发，底层使用NPOI库解析Excel，对npoi再次封装，简化开发难度。

经过模版引擎由Excel数据结构填充，生成对应的代码，无需人工编写读表代码。

Winform开发GUI界面  ，下降使用难度，给非技术类同事提供友好界面。

支持把解析后的Excel数据插入到数据库中。

 

功能介绍

感谢Mr.Kelly的开源项目，我基于Kelly的TableML基础上进行扩展(https://github.com/mr-kelly/TableML)，增长或修改如下功能：

• 扩展支持多种格式的Excel配置 文件 ，好比首列为注释列，表头列在自定义行
• 若是某列不须要，能够把表头列项置空
• 支持能够为每个Excel生成一个单独的C#文件类
• 支持把数据插入到sql数据库中，并生成sql脚本(数据库脚本语言)
• 提供GUI界面，本来已提供命令行模式
• GUI支持文件拖动编译单个Excel，和编译某个文件的Excel，或者直接读取tsv文件
• GUI上同时开发了辅助工具，用于检查Excel数据的合法性，字段名是否重复

 技术支持

若是在使用过程当中遇到问题或发现bug，欢迎与我联系。

个人邮箱：569032731@qq.com

TableML-GUI 

读懂配置文件

tablemlGUI.exe目前提供一份简易的xml配置文件，用于初始化tableml-gui

打开tablemlGUI.exe所在的目录，找到app.config

（建议使用notepad++，sublime text，editplus等能够高亮xml关键词和语法，减小改错概率）

在app.config中，每一条重要的配置项都添加了注释说明(<!--中间是注释说明 -->)，好比：

<!--是否使用绝对路径;true:全部路径都是绝对的,完整路径;false:全部路径是相对于此exe的-->
<add key="UseAbsolutePath" value="false" />

<!--excel源文件路径-->
<add key="srcExcelPath" value=".\..\Src\" />

<!--excel编译后的database保存路径-->
<add key="DBPath" value=".\..\client_setting\data.db" />

是否使用绝对路径？

UseAbsolutePath是一项重要配置，它决定整个应用程序中上涉及到的路径是相对路径仍是绝对路径。

绝对路径是指一个文件的完整路径，完整到盘符，路径不包含..\之类的。

我是绝对路径：c:\work\plan\005ConfigTable\client_tool\TableMLGUI.exe

我是相对路径：..\client_tool\TableMLGUI.exe

有些路径我不知道填？

客户端读表代码路径 和 客户端项目tml路径 ，这两项若是你不须要用到，那就保持默认值，不用修改

若是你是一名策划，只须要导表，那你基本就只须要修改DBPath为客户端的路径。

GUI工具使用

主界面预览

编译所有或部分

• 编译并插入到sqlite中

• 若是你须要编译某个目录下所有的excel并把编译结果播放到sqlite中，就选择它。
• ​编译指定的几个excel（若是仅仅想编译指定的几个excel，把要的excel拖到框中，选择 编译上面框中的excel）

其它功能

命令行支持

GUI同时提供命令行参数功能，目前支持单个或批量编译所有的excel，并将数据插入到sqlite中，它是一个bat，双击就OK了。

命令行使用示例：

编译某个目录下的全部excel：

cd /d %~dp0

start TableMLGUI.exe all

辅助功能

这里是一些辅助的功能，你能够看看。

标题中的组是指把某类功能放在一个组，一个统一的面板下。

组- For CSharp版本使用

根据Excel生成对应的C#代码，并拷贝到对应的目录下

若是是把数据插入到sqlite中，这部分功能不会用到，咱们目前就是。

组- 检查Excel错误

当你的表在导出出现错误，能够选择性的使用这里的一些功能对excel进行检查

组- 其它

这里是一些文件夹打开类的功能

其它功能

在编译excel后，会在应用程序目录生成一个compile_result.csv，当源始Excel文件名并不能直接用做代码文件名，或excel文件名有中文时，方便策划和程序对接时查看。

表中记录示例：

编译后tsv[文件名]	源始Excel文件名
scene_config	场景配置表.xls
item_config	道具配置表.xls