Skip to content

luban_assistant

walon edited this page Dec 3, 2021 · 1 revision

插件的设计目的

为了解决大型项目多人编辑,xlsx容易冲突的问题,一个解决思路是,在xlsx中编辑数据,但每个记录保存为符合luban要求的json文件。LubanAssistant可以读取luban表数据, 加载到excel中,编辑修改后,可以重新保存为json文件格式。这样解决了多人编辑冲突及多版本间合并的困难。

如何安装

目前由于证书的原因,LubanAssistant插件只能自行编译安装。 打开本项目的src/LubanTools.sln工程,编译发布此插件。然后双击生成的LubanAssistant.vsto文件即可安装。 后面将会解决这个问题。

支持哪些office版本

目前在office 2016版本是可以工作的,更新版本应该没问题,旧版本未测试,应该也可以。

支持 mac下的excel吗

不支持。

如何使用

  • 新建一个xlsx文件
  • 切到 "加载项" 功能页
    • 点击 "设置Root文件" 设置 __root__.xml 文件的路径
    • 点击 "设置配置根目录" 设置 配置根目录 (如luban_examples/DesignerConfigs目录)
  • 如普通的luban xlsx表那样填好 标题头及注释行,例如
## id x y
## id 字段x 字段y
  • A1单元##后添加 table=表名 例如
##table=item.TbItem id x y
## id 字段x 字段y
  • 点击 "加载项" 功能页中 加载数据,则 item.TbItem表的所有json文件会加载到当前xlsx中,现在你可以自由编辑了
  • 保存, 支持几种方式
    • 保存选中的一部分记录。 选择要保存的记录所在的行,点击 "保存选中" 即可
    • 保存全部。 点击 "保存全部" 即可

有没有使用示例

luban_examples 项目下 DesignerConfigs/Datas/test目录的 luban_assistant_test_json.xlsx和luban_assistant_test_multi_rows.xlsx 是两个例子。

对于以json格式的保存的表,有什么要求?

符合luban数据源要求的都可以被加载到LubanAssistant中,但LubanAssistant保存时,会将每个记录以对应的key作文件名,保存到input指定的路径中。 因此要求table的input必须为目录。

支持多行记录和sep等等普通luban xlsx表的特性吗

支持。所有普通luban表的xlsx格式都支持。

支持将一个表加载到多个sheet吗?

不支持。暂时只能将整个表加载到一个sheet。但可以用其他技巧达到这个效果,比如你将表文件拆分到几个目录的中,创建几个分组为e或其他的不导出的表, 这些表的结构与你要编辑的表完全相同,每个表指向一个拆分的子目录,这样你就可以分别在不同的sheet里编辑不同目录的记录了。

支持多个表在同一个xlsx文件中吗?

支持。每个sheet是独立的。