vol开发文档

# 快速上手

【项目启动】->【框架使用流程】

# 编写扩展业务及组件

  1. 前端自定义业务：前端开发、生成页面文档
  2. 后台自定义业务：后台开发
  3. 或者参照文档：http://v2.volcore.xyz/document/api 里的[代码生成页面ViewGrid]示例

# 生成页面与自定义组件互相调用

  1. 文档位置：生成页面文档->参数属性配置,让下面两个属性
    自定义页面调用生成页面对象： 自定义扩展页面获取父组件(获取生成页面对象)
    生成页面js里调用自定义对象： 获取自定义扩展页面

# 如何获取自定义扩展的组件

  1. 代码生成后的表单页面，可以通过this.$refs.gridHeader、gridBody、gridFooter、modelHeader、modelBody、modelFooter拿到自己定义开发的组件，可参照SellOrder.js(可扩展完整示例页面)使用扩展业务的方式
  2. 代码生成后的表单页面，可以通过自定扩展组件进行任何复杂操作,可参照SellOrder.js(可扩展完整示例页面)扩展

# 自定义扩展组件中获取父组件

获取父组件(ViewGird.vue也是代码生成后的页面上能看到的组件)， this.$emit('parentCall', $vue => { }) //$vue为父组件对象，具体使用参考order->GridHeaderExtend.vue文件

# 在页面添加自定义按钮

可参照SellOrder.js

# 使用EF、Daper、事务、缓存

Sell->Partial->SellOrderService.cs中有详细介绍

# 实体校验、常用扩展、日志

Sell->Partial->SellOrderService.cs中有详细介绍

# 后台获取用户信息

UserContext.Current在Sell->Partial->SellOrderService.cs中有详细介绍

# 前端获取用户信息/权限等

菜单->其他组件

# 如何使用一对多(企业版已可以生自动生成)

目前代码生成只有主从一对一，一对多需要自己扩展，可参照【表单一对多】页面

# 数据库表字段发生变化怎么处理

数据库字段发生变化后，在代码生成器页面点击->【同步表结构->【生成model】->【生成vue页面】

# 如何删除菜单配置

目前不支持删除菜单，如果想删除菜单，将父级ID设置为其他不用节点的id即可

# 页面提示没有权限

  1. 确认是否给角色分配好了权限
  2. 菜单设置页面,当前菜单的【视图/表名】字段在Sys_Menu表中是否有重复(【视图/表名】字段在Sys_Menu表中不能有重复)
  3. 如果是代码生成器生成的页面也分配权限后还是提示权限，请检查代码生成器配置中的【真实表名】与菜单设置中的【视图/表名】是否一样

# 多表关联页面

如果只是多表关联显示在页面，建一个视图，把视图生成前后端代码

# 代码生成后表结构发生变化

代码生成后，如果表结构发生了变化，点【同步表结构】再点【生成model】【生面vue页面】

# 设置接口token永不过期

如果想要某些接口使用固定的token永不过期，控制器的方法加上[FixedToken]属性，只要数据库与缓存的token一致，token就永远不会过期

# select组件不能手动设置值

  1. select的数据源如果是从字典项中加载的，设置select的值必须是字符串类型
  2. 请检查select绑定的数据源中key的类型，设置的值必须也key的类型一致

# 新建类库提示版本问题

  1. 当前项目使用的是.netcore2.1，新建的类库从新在nuget上引用此版本
  2. 新建的类库需要引用Vol.Core,Vol.Entity项目
  3. VOL.WebApi需要引用新建的类库

# 表主键支持类型

主键目前只支持自增或Guid类型，如果是mysql数据库使用guid，主键设置为char长度36

# 代码生成器生成业务类异常

后台必须运行builder_run.bat命令才可以生成业务类，生成其他运行dev_run.bat或builder_run.bat

# 代码生成器生成业务类找不到文件

同上

# 代码生成新建时没有加载表结构数据

确认表是否存在,如果存在先把代码生成页面的对应的菜单删除，再重新操作新建流程

# 生成model没有反应或异常

点击生成model响应或异常，原因是数据表结构与代码生成页面的结构不一样，点击同步表结构再点生成model,如果还是无法解决(mysql,sqlserver有些很少用的字段没有考虑，也没有经过测试)，请提issue

# 代码生成页面弹出新建页面空白

代码生成页面需要自己配置编辑行，可参照现有其他页面的配置(配置完成后，点击保存与生成model)

# 代码生成页面没有查询字段

代码生成页面需要自己配置查询行，可参照现有其他页面的配置(配置完成后，点击保存)

# 代码生成主从明细表,保存异常或加载不了主从明细表数据

主从明细表外键必须是主表的主键字段,如：主表Sell_Order主键Order_Id,主从明细表SellOrderList的外键必须为Order_Id

# 页面加载时提示未配置好url

(代码生成后)请确认后台项目是否运行的dev_run.bat命令

# 编辑/新建保存时提示没有配置好编辑的数据，请检查model

(代码生成后)请确认后台项目是否运行的dev_run.bat命令

# 权限分配后看不到菜单

权限分配页面，请确认是否勾选了一级菜单的【查询】权限

# MySql批量保存出错

MySql批量保存出错，异常提示：Don't use MySQL xxxx或The used command is not allowed with this MySQL version 解决办法：在mysql数据库中执行:set global local_infile = 'ON';