工作总结及交接
现阶段手头上的工作主要有两块，两份工作均告一段落，但日后可能有新的需求或者异常。所以记录一下两块项目的工作内容和具体的思路，方便其他人维护。
下面列一下具体内容
- 翼萨项目
- 生成一系列docx文档
- 同洲易题项目
- docx转json（划重点）
- 按数据生成xlsx
- 解析xlsx
- 根据后台题目数据生成简单试卷，格式为docx
- 收藏功能本地数据库库同步
翼萨项目
项目地址
http://develop.coolcto.com/lipengcheng/yisa-consulting-services-portal-frontend
工作内容
从两个数据源取出数据，按照参数不同 ->生成多个文件，并打包，然后上传到七牛云存储，然后将url返回给前端
流程图
项目设计
因为基本上可以说是从一个数据源，然后生成多个文件的过程。
项目采用的是模板替换的方式，从模板的docx文件，标记文字，然后替换其中的标记。
目前在项目中只能标记图片和文字，不能标记表格，标记如图所示、
标记文字使用{key}：
标记图片使用{%key}：
优点
- 开发速度快
- 添加的文字随模板文件的字体样式和格式
缺点
- 需要通过hack的方式去应对项目方奇葩的需求
举个栗子，项目放需要根据不同数目的(董事+监事+经理) 生成不同数目的表格。我用了hack的方式，设置了多个不同模板，然后根据js去判断数量，然后选用不同的模板。
看着上面整齐划一的模板，我的内心是崩溃了。
产品经理，在项目开始的时候，不是说好了没有这种诡异的需求了么？
- 需要严格控制模板的格式和变量名
举二个栗子，
针对表格内填充图片的行为，需要提前设置好表格中单元格的宽高，以免产生与预期不匹配
采用统一的数据处理（下文中的dataMiddleHandle.js文件），模板内相应的地方都需要填入对应的变量名
- 无法替换表格
npmjs里有
主要文件及位置
\mewchan\node_modules\docxmodule
//存放docx模板的文件
\mewchan\node_modules\docx.js
//生成模板文件的封装
\mewchan\node_modules\dataMiddleHandle.js
//数据处理中心
\mewchan\kitties\moduledocx
//接口及处理处理除数据外其他逻辑的地方
使用的插件
-
docxtemplater
- 用途： 根据模板和数据生成docx文件, 只能替换模板内的文字
- 地址： https://www.npmjs.com/package/docxtemplater
-
docxtemplater-image-module
- 用途：docxtemplater的插件，使之能 替换模板内的图片标记
- 地址： https://www.npmjs.com/package/docxtemplater-image-module
-
Downloader
- 用途：other的下载包，用于下载将替换到模板的图片从七牛下载到本地
- 地址：
-
Uploader
- 用途：other在七牛官方包上的进一步封装，提供往七牛上传文件的服务。在本项目中，用于将生成的docx和压缩包上传到七牛，然后提供url给前端。
- 地址：
-
other_client.js
- 用途：other在http请求上的封装，用于给后端发送jsonrpc
- 地址：
易题项目
项目地址
http://develop.coolcto.com/zhujunwei/e_teach_clean
工作内容
- docx转json（划重点）
- 按数据生成xlsx
- 解析xlsx
- 根据后台题目数据生成简单试卷，格式为docx
- 收藏功能本地数据库库同步
docx转json
将带有标记的试题题目的文档转化成json并传到后端。
docx内的格式如下
第一段文字为该试卷的标题
1. //这里是题号
#
这里是题目内容
#
*
这里是答案
*
{
这是是对答题卡的设置
}
流程图
项目设计
本质上，docx就是一个xml文档的zip压缩包。
由于历史遗留原因，目前的总的设计是将docx --->text --->json
个人觉得，这是一个坑比较大的项目，主要集中在以下三点:
主要可能维护的地方
docx转text，目前是流式处理，遇到不能解析的格式或者文字，则忽略，但由于目前所查的docx资料有限，不能保证office不坑我们。目前小规模测试暂无异常。目前转换的结果存储在
path.join(os.tmpdir(),'translate.txt')，可以靠看这个文件去排错。text转json， 大坑。目前由于减小客户在往系统里面撸题目的时候尽量简便，所以判断的逻辑很复杂。目前是按行去读取text，然后用状态和正则去记录和判断题干，小题，小题中的小题。不排除客户会用稀奇古怪的序号去标记小题目，导致正则无法判断。目前转换为json的结果存储在
path.join(os.tmpdir(),'result.json')text转json后给每道题目加上类型。最开始只是前端需要根据这个类型去给每个题目套上不同的样式。这个判断并不可靠，只是应急方案。目前判断依据 是有无()或者____，有无选项或者小问。详细判断逻辑参照
\mewchan\node_modules\TextToJson\addType.js.
主要文件及位置
\mewchan\brain\servlet.js
//处理上传请求接口，会把请求转给handler.js处理
\mewchan\brain\handler.js
//处理请求逻辑
\mewchan\brain\init.js
//在程序初始化时检测如果是win平台且没有拷贝过，则拷贝 转换图片的应用程序到缓存目录
\mewchan\brain\result.json
//报错信息汇总
\mewchan\brain\config.js
//配置文件
\mewchan\node_modules\docx2Text
//自己写的docx转txt模块
\mewchan\node_modules\TextToJson
//将docx转好的txt，再转为txt。因为需要对题目
\mewchan\node_modules\errorList.js
//报错处理
\mewchan\node_modules\imageConvert.js
//将docx内微软格式的图片，转换为可以在页面上显示的图片类型。依赖于imagemagick程序
\mewchan\node_modules\uploadTemp.js
//将文件上传到七牛
docx内xml文档标记的一些参考资料
https://msdn.microsoft.com/en-us/library/office/gg278308.aspx
https://msdn.microsoft.com/en-us/library/office/gg278323.aspx
https://msdn.microsoft.com/en-us/library/office/ee922775(v=office.14).aspx
这个网站是我的主要参考源 http://officeopenxml.com
http://www.docin.com/p-428010508.html
http://www.taguage.com/tag/55f14c4674ebc826528da22f
http://www.bubuko.com/infodetail-1290603.html
http://blog.csdn.net/u010371710/article/details/51966236
使用的插件
-
multer
- 用途： 解析前端通过dropzone插件上传到node端的文件并存到本地
- 地址： https://www.npmjs.com/package/multer
-
Uploader
- 用途：other在七牛官方包上的进一步封装，提供往七牛上传文件的服务。在本项目中，用于将解析的docx中的图片和公式（根据公式生成的docx文档）上传到七牛，然后将返回的url塞进json传给后端。
- 地址：
-
@.fs.unzip()
- 用途： 将docx解压，以便读取其中的xml文档
- 地址: 参照what中[mewUtil文档](http://what.coolcto.com/#!/activity/main/what-detail-page?documentID=123&hasToc=true&title=mew_util 文档 )
-
imagemagick
- 用途：docx内有一些图片和公式的格式为微软官方支持的wmf和emf等图片，不能在前端网页直接显示，所以需要通过插件将这些图片格式转换好。
- 文件路径：
\mewchan\brain\imageconvert.zip - 地址： http://www.imagemagick.org/script/index.php
-
other_client.js
- 用途：other在http请求上的封装，用于给后端发送jsonrpc
- 地址：
按数据生成xlsx
用于 方便客户下载一个excel文档，从题库生成试卷用到的，在excel内选择需要添加的题目类型，考察的知识点啊。由于excel如果任由客户发挥的话，也挺污的。所以自己写了一个拼接xml然后打包生成excel的。提供
- 单元格可填写文字
- 单元格可使用下拉单选框
- 指定区域外的单元格不能编辑
这三个定制功能.
详细可参考\mewchan\node_modules\excelCreater\README.MD
如果后续有更多的要求，建议使用 exceljs替代
解析xlsx
主要使用的是node-xlsx, 因为mew_js系统目前不支持ES7，所以对其中部分代码从ES7->ES6。然后在外面包了一层，保证取出的数据符合后端需要的格式。具体详见\mewchan\node_modules\xlsx目录
根据后台题目数据生成简单试卷，格式为docx
根据前端发过来的订单号，从后台取出数据，然后生成试卷。
项目设计
目前的需求是从后台取出数据，然后依次下载图片和公式，给题目的选项和小问加上序号（这个依赖于解析docx加上的题目类型）。然后根据数据生成docx；
理论上讲，因为数据都是从后台拿的，源数据是解析docx得到的，不会有过多的问题。
主要文件及位置
\mewchan\node_modules\createPaperAdapter
//依赖包为docxCreater，根据json生成docx文档
使用的插件
- docxcreater
- 用途： 在office-clippy包基础上改的，用于生成docx。
- 地址：https://www.npmjs.com/package/docxcreater
收藏功能本地数据库库同步
项目设计
用户端界面，有一个收藏题目的功能，方便用户快速的把收藏的题目放到试卷内。由于功能较为简单，且放在后台有点脏，所以放在用户端了。但随之而来的问题就是。用户可能换电脑。所以需要 数据库同步。目前采用的流程详见流程图。
需要注意的两个小细节
前端传给node的数据库更新不及时（服务器依赖于session），前端判定需要库同步是在刷新页面上。所以上传完成的数据库需要通知前端
如果用户在短时间内频繁触发下载和上传数据库逻辑，可能会带来问题。所以分别设定了开关
流程图
主要文件及位置
\mewchan\kitties\e_teach\database.sql
//创建数据库的sql语句
\mewchan\node_modules\replaceSQL.js
//替换数据库的代码
\mewchan\kitties\e_teach\index.js
//数据库增删改查 以及 同步数据库逻辑的代码（hack一些可能出现的问题）
使用的插件
- sql.js, mdbc.js, sqlite.js
- 用途： other的操作数据库三件套
- 地址：
- Uploader
- 用途：other在七牛官方包上的进一步封装，提供往七牛上传文件的服务。在本项目中，上传数据库文件。
- 地址：
-
Downloader
- 用途：other的下载包，用于下载数据库
- 地址：
-
other_client.js
- 用途：other在http请求上的封装，用于给后端发送jsonrpc
- 地址：
写在最后
之前提到了exceljs包。附上一段自己的测试代码。
当然，也可以直接去看它的官方文档
var Excel = require('exceljs');
var workbook = new Excel.Workbook();
var worksheet = workbook.addWorksheet('sheet', {
pageSetup:{paperSize: 9, orientation:'landscape'}
});
//设置行高,符合预期值
worksheet.getRow(1).height = 42.5;
// 可以设置单元格的列宽，实际列宽是9.38，31.38，9.38
worksheet.columns = [
{ header: 'Id', /*key: 'id', */width: 10 },
{ /*header: 'Name',*/ key: 'name', width: 32 },
{ /*header: 'D.O.B.',*/ key: 'DOB', width: 10, outlineLevel: 1 }
];
//合并单元格测试有效
worksheet.mergeCells('A4:B5');
worksheet.getCell('B5').value = 'Hello, World!';
//上下和垂直居中测试有效
worksheet.getCell('B5').alignment = { vertical: 'middle', horizontal: 'center' };
// 测试边框，只对单元格有效
// 边框的粗细为最细
worksheet.getCell('B6:C10').border = {
top: {style:'thin'},
left: {style:'thin'},
bottom: {style:'thin'},
right: {style:'thin'}
};
// 测试单元格背景颜色
worksheet.getCell('C10').fill = {
type: 'pattern',
pattern:'solid',
// bgColor:{argb:'CCFFFF00'}
fgColor:{argb:'FFCCFFFF'}
};
worksheet.getCell('C10').value = "测试";
worksheet.getCell('C11').fill = {
type: 'pattern',
pattern:'solid',
// bgColor:{argb:'EEF7FF00'}
fgColor:{argb:'FFEEF7FF'}
};
worksheet.getCell('C11').value = "测试";
// 测试更改字体的一些属性
worksheet.getCell('C12').font = {
name: 'Comic Sans MS',
// family: 4,
// size: 16,
// underline: true,
bold: true,
color: {argb:'FFEEF7FF'}
};
worksheet.getCell('C12').value = "测试2"
//数字格式按照这样处理是可以的;
worksheet.getCell('C13').value = "11.212323"
//测试直接添加二维数组
worksheet.addRows([[111,222,333],["shenme","shenme"]]);
//测试输出文件
workbook.xlsx.writeFile("./1.xlsx")
.then(function() {
console.log("done")
});
