简介：《JNPF产品功能使用手册_v3.4.2》面向JNPF软件开发平台的实施人员、二次开发工程师与平台管理员，系统梳理V3.4.2版本的各项功能入口与操作路径，可作为项目落地、功能选型和团队培训时的对照文档。手册以在线开发为主线，依次讲解表单、列表、流程与结果展示的配置方法，并延伸至门户新建与展示、大屏管理、地图管理、分类管理、数据源管理及报表设计；代码生成部分覆盖功能表单与流程表单两条主线，系统管理则涉及基础设置、安全设置、第三方设置、超级管理员、系统公告、系统调度、缓存、日志、监控、图标与菜单权限等内容。整包为1个PDF文件，约40.01MB，目录层级清晰、章节编号完整，便于按模块跳转查阅。目前已有1343人学习下载，适合需要快速熟悉平台功能边界、编写操作规范或开展内部培训的技术人员参考。

1. 这份 v3.4.2 手册的价值不在目录：先把「配置顺序」看懂

JNPF 产品功能使用手册 v3.4.2 这份 PDF 我前后翻了三遍，第一次是照着目录找「表单设计」，第二次是项目上线前查「流程异常处理」，第三次是排查一个列表空白问题。它解决的问题很具体：在一个低代码平台上，把表单、列表、流程、门户、大屏、代码生成、系统权限这些模块按什么顺序配置，参数落在哪一页。适合正在用 JNPF 搭业务系统的一线开发、实施和运维，也适合准备接手别人配置了一半的项目、需要快速判断「哪里漏配」的人。它不是 API 手册，更像一张操作路径图，翻的时候别从第一页顺读，先看修订记录里 v3.4.2 新增了什么，再按「在线开发 → 代码生成 → 系统权限 → 工作流程」的顺序对照自己的项目。

2. 在线开发：从表单到流程的六个配置层次

2.1 基础设置里先定数据表，不然后面全是返工

在线开发的第一入口是功能设计，新建时先选类型：表单、列表、流程。很多人一上来就拖控件，拖完才发现数据表没定，回头改字段绑定，控件字段全部要重选。手册里写得很清楚：未设置数据连接时，流程新建完成后会自动建表，主表以「mt+功能 ID」命名，子表以「ct+雪花 ID」命名。这个机制适合从零起的新功能，命名权交给平台，省事但后期不好认。对接存量库时，要在基础设置里下拉数据连接，点「新增一行」进入数据选择页面，绑定数据建模里的单表或多表。

单表和母子表的选择会直接影响后面的表单设计。选多表时，必须配置子表的外键字段和关联主键，否则主表和子表关联不上，表单保存时看起来成功，列表查出来却是空的。我一般会先把数据表关系画在纸上：主表一条业务记录，子表是明细行，副表是扩展信息。手册里也提到副表加子表、两个副表、两个子表的组合，但组合越多，后面字段绑定和权限配置越容易漏。新项目可以先用自动建表跑通流程，等业务稳定后再迁到自定义表；存量项目一开始就绑定已有表，别中途混用两种策略，否则同一个功能里一半字段在自动表、一半在绑定表，排查时非常难受。

提示：基础设置里改数据表绑定，已录入的数据不会自动迁移。上线前改表，先导出测试数据，别在生产功能上直接换表。

2.2 表单设计：控件字段绑定与子表合计/动作设置

表单设计页左侧是控件区，基础控件、高级控件、系统控件都在这里，拖到中间画布后，右侧配属性。最关键的一步是「控件字段」：有表设计时，必须下拉选择关联表的字段名；没有合适字段，可以在下拉里快捷新建字段。手册里提到，新建字段窗口会展示当前数据表已有字段，已有字段不支持修改，新建字段则新增一行空白行自定义配置。这个细节很重要：字段一旦被控件绑定，后面再改类型或长度，会影响已有数据，所以我一般在数据建模阶段就把字段定稿，表单设计只做选择和少量补充。

子表设计是容易翻车的地方。需要先选「设计子表」控件，在右侧关联基础设置里添加的子表，然后才能把控件拖进子表区域。子表里的控件同样要绑定控件字段。子表支持合计设置和动作设置：合计设置只认子表内单行输入、数字输入、计算公式类型的字段，开启后流程使用时子表框下方展示合计栏；动作设置用于子表添加数据时从远端接口联动填充，需要配弹窗标题、弹窗类型、弹窗宽度，选数据接口后把接口参数和主表字段做映射，再设置列表字段和关联字段映射，映射来源支持接口字段和固定值。

组件事件是另一个高频用法。手册里支持「发生变化时触发」和「失去焦点时触发」，代码区写 JavaScript。常见场景是下拉选择控件选 a 时给另一个控件赋值 1，选 b 时赋值 2，选 c 时隐藏控件，选 d 时设为必填。写这类脚本时，我习惯先把控件标识和字段名列成一张小表，脚本里只做条件判断，不在里面做复杂查询，查询交给数据接口。组件样式里还能配栅格、标题宽度、多端显示，桌面端和移动端可以分别控制某个控件是否展示，默认都选中。移动端字段多的表单，别把所有控件都勾上，先按业务必填项裁一遍。

表单属性里有两项要特别注意：主键策略支持雪花 ID 和自增长 ID，流程保存后不可修改；并发锁定开启后，并发提交表单会加乐观锁机制，保证数据提交准确性。主键策略在功能创建时就要定，后面改不了；并发锁定适合库存、额度这类会并发扣减的场景，普通信息登记表可以不开，开了之后并发冲突会提示，需要前端有重试提示。

2.3 列表设计与高级查询/行内编辑的边界

新建功能设计选「列表」时，配置链路是基础设置、表单设计、列表设计三段，桌面端与移动端切换分别设计。列表属性、列表字段、查询字段都在列表设计里配。v3.4.2 的功能设计增加了高级查询、行内编辑、列表查询，这三个能力很实用，但边界要清楚。高级查询适合多条件组合筛选，比如订单列表按状态、日期区间、客户名称组合查；行内编辑适合字段少、权限清晰的维护场景，比如字典表、参数表；列表查询适合把常用查询条件固定在列表顶部，减少用户展开高级查询的次数。

行内编辑不要开在涉及流程状态、计算字段、子表汇总的列表上。原因很直接：行内编辑绕过表单的提交前置/后置事件，计算字段不会重算，流程状态也可能被误改。手册里表单事件支持表单加载触发、提交前置触发、提交后置触发，这些事件在行内编辑场景下不一定按预期走。我的做法是：主数据列表只读，编辑走表单弹窗；参数类列表可以开行内编辑，但要把不可编辑列锁死，并且只给特定角色开按钮权限。

列表字段和查询字段的来源是表单设计里绑定的控件字段。列表空白时，先看列表设计里有没有把字段放进去，再看查询字段是不是选了不该选的字段导致默认条件过滤。移动端列表和桌面端列表是分开设计的，桌面端调好的列宽和显示字段，移动端不会自动继承。上线前两个端都要点一遍，尤其是移动端，字段多的时候列会挤在一起，最好只保留三到五个关键列。

2.4 流程设计：节点、审批设置与异常处理

流程设计分三页：基础信息、表单设计、流程设计。基础信息里配流程名称、绑定表单、数据表等；表单设计里配字段权限，哪些节点可编辑、哪些只读；流程设计里画节点、连线条、配审批人。手册在 v3.3.1 增加了审批设置候选人、保存草稿、节点事件、子表合计、审批汇总、流程评论、子流程同步异步；v3.4.2 又增加了超时提醒、异常处理、自动同意、节点变更、流程复活、子表传递。这些功能不是越多越好，要按业务场景挑。

审批设置候选人是最容易出问题的一步。候选人可以按用户、角色、岗位、分级管理范围来配，配完还要确认用户是否挂到了对应组织、岗位和角色上。流程提交后待办为空，八成是候选人没配全，或者配了岗位但用户没挂岗位。超时提醒要设时间单位和提醒对象，别设得太密，否则待办消息会刷屏。异常处理要明确异常时走哪个分支，是转交、跳过还是终止，手册里给了配置入口，具体动作按项目规范定。自动同意适合重复审批节点，比如部门内会签，条件要写清楚，别把需要人工判断的节点也开自动同意。

节点变更和流程复活是运维友好功能。节点变更用于流程走到一半发现审批人配错，可以在流程监控里调整；流程复活用于异常终止的流程恢复。这两个操作都会留痕，但不要当成日常操作，能退回重提就退回重提。子表传递用于主流程和子流程之间传明细数据，配的时候要确认子表字段映射，字段类型不一致会在传递时丢精度。流程上线前，我一般按「发起 → 审批 → 驳回 → 撤回 → 超时 → 异常」六个动作各走一遍，光看流程图看不出问题。

3. 代码生成与门户大屏：三类页面的选型边界

3.1 功能表单与流程表单的代码生成差异

代码生成分功能表单和流程表单。功能表单生成的是表单、列表、流程、结果展示这一套；流程表单更偏向带审批流的业务单据。选哪个，取决于交付方式：如果项目要求交付源码、后续由开发团队二次开发，就用代码生成，把在线开发里配好的表单和列表转成代码；如果只是快速上线、业务人员自己维护，在线开发配置完直接发布更轻。手册里代码生成的章节从功能表单的表单、列表、流程、结果展示一直写到流程表单，说明生成器不是一键出全部，而是按模块生成。

生成前要把字段定稿。在线开发里控件字段可以快捷新建，但代码生成后再改字段，往往要重新生成，手工合并代码的成本更高。我一般会先把表单字段、列表字段、查询字段、流程节点列成一张清单，确认没有重复字段、没有类型冲突，再走代码生成。生成后先看结果展示页，再回头看列表和流程，因为结果展示最容易暴露字段绑定问题。

3.2 门户设计：新建与结果展示的复用逻辑

门户设计分新建和结果展示。门户是系统入口，把常用菜单、待办、公告、报表聚合到一个页面。新建门户时先定布局，再挂组件，最后配权限。手册里门户设计的篇幅不长，但落地时最容易忽略的是权限：门户上的每个组件背后都对应菜单或数据权限，菜单没给角色，门户上就是空白。我一般先把系统菜单、角色权限配完，再部门户，门户只做展示层，不承担权限分配。

结果展示页要检查三件事：组件数据源是否指向正确的数据接口，移动端布局是否错位，门户分类是否挂对。门户组件里的列表和图表，查询量大的时候会拖慢首屏，常见做法是把重查询放到二级页面，门户只放汇总数和待办。门户不是越满越好，入口页放三到五个高频模块就够了。

3.3 大屏设计：大屏管理、地图管理、分类管理、数据源管理

大屏设计分四块：大屏管理、地图管理、分类管理、数据源管理。顺序上先配数据源，再建大屏，再挂地图，最后用分类管理组织。数据源管理要选对数据连接，数据连接在 3.10.1 配，数据接口在 3.10.4 配，接口认证在 3.10.5 配。很多人直接在大屏里选接口，接口没配认证，图表就是空白。地图管理要匹配行政区划，3.10.7 有行政区划数据，地图层级和区域编码对不上，地图上不会渲染数据。

分类管理用于大屏分组和权限检索。大屏多了以后，没有分类很难找，权限也不好控。我的做法是按业务域分类，比如运营、生产、财务，每个分类下再按桌面端和移动端分。大屏数据源尽量走汇总接口，不要直接查明细表，大屏刷新频率高，明细查询会把数据库连接占满。

3.4 报表设计与数据应用：数据连接、建模、字典、接口

报表设计在手册第 1.4 节，数据应用在 3.10 节，两者经常一起用。数据应用的顺序是：数据连接 → 数据建模 → 数据字典 → 数据接口 → 接口认证 → 数据同步 → 行政区划。数据连接是底座，数据建模把表关系理清，数据字典统一枚举值，数据接口对外提供查询，接口认证控制访问，数据同步做跨库数据搬运，行政区划给地图和地址类字段用。这个顺序不要跳，跳了之后接口查不到字段、字典对不上编码，排查起来会绕很远。

报表设计依赖数据接口和数据集。做报表前先确认指标口径，是查明细还是查汇总，汇总字段在数据建模里有没有。报表参数尽量用数据字典的下拉值，不要让用户手输编码。报表导出和打印模板在 3.9.3、3.9.4 有说明，打印模板要先配单据模板，再挂到功能上。报表上线前，用一条边界数据验证：最大值、最小值、空值、超长文本，这四个值能过，基本就不会在客户现场翻车。

4. 系统管理与权限：五层权限模型怎么落到位

4.1 系统配置与安全设置：基础设置、登录方式、锁定账户

系统配置分基础设置、安全设置、第三方设置、超级管理员。基础设置改系统名称、Logo、版权信息这类全局参数；安全设置管图形验证、登录方式、锁定账户；第三方设置配外部系统对接；超级管理员账号要单独维护。改安全设置前，先确认超级管理员能正常登录，别把自己锁在外面。锁定账户策略要结合用户规模，失败次数太少容易误锁，太多又起不到防护作用。

系统公告、消息中心、系统调度、系统缓存、系统日志、系统监控、系统图标都在系统管理下。系统公告支持新建、编辑、删除、详情、发布，发布时要选发送人员范围，范围选错，公告发了没人看到。系统调度支持内部方法类型，定时任务失败先看系统日志里的操作日志。系统缓存清理要谨慎，清完缓存后用户权限、菜单会重新加载，最好在低峰期做。系统监控看连接数和内存，大屏和报表多的时候，连接池容易打满。

4.2 系统菜单与子系统：按钮权限、列表权限、表单权限、数据权限

系统菜单是权限的入口。新建菜单后可以导入导出，按钮权限、列表权限、表单权限、数据权限都在菜单下配。v3.4.2 增加了子系统，多业务线可以分子系统管理。五层权限要分开看：菜单权限决定用户能不能看到入口；按钮权限决定新建、编辑、删除、导出这些按钮能不能点；列表权限决定列表里哪些列可见；表单权限决定字段可编辑还是只读；数据权限决定用户能看哪些行。很多权限问题不是没配，而是配在了错误的层：菜单给了，按钮没给，用户进去只能看不能动；按钮给了，数据权限没给，用户能看到全部数据。

表单权限还涉及子表字段权限，v3.4.1 的修订记录里提到子表字段权限配置。子表里有些字段只允许财务看，有些字段只允许发起人编辑，这些要在表单权限里按字段配，不要图省事用整个表单只读。

4.3 组织、岗位、用户、角色与分级管理

系统权限的顺序是：分级管理 → 组织管理 → 岗位管理 → 用户管理 → 分组管理 → 角色管理 → 权限管理。分级管理适合多组织、多层级的企业，先划分级范围，再建组织。组织建完建岗位，岗位挂到组织下。用户新建时选组织、岗位，重置密码、解除锁定、导入导出都在用户管理里。分组管理用于跨组织的项目组或临时团队，角色管理负责把权限打包，角色成员可以批量加用户，角色权限挂菜单和数据权限。

常见错误是先建用户再建组织，用户没有归属，流程候选人按组织找不到人。正确顺序是先组织、后岗位、再用户。角色权限和数据权限要分开配：角色权限决定功能入口，数据权限决定数据范围。分级管理员只能管自己范围内的组织和用户，配分级管理时要把管理范围划清楚，别把跨级数据放进去。在线用户页面可以看当前登录用户，调试权限时用它确认用户身份和角色是否生效。

4.4 系统调度、缓存、日志、监控的日常巡检

系统调度、缓存、日志、监控是运维四件套。调度任务失败，先看系统日志里的操作日志，再看任务本身有没有配内部方法类型；缓存异常，先确认是不是刚改了菜单或权限，改完权限清缓存再让用户重登；日志要看操作日志和登录日志，异常登录和批量删除是重点；监控看系统负载和连接数，大屏、报表、导入导出同时跑的时候，连接数会明显上升。

系统图标和系统模板属于配置类资源。短信模板、消息模板、打印模板、单据模板都在 3.9 节，模板改完要发一条测试消息或打一张测试单据。打印模板依赖单据模板，单据模板没配，打印出来是空白。日常巡检我一般一周一次：看调度失败记录、看缓存命中、看日志异常关键字、看监控峰值，四个动作十分钟能做完，比出问题再查省事。

5. 避坑与排查：六条配置顺序错误和权限穿透记录

5.1 表单发布后列表空白：数据表没绑定还是查询字段没放

现象：功能设计发布后，列表页一条数据都没有，表单却能正常打开。原因通常有三类：基础设置里没选数据连接，系统自动建了表，但列表设计没把字段放进去；选了多表，子表外键和关联主键没配，主表有数据、子表关联不上；列表设计里查询字段选了带默认值的字段，默认条件把数据过滤掉了。解决顺序是回基础设置看数据表绑定，回表单设计看控件字段是否都绑到了表字段，回列表设计看列表字段和查询字段。发布后清一次系统缓存，再用新角色登录验证。这个问题我遇到过两次，第二次是因为多表关联主键选错，表单保存成功但列表查不出来，最后在数据建模里把关联关系重新对了一遍。

5.2 子表合计不生效：字段类型和合计字段来源

现象：子表里填了数字，合计栏不显示，或者显示为 0。原因：合计设置只认子表内单行输入、数字输入、计算公式类型的字段，选了下拉框、日期、附件都不行；子表控件没有关联基础设置里的子表，拖进去的控件不在子表区域内；合计字段没选或选了多行文本。解决：先检查子表控件的关联子表，再检查每个数字字段的控件类型，最后在合计设置里重选字段。保存后不要只看设计器预览，要走一遍流程表单，因为合计栏在流程使用时才展示。子表动作设置里的远端数据联动也会影响合计，接口返回的字段类型如果是字符串，合计会按 0 处理，映射时要做类型转换。

5.3 流程节点找不到审批人：候选人、岗位、角色与分级管理

现象：流程提交成功，下一节点待办为空，流程停在节点上。原因：审批设置候选人没配；配了岗位但用户没挂岗位；配了角色但角色成员没加；配了分级管理，但发起人不在管理范围内；候选人配了多个来源，取交集后为空。解决：用流程监控看当前节点和候选人计算逻辑，再到用户管理确认用户的组织、岗位、角色，最后回流程设计补候选人。分级管理场景要特别注意，分级管理员只能选自己范围内的用户，跨级用户不会出现在候选人里。流程复活可以恢复异常流程，但恢复前先修候选人，否则还会卡住。

5.4 代码生成后菜单不显示：同步菜单与权限缓存

现象：代码生成成功，部署后系统菜单里找不到新功能。原因：代码生成后没有同步菜单；菜单建了但没给角色权限；菜单挂在子系统下，当前角色没有子系统权限；浏览器缓存了旧菜单。解决：先在系统菜单里执行同步菜单，再给角色勾选菜单权限和按钮权限，检查子系统归属，最后清系统缓存并重新登录。代码生成的功能表单和流程表单菜单来源不一样，流程表单还要确认流程设计里的表单绑定是否正确。如果菜单显示但点进去 404，检查生成代码的路由和菜单地址是否一致。

5.5 大屏数据源连不上：数据连接、接口认证与行政区划

现象：大屏图表空白，或者地图上只有底图没有数据。原因：数据源管理里选的数据连接不通；数据接口没配接口认证，大屏请求被拒绝；地图管理用的区域编码和行政区划数据不一致；大屏分类权限没放开，当前用户看不到大屏。解决：先到数据连接里点测试，再到数据接口里手工调一次，确认返回结构；接口认证在 3.10.5 配，认证方式要和调用方一致；地图问题先查 3.10.7 行政区划，确认区域编码；最后看大屏分类和角色权限。大屏刷新间隔太短也会导致接口超时，先把刷新间隔调大，再排查数据量。

5.6 系统公告发了没人看到：发送范围与消息中心

现象：系统公告发布成功，目标用户说没收到。原因：发布时发送人员范围选错；公告状态没发布；消息中心模板没配；用户没有消息中心权限。解决：回系统公告看发送范围和发布状态，再到系统模板里的消息模板确认模板启用，最后检查用户角色的消息中心菜单权限。公告和消息模板是两套配置，公告负责内容，消息模板负责通知渠道，只配公告不配模板，站内消息可能不触发。

6. 把手册用成验收清单：三个验证动作和一条固定习惯

6.1 用「新建-配置-发布-回滚」四步验证

这份手册最实用的地方不是教你点哪个按钮，而是帮你把配置顺序固定下来。我现在的做法是每改一个功能，都走「新建-配置-发布-回滚」四步：新建一条测试数据，确认表单能存、列表能查；配置权限，换角色看菜单、按钮、字段、数据四层是否生效；发布后走一遍流程，看审批人、超时提醒、异常处理；最后回滚测试数据，避免污染生产。四步走完，再去看手册里对应章节的参数说明，基本能覆盖八成配置问题。

6.2 版本升级前先比对修订记录里的功能增量

手册开头的修订记录比正文更容易被忽略。v3.3.1 增加了审批设置候选人、保存草稿、节点事件、子表合计、审批汇总、流程评论、子流程同步异步；v3.3.3 增加了系统图标、超级管理员、系统公告发送范围、系统调度内部方法类型、操作日志、分组管理、流程批量审批；v3.4.1 做了 PC 端与移动端功能设计合并、子表字段权限、同步菜单；v3.4.2 增加了流程超时提醒、异常处理、自动同意、节点变更、流程复活、子表传递、分级管理、接口认证、高级查询、行内编辑、列表查询、子系统。升级前拿这张增量表对照现有配置，重点看流程和权限两项，新增功能往往伴随新的权限点，旧角色不会自动拥有。

从那以后我每次上线前都强制走一遍「新建-配置-发布-回滚」，再把修订记录里的新增项对照一遍，宁可多花二十分钟，也不在客户现场解释为什么待办是空的。希望帮到你。

本文还有配套的精品资源，点击获取