JNPF 3.4.2操作手册详解：零代码开发从表单到工作流配置

简介《JNPF产品功能使用手册_v3.4.2.pdf》是福建引迈信息技术有限公司出品的官方操作手册面向 JNPF 软件开发平台的开发者、实施人员与系统管理员帮助读者全面掌握在线开发、门户设计、大屏设计、代码生成和系统管理等核心模块。手册按功能模块组织在线开发部分详细讲解表单、列表、流程设计及结果展示门户设计包含新建门户与结果展示大屏设计涵盖大屏管理、地图管理、分类管理和数据源管理代码生成部分覆盖功能表单、流程表单系统管理部分则涉及系统配置、公告、调度、缓存、日志、监控与菜单权限内容细致且目录清晰便于对照操作。资源为单个 PDF 文件压缩包大小约 40MB已有 1339 人浏览学习适合作为 JNPF 平台日常使用、二次开发和项目实施时的案头参考。1. 先看懂 JNPF 3.4.2一份手册能覆盖多少从零搭建业务的耗时JNPF 软件开发平台 V3.4.2 操作手册这份 PDF我拆完之后的最大感受是它不是在介绍菜单而是把一套零代码交付流程完整串了起来。从功能设计的表单、列表、流程到系统菜单里的按钮权限和字段权限再到数据建模、数据字典、数据接口最后落大屏、报表和导入导出正好对应一个业务系统从建表到上线的全部环节。对做项目交付的人来说最划算的用法是把它当成配置手册照着在线开发路径走一遍再回来看权限和工作流怎么联动。这篇就按我动手验证的顺序来讲先走通在线开发再拆权限与流程的联动最后写大屏和报表的验证方法。2. 在线开发三件套表单、列表、流程的拖拽设计与数据表绑定2.1 功能设计入口与三类新建表单的定位差异JNPF 的在线开发集中在「功能设计」里打开之后先有查询、重置、刷新、导入、新建表单这批操作。手册把新建分成表单、列表、流程三种我先把三者的边界说清楚不然很容易建错类型。表单类型解决「录数据」只产出录入界面适合做填报、台账登记列表类型是「表单列表」的组合除了录入还负责把已有数据以表格方式展示和检索一般业务后台的主功能页面都选这个流程类型则在表单基础上挂审批链路适合请假、报销、采购这类需要多节点流转的场景。手册里基础设置、表单设计的步骤在三种类型里是通用的区别集中在后面的列表设计和流程设计。提示列表类型本身就包含表单流程类型也包含表单。不要指望在纯表单类型里做数据查询查询能力在列表设计里需要单独配列表字段和查询字段。比较反直觉的一点是刚上手的人以为表单类型也能做数据查询实际查询能力在「列表」里。V3.4.1 之后 PC 端和 APP 端设计合并控件层面的「多端显示」开关负责控制某个控件在桌面或移动端是否展示而不是分别维护两套表单这是版本演进里一个值得留意的变化。2.2 表单设计数据连接、控件字段、子表与事件脚本表单设计第一件事是基础设置。这里有一个关键动作绑定数据表。手册写了如果未设置数据连接流程新建完成后会自动创建数据表主表以“mt功能ID”命名子表以“ct雪花ID”命名。这种自动建表在原型阶段很快但正式项目里我一般不会依赖它因为后续想改表名、接已有业务库代价会变大。稳妥做法是先到数据建模把表设计好再到基础设置里下拉选择数据连接点「新增一行」进入数据表绑定页面选单表或多表。选单表时控件直接下拉「控件字段」绑定表字段还能在下拉列表里快捷新建字段。选多表时需要配置子表的外键字段和关联主键主表与子表才能正确串起来。手册把这个点放在显眼位置是有原因的子表保存失败八成是外键没配。子表控件本身支持合计设置和动作设置合计字段必须选自子表内的单行输入、数字输入、计算公式类型字段可以多选动作设置则用于「子表按条件联动数据接口」需要先配置弹窗标题、弹窗位置和宽度再选远端数据接口最后设置列表字段映射和关联字段映射。组件事件是表单设计里一个容易忽略但很实用的能力。控件支持发生变化时、失去焦点时两类事件代码区域直接用 JavaScript。手册给了一个典型场景下拉选择值变化后让另一个控件赋值、隐藏或改必填。常见写法会复用平台暴露的控件方法类似下面这样// 下拉选择控件值变化时触发 if (value a) { setValue(aControl, 1); // 下拉值为 a把 a 控件赋值为 1 } else if (value b) { setValue(bControl, 2); // 下拉值为 b把 b 控件赋值为 2 } else if (value c) { setVisible(cControl, false); // 下拉值为 c隐藏 c 控件 } else if (value d) { setRequired(dControl, true); // 下拉值为 d把 d 控件设为必填 }这段逻辑对应手册里的四类联动赋值、赋值、隐藏、必填。value 是当前下拉控件的新值setValue / setVisible / setRequired 分别处理字段赋值、控件显隐和校验必填方法名在不同版本里可能带前缀以实际编辑器提示为准。事件里可以处理多个控件避免为每个控件单独配一遍联动。要注意脚本在流程发起和流程办理时都会触发别把提交动作写进发生变化事件里否则会出现一次流程被多次赋值的情况。表单属性里有两个参数需要提前定主键策略支持雪花 ID 和自增长 ID保存后不可修改并发锁定开启后会给表单加乐观锁保证多用户并发提交时数据不会互相覆盖。表单事件分加载、提交前置、提交后置三类适合在提交前做校验、提交后刷新关联数据。我一般把「提交前置事件」当最后一道防线比如检查必填项是否满足业务条件。参数可选值/开关配置时机常踩的坑主键策略雪花ID、自增长ID表单设计保存前保存后不可改并发锁定开/关保存前关闭时会互相覆盖提交数据多端显示桌面端/移动端控件维度随时改默认全选容易漏看子表合计字段子表内数值类字段子表配置非数值类字段选不了控件字段表字段或快捷新建拖拽后必配漏配会丢数据2.3 列表设计查询字段、行内编辑与双端布局列表类型的核心在「列表设计」这一步。它和表单设计分开配置桌面端与移动端分别设计。设计列表时最需要想清楚的是查询字段和列表字段的差异查询字段决定用户在搜索区能按什么条件过滤比如客户名称、单据状态、时间范围列表字段决定结果表格展示哪些列两者并不要求一致。V3.4.2 把「高级查询」「行内编辑」「列表查询」都补进了列表设计所以这个版本里列表页已经不止是静态表格还能允许在网格里直接改数据。实际配置里我习惯的顺序是先定列表字段把表格列、宽度、对齐方式排好再定查询字段把高频筛选条件放出来最后再检查高级查询里哪些字段要参与组合查询以及行内编辑要不要放开。行内编辑一旦开启意味着有更新权限的用户在列表页就能改值配置时需要把可编辑字段限定在业务允许范围内。数据绑定上列表类型的基础设置和表单一致。如果列表需要同时展示主表和子表数据多表绑定下的外键关系同样要在这里配好否则表格里子表数据是空的。查询性能方面百万数据量级下查询字段偏多或未建索引列表页会出现明显的加载卡顿这在扩展应用里的「百万数据」示例页可以直观验证后面第 6 章再细说。2.4 从在线开发到代码生成什么时候切换更划算手册后半部分单列了「代码生成」支持功能表单和流程表单两类。这意味着 JNPF 不是只能停在零代码运行时还能在拖拽配置完成后把功能表单、流程表单的代码生成到工程里做二次开发。就实际交付看纯配置能解决的页面优先留在在线开发里维护因为后续改表单、加字段都在界面上完成不用走发布流程只有需要深度定制比如改页面样式、接内部 SDK、做复杂交互逻辑时再把生成代码拉出去改造。这里有个容易翻车的点在线开发的配置和生成的代码底层都依赖同一个数据建模结果。如果先在在线开发里改了字段又去生成的代码里改了结构两边就会失同步之后无论回到哪边继续做都会互相覆盖。我在团队里定的规矩是一个功能只能有一个维护入口要么在线开发要么代码工程禁止两边同时改同一个表单。代码生成告一段落后回到功能设计列表里用「结果展示」完成预览、发布、同步菜单这个闭环动作在手册里出现频率很高。建议第一次使用前先在一个表单上跑通整个生成流程确认生成的目录结构和命名规则再批量处理避免一次生成几十个文件后找不准改动位置。3. 系统管理与权限菜单、字典、数据接口和角色权限的联动配置3.1 系统菜单的四层权限按钮、列表、表单与数据系统管理里的「系统菜单」非常值得细看。菜单不只是做入口展示它背后挂着一套权限体系按钮权限、列表权限、表单权限、数据权限V3.4.2 开始还支持子系统。这个层级关系如果理解错交付时非常容易出权限越界。按钮权限管「能不能点击」比如新增、编辑、删除、导入导出这些操作按钮按角色分配可见可点范围列表权限管「表格展示哪些列」同一条数据不同角色看到不同字段表单权限管「表单里哪些控件可编辑、哪些只读或隐藏」数据权限管「能查哪些行的数据」比如只看本人、本部门或全部。它们按「菜单→按钮→列→字段→行」的粒度逐层缩小配置时先想清楚角色对应的数据边界。V3.4.2 系统菜单增加了「子系统」能力可以把多个菜单挂到同一套子系统下对多业务线交付比较实用。菜单本身支持导入导出我一般先在测试环境把菜单树整理好再整体导出到生产环境避免生产环境手点出错。权限类型控制范围配置位置典型场景按钮权限操作按钮可见与可用系统菜单-按钮权限主管才能看到「删除」按钮列表权限表格列显隐系统菜单-列表权限财务角色看到金额列普通角色不看表单权限控件编辑/只读/隐藏系统菜单-表单权限提交之后状态字段只读数据权限行范围本人/部门/全部系统菜单-数据权限销售只看自己跟进的客户3.2 数据应用连接、建模、字典、接口与认证的上下游顺序数据应用模块是 JNPF 底层能力所在包含数据连接、数据建模、数据字典、数据接口、接口认证、数据同步、行政区划。它们之间有清晰的上下游顺序按顺序配置会顺畅很多。数据连接负责注册数据库支持平台库和外部业务库数据建模基于连接建表供在线开发和代码生成复用数据字典维护枚举数据比如状态、类型、性别让表单下拉、列表筛选引用同一份字典避免各建各的值数据接口是能力出口在线开发的子表动作设置、大屏设计的数据源都会来调数据接口接口认证则决定哪些调用方有权限调取接口。一套刚起步的项目最先做的是数据连接和数据建模字典可以边做边补接口认证通常在联调阶段再收紧。数据接口的定义方式值得留意。接口创建时可以把查询条件暴露成参数子表动作设置里选的正是这些接口参数与表单字段的映射关系——接口返回的数据会根据表单字段值做筛选后再展示这就是「远端数据联动」的实现基础。数据同步用于不同库之间的数据搬运行政区划一般直接用来做地区选择下拉。这五个能力如果只挑一个先熟练我建议优先把数据字典用透。很多项目到最后字段枚举散落各处对不上口径本质是字典没建好。JNPF 里字典和控件字段关联后就算后面枚举加值也只是在数据字典里动一行不用去改表单脚本。3.3 组织、岗位、用户与角色的配置顺序系统权限这一大章手册给的路径是分级管理→组织管理→岗位管理→用户管理→分组管理→角色管理→权限管理。按这个顺序走是有道理的分级管理解决多层级组织的边界组织管理建部门树岗位管理定职位比如部门负责人、会计、销售用户管理挂人支持新增、重置密码、解除锁定、批量导入导出角色管理再把菜单权限、按钮权限、数据权限批量授给一组人。我实际交付时习惯稍微调整先建组织、再建岗位、再导入用户最后建角色并分配权限。如果把顺序反了先建了一堆角色再回头建组织用户和角色之间很难对得上。分组管理是后面版本补进的能力适合在同一角色体系下做细粒度用户分组比如同是销售角色再按大区拆组分组后的数据权限可以在角色权限之外做二次收敛。用户管理里有一个容易被忽略的操作解除锁定。平台在安全设置里配置了登录失败锁定策略后用户输错密码锁定的情况会变得频繁管理员不是在用户列表里改密码而是先「解除锁定」再让用户重新登录。V3.4.2 新增的「超级管理员」设置也在这块附近它区别于普通管理员角色用于处理最高权限和特殊配置平时不应把业务用户挂到超级管理员上权限边界会更干净。3.4 系统缓存、日志、监控与公告上线前的检查项系统管理里还有一批偏运维的功能系统配置、系统公告、系统调度、系统缓存、系统日志、系统监控。单独看都不复杂但上线前要特别过一遍。系统配置里比较关键的是安全设置比如登录方式、图形验证码、账户锁定策略。第三方登录和接口认证也在这里统一管理。系统公告要配置发送人员范围避免全员无效广播系统调度支持内部方法类型的定时任务适合做数据清理和统计汇总但上线前务必验证调度时间是否正确避免在业务高峰期触发大批量任务。系统缓存的清空操作要谨慎配置或字典变更后缓存没刷新时界面会显示旧数据很多人第一反应是重启服务其实手动清一次缓存就能恢复。系统日志分操作日志等几类出问题时先到日志里看异常栈再排查配置。系统监控用于观察服务状态联调阶段有问题先在监控里定位是平台服务还是接口超时。4. 工作流程升级点节点事件、超时提醒、子表传递与流程委托4.1 流程设计的三层结构与节点属性工作流程模块从「流程设计」开始手册给的层次是基础信息→表单设计→流程设计。基础信息里要确定流程编号、名称、所属功能分类表单设计负责流程里录入的表单流程设计负责画出审批链路。V3.4.2 这条版本线里流程新增了超时提醒、异常处理、自动同意、节点变更、流程复活、子表传递功能明显比早期版本重。节点属性是流程设计里的核心。每个节点至少需要配置审批人可以是具体用户、角色、候选人候选人意味着该步骤不是固定人审批而是由候选池里的人处理。节点之间通过连线组织顺序条件连线按业务规则分流。更复杂的场景用子流程支持同步和异步两种方式同步子流程会阻塞当前流程直到子流程结束异步则让子流程并行跑互不等待。加签、减签、转签这类操作在不同版本里的叫法略有差别手册按节点的处理按钮来区分。节点事件写 JavaScript常用在办理前做数据校验、办理后同步关联数据。比如审批通过后把子表合计写回主表字段或者在流程结束时更新外部业务状态。这里有一个细节事件执行失败会影响节点提交结果需要在流程监控里看到异常信息再去改脚本脚本本身最好做异常保护。属性作用配置建议审批人/候选人确定谁能办理当前节点候选人适合抢单场景超时提醒节点超时后发送提醒设置提醒时间与接收人异常处理环节异常时兜底策略建议配置异常通知自动同意满足条件时跳过人工审批低风险节点可用子流程同步/异步调用子流程异步注意数据一致性节点事件办理前/后执行脚本脚本务必做异常保护4.2 一个带超时提醒和子表传递的请假审批流程把上面这些串起来的典型 demo 是请假审批流程。基础信息里选择主表来源进入表单设计把开始时间、结束时间、请假天数、事由、子表明细拖进页面。流程设计里画三个环节发起人提交→部门负责人审批→人事复核连线条件按请假天数分支三天以内走简单审批三天以上追加一级审批。节点属性里部门负责人节点打开超时提醒比如超过 24 小时未处理系统提醒部门负责人并抄送其上级人事复核节点可以开启自动同意前提是表单里有明确的判断依据比如「请假天数≤3 且部门负责人已通过」就自动通过。节点事件脚本里如果存在子表明细可以汇总子表请假天数写回主表字段后续列表展示和统计都直接取主表字段不用每次去子表里聚合。子表传递用的是表单设计的动作设置在前端选择子表数据时调用数据接口把「员工编号」作为参数传入接口返回该员工的部门、岗位等数据并自动填充到子表对应字段里。这个能力在订单类场景很常用选择商品后自动带回单价、库存、单位。配置顺序是先在数据应用里建好数据接口再到子表动作设置里选接口、映射字段最后在流程表单里验证参数联动。4.3 运行态待办、已办、抄送与流程委托流程配置完进入运行态。手册把用户侧操作拆成我发起的、待办事宜、已办事宜、抄送事宜、流程委托、流程监控。我发起的页面能看到自己提交的所有流程及当前节点待办事宜需要处理收到的审批任务已办事宜记录历史审批抄送事宜接收被抄送的通知流程监控则站在管理员角度查看所有在途流程能定位卡死的节点。流程委托是一个非常实用的能力用户一段时间不在时可以把待办临时委托给同事。委托并不是把所有流程权限都交出去它只作用于委托时间段内的待办任务受托人可以代为办理被委托人的节点。配置委托时建议顺手设置开始和结束时间避免忘记取消委托造成越权审批。流程批量审批功能也可以在这里启用把高频的同类待办一次性批量通过适合报销单、公告审核这类量大且风险低的节点。流程「复活」是 V3.4.2 补的异常恢复能力针对异常中断的流程做重新激活。调试阶段如果遇到流程跑到一半就消失先到流程监控里看该流程实例的状态再做复活操作不要直接新建一个流程实例来替代那样会丢掉历史审批记录和表单数据。5. 常见问题与排查实录表单字段丢失、流程不流转与权限越界的六个坑5.1 表单与列表配置期的三个坑第一坑主键策略保存后不能修改。现象表单已经创建并录入过数据后来想把自增长 ID 改成雪花 ID在表单属性里发现选项是灰的。原因主键策略在保存时已经确定主表结构生成逻辑流程保存后不可修改。解决设计阶段先定主键策略并发量高、多系统同步数据优先用雪花 ID实在要改只能重建功能并把旧数据迁移到新表这是一步没有后悔药的操作。第二坑未绑定数据表导致表名失控。现象流程发起后数据库里自动生成了一堆 mt功能ID、ct雪花ID 的表后续维护时根本分不清哪张表对哪个功能。原因基础设置里没选数据连接、没做数据建模的表绑定。解决在数据建模里先建好主表和子表再到基础设置里绑定数据表表名、字段名可控后续改表结构也清晰。我一般在项目初始化阶段就把数据建模的命名规范写进交付文档避免后期靠猜。第三坑子表数据保存失败或字段缺失。现象子表控件拖进去了也填了数据但提交后子表记录丢失。原因多表设计时子表的外键字段和关联主键没有配置主表和子表之间没有建立关联。解决基础设置里检查主表、子表的关联配置确保子表外键与主键对应控件字段也逐个确认已映射到表字段避免字段名对不上。排错时先在数据应用里看表结构是否存在再回到表单设计里看控件字段映射基本能定位。5.2 权限与流程运行期的三个坑第四坑数据权限越界或查不到数据。现象某个角色明明只配置了「查看本部门」却能看到全部用户数据或者反过来连本部门数据都看不到。原因数据权限没在角色上赋权或者部门关系维护在组织管理里组织树没建好导致部门归属判断失败。解决先检查组织管理里用户与部门是否挂对再去系统菜单的数据权限里按角色配置行数据范围必要时配合用户分组做二次收敛。配置完成后用两个不同部门的账号各测一次确认边界符合预期。第五坑流程卡在节点不流转。现象待办里点完「同意」流程没有进入下一节点。原因节点事件脚本抛了异常导致提交中断或者下一节点的审批人配置成了空值、候选人池为空。解决先到流程监控看实例状态再到系统日志里查异常栈定位脚本错误审批人配置要确认节点上至少有一个有效审批人候选人场景要确认候选池里有成员。这个问题的排查顺序很固定流程监控→系统日志→节点属性不要一上来就改脚本。第六坑并发提交互相覆盖。现象两个用户同时打开同一条表单后提交的人把先提交的人数据覆盖了。原因表单属性里的「并发锁定」没开启编辑时没有乐观锁控制。解决表单设计阶段开启并发锁定。锁定后后提交方会收到冲突提示再由用户决定是重新提交还是放弃修改。这个功能上线后才补会涉及表单结构变更最好一开始就开着属于标准配置项而不是可选优化项。5.3 配置错误的通用排查顺序遇到表单或流程问题先别急着改配置按顺序查会快很多。第一步看系统日志操作日志记录操作轨迹异常日志里一般能看到完整堆栈第二步看流程监控确认流程实例是否在预期的节点上状态是什么第三步检查系统缓存字典或菜单改了不生效清一次缓存再验证第四步回到数据应用里核对表结构看字段是否真的存在于数据表。这里有一个现场最常上演的场景改了某字段的组件事件结果流程提交报错。先打开系统日志看异常信息发现脚本里调用了未定义的方法回到表单设计里检查事件代码补上方法名再重新提交整个过程不需要重启服务。如果日志里查不到任何痕迹那就要考虑是权限问题还是缓存问题这时候再去系统菜单和数据权限里核对角色配置。把日志、监控、缓存、表结构四步走成固定顺序后大多数问题都能在十分钟内定位。6. 大屏与报表的进阶做法数据源接入、地图分类与百万数据导出验证大屏设计模块分为大屏管理、地图管理、分类管理和数据源管理。大屏管理的核心是新建大屏后选择布局组件把每个组件的数据源指向数据接口或数据表地图管理负责接入地理数据分类管理维护大屏分组。我的建议是大屏和报表统一建立在数据接口之上而不是直接连数据表。这样大屏展示的数据口径与表单查询完全一致接口认证还能控制哪些请求有权限取数。扩展应用里附带了门户示例、功能示例、图表示例、表单示例、大屏示例和报表示例需要参考布局时直接打开这些页面比自己盲配快得多。新建大屏的一般路径是先在数据源管理里登记数据接口再在大屏管理里新建大屏最后把组件的数据源指向接口并设置刷新周期。这个顺序能避免先画布局后找数据源的返工。报表设计也类似有独立的报表设计入口支持新建报表、绑定数据源和结果展示。报表偏聚合统计表单偏录入与明细所以设计报表前要在数据建模里把统计字段先整理好。步骤配置项说明1数据源管理登记大屏要用的数据接口建议与在线开发共用2大屏管理新建大屏选择布局组件3组件绑源组件绑定数据接口设置刷新周期验证阶段可以利用扩展应用里的「百万数据」和「导入导出」示例导入批量数据后用列表查询、行内编辑和大屏组件分别跑一遍确认查询性能与导出结果符合预期。从那以后我每次交付前都强制把六项走一遍建表走数据建模、字段挂数据字典、列表开并发锁定、角色配数据权限、节点设超时提醒、大屏走数据接口。这套习惯会让交付最稳的部分沉淀在配置和检查里少出黑匣子问题。希望帮到你。本文还有配套的精品资源点击获取