首页 > 数据库 >ExcelPatternTool: Excel表格-数据库互导工具

ExcelPatternTool: Excel表格-数据库互导工具

时间:2023-03-07 19:34:49浏览次数:52  
标签:互导 excel 单元格 Excel 指定 校验 Sample ExcelPatternTool

ExcelPatternTool

Excel表格-数据库互导工具

介绍:

指定Pattern文件-一个规则描述的json文档,基于此规则实现Excel表格与数据库之间的导入导出,校验等功能。

特点:

  1. 小巧,轻量化的命令行工具
  2. 基于json文档的配置
  3. 支持Excel97-2003(xls)与Excel2007及以上(xlsx)格式
  4. 数据库支持SQL server、Sqlite、MySql
  5. 支持单元格注解,样式,公式的导出(导出至Excel)
  6. 内置lambda表达式和正则表达式两种校验器

更新内容:

DateVersionContent
V0.1.0 2022-7-29 初始版本

快速开始

编写Pattern文档

  1. 导入规则编写
  • 指定表格的工作表名称SheetName或者工作表序号SheetNumber,二者选一配置即可,SheetName优先,SheetNumber从0开始
  • 指定开始行数SkipRow,这个是实际数据的开始行数,不包含表头行。在Sample中,这个行数为3

Sample:

"ExcelImport": {			// excel导入规则
    "SheetName": "",		// 工作表名称
    "SheetNumber": 0,       // 工作表序号
    "SkipRow": 3           // 开始行数
  }
  1. 导出规则编写
  • 指定数据库表的名称,主键类型。数据库类型将在Cli参数中指定

Sample:

"DbExport": {               // Db导出规则
    "TableKeyType": "Guid", // 表主键类型 可选 "无","int","long","Guid",
    "TableName": "Employee" // 表名称
  }
  1. Pattern配置

对列进行配置

  • 列指定列标题名称,属性名称,类型和排序
  • 单元格类型为普通类型是"常规"时,直接输出的为单元格值,"包含注解","包含样式","包含公式","全包含"仅对导出至Excel有效
  • Ignore 为True时将忽略这一列,等效于无此列的Pattern设置
  • 列序号为此列在Excel中的编号,从0开始,即A列对应0,B列对应1 ...
  • 列属性类型PropType为bool时,可支持0,1,True,False

Sample:


"Patterns": [                       // Pattern配置
    {
      "PropName": "EmployeeName",   // 属性名称
      "HeaderName": "姓名",         // 列标题名称
      "PropType": "string",         // 属性类型,可选 "string", "DateTime","int","double","bool",
      "CellType": "常规",           // 单元格类型 可选 "常规","包含注解","包含样式","包含公式","全包含"
      "Ignore": false,              // 是否忽略
      "Order": 0,                   // 列序号
      "Validation": {               // 校验配置
       ...
      }
    },

配置校验

  • 配置Target,可对单元格值或单元格公式进行校验
  • 普通校验器时,{value}占位符代表当前单元格值或公式的内容
  • Sample1为普通校验器,校验单元格数值,Sample2为正则校验器,校验单元格公式

Sample1:

    
      "Validation": {
        "Target": "单元格数值",
        "Description": "整数值需要大于2",
        "Convention": "普通校验器",
        "Expression": "{value}>=2"
      }
    

Sample2:

    
      "Validation": {
        "Target": "单元格公式",
        "Description": "需要满足正则表达式",
        "Convention": "正则表达式校验器",
        "Expression": "^ROUND\\(AN\\d+\\+BC\\d+\\+BD\\d+\\+BE\\d+\\+BF\\d+\\+BG\\d+\\+BH\\d+,2\\)$"
      }
    

完整示例请参考 Sample

安装

不需要特别的安装,在此获取ept.exe,或git pull代码后生成可执行文件

运行

  1. 进入可执行文件所在目录,并运行
  • 若要导出至Sqlite,请确保相同目录下包含e_sqlite3.dll
  • 若要导出至SQL server,请确保相同录下包含Microsoft.Data.SqlClient.SNI.dll

参数列表:

参数含义用法
-p PatternFile 指定一个Pattern文件(Json), 作为转换的模型文件
-i Input 指定一个Excel文件路径,此文件将作为导入数据源
支持Xls或者Xlsx文件
-o Output 指定一个路径,或Sql连接字符串作为导出目标
当指定 -d 参数为sqlserver, sqlite, mysql时,需指定为连接字符串;
当指定 -d 参数为excel时,需指定为将要另存的Excel文件路径,支持Xls或者Xlsx文件
-s Source 值为excel
-d Destination 值为excel, sqlserver, sqlite或者mysql
-w WaitAtEnd 指定时,程序执行完成后,将等待用户输入退出
-h Help 查看帮助

导出至Sqlite的Sample

.\ept.exe -p .\sample\pattern.json -i .\sample\test.xlsx -o "Data Source=mato.db" -s excel -d sqlite

导出至Excel的Sample

.\ept.exe -p .\sample\pattern.json -i .\sample\test.xlsx -o .\sample\output.xlsx -s excel -d excel
  1. 等待程序执行完毕

结果

将在-o 参数指定的地址生成数据
生成至Excel

生成至Sqlite

其他

配置

ept.exe 相同目录下新建appsettings.json可自定义配置,若无此文件将采用自定义样式配置,如下:

{
  "HeaderDefaultStyle": {
    "DefaultFontName": "宋体",
    "DefaultFontColor": "#FFFFFF",
    "DefaultFontSize": 10,
    "DefaultBorderColor": "#000000",
    "DefaultBackColor": "#888888"
  },
  "BodyDefaultStyle": {
    "DefaultFontName": "宋体",
    "DefaultFontColor": "#000000",
    "DefaultFontSize": 10,
    "DefaultBorderColor": "#000000",
    "DefaultBackColor": "#FFFFFF"
  },
  "CellComment": {
    "DefaultAuthor": "Linxiao"

  }
}

可扩展性

检验提供类ValidatorProvider类具有一定的扩展功能,
InitConventions方法对校验行为进行初始化,默认提供RegularExpression,LambdaExpression对应的委托函数分别实现了正则表达式校验和普通表达式校验,重写InitConventions可实现一个自定义方式校验

Sample:

public override Dictionary<string, ValidateConvention> InitConventions()
{

    var defaultConventions = base.InitConventions();
    //x 为当前列轮询的字段规则PatternItem对象,
    //e 为当前行轮询的Entity对象
    //返回ProcessResult作为校验结果
    defaultConventions.Add("MyExpression", new ValidateConvention((x, e) =>
    {
        //再此编写自定义校验功能
        //可用 x.PropName(或PropertyTypeMaper(x.PropName)) 获取当前列轮询的字段(Excel表头)名称
        //返回ProcessResult作为校验结果,IsValidated设置为true表示校验通过
        x.Validation.ProcessResult.IsValidated = true;
        return x.Validation.ProcessResult;
    }));

    return defaultConventions;
}

Todo

  1. 从数据库导入
  2. ept带UI版本(WPF)

工具

Roslyn Syntax Tool

  • 此工具能将C#代码,转换成使用语法工厂构造器(SyntaxFactory)生成等效语法树代码

已知问题

作者信息

作者:林小

邮箱:[email protected]

License

The MIT License (MIT)

项目地址

Github:ExcelPatternTool

本文来自博客园,作者:林晓lx,转载请注明原文链接:https://www.cnblogs.com/jevonsflash/p/16541171.html

标签:互导,excel,单元格,Excel,指定,校验,Sample,ExcelPatternTool
From: https://www.cnblogs.com/sexintercourse/p/17189312.html

相关文章

  • 用openpyxl操作excel学习笔记
    课程来源:https://www.bilibili.com/video/BV19p4y1z7rM/?p=3&spm_id_from=pageDriver&vd_source=5c65398a0f1ade31116f35fc9c0cf651fromopenpyxlimportload_workbookwb......
  • pandas处理Excel数据
    pandas数据转换成numpy数据DataFrame转换成ndarrayarray(data)series转换成ndarrayarr=series.as_matrix()print(type(data))#打印数据类型替换数据中的空值为0da......
  • Excel表格打开或者点击Sheet报错“#REF!”怎么处理
    Excel表格打开或者点击Sheet报错“#REF!”怎么处理 1.如图所示,打开表格或者点击Sheet表格后报错,主要是因为表格中一些引用位置失效。   2.打开表格的宏代码......
  • php 导出Excel到指定文件并删除指定文件
    ob_end_clean();//这一步非常关键,用来清除缓冲区防止导出的excel乱码/*header("Content-Type:application/force-download");header("Content-Type:application/octe......
  • ChatExcel--自动处理表格
    目录一、简介1.项目背景2.有点超越ChatGPT?3.功能特点4.ChatExcel入口5.操作系数二、页面分析三、浅入测试1.模拟表格内容2.上传文件3.测试降序4.条件筛选四、输入案例五、......
  • Laravel9 Excel导入 和 Word导入
    Excel导入类:<?phpnamespaceApp\Utils;useIlluminate\Http\UploadedFile;useIlluminate\Support\Facades\Storage;useMaatwebsite\Excel\Facades\Excel;class......
  • PHPExcel
    <?php/***TP6使用PHPExcel*/usePHPExcel_IOFactory;//Excel模板$template='./static/excel/Invoice10012ss.xls';//newPHPExcel类,并传入模板路径$objP......
  • WPS Excel
    1~10节知识点:1.工作表与工作簿工作表可以包含多个工作簿  双击修改工作表名称,点击"+"添加工作表  2.数据的添加,删除,隐藏,取消隐藏双击输入数据之后,Enter继续......
  • 【易语言】将超级列表框中的数据导出到excel
    需要精益模块.版本2.支持库iext.支持库shell.子程序_按钮1_被单击.局部变量局_表项索引,整数型.局部变量局部_列表,外部超级列表框局_表项索引=超级列表......
  • Excel批量插入图片(Excel函数集团)
    批量插入图片,归函数集团管了?对,你没看错,就是函数集团的活!因为Microsoft365出了一个新函数:IMAGE!所以,以前折腾的那种一堆合并以后再贴进txt文本文件再贴回来的,没用了?是与......