模块开发

功能简介

模块开发用来给前台增加系统里原本没有的业务对象，比如「合作伙伴」「车辆管理」「服务报告」。新增的「默认模块」和「客户」「合同订单」一样有列表、详情、新建、编辑、删除，能挂在任意一级菜单下；新增的「图表模块」（仪表盘）则是一张可自行摆放统计图表的页面，没有记录的增删改。模块只在这里创建和安装，字段、布局、相关信息在安装后到「业务对象」里配置。

页面概览

• 顶部按钮：「新增模块」「新增仪表盘」，右侧「?」悬停显示说明。
• 列表区：每个自定义模块一行，列为「#」「显示名称」「英文名称」「类型」「主菜单」「关联模块」「模块功能」「显示顺序」「模块状态」「工具」。「类型」为「默认模块」或「图表模块」；「模块功能」列出「关联附件」「关联产品」「产品出库」「产品入库」「导入导出」中已勾选的项；「模块状态」为「新增」（已保存未安装）或「安装」。
• 「工具」列：「新增」状态的行可点「删除」「安装」；「安装」状态的默认模块可点「删除」「配置」，图表模块只可点「删除」。灰色文字表示当前状态下不可用。

操作步骤

新增模块

1. 点击「新增模块」，弹出「新增模块」弹窗，停在「基本信息」页签。
2. 填写「英文名称」「显示名称」「显示顺序」，在「主菜单」选择模块挂在哪个一级菜单下。
3. 切换到「高级信息」页签。
4. 在「关联模块」里选择需要关联的模块，最多 10 个。
5. 按需勾选「关联附件」「产品列表信息」「允许产品入库」「允许产品出库」「导入导出功能」（「审批功能」当前版本勾了也不生效，见「注意事项」）。
6. 点击「保存」，提示「新增模块成功」，页面刷新后列表顶部出现这一行，「模块状态」为「新增」。「英文名称」已被使用时提示「模块已经存在」；关联模块超过 10 个时提示「关联模块请不要超过十个」。

安装模块

1. 在「新增」状态的行点击「安装」，确认「是否安装？」。
2. 等待加载提示消失，页面刷新，「模块状态」变为「安装」，「工具」列出现「配置」。安装会建好模块的字段、默认视图和权限，具体内容见「字段与选项说明」。
3. 到「设置中心」点击「清除缓存」，管理员的前台菜单里即出现该模块；其他用户需要退出重新登录后才能看到。
4. 点击「配置」，直接跳到「业务对象」并选中该模块，继续添加字段、调整布局。

新增仪表盘

1. 点击「新增仪表盘」，弹出「新增仪表盘」弹窗。
2. 填写「英文名称」「显示名称」「显示顺序」，选择「主菜单」。
3. 点击「保存」，提示「新增模块成功」，列表顶部出现「新增」状态的一行。
4. 点击该行的「安装」并确认「是否安装？」，页面刷新后状态变为「安装」。
5. 到「设置中心」点击「清除缓存」。

前台打开这个菜单是一张空白仪表盘，点击页面上的「创建图表」添加图表；每块图表右上角有「重新从远程获取内容」，管理员还多出「编辑」「移除面板」。

删除模块

1. 点击该行的「删除」，确认「是否删除？」，提示「删除成功」，页面刷新后该行消失。
2. 到「设置中心」点击「清除缓存」，前台菜单才会去掉该模块。

「新增」状态的模块只删除配置。「安装」状态的模块里还有记录时提示「所选模块中有数据，请删除数据后再删除模块。」，先到前台删掉全部记录（回收站里的记录不算）再删；没有记录时该模块的全部数据、字段、视图、权限和菜单项一并删除，不可恢复。

字段与选项说明

字段	含义	备注
「英文名称」	模块的内部标识，保存后自动转为小写，不能修改	必填；只能是字母，5～24 个，不能含 test，不能与已有模块重复
「显示名称」	前台菜单和页面上显示的模块名	必填；安装后可在「业务对象」的「模块编辑」弹窗里改
「显示顺序」	在所属主菜单下的排列位置，数字越小越靠前	必填，整数
「主菜单」	模块挂在哪个一级菜单下，选项即「主菜单」页面里的一级菜单	保存后不可改
「关联模块」	每选一个模块，新模块就多一个必须从该模块选取记录的字段（如「客户」「联系人」），同时该模块的详情页多一个显示本模块记录的相关信息页签	最多 10 个；保存后不可改
「审批功能」	当前版本保存时不记录这个勾选，安装出来的模块没有「审批人」「审批状态」字段，也没有「审批」权限项	见「注意事项」
「关联附件」	详情页有「附件」相关信息，可上传文件	列表「模块功能」显示「关联附件」
「产品列表信息」	模块带产品明细表和「金额总计」字段，像报价单一样逐行录入产品；「产品」详情页多一个本模块的相关信息页签	勾选后才能勾选下面两项；列表显示「关联产品」
「允许产品入库」	在产品明细基础上增加「仓库」「入库状态」字段，前台可对记录执行入库	与「允许产品出库」二选一；列表显示「产品入库」
「允许产品出库」	在产品明细基础上增加「仓库」「出库状态」字段，前台可对记录执行出库	列表显示「产品出库」
「导入导出功能」	前台列表页有「导入」「导出」按钮，并给所有职能开放这两项操作权限	列表显示「导入导出」

安装后的默认模块自带以下内容：字段「主题」（必填）「负责人」「创建人」「创建时间」「修改时间」「最新评论时间」「备注」，加上每个关联模块对应的字段；三个显示区域「基本信息」「自定义信息」「描述信息」；默认视图「所有」；全局共享为「私有」；所有职能都获得该模块的「新增」「编辑」「删除」「查看」「设置视图」「共享」「转移」权限；一份默认打印模板和导出模板。

注意事项

• 「审批功能」在当前版本里勾了也不保存，装出来的模块缺少审批所需的「审批状态」「审批人」字段，直接在「审批流程」里为它启用流程未必能用；自定义模块需要审批时请联系实施人员。
• 新模块默认对所有职能开放且全局共享为「私有」；上线前到「职能设置」收回不该有的操作权限，到「全局共享」按需放开数据范围。
• 新模块没有自动编号，需要单号时到「自动编号」里为它设置前缀。