简介JNPF软件开发平台V3.4.2操作手册由福建引迈信息技术有限公司发布面向使用该低代码平台的开发者与实施人员帮助其系统掌握产品各项功能。手册围绕在线开发、门户设计、大屏设计、代码生成与系统管理五大模块展开其中在线开发细分为表单、列表、流程与结果展示大屏设计涵盖大屏、地图、分类与数据源管理代码生成则包含功能表单与流程表单系统管理涉及系统配置、公告、调度、缓存、日志、监控、图标与菜单权限等内容目录层级清晰便于按模块查阅。资源为1个PDF文件压缩包约40.01MB适合作为日常开发与配置的案头参考。目前已有1339人学习下载读者可借此快速定位功能入口、理解配置逻辑减少摸索成本提升平台落地效率。1. 拿到一份 JNPF 产品功能使用手册先别急着翻目录很多团队在低代码选型时第一反应是让厂商发一份产品功能使用手册然后从头读到尾。我见过不止一个开发者把 JNPF 产品功能使用手册_v3.4.2.pdf 这类文档当成小说看翻了两百多页合上之后还是不知道从哪下手。问题不在文档在于读法。这份手册本质是一份功能地图不是教程它告诉你平台有什么但不告诉你先配什么、后配什么、哪些参数改了会连锁反应。如果你正在做企业内部系统比如审批流、进销存、项目管理看板又不想从零写前后端JNPF 这类低代码平台值得花两天认真摸一遍。这篇笔记按我自己的落地顺序拆先搞清楚它的功能分层再跑通一个最小表单到流程的闭环然后讲权限、数据源、打印模板这些容易翻车的地方最后给一套版本升级前的自检习惯。适合有一两年后端基础、准备把低代码引入生产环境的工程师。2. 先看懂 JNPF 的功能分层从表单引擎到流程引擎的调用关系2.1 手册里没明说但必须理解的三层结构JNPF 产品功能使用手册_v3.4.2.pdf 的目录通常按模块罗列表单设计、流程设计、报表、权限、系统管理。但实际运行时这些模块不是平级的而是三层依赖关系。最底层是数据模型层表单设计器里拖出来的每一个控件最终都会映射成数据库表的一个字段。中间层是逻辑编排层流程引擎、业务规则、定时任务都在这一层消费数据模型。最上层是展示与交互层包括列表页、报表、大屏、移动端。理解这个分层的好处是当你在流程节点里取不到表单数据时你就知道该去检查数据模型层有没有正确生成字段而不是在流程设计器里反复改表达式。手册里不会写“先建数据模型再建流程”但这是实际操作的唯一顺序。2.2 功能模块的依赖顺序与最小可用路径我一般建议按这个顺序走一遍数据模型 → 表单 → 流程 → 菜单 → 权限 → 报表。每一步都验证通过再进下一步。最小可用路径是建一张请假单表拖一个表单绑定它配一条两级审批流程挂到菜单上给一个测试角色授权然后提交一条数据看流程是否流转。这个路径跑通之后再回头看手册里的高级功能比如子表、关联查询、打印模板、API 编排你就能判断哪些是当前项目真正需要的。手册里每个功能都有截图和参数说明但截图是静态的参数说明是孤立的只有在你跑通过一次完整链路之后这些说明才有上下文。2.3 用一张对照表把手册章节映射到实际配置入口手册章节实际配置入口前置依赖常见误用表单设计表单管理 → 新建表单数据模型已建先建表单再补数据模型导致字段类型对不上流程设计流程管理 → 新建流程表单已发布流程节点里直接写死审批人换人就要改流程权限管理角色管理 → 数据权限菜单已配置只配菜单权限不配数据权限用户能看到全部数据报表设计报表管理 → 新建报表数据模型有数据报表直接查业务表不走模型层字段变更后报表崩系统管理系统设置 → 参数配置无改全局参数不记录升级后配置丢失这张表不是手册里的是我自己在配置时反复对照总结的。手册告诉你每个模块有什么按钮这张表告诉你按钮之间的先后关系。3. 跑通第一个闭环表单绑定数据模型到流程审批的最小步骤3.1 建数据模型时字段类型怎么选才不返工数据模型是地基。JNPF 的数据模型设计器里字段类型有文本、数字、日期、下拉、关联、附件等。新手最容易犯的错是把“部门”建成文本字段后面想做数据权限过滤时发现没法按部门隔离。正确做法是凡是需要参与权限过滤、流程条件判断、报表分组的字段一律用关联字段或下拉字段不要用文本。另一个坑是字段长度。手册里默认文本字段长度是 200如果你存的是 JSON 或长文本提交时会静默截断前端不报错后端存进去少一截。我一般把备注类字段直接设成 2000 或 text 类型避免后期改表。-- 这是 JNPF 数据模型底层生成的表结构示例简化 -- 实际表名由平台按规则生成不要手动改表名 CREATE TABLE form_leave_apply ( id VARCHAR(32) PRIMARY KEY, -- 平台自动生成的主键 apply_no VARCHAR(50) NOT NULL, -- 单号建议用规则生成 applicant VARCHAR(32), -- 申请人ID关联用户表 dept_id VARCHAR(32), -- 部门ID用于数据权限过滤 leave_type VARCHAR(20), -- 请假类型下拉字段 start_time DATETIME, -- 开始时间 end_time DATETIME, -- 结束时间 reason TEXT, -- 事由长文本 status INT DEFAULT 0, -- 流程状态0草稿 1审批中 2通过 3驳回 create_time DATETIME DEFAULT CURRENT_TIMESTAMP );这段 SQL 不是让你手动执行而是帮你理解平台在背后做了什么。关键参数是dept_id和status前者决定数据权限能不能按部门隔离后者决定流程引擎能不能正确回写状态。如果你在数据模型里没建这两个字段后面流程和权限都要返工。3.2 表单设计器里三个必须手动改的默认设置表单设计器拖完控件后有三处默认值必须改。第一字段绑定要确认绑定到正确的数据模型字段默认可能绑到临时字段。第二必填校验要手动开默认是不校验。第三提交按钮的保存动作要选“保存并提交流程”默认可能只是“保存草稿”。// 表单提交前的前端校验逻辑在表单事件里配置 // 这段代码放在“提交前”事件中用于拦截明显不合规的数据 function beforeSubmit(formData) { // 结束时间必须大于开始时间 if (formData.start_time formData.end_time) { if (new Date(formData.end_time) new Date(formData.start_time)) { throw new Error(结束时间必须晚于开始时间); } } // 请假天数不能超过15天超过走特殊流程 var days (new Date(formData.end_time) - new Date(formData.start_time)) / 86400000; if (days 15) { throw new Error(超过15天的请假请走特殊审批流程); } return true; }这段校验逻辑放在前端事件里目的是减少无效流程实例。参数说明formData是表单当前数据对象字段名要和数据模型字段名一致。注意前端校验可以被绕过关键业务规则还要在流程节点或后端接口里再校验一次。3.3 流程节点里审批人用变量而不是写死人名流程设计器里审批人设置是最容易翻车的地方。新手直接选具体人员结果请假的审批人离职了流程卡住。正确做法是用变量审批人 申请人所在部门的负责人或者审批人 角色为“部门经理”的用户。JNPF 流程引擎支持表达式取审批人常见写法是引用表单字段或系统变量。比如$form.dept_id取表单里的部门ID然后通过组织架构接口查到该部门负责人。手册里会列出可用变量但不会强调“永远不要写死”。// 流程节点审批人表达式示例 // 取申请人部门的负责人作为审批人 var deptId $form.dept_id; var leaderId orgService.getDeptLeader(deptId); if (!leaderId) { // 找不到负责人时回退到指定角色 leaderId orgService.getUserByRole(backup_manager)[0].id; } return leaderId;这段表达式的逻辑是优先取部门负责人取不到则回退到备用角色。参数说明orgService是平台内置的组织架构服务getDeptLeader和getUserByRole是常用方法。注意回退逻辑一定要有否则组织架构不完整时流程会直接报错。4. 权限、数据源与打印模板三个最容易翻车的配置区4.1 菜单权限和数据权限是两套东西很多人配完菜单权限就以为权限配完了结果用户登录后能看到全部数据。菜单权限控制的是“能不能看到这个页面”数据权限控制的是“在这个页面里能看到哪些数据”。JNPF 的数据权限通常在角色管理里配按部门、按用户、按自定义规则过滤。我一般给每个业务表都加一个dept_id或create_by字段然后在数据权限里配“只能看本部门数据”或“只能看自己创建的数据”。这样即使菜单权限配错了数据也不会泄露。4.2 外部数据源接入时连接池和超时怎么设JNPF 支持接入外部数据库作为数据源。手册里会写支持 MySQL、SQL Server、Oracle 等但不会告诉你连接池怎么设。我踩过的坑是默认连接池太小并发一上来就报“等待连接超时”。一般把最大连接数设成 20 到 50具体看数据库承载能力。超时时间设 30 秒不要设太长否则一个慢查询会拖垮整个页面。# 外部数据源配置示例在系统管理 → 数据源里填写 datasource: name: erp_db type: mysql url: jdbc:mysql://192.168.1.100:3306/erp?useSSLfalseserverTimezoneAsia/Shanghai username: readonly_user password: ****** pool: maxActive: 30 # 最大连接数按并发量调整 maxIdle: 10 # 最大空闲连接 minIdle: 5 # 最小空闲连接 maxWait: 30000 # 获取连接超时时间单位毫秒 validationQuery: SELECT 1参数说明maxActive是并发上限设太小会排队设太大数据库扛不住。maxWait是拿不到连接时的等待时间超过就抛异常。validationQuery用于检测连接是否有效MySQL 用SELECT 1。注意外部数据源的用户权限要最小化只给查询权限不要给写权限。4.3 打印模板的字段映射和分页控制打印模板是低代码平台里最容易被低估的模块。手册里可能只有两页讲打印但实际项目中请假单、报销单、合同都要打印。JNPF 的打印模板通常用类 Word 的编辑器字段用占位符映射。常见翻车点字段名写错导致打印出来是空白表格行数多了不会自动分页内容被截断。解决办法是字段占位符直接从数据模型里复制不要手打分页用模板里的“分页符”控件不要靠回车换行。5. 避坑与排查JNPF 配置过程中最常见的五个问题5.1 流程提交后状态不更新现象表单提交成功流程也走完了但列表页状态还是“草稿”。原因流程节点里没有配置“更新表单状态”的动作或者更新动作绑定的字段不对。解决在流程结束节点加一个服务任务调用数据模型更新接口把status字段改成对应值。检查字段名是否和数据模型一致。5.2 子表数据保存后丢失现象主表保存成功子表数据没了。原因子表的数据模型没有和主表建立外键关联或者表单提交时子表数据没有一起提交。解决在数据模型里给子表加一个parent_id字段表单设计时把子表控件绑定到该字段。提交前确认子表数据在formData的数组里。5.3 报表查询慢到超时现象报表页面加载超过 30 秒最后报超时。原因报表直接查业务表没有走数据模型层或者查询条件没有走索引。解决报表数据源改成数据模型不要直接写 SQL 查物理表。如果必须写 SQL确保查询字段有索引并且加LIMIT限制返回行数。5.4 移动端页面错乱现象PC 端正常移动端打开表单控件重叠。原因表单设计时用了固定宽度没有用响应式布局。解决在表单设计器里把控件宽度改成百分比或者用平台提供的移动端专用模板。手册里通常有移动端适配章节但容易被跳过。5.5 版本升级后自定义配置丢失现象从 v3.4.1 升到 v3.4.2 后之前配的数据源、打印模板、流程表达式不见了。原因升级脚本覆盖了配置文件或者自定义配置没有放在平台推荐的扩展目录里。解决升级前备份数据库和配置文件自定义配置尽量用平台提供的扩展点不要直接改核心文件。升级后逐项检查数据源、流程、权限、打印模板。6. 版本升级前的自检清单与一个省时间的技巧升级前我一般做四件事。第一导出所有数据模型和表单定义存成 JSON 文件。第二导出流程定义特别是审批人表达式和条件分支。第三备份数据库包括平台库和业务库。第四在测试环境先升一遍跑通核心流程再动生产环境。一个省时间的技巧是把手册里每个模块的配置入口截图保存升级后对照截图逐项检查。因为手册版本和实际版本可能有细微差异截图比文字更可靠。另外JNPF 产品功能使用手册_v3.4.2.pdf 里的参数说明我习惯用批注工具标上“已配”“待验证”“不适用”下次升级时直接看批注不用重新翻。# 升级前备份脚本示例在服务器上执行 # 备份平台数据库 mysqldump -u root -p jnpf_platform /backup/jnpf_platform_$(date %Y%m%d).sql # 备份业务数据库 mysqldump -u root -p jnpf_business /backup/jnpf_business_$(date %Y%m%d).sql # 备份上传的附件和打印模板 tar -czf /backup/jnpf_uploads_$(date %Y%m%d).tar.gz /data/jnpf/uploads # 备份自定义配置文件 cp -r /data/jnpf/config /backup/jnpf_config_$(date %Y%m%d)这段脚本的关键是备份三样东西数据库、附件、自定义配置。参数说明jnpf_platform和jnpf_business是示例库名实际按部署时的库名改。/data/jnpf/uploads是附件目录/data/jnpf/config是配置目录。注意备份文件要存到另一台机器或对象存储不要放在同一块盘上。我自己的习惯是每次升级前把手册里对应的版本号页拍个照升级后核对版本号是否一致。有一次升级完发现版本号没变排查半天才发现升级包没覆盖成功。这个习惯帮我省过至少两次回滚。希望帮到你。本文还有配套的精品资源点击获取