简介JNPF产品功能使用手册_v3.4.2.pdf面向使用JNPF低代码平台的产品经理、实施人员与开发新手系统梳理V3.4.2版本的功能入口、操作流程与配置要点可帮助读者尽快熟悉平台从在线开发到系统管理的使用路径。资源包仅含1个PDF文件大小约40.01MB以操作说明和目录索引为主按在线开发、代码生成、系统管理三大板块编排便于按模块检索。手册覆盖表单、列表、流程与结果展示设计门户及大屏设计中的大屏管理、地图管理、分类管理、数据源管理还包含报表设计、功能表单与流程表单的代码生成系统管理部分涉及基础设置、安全设置、第三方设置、系统公告、调度、缓存、日志、监控及菜单权限等内容。已有1343人学习适合作为平台实施、功能配置和日常运维的案头参考也可用于团队培训与查漏补缺。1. 两百多页的手册该怎么读先找到它压住的四个落地环节拿到一份两百多页的 PDF多数人的第一反应是搜关键词搜不到就关掉。这份 JNPF 3.4.2 的使用手册恰好属于搜关键词会失效的那类——目录按产品菜单的顺序排没有按你手上的任务来排。真正会卡住的地方基本就四类表单控件绑不上字段、子表数据填不进来、流程走到一半改不动、权限配完发现别人看不到数据。手册把答案分散在「在线开发」「工作流程」「系统管理」「系统权限」四章里而修订记录从 3.3.1 到 3.4.2 的十几条增补恰恰说明它是在真实项目里反复打补丁长出来的比如子表字段权限、流程超时提醒、接口认证、行内编辑这些都是被用户催出来的。适合谁看正在做低代码平台选型评估的架构、要接手一套已上线配置的实施、准备把线下审批搬到线上但不想写全栈代码的团队。2. 在线开发从建表到控件绑定的五步落地低代码平台最容易让人产生错觉的一步就是拖控件。把输入框拖到画布上看起来就完成了但真正决定这个功能能不能跑起来的是控件背后挂的那个字段以及这个字段落在哪张表、哪个库、哪套主键策略上。手册第一章「在线开发」的篇幅最厚从第 1 页排到第 65 页原因也在这里它讲的不是拖拽而是绑定关系。2.1 三条产品线怎么选表单、列表、流程的取舍在功能设计页面点击左上角新建表单会弹出类型选择表单、列表、流程。很多新手在这里随手选一个后面发现要补列表只能重来。这三条产品线的差别本质上是「数据写入之后还有没有下一步」。表单类型最轻只负责数据录入和存储适合参数配置、基础档案、单次登记这类场景提交完就结束了没有列表页给你翻查历史。列表类型是表单加列表等价于一份能录入、能查询、能翻页的台账适合设备台账、合同登记、物资清单这种需要反复检索的数据。流程类型则在此基础上再叠加审批流转走的是「提交—审批—归档」的闭环适合请假、报销、采购申请、用章申请。我一般的判断顺序是反过来的先问这份数据提交之后有没有人要去查历史有就至少是列表再问有没有第二个人要签字或者确认有就是流程。两个都否定才选纯表单。这个顺序能省掉大量返工因为表单类型改成列表类型控件不用重画但列表列和查询条件要重新设计一遍。还有一点容易被忽略列表设计和表单设计在桌面端与移动端是分开设计的手册在多处强调可以切换分别设计。这意味着你在 PC 端排好的列宽、查询条件布局不会自动继承到移动端得手动再过一遍。真做项目时这一块的工作量经常被低估。2.2 基础设置默认建表与自定义绑定的分水岭新建功能之后先填基础设置这里的每一个选项都会在后面产生后果。不选数据连接时流程新建完成后平台会自动建表主表以mt功能ID命名子表以ct雪花ID命名。这是最省事的路子适合从零开始的新业务表结构由平台托管字段随控件走。代价是表名不可读mt后面跟一串功能 ID后期做报表取数或者让 DBA 排查问题时得先去功能列表里对一遍 ID。选了数据连接并绑定已有数据库表情况就反过来字段映射由你控制表和外部系统共用一份报表、数据同步、第三方读取都能直接对接。手册里明确写了多表绑定的规则——选多表时必须配置子表的外键字段和关联主键让主表和子表关联起来选单表则跳过这一步。这条规则是整个表单设计的地基配错了后面子表控件压根拖不进去。绑定方式表命名适用场景主要代价默认自动建表主表mt功能ID子表ct雪花ID全新业务、快速验证、无外部取数需求表名不可读跨系统对接成本高自定义绑定单表沿用已有表名与已有业务库共用、报表直接取数字段类型必须提前对齐自定义绑定多表沿用已有表名 外键关联主子结构清晰的老系统改造外键与关联主键必须一次配对绑定已有表时最常翻车的是字段类型。平台控件有自己的类型体系数据库字段有另一套日期、布尔、大文本、金额这几类最容易对不上。绑定前把目标表的字段类型导出来对一遍比绑定后再改控件省事得多。2.3 表单设计控件字段、子表传递与合计进入表单设计页左侧是控件区右侧是属性区顶部有预览、清空、桌面端/移动端切换。核心动作只有一个选中控件在右侧下拉「控件字段」里选它对应的表字段。这里手册给了一个很实用的细节下拉控件字段时支持快捷新建字段。点添加会弹出字段设置窗口展示当前数据表里已有的字段已有字段不支持修改再点新建字段才新增一行空白行做自定义配置。换句话说改表结构和绑字段可以在同一个弹窗里完成不用切到数据建模页面来回跳。我一般会先用这个入口把缺的字段补齐再统一绑一遍比边绑边建效率高。副表和子表是这一节的重点。副表的设计方式是选普通控件然后在右侧数据库表里关联副表再选对应控件字段。子表不一样必须先拖一个「设计子表」控件在右侧组件属性里关联基础设置中添加过的子表之后才能往这个区域里拖子表控件。顺序反了控件会拖不进去这是很多人的第一道坎。子表有两个进阶配置值得单独说。合计设置开启后流程使用时刻在子表框下方展示合计栏。合计字段只能从子表内的单行输入、数字输入、计算公式这三类字段里选可以多选。注意是这三类日期、下拉、附件这些字段不会出现在可选项里如果发现合计栏是空的先回头确认字段类型。动作设置也就是子表传递功能是子表添加数据后自动填充内容。配置链路是——点配置表单设置弹窗标题、弹窗类型居中或右侧、弹窗宽度然后点远端数据联动选择数据接口数据来源是系统管理里的数据接口模块选完后接口带的参数会自动列到参数设置区下拉表单字段选主表字段作为筛选条件再在设置列表字段区新增行定义弹窗里展示哪些列、对应接口的哪个字段最后在设置关联字段区新增行定义子表字段的映射规则映射来源支持接口字段和固定值两种。这条链路的价值在于用户选一次主表信息子表就能带出一批明细不用手工一行行敲。但它对接口的返回结构有要求字段名必须和你在列表字段里填的一致差一个字母就是空白列。2.4 自定义 JS 与表单属性主键策略、并发锁这两个决定后悔不后悔组件属性里可以配自定义组件事件支持「发生变化时触发」和「失去焦点时触发」代码区写 JavaScript。表单级别则有三类事件表单加载触发、提交前置触发、提交后置触发。这五个钩子基本覆盖了低代码做不了的个性化逻辑。下面这段是按手册里那类联动场景整理的脚本骨架函数名以平台内置编辑器的实际提示为准不要照抄名字照抄逻辑// 控件「发生变化时触发」按当前值做赋值、隐藏、必填三类联动 const v this.value; // 当前控件的值 if (v a) { this.setValue(aField, 1); // 值为 a 时给 aField 赋 1 } else if (v b) { this.setValue(bField, 2); // 值为 b 时给 bField 赋 2 } else if (v c) { this.setFieldVisible(cField, false); // 值为 c 时隐藏 cField } else if (v d) { this.setFieldRequired(dField, true); // 值为 d 时dField 变必填 }逻辑说明这段脚本挂在某个下拉控件的变更事件上触发时机是用户改完选项、值已经落到控件之后。四类分支分别对应赋值、赋值、隐藏、必填是表单联动里出现频率最高的四种动作。参数说明this.value取当前控件值setValue(字段名, 值)用于给其他控件赋值setFieldVisible(字段名, 布尔)控制显隐setFieldRequired(字段名, 布尔)控制必填。三个方法的第一个参数都是控件标识不是数据库字段名这一点经常有人搞混写错了不报错只是没效果。表单属性区还有两个选项属于「配错了很难回头」的那种。主键策略支持雪花 ID 和自增长 ID流程保存后不可修改。雪花 ID 适合分布式、多实例部署、需要跨库合并数据的场景自增长 ID 适合单库、需要人读、要和旧系统对号的场景。一旦流程跑起来再想改历史数据的 ID 规则会乱所以新建时就得定死。并发锁定开启后并发提交表单会加乐观锁保证数据提交的准确性。多人同时编辑同一条记录时后提交的会被拦下来而不是无声覆盖。默认关着涉及库存、额度、余额这类数据的表单建议开。玄学的地方在于不开的时候几乎不会出问题一旦出问题就是数据对不上且很难复盘是谁覆盖了谁。组件样式里还有栅格、标题宽度、多端显示三项。多端显示默认两端都勾选取消勾选即该端不展示这个控件。做移动端精简表单时这个开关比重新设计一套表单划算得多。3. 列表与流程把一条业务从能填推到能跑完第二章讲的是数据怎么进来这一章讲的是数据进来之后怎么被看见、怎么被推进。手册把列表设计放在 1.1.2流程设计放在 1.1.3代码生成单独成章顺序本身就说明了依赖关系列表依赖表单的字段流程依赖列表的数据代码生成依赖前面所有配置。3.1 列表设计属性、字段、查询条件这三层列表类型的功能需要走完基础设置、表单设计、列表设计三步。前两步和纯表单一致第三步才是列表自己的活。手册在图 1-1-19 之后展开的内容本质上是三层配置。第一层是列表属性分页方式、每页条数、是否显示序号、操作列按钮、行高、是否开启行内编辑。行内编辑是 3.4.2 版本补进来的能力作用是直接在列表单元格里改值并保存不用点进详情页。适合批量修改状态、备注、负责人这类轻量字段。不适合金额、关联字段、子表因为校验逻辑在列表页跑不全。第二层是列表字段决定展示哪些列、列宽、排序、对齐、是否可排序筛选。这里的坑在于字段选多了页面会横向滚动选少了用户得来回复查。我一般按「谁在用这个列表」来定一线操作人员的列表只留 6 到 8 列把详情放在抽屉里管理岗的列表可以宽一些但要开列配置让用户自己勾。第三层是查询字段定义列表顶部的筛选条件。高级查询是 3.4.2 新增的支持组合条件比单一字段筛选灵活。设计查询条件时有个经验把用户最常用的两三个条件固定在顶部其余收进高级查询。全铺开会让页面顶部长得像个表单反而没人用。移动端的列表要单独再设计一遍。PC 端能放 10 列手机上 3 列就到头了剩下的靠点击进详情。这一步不做移动端打开就是一片横向滚动条体验直接崩。3.2 流程设计的三层结构基础信息、表单、节点流程设计在手册里从第 197 页开始一直排到 238 页是单章里篇幅第二厚的。它被拆成三块基础信息、表单设计、流程设计。基础信息定义流程的身份流程名称、所属分类、绑定的功能表单、适用范围、发起权限。这里要特别注意「绑定的表单」这一步——流程表单和功能表单不是同一套东西。功能表单是在线开发里独立设计的流程表单是在流程设计器里绑定的两者的字段权限可以分别控制。手册在 5.1.2 专门讲了流程的表单设计说明它不是简单引用。流程设计器里画的是节点和连线。节点类型覆盖发起、审批、抄送、条件分支、子流程。审批节点的配置项最多审批人设置支持指定人员、角色、岗位、部门主管、发起人自选等审批设置里可以配候选人、多人会签或或签、自动同意规则节点上还能挂事件脚本。条件分支靠连线上的表达式决定走向表达式引用的是表单字段字段名写错这条分支永远不命中且不会有任何报错提示。子流程分同步和异步两种。同步子流程要等子流程走完父流程才继续异步子流程发起后父流程直接往下走。选错的影响是流程时序错乱比如父流程已经归档了子流程还在审批中。判断方法很简单业务上父流程的下一步是否依赖子流程的结果依赖就同步不依赖就异步。3.3 流程的容错能力超时、异常、变更、复活这几个是救命的3.4.2 版本在流程上补了一批容错能力这些功能平时用不上出事的时候是唯一的后悔药。超时提醒节点上可以配超时规则超过设定时长给审批人发提醒。消息走的是系统模板里的消息模板或短信模板模板要先在系统管理里配好否则提醒发不出去且日志里不一定有明显报错。异常处理流程节点执行出错时的兜底策略。常见触发场景是节点事件脚本抛异常或者调用的数据接口超时。配了异常处理流程可以停在异常节点等待人工干预而不是整体卡死。自动同意满足条件时节点自动通过常用于「金额小于某值主管节点自动同意」这类规则。要注意它和条件分支的区别——条件分支是跳过节点自动同意是节点照走但自动批。节点变更流程跑到一半需要换审批人。这是实施岗最常用的功能之一人员离职、岗位调整、审批人请假都靠它。变更会留下记录但历史节点已经产生的待办不会自动转移需要配合流程监控手动处理。流程复活流程被终止或异常结束后重新拉起。适合误操作终止的场景。复活后的流程从哪个节点继续取决于配置不是无脑从头开始。配套的还有批量审批、流程评论、流程委托、流程监控。批量审批适合审批人一次性处理几十条同类单据流程委托适合长假前把待办转给别人流程监控是管理员视角能看到全公司流程的卡点和耗时做流程优化时这是唯一的客观依据。3.4 代码生成它能生成什么不能生成什么手册第二章「代码生成」从第 66 页到第 98 页分功能表单和流程表单两条线每条线下又是表单、列表、流程、结果展示四小节结构和在线开发几乎一一对应。这说明代码生成不是另起炉灶而是把在线开发里配好的东西翻译成代码骨架。生成物通常包括实体类、数据访问层、服务层、控制器、前端页面结构。它解决的是「不想从零搭 CRUD」的问题不解决业务逻辑。边界要提前说清楚条件分支里那种跨三张表的复杂计算、需要调用外部系统并处理重试的逻辑、涉及事务边界的批量操作生成的代码只能给你一个空方法逻辑还得自己写。我见过有团队以为点了生成就完事结果上线前发现核心校验全是空的。合理的预期是——生成负责 70% 的重复结构剩下 30% 的业务逻辑是省不掉的但这 70% 已经能省掉大量时间。生成之后的代码就脱离了平台的可视化配置再改表单不会同步回代码。这个单向性必须在动手前讲明白否则后面会出现「平台里改了字段代码里没改线上报错」的经典问题。4. 系统管理与数据应用权限模型和取数链路的真实边界第三章和第四章加起来接近一百页讲的是平台自身怎么配、数据怎么连。这两章在实施阶段被翻得最多因为前面画得再漂亮权限配不对、数据取不到功能就是废的。4.1 系统配置与安全设置上线前必须改的几项系统配置分四块基础设置、安全设置、第三方设置、超级管理员。基础设置管平台名称、Logo、默认首页这类外观和入口。安全设置里有几项上线前必须过一遍图形验证码开关、登录方式账号密码、短信、第三方、账户锁定策略连续失败几次锁定、锁多久。手册在 3.3.1 的修订记录里专门提到新增图形验证、登录方式和锁定账户说明这三项是安全审计的必查项。第三方设置管外部系统对接比如单点登录、消息推送通道。配错了不会立刻报错而是等到用户点登录才发现跳转失败。超级管理员是独立于普通角色之外的一类账号权限最高不受数据权限约束。这个账号的密码策略要单独收紧且不建议日常使用。3.3.3 版本补充了系统公告的发送人员范围也侧面说明平台在往精细化权限走。4.2 系统菜单的四层权限按钮、列表、表单、数据系统菜单这一节从第 123 页排到 137 页五个小节里四个是权限密度很高因为这是整个平台权限模型的核心。权限层级控制对象典型配置错误后果按钮权限页面上的操作按钮只配了菜单没配按钮用户能进页面但看不到新增/删除按钮列表权限列表里可见的列列权限和查询字段不一致能按某字段筛选但列表里看不到这列表单权限表单里可见/可编辑的字段只配了可见没配可编辑字段能看不能改用户以为系统卡了数据权限能查到哪些行规则引用了错误的组织维度页面正常打开数据是空的四层是从粗到细的关系缺一层就出问题。实际项目里最常见的报错是「页面能打开但没数据」八成是数据权限。第二常见的是「按钮不见了」八成是按钮权限漏配。数据权限的规则通常按组织、角色、岗位、本人、自定义SQL几种维度组合。这里有个容易忽略的点数据权限是叠加在菜单权限之上的用户先要有菜单权限才谈得上数据权限。顺序搞反怎么调都没效果。配套的还有分级管理、组织管理、岗位管理、用户管理、分组管理、角色管理、在线用户。分级管理是 3.4.2 新增的用于多层级组织下放管理权限比如让分公司管理员只管自己分公司的人。用户管理里还有重置密码、解除锁定、导入导出其中解除锁定是运维高频操作账号被锁的用户第一时间找的就是这个。4.3 数据应用的六段链路连接、建模、字典、接口、认证、同步系统管理下的数据应用模块有七个小节串起来是一条完整的取数链路。数据连接配置外部数据源支持多种数据库。这一步不通后面全废。连接串里的时区、字符集、连接池参数经常被忽略跨时区部署时会出现时间字段差 8 小时的问题。数据建模把物理表建成逻辑模型供表单绑定和数据接口引用。手册在 1.1.1 里明确说绑定多表时表数据来源于数据建模说明建模是绑定的前置条件。数据字典维护枚举值比如状态、类型、级别。字典的好处是改一处全局生效坏处是一旦被业务数据引用就不能随便删项只能停用。数据接口把查询逻辑封装成接口供子表传递、大屏、报表调用。接口要配参数和返回字段字段名就是前端取数的键。接口认证3.4.2 新增给接口加访问凭证。内部系统互调时经常图省事不开认证等到要过等保测评才发现补不上。数据同步配置源库到目标库的同步任务。同步方向、增量字段、冲突策略三件事必须一次想清楚改起来代价很大。行政区划是配套的基础数据做地址选择、区域统计时用得上一般导入现成的区划数据即可。4.4 调度、缓存、日志、监控运维侧的四件套系统调度管定时任务支持 Cron 表达式和内部方法两种类型3.3.3 版本补的就是内部方法类型。定时任务的坑集中在时区和并发上同一任务上一轮没跑完下一轮又起来数据会重复。配置里如果有「不允许并发执行」这类开关务必打开。系统缓存用于手动清理缓存。改了字典、菜单、权限之后前端没变化第一反应应该是清缓存而不是怀疑配置错了。系统日志分操作日志和登录日志。3.3.3 版本补的操作日志是排障主力谁的什么操作导致了数据变化这里能查到。日志保留周期要提前和运维约定默认值往往偏短。系统监控看的是服务器资源和服务状态。上线初期每天扫一眼能提前发现内存泄漏这类慢性问题。剩下的系统图标、系统模板短信模板、消息模板、打印模板、单据模板属于配置项模板类的东西建议在项目启动阶段就统一配好等到流程跑到一半才发现短信发不出去返工成本高得多。5. 避坑与排查五条踩过才知道的记录这一章记录的是配置阶段最容易翻车的五个点每条按现象、原因、解决的顺序写都是可以在半小时内自查完的。5.1 子表控件拖不进设计区现象拖了一个设计子表控件到画布再拖输入框进去死活放不进去鼠标显示禁止图标。原因设计子表控件没有在右侧组件属性里关联子表。手册写得很清楚关联的子表数据来源于基础设置中添加的子表只有关联之后这个区域才变成可放置的容器。解决回到基础设置确认子表已经添加并保存再回到表单设计选中设计子表控件在右侧下拉里选到对应子表。如果下拉是空的说明基础设置那一步的子表没保存成功或者当前功能是单表绑定压根没有子表结构。5.2 子表传递配完了弹窗里是空白列现象动作设置里配好了数据接口、列表字段、关联字段实际使用时子表弹窗能打开但列表是空的或者列名有、数据没有。原因三种可能。一是数据接口本身的返回字段名和你在设置列表字段里填的字段名不一致二是参数设置区映射的主表字段取不到值接口拿到的筛选条件是空的三是接口没配认证或者认证失效请求被拒但前端只显示了空列表。解决先用接口调试工具单独调一次数据接口确认返回结构和字段名逐个和列表字段配置比对再检查参数映射里选的主表字段在当前表单上是否真的有值最后看接口认证有没有过期。排查顺序按这三步走基本能定位。5.3 流程节点变更后历史待办对不上人现象把审批人从 A 改成 B流程继续往下走了但 A 手上还挂着这条任务的待办B 那边也没收到新的待办。原因节点变更影响的是后续节点的审批人已经生成且未处理的待办不会自动转移。手册里流程监控和流程委托是两套机制前者给管理员用后者给个人用节点变更不在其中。解决变更后用管理员账号进流程监控找到这条流程实例手动处理遗留待办或者让原审批人走流程委托把待办转给新审批人。常态化的人员调整建议在组织管理层面调整岗位和角色而不是逐条改流程节点。5.4 权限全配了用户登进来还是看不到数据现象菜单权限、按钮权限、角色成员都配了用户能进页面列表是空的点新增也正常就是查不到已有数据。原因数据权限没配或者配了但维度选错。常见的错误是给角色配了数据权限但用户是通过分组或岗位进的这个角色两个维度的组织树没对上。解决先用超级管理员账号验证功能本身有没有数据确认不是数据问题再逐层缩小——去掉数据权限看是否能看到全部数据能的话问题就锁定在数据权限规则上。然后检查规则里的组织范围、角色范围是否覆盖了这个用户实际所属的节点。数据权限是最容易配出「看起来对但就是不生效」的一层配完一定要用真实账号验证不要用管理员账号自测。5.5 大屏和报表取数超时现象大屏打开转圈十几秒最后报超时或者显示部分图表无数据。原因大屏的数据源直接指向了业务主表数据量上去之后全表扫描。手册在扩展应用里有「百万数据」示例说明平台本身考虑过大数量级场景但示例归示例实际配置时如果不走索引、不做聚合一样会慢。解决把大屏取数从直连业务表改成走数据接口在接口里做条件过滤和聚合只返回大屏需要的字段高频刷新的图表加缓存确实要实时的大盘控制刷新频率。另外一个常被忽略的点是数据同步任务和大屏查询撞在一起把同步任务挪到业务低峰期能缓解不少。6. 把手册当工具书检索路径与上线前的验证清单这份 PDF 最大的问题是没有索引最大的优势是目录层级足够细。用的时候别从第一页读按任务找入口更快。我自己的三条检索路径是这样的。第一条按模块定位手上要做审批流直接翻第 197 页的「工作流程」从 5.1 流程设计开始看跳过前面所有内容。第二条按功能名反查不确定某个能力在哪个模块用阅读器的全文搜索搜具体的功能词而不是概念词比如搜「行内编辑」「超时提醒」「接口认证」这些是 3.4.2 新增的词命中率比搜「权限」「流程」高得多。第三条按修订记录定位文档开头的修订记录其实是一份变更索引3.4.2 那一行列出的超时提醒、异常处理、自动同意、节点变更、流程复活、子表传递、分级管理、接口认证、高级查询、行内编辑、子系统全是这一版的重点配置时优先确认这些能力有没有被用上。上线前我会强制过一遍下面这张清单每一项都是踩过之后加进去的检查项判定标准出问题的代价主键策略新建功能时已确定未在流程运行后修改历史数据 ID 规则混乱并发锁定涉及额度、库存、余额的表单已开启并发覆盖数据对不上且无法复盘数据权限用真实业务账号非管理员验证过列表有数据上线当天用户报「系统没数据」子表关联设计子表控件已在组件属性里绑定子表控件拖不进去表单设计卡死数据接口认证所有被前端调用的接口都已配认证且未过期数据泄露或接口被拒定时任务并发同一任务不允许并发执行数据重复写入消息模板流程提醒用到的模板已配置并测试发送成功超时提醒静默失败没人发现移动端表单和列表的移动端已单独设计并真机验证手机端横向滚动无法使用缓存清理改完字典/菜单/权限后已清缓存再验证误判为配置错误反复返工代码生成边界已明确哪些逻辑由生成代码承担、哪些需手写上线前发现核心校验为空最后说一个习惯。我现在拿到任何一份平台手册都会先用十分钟把修订记录和目录抄成一张两列的表格左边是「这一版新增了什么」右边是「我的项目用不用得上」。抄完之后手册里哪些页要精读、哪些页只需要知道存在就一目了然了。这个动作花十分钟能省掉后面几小时的盲目翻阅。希望帮到你。本文还有配套的精品资源点击获取