简介JNPF产品功能使用手册_v3.4.2.pdf面向低代码平台的使用者、开发人员与系统管理员围绕JNPF V3.4.2的功能落地提供操作指引可用于项目实施、功能培训与日常运维查阅。手册以在线开发为主线串起表单、列表、流程与结果展示并延伸到门户设计、大屏管理、地图与数据源配置、报表设计及代码生成等环节对功能表单、流程表单的配置路径交代较细。系统管理部分则覆盖基础设置、安全设置、第三方设置、超级管理员、系统公告、消息中心、系统调度、缓存、日志、监控、图标与菜单权限等内容便于读者按目录定位配置项并核对权限边界。资源包共1个PDF文件大小约40.01MB页面完整、目录层级清晰适合按模块检索或打印备查。目前已有1343人学习可作为平台上手、实施交付和团队内部培训的参考材料。1. 先说清楚这份手册管什么一套低代码平台的六个能力域前阵子帮朋友的团队做交付评审他们用一套低代码开发平台搭了十几个业务模块表单设计、列表、流程全靠在浏览器里拖拽完成结果卡在一个很土的问题上没人说得清某个字段到底绑在哪张表、哪个流程节点的按钮权限控制到哪一层。最后救场的是一份四百多页的操作手册——这套低代码开发平台 3.4.2 版的功能使用手册。它不是接口文档也不是架构白皮书而是把「在线开发、代码生成、系统管理、系统权限、工作流程、扩展应用」六个能力域按操作路径一条条写清楚的说明书。适合两类人一类是刚接手平台、需要照着把第一个表单和流程跑通的实施同学另一类是要在这套平台上做二次开发需要搞清楚自动建表规则、权限模型和数据接口边界的后端。接下来按它的章节结构拆从怎么跑、怎么配讲到怎么改。2. 在线开发拆解表单、列表、流程三条主线怎么串成一张业务表在线开发是这套平台的核心所有业务模块的起点都在【功能设计】页面。这个页面本身没什么可讲的——查询、重置、刷新、导入、新建表单五个按钮真正决定后面返工量的是点下「新建表单」之后的三选一表单、列表、流程。选错类型后面要么白配一遍流程要么在列表页上反复补查询条件。2.1 功能设计入口与基础设置的建表规则新建表单类型选「表单」时只需要配基础设置和表单设计选「列表」则多一步列表设计选「流程」还要接流程设计器。基础设置里最容易被跳过的是「数据连接」而它恰恰是后面所有坑的源头。不选数据连接的时候平台会托管建表主表用「mt 功能 ID」命名子表用「ct 雪花 ID」命名。这个规则必须记住因为二次开发写 SQL、做数据同步、配报表取数时你面对的就是这种带前缀的表名而不是你在界面上起的那个中文名。手册修订记录里能看到 3.3.1 到 3.4.2 这几个版本的增量3.3.3 补了系统图标和菜单按钮权限3.4.1 把 PC 端和 APP 端的功能设计合并、去掉了无表模式3.4.2 又加了高级查询、行内编辑和子系统。也就是说 3.4.x 之后一个功能到底建不建物理表是被强制约束的别拿老版本的思路套。要绑已有库表就得先在「数据应用 → 数据建模」里把表模型建出来再回到功能设计里下拉数据连接、点「新增一行」选表。选多表时必须配子表外键字段和关联主键单表不用。表单的多表设计还支持副表加子表、两个副表、两个子表这几种结构副表是在控件属性里直接选关联表并绑定字段子表则要先拖一个「设计子表」控件把基础设置里加过的子表关联上去才能往里拖控件。新建类型必配步骤自动建表典型场景表单基础设置 表单设计是mt/ct 前缀纯数据录入、弹窗表单列表基础设置 表单设计 列表设计是需要列表页查询、行内编辑的台账流程基础设置 表单设计 流程设计是需要审批、待办、抄送的流程单据提示基础设置里改数据连接的成本极高字段绑定之后基本等于重做。动手前先在数据建模里把表结构定死再进功能设计。2.2 表单设计控件属性、字段绑定与子表的合计动作表单设计页面是左中右三栏左边控件区基础控件、高级控件、系统控件中间画布右边属性面板。拖拽和点击都能加控件顶部可以切桌面端和移动端预览也可以一键清空重来。选中控件后右侧能看到组件属性、组件样式、多端显示三块。最关键的配置项是「控件字段」——它决定这个控件的数据落到哪一列。下拉里能选当前绑定表的字段也能直接点添加按钮快捷新建字段弹窗先列出表里已有的字段不可改再点新建字段新增一行空白行自己填。这一步做漏了控件就只是个摆设提交时数据不会入库。组件样式里的多端显示是个实用开关桌面端和移动端可以只让某个控件在某一端出现默认都勾选。表单属性则是全局的表单尺寸、标题宽度、样式、宽度外加两个后端同学最关心的项——主键策略和并发锁定。主键支持雪花 ID 和自增长 ID流程保存之后不可修改并发锁定开启后并发提交会走乐观锁防止两个人同时改一条单据互相覆盖。子表配好之后还有两个进阶设置。合计设置开启后使用时会显示合计栏合计字段从子表的单行输入、数字输入、计算公式三类字段里选支持多选。动作设置也就是子表传递更复杂配表单、配弹窗标题和类型居中或右侧、弹窗宽度再选远端数据联动用的数据接口接口参数会自动带出来你可以下拉主表字段作为筛选条件然后配列表字段弹窗里显示哪几列和关联字段接口字段或固定值映射到子表字段。这套东西本质是「选数据 → 回填子表」的低代码实现配错一个映射回填就会错行。2.3 控件事件与表单事件手册里那段 JavaScript 怎么用手册在表单设计这一节给了唯一的脚本示例下拉选择控件变更时值为 a 就把 a 控件赋 1值为 b 就把 b 控件赋 2值为 c 就隐藏 c 控件值为 d 就把 d 控件设为必填。事件挂在组件属性里分「发生变化时触发」和「失去焦点时触发」两种。// 挂在「下拉选择」控件的 change 事件上 // value当前控件选中的值由平台注入 // form表单实例用它读写其他控件 switch (value) { case a: form.setValue(fieldA, 1); // 数字控件直接赋值 break; case b: form.setValue(fieldB, 2); break; case c: form.setVisible(fieldC, false); // 隐藏控件同时一般不参与校验 break; case d: form.setRequired(fieldD, true); // 动态改必填状态 break; default: form.setValue(fieldA, null); // 清空避免上一次选择残留 }逻辑本身很直白一个字段的变化驱动另外几个字段的状态。参数上要留意两点value拿到的是选中值而不是文本form是平台注入的表单上下文对象setValue / setVisible / setRequired这类方法名属于我对这类平台常见 API 的归纳实际方法名以平台内置对象的提示为准手册只给了业务逻辑示意。真正的血泪经验是 default 分支很多人只写 if 不写 else用户先选 a 再改选 cfieldA 的 1 会一直挂在那里提交上去就是脏数据。表单事件则在表单属性里分表单加载触发、提交前置触发、提交后置触发三种。提交前置是做校验的最后一道闸门。// 表单事件提交前置触发返回 false 阻止提交 var start form.getValue(startDate); var end form.getValue(endDate); if (!start || !end) { form.toast(起止时间不能为空); return false; // 阻断本次提交 } if (new Date(end) new Date(start)) { form.toast(结束时间不能早于开始时间); return false; } // 明细合计不能超过主表额度getSubTotal(subTableKey, fieldKey) var total form.getSubTotal(detailList, amount); if (total form.getValue(quota)) { form.toast(明细合计超出额度); return false; } return true; // 放行startDate / endDate / quota是主表字段的字段名detailList是子表控件的标识amount是子表里的金额列。返回 false 会中断提交并保留在当前页面返回 true 或什么都不返回则继续走后面的入库逻辑。提醒一句提交后置触发适合做通知、写日志这类事别在那儿改数据失败了你连回滚的机会都没有。2.4 列表、门户、大屏、报表四个展示层的分工列表设计是「表单 列表」的组合基础设置和表单设计跟纯表单一样多出来的是列表属性、列表字段、查询字段这三块配置桌面端和移动端要分别设计。3.4.2 加的高级查询、行内编辑、列表查询就落在这里行内编辑决定列表里能不能直接改单元格高级查询决定查询条件能不能组合列表查询是给查询字段配默认值。做台账类功能时查询字段配不全会让用户天天骂人因为几万条数据只能靠翻页找。门户设计、大屏设计、报表设计属于往上叠的展示层。门户是新建之后挂组件、看结果展示大屏分四块管理——大屏管理、地图管理、分类管理、数据源管理其中数据源管理决定了大屏能连哪些库地图管理是给地理类组件配底图和区域报表设计相对独立走的是取数加展示的路子。这四层的共同点是都消费下层的数据接口和数据字典所以顺序上永远是先在数据应用里把数据连接和建模做好再去画大屏反过来做必然返工。3. 流程与权限的落地链路从流程设计器到菜单四级权限业务表能存数据之后第二个问题是「谁在什么节点能做什么」。这套平台把这件事拆成了两个系统工作流程负责单据怎么流转系统权限负责人能看到什么。两块分开配但真正出问题的时候往往纠缠在一起——比如流程节点上给了审批权菜单上却没给这个功能的访问权限审批人点进去就是白屏。3.1 流程设计器的节点配置从审批人到超时提醒流程设计分三步基础信息、表单设计、流程设计。基础信息定流程名称、分类、绑定的功能表单表单设计决定这个流程节点上表单显示哪些字段、哪些可编辑——这一步常被忽略很多人以为流程表单就是原表单其实节点级的字段权限是在这里单独配的。流程设计器本身是节点加连线3.4.2 版本往里补了一批很实用的能力审批设置里的候选人配置、保存草稿、节点事件、子表合计、审批汇总、流程评论、子流程同步异步再往后是超时提醒、异常处理、自动同意、节点变更、流程复活、子表传递。这些词听着杂其实分三类一类是效率项比如自动同意满足条件直接过节点省掉人工点一下、超时提醒节点停留超时发通知、保存草稿发起人先存不提交。这类配置改的是流转速度配置前要想清楚业务上能不能接受「没人点也算过」。二类是容错项比如异常处理节点执行出错时的分支、节点变更流程跑到一半要换审批人、流程复活已结束或已终止的单据重新拉起。节点变更和流程复活是运维的高频需求但也是最容易踩坑的地方——复活之后的单据历史节点的字段值怎么算、审批记录怎么补手册里给的是操作路径细节得自己在测试环境验一遍。三类是数据项比如子表传递父流程子流程之间传子表、子表合计审批页展示合计、审批汇总把各节点的意见汇总成一张表。流程评论是给人看的子表传递是给数据用的别混为一谈。流程外围还有六个入口我发起的、待办事宜、已办事宜、抄送事宜、流程委托、流程监控。委托功能适合请假场景监控功能适合运维排查卡单这两块平时不用出了事就是救命稻草。3.2 权限模型分级管理下的组织、角色与菜单四级权限权限这一块3.4.2 补了分级管理也就是多组织场景下每一级管理员只管自己那一摊。往下的结构是组织管理 → 岗位管理 → 用户管理 → 分组管理 → 角色管理 → 权限管理另外还有在线用户用来踢人。用户管理里有重置密码、解除锁定、导入导出角色管理里分角色成员和角色权限两步先拉人再给权。真正决定「点不点得动」的是系统菜单里的四级权限这是整套权限体系里最需要理解的部分权限层级控制对象配错的典型后果按钮权限页面上的新增、删除、导出等按钮菜单能进按钮点了没反应列表权限列表里显示哪些列数据有但关键列看不见表单权限表单里哪些字段可见、可编辑字段能看见但改不了或者不该看的看到了数据权限能查哪些行按组织、角色、自定义越权看到别的部门数据菜单本身还支持子系统也就是把一批菜单收进一个二级入口3.4.2 新增的。新建菜单后可以导入导出做环境迁移时省事。这里有个顺序问题正确做法是先建菜单拿到菜单 ID再去角色里勾权限最后给用户挂角色反着来会出现「用户有了角色但菜单树里找不到」的玄学现象排查半天发现是菜单没同步。3.3 数据应用连接、建模、字典、接口四件套系统管理下的数据应用是整套平台的数据底座七个模块数据连接、数据建模、数据字典、数据接口、接口认证、数据同步、行政区划。数据连接管的是外部库的连接串一个平台可以挂多个库数据建模是在连接之上建表模型功能设计里绑表时下拉出来的表就来自这里数据字典管枚举值下拉控件、单选框的选项基本都从字典取好处是改一处全站生效数据接口是把查询封装成可复用的接口子表的远端数据联动就是调它接口认证是给外部系统调平台接口时发凭证的地方数据同步负责库与库之间的搬运行政区划是内置的省市区数据地址类控件直接用。外部系统对接这块常见做法是先拿 appKey 换 token再带着 Authorization 头调业务接口# 第一步取凭证路径与参数名以你部署的平台为准这里只示意结构 curl -X POST https://{your-host}/api/auth/token \ -H Content-Type: application/json \ -d {appKey:your-key,appSecret:your-secret} # 第二步带 token 调数据接口page/size 控制分页 curl -X GET https://{your-host}/api/data/{interfaceCode}?page1size20 \ -H Authorization: Bearer {token}appKey / appSecret在接口认证里配interfaceCode是数据接口的编码page / size是分页参数——这三个是调不通时最先检查的地方。凭证过期返回 401权限不足返回 403接口编码写错返回 404靠状态码基本能定位到是哪一层的问题比翻日志快。4. 代码生成与扩展应用零代码产物怎么过渡到可交付代码低代码平台最尴尬的时刻是业务方说「这个功能挺好但我们要嵌到自己系统里」。这套平台的答案是代码生成把在线配好的表单和流程转成工程代码交付给研发继续维护。这一章讲清楚生成前后的差异以及扩展应用里那批示例该怎么用。4.1 功能表单与流程表单生成之前先把主键和字段类型定死代码生成分两条路径功能表单和流程表单。功能表单对应纯数据维护走表单 → 列表 → 流程 → 结果展示这条链流程表单则是带审批流的单据生成出来的代码里会多出流程相关的页面和接口。生成之前有几件事必须先定否则生成完了再改就是灾难主键策略。表单属性里选雪花 ID 还是自增长 ID流程保存后不可修改。雪花 ID 适合分布式、多库合并的场景自增长 ID 适合单库、要和遗留系统对齐的场景。选错了要么合并数据时主键冲突要么对接老系统时对不上号。字段类型。控件字段绑定时快捷新建的字段类型是按控件推断的单行输入给字符串、数字输入给数值。如果你在界面上用单行输入存了金额生成出来的代码里这一列就是 varchar后面做汇总统计时排序和求和全是坑。金额、数量、比率这类字段一律用数字输入控件。表关系。多表设计里的主表、副表、子表关系生成时会翻译成实体之间的关联。子表外键字段和关联主键配错生成的代码能跑但查出来的子表数据会串到别的单子上这种问题在测试环境数据量小的时候根本暴露不出来。4.2 扩展应用二十多个示例其实是现成的模板库扩展应用这一章目录很长功能示例、门户示例、报表示例、大屏示例、图表示例、表格示例、表单示例、百万数据、导入导出、电子签名、电子签章、日程安排、邮件收发、知识管理、文档预览、条码示例、打印示例、地图示例、订单示例、订单管理、项目管理。看着像产品功能清单实际上是我认为这份手册里最值钱的部分——它是平台的回归测试集。上手一个新环境我一般按这个顺序跑先跑「表单示例」确认控件和字段绑定正常再跑「百万数据」压一下列表查询性能然后跑「导入导出」验证文件流和模板最后跑「电子签章」和「打印示例」确认第三方组件的授权状态。这四步跑通环境基本就没问题了哪一步挂掉问题范围立刻缩小到对应模块。几个模块值得单独说。邮件收发要先在邮箱配置里填 SMTP 信息再走写邮件、收件箱、星标件、草稿箱、已发送这套流程本质是个内嵌的邮件客户端配不通多半是端口和加密方式的问题。知识管理分全部文档、我的共享、共享给我、回收站是个轻量文档库共享给我这个视角经常被当成权限 bug其实是共享关系没建。文档预览依赖文件转换服务条码和打印依赖模板设计这三块是外部依赖最重的部署时容易漏。4.3 系统管理里的运维开关调度、缓存、日志、监控系统配置这一层平时不动出事的时候全在这儿。基础设置管平台名称、Logo 这类安全设置管密码策略、登录方式、图形验证、锁定账户第三方设置管外部集成超级管理员是兜底账号。系统公告支持新建、编辑、删除、详情、发布3.3.3 之后还能限定发送人员范围。消息中心是公告的收件箱。系统调度管定时任务3.3.3 加了内部方法类型也就是可以直接调平台内的 Java 方法而不只是发 HTTP 请求。系统缓存是清缓存的地方改了字典、菜单、权限之后不生效先来这儿清一下能省掉大量「我明明改了」的扯皮。系统日志分操作日志等类型3.3.3 补的操作日志是排查「谁改了这条数据」的唯一凭据。系统监控看的是运行状态系统图标管的是菜单图标库。系统模板这一组容易被忽略短信模板、消息模板、打印模板、单据模板。短信和消息模板是流程通知的载体节点通知里选的就是这里的模板打印模板和单据模板决定打印出来长什么样3.3.1 之后打印模板有过补充。做审批流交付时模板没配等于流程跑完了没人知道。5. 上线前排查清单五类最容易翻车的配置问题5.1 现象表单字段配了提交后库里是空的现象很典型界面上填了值提交成功提示也弹了去数据库一看那一列全是 NULL。原因基本只有一个控件没绑「控件字段」。控件拖进画布只是画了个框右侧组件属性里的控件字段是空的提交时平台不知道往哪写。多表设计下还有第二种情况——控件绑了字段但绑的是副表的字段而副表关联没配对数据写进了另一张表。解决方式提交前把表单设计页每个控件过一遍确认控件字段非空多表场景下点开副表/子表控件逐个核对关联表和关联字段。更稳的做法是先跑一遍「表单示例」它覆盖了各类控件的绑定能对上就说明绑定逻辑没问题。5.2 现象子表保存后主表对不上或者子表数据串行现象是主表一条单据点开子表看到的是别的单据的明细或者保存时报外键为空。原因是多表设计时子表的外键字段和关联主键没配或者配反了。平台建子表用的是「ct 雪花 ID」的表名主表是「mt 功能 ID」两张表靠你指定的关联字段连起来这个关联关系没建立子表就是一张独立的表查询时按什么条件过滤全看运气。解决方式回到基础设置确认多表选择时下方显示的关联配置里子表外键字段指向主表主键、关联主键选中主表主键列。改完之后已有数据不会自动修复需要手工补一次关联值所以这种配置一定要在建表阶段就核对别等有数据了再改。5.3 现象流程改过之后历史单据打不开或审批人看不到现象是流程定义改了节点或者换了审批人之前发起的单据点进去报错或者新审批人待办里没有这张单。原因是流程定义和运行实例之间是绑定的。节点变更、流程复活这类操作会重新计算后续节点和审批人但已经跑过的历史节点不会重算如果改的是表单字段历史单据的字段值也不会自动迁移。解决方式改流程定义前先确认有没有在途单据有的话走节点变更而不是直接改定义需要重新拉起的用流程复活并且复活后手工核对一遍审批记录。生产环境的规矩是流程定义只增不改要改就发新版本让在途单据跑完老版本。5.4 现象菜单加了用户登录后看不到或者点进去白屏现象是管理员账号一切正常普通用户登录后菜单树里没有这一项或者有菜单但页面空白、按钮点了没反应。原因是权限分了两处菜单本身要在系统菜单里建好并同步角色里要勾上这个菜单进去之后按钮能不能点还取决于按钮权限、列表权限、表单权限有没有配。数据权限没配则是另一个表现——页面能打开但列表一条数据都没有。解决方式按「菜单 → 角色 → 用户」的顺序排查先确认菜单存在且已同步到对应子系统再看角色权限里这个菜单是否勾选最后看四级权限。清一次系统缓存再刷新很多时候就是缓存没刷。3.3.3 之后 APP 端也单独有按钮权限和列表权限只配了 PC 端的话移动端就是白屏。5.5 现象数据量上来之后列表转圈导出直接超时现象是小数据量一切正常十几万条之后列表打开要十几秒导出干脆 504。原因是列表的查询字段没配全平台只能全表扫描导出走的是同步接口数据量大时直接撑爆请求超时再就是列表权限里勾了太多列每列都参与渲染。解决方式先把查询字段补齐常用的过滤条件一定要配上索引分页参数确认生效别把 size 设成 1000导出改走异步或者分批。手册里的「百万数据」示例就是专门压这个场景的上线前拿它跑一遍比拍脑袋估容量靠谱。6. 二次开发视角把操作手册当接口文档用的四个技巧手册不是给研发写的但研发看它的收益反而更高前提是换一种读法——不按顺序读而是把它当成「配置项到数据库」的映射字典。第一个技巧是拿章节号当检索坐标。手册的编号体系很稳定数据权限在系统菜单那一节角色权限在系统权限那一节接口认证在数据应用那一节流程节点配置在工作流程那一节。遇到线上问题先定位章节再看这一节的操作路径比全局搜索关键词快得多。我习惯在团队 wiki 里维护一张对照表把「问题现象 → 手册章节 → 对应配置项」三列填满新人接手时直接查表。第二个技巧是把自动建表规则当硬约束用。主表 mt 功能 ID、子表 ct 雪花 ID这个规则一旦写进二次开发的 SQL 里就再也拔不出来。我的做法是任何跨模块取数都走数据接口或视图不在代码里硬编码表名。功能 ID 是平台生成的删了重建功能表名就变了硬编码的 SQL 当天就挂。改造点手册锚点验证方法自定义字段写入表单设计的控件字段绑定提交一条数据查库确认列有值外部系统取数数据应用的数据接口与接口认证用 curl 打一遍看 401/403/404流程节点扩展工作流程的节点事件与异常处理造一条超时单看提醒是否触发权限精细化系统菜单的按钮/列表/表单/数据权限用普通账号登录逐级点一遍第三个技巧是用扩展应用的示例做回归。每次平台升级前先跑表单示例、百万数据、导入导出、电子签章这四组跑通了再动生产。升级最大的风险不是新功能不能用是老配置被静默改掉——3.4.1 去掉无表模式、合并 PC 与 APP 端功能设计这类变更在修订记录里只有一行字但影响的是所有存量功能。第四个技巧是升级前用修订记录做差异清单。手册开头的修订记录列了每个版本补了什么3.3.1 加候选人、保存草稿、节点事件、子流程同步异步3.3.3 加超级管理员、系统调度内部方法、操作日志3.4.2 加超时提醒、异常处理、自动同意、节点变更、流程复活、分级管理、接口认证、高级查询、行内编辑、子系统。把这份清单和你实际用到的功能对一遍命中的项就是升级回归的重点。这套流程我踩过一次坑有回升级完一个跑了半年的审批流突然不自动同意了查了半天发现是节点配置里那个开关的默认值变了界面上看不出来任何异常属于典型的黑匣子。从那以后我每次升级前都强制走一遍「修订记录对照 示例回归 一条真实单据全流程跑通」三步做完才敢动生产。希望帮到你。本文还有配套的精品资源点击获取