★ FEATURED ARTICLE 简介由福建引迈信息技术有限公司发布的JNPF软件开发平台V3.4.2操作手册以PDF格式封装共1个文件、约40.01MB适合JNPF产品开发与实施人员查阅。手册覆盖在线开发、门户设计、大屏设计、代码生成、系统管理五大核心模块其中在线开发部分详述表单设计、列表设计、流程设计与结果展示门户设计和大屏设计分别介绍新建门户、大屏管理、地图管理、分类管理及数据源管理等内容系统管理部分从基础设置、安全设置、第三方设置到超级管理员均有说明并延伸至系统公告、系统调度、缓存、日志、监控与菜单权限配置。读者可按章节对照学习掌握从功能表单到流程表单的代码生成路径快速搭建在线应用与大屏页面。已有1341人学习适合初次接触JNPF平台的用户按图索骥也可作为已有项目的配置参考手册。1. JNPF V3.4.2 手册怎么读把表单、列表、流程这条链路的关系先看懂花一个下午把这份 JNPF V3.4.2 操作手册翻完最大的感受是低代码平台真正值钱的不是拖拽控件本身而是它把“表单—列表—流程—权限—数据”这条链路的关系讲清楚了。很多人拿到手册直接翻表单设计把流程类型当普通表单建等流转要跑起来才发现缺了一堆配置。手册按在线开发、代码生成、系统管理、系统权限、工作流程、扩展应用六个大块组织V3.4.2 新增的流程超时提醒、异常处理、自动同意、接口认证、分级管理都有带截图的操作路径。章节编号可以直接当索引用查功能按标题跳就行。适合刚接手 JNPF 项目、要做功能配置的实施人员也适合想弄清“在线开发”和“代码生成”边界在哪的二开开发者。前者按第 2 章顺序做后者重点看系统管理与数据应用那段权限链路。2. 在线开发功能设计的三种类型、数据表绑定与脚本事件2.1 功能设计入口查询、重置、导入与新建表单在线开发目录下进入功能设计页面顶部是一组操作查询、重置、刷新、导入、新建表单。查询按名称或编码筛出已有的设计项重置清空筛选条件刷新拉取最新数据导入负责把另一套环境里导出的功能设计包拿进来复用。列表本身就是一个功能设计台账新建、编辑、删除、结果展示都从这里进入。新建表单时必须在表单、列表、流程三种类型里选一个。三者基础设置和表单设计几乎一样区别从列表设计和流程设计开始分叉。我一般先问一个问题这个功能的最终形态是什么只要数据填报就选表单要查询、分页、多行编辑就选列表要走审批流转就选流程。选错类型不是不能改但字段和节点都配了一轮之后的返工量比自己以为的大得多。下面这张表是三类表单的选型依据新建前对着看一眼能少走弯路新建类型配置链路典型场景表单基础设置 表单设计单条数据录入、填报界面列表基础设置 表单设计 列表设计数据管理页带查询、分页、行内编辑流程基础设置 表单设计 流程设计需要审批流转的业务单据提示类型在新建时就定死方向比建完再改省事。流程表单和列表表单在运行视图上完全不同不要用“先建了再说”的思路。2.2 基础设置与数据表绑定主表 mt功能 ID 的命名规则新建后进入基础设置。这里有两个选择不设置数据连接平台会在流程新建完成后自动创建数据表主表命名规则是“mt功能 ID”子表是“ct雪花 ID”如果已经有了数据模型就下拉选择数据连接点“新增一行”进入数据选择页面绑定数据建模里维护的表支持单表或多表。自动建表适合快速验证原型但生产环境我建议绑定自建表。自动建出来的表名是 mt 开头加一串 ID后续写 SQL 报表、做数据同步时表名可读性很差字段含义全靠表单里去猜。真到报表阶段再回头看表名就是个黑匣子只能打开表结构对着字段一个个认。选多表时必须配两样东西子表的外键字段和关联主键。手册写得很明确主表和子表通过外键字段建立关联不配置的话流程发起后子表数据要么为空要么写入失败。这个环节最容易翻车保存时平台会做合法性校验但运行时的写入错误要盯后端日志才看得见前端往往只给一个含糊的失败提示。2.3 表单设计控件字段映射、副表子表与多端显示基础设置完成后点下一步进入表单设计页。左侧控件区按基础控件、高级控件、系统控件分组点击或拖拽到画布右侧集中配置组件属性、组件样式、表单属性顶部提供预览、清空、桌面端与移动端切换预览。组件属性里最关键的是“控件字段”下拉框。有表设计时每个控件必须下拉选择它关联表的字段名控件值才会写进对应字段。下拉框支持快捷新建字段点添加弹出字段设置窗口展示当前数据表已有字段不允许修改点新建字段会新增一行空白行自定义字段名和类型。字段类型和控件类型要匹配数字字段绑到文本控件上提交时容易触发类型转换问题这类错误在列表查询排序时尤其明显。组件样式里可以配控件栅格、标题宽度、多端显示。多端显示通过勾选决定控件在桌面端还是移动端展示默认全选中。实际项目里移动端表单一般会精简字段把“多端显示”理解成“哪端展示这个控件”而不是“哪端能编辑”就不会配错。表单是多表设计时可以拆成副表加子表、两个副表、两个子表几种组合。副表设计直接选控件在右侧数据库表里关联副表再选控件字段子表要先拖“设计子表”控件在组件属性里关联子表再往子表控件区域拖字段控件。子表支持合计设置和动作设置合计字段只能从单行输入、数字输入、计算公式里挑多选后运行时子表下方会展示合计栏。2.4 组件事件与表单事件JavaScript 脚本的联动写法组件属性支持自定义组件事件触发时机有“发生变化时触发”和“失去焦点时触发”。点击事件进入代码区域编写 JavaScript。手册给了一个典型联动场景下拉控件值不同分别触发赋值、隐藏、设必填脚本思路如下// 下拉选择控件“发生变化时触发”脚本 if (value a) { // 选 a 时给 fieldA 赋固定值 1 this.form.fieldA 1; } else if (value b) { // 选 b 时给 fieldB 赋固定值 2 this.form.fieldB 2; } else if (value c) { // 选 c 时隐藏 fieldC 控件 this.form.fieldC.visible false; } else if (value d) { // 选 d 时把 fieldD 设为必填 this.form.fieldD.required true; }value 是当前控件变化后的值this.form 是表单数据模型fieldA 这些是控件绑定的字段名。脚本在前端上下文执行写完一定用预览把每条分支点一遍而且桌面端和移动端都要看——visible 和 required 在两端的表现并不完全一致。表单属性层还有三个表单事件表单加载触发、提交前置触发、提交后置触发分别适合做回显、整体校验、业务日志。主键策略支持雪花 ID 和自增长 ID流程保存后不可修改建表单前就要定好并发锁定开启后启用乐观锁机制高并发提交场景建议打开提交冲突时平台会拦截并提示。3. 列表与流程设计查询字段、子表合计与审批节点的配置顺序3.1 列表设计列表属性、列表字段与查询字段新建类型选列表时配置链路是基础设置、表单设计、列表设计三步。列表设计分三块列表属性控制表格整体行为列表字段决定表格展示哪些列查询字段决定顶部筛选区放哪些条件。V3.4.2 还新增了高级查询、行内编辑、列表查询高级查询让用户自己组合筛选条件行内编辑允许在表格里直接改值再保存列表查询是普通查询区的增强入口。桌面端与移动端切换分别设计是列表设计里经常被忽略的一步。PC 端列多可以全字段展示移动端通常只留关键列和操作按钮。忘了切端去调PC 端排好的列表在手机上要么列挤成一团要么操作按钮被截断这种问题到验收才被发现就很被动。列表字段里字段顺序决定展示顺序宽度和对齐方式按列单独配置。查询字段要克制别把所有字段都堆进筛选区。常见做法是放三到五个高频筛选条件其余交给高级查询兜底不然查询区本身就把页面撑得很难看。3.2 子表合计与动作设置合计类型限制和远端数据联动子表配置有两个进阶能力合计设置和动作设置。合计设置开启后流程使用时子表下方展示合计栏可多选合计字段但只识别子表内单行输入、数字输入、计算公式三种类型。复选框、日期、下拉这类字段勾了也不参与计算这个限制很容易在验收时才发现建议配置时就按类型筛一遍。动作设置实现的是“弹窗选数据、自动填子表”。先在配置表单窗口里设置弹窗标题、弹窗类型居中或右侧、弹窗宽度再选远端数据联动数据源来自数据接口模块维护的接口最后设置列表字段和关联字段映射。接口参数联动逻辑如下数据接口含有的参数会自动展示到参数设置区域下拉表单字段选主表字段子表添加数据时接口返回数据会根据参数调用所设表单字段作为筛选内容再展示给用户选择。关联字段映射里目标表单字段的映射来源支持接口字段和固定值固定值适合写死状态标记这类业务常量。3.3 流程设计基础信息、表单设计与审批节点配置流程类型的功能设计在基础设置、表单设计之外多一个流程设计步骤按基础信息、表单设计、流程设计的顺序走。流程设计里完成节点编排、审批设置、候选人、节点事件等配置。V3.4.2 在流程侧补了一批能力超时提醒、异常处理、自动同意、节点变更、流程复活、子表传递。超时提醒按节点配置提醒时间和提醒对象审批卡住时自动提醒不用人工盯异常处理是节点执行失败后的兜底动作自动同意是满足条件时节点自动通过适合请假这类低风险审批子表传递解决主子表数据跨节点传递的问题配不好会出现子表数据在后续节点丢失这是多级审批场景的高频问题。审批设置里几个常用项候选人决定节点谁能审批保存草稿让发起人可以中途存草稿节点事件支持在节点进入和离开时挂脚本审批汇总和流程评论用于多级审批场景。运行时用户在我发起的、待办事宜、已办事宜、抄送事宜里处理管理员在流程监控里干预异常流程流程委托可以把一段时间内的审批权委托给别人出差时不用干等。3.4 结果展示与发布自检按三个动作验收功能设计配置完成后点确定回到列表更多操作里可以查看结果展示。结果展示看到的是配置生成后的成品页面和设计态的预览不是一回事设计态预览看布局成品页面看真实交互。我发布前固定按三个动作过一遍表单预览看字段和事件是否正常列表查询看筛选条件是否命中流程发起走一遍看审批流转是否按节点顺序执行。有权限相关配置时还要换一个非管理员账号登录验证按钮权限和数据权限是否按预期生效这一步省不掉管理员视角永远看不出普通用户的问题。4. 系统管理与数据应用菜单权限、数据建模与接口认证的配置链路4.1 系统菜单新建菜单、子系统与四类权限系统管理下的系统菜单是权限落地的核心入口。新建菜单要配置菜单类型、上级菜单、路由、排序导入导出支持跨环境迁移菜单配置换环境部署时不用重搭菜单树。V3.4.2 在系统菜单里增加了子系统多系统场景用子系统做顶级节点每个子系统下挂自己的菜单比所有菜单混在一棵树上好维护得多。权限模型分四类按钮权限、列表权限、表单权限、数据权限它们的控制范围差异如下表权限类型控制范围配置位置按钮权限页面上新增、编辑、删除、导出等按钮的显隐系统菜单 → 按钮权限列表权限列表字段的可见性系统菜单 → 列表权限表单权限表单字段的可见、可编辑、必填系统菜单 → 表单权限数据权限用户可见的数据行范围系统菜单 → 数据权限这四类权限在角色管理里分配给角色角色再挂用户。V3.4.2 把系统菜单权限字段去掉了手输改成下拉选择减少手输错误导致的权限不生效。新增的分级管理还可以在公司、部门、岗位层级上做权限下放总部配好模板下级单位按分级规则继承适合多组织架构。4.2 数据应用数据连接、数据建模与数据字典数据应用模块包含数据连接、数据建模、数据字典、数据接口、接口认证、数据同步、行政区划七块。数据连接维护数据库连接串数据建模在上面建业务表数据字典维护下拉选项等枚举值数据同步解决跨库或跨系统数据同步行政区划一般直接引用内置的区划数据。我习惯在数据建模阶段就把字段类型、长度、默认值定清楚。后续在线开发的控件字段下拉、列表字段展示、报表取数都依赖这一步建模草率后面全是返工。数据字典适合做全局枚举比如状态 0/1 对应停用/启用表单下拉控件直接引用字典项避免每个表单各写一套后续要调整枚举只改字典一处不用动表单。4.3 数据接口与接口认证取数与鉴权配置数据接口是动作设置、子表传递、大屏数据源取数的出口接口返回的数据结构直接决定前端展示。接口认证是 V3.4.2 新增的鉴权配置外部系统调用接口前先通过认证换取凭证再带凭证访问业务接口。配置要点在认证类型和参数顺序配置界面里把认证地址、请求参数、凭证字段填对先做接口测试通过后再挂到业务场景。第三方对接场景我一般先在内网环境把认证链路调通再切生产连接串避免认证失败和业务报错混在一起排查。接口测试时要盯返回结构平台对接口返回格式有约定字段名对不上展示层会拿到一堆空值问题看起来像数据问题其实是字段映射问题。4.4 系统配置与运维安全设置、调度、模板、日志与在线用户系统配置分基础设置、安全设置、第三方设置、超级管理员四块。安全设置包含图形验证、登录方式、锁定账户按审计要求配好登录失败锁定阈值能挡住一部分暴力尝试。系统调度支持内部方法类型定时任务可以直接调用平台内部方法比裸写脚本可靠。系统缓存、系统日志、系统监控分别负责缓存清理、操作日志追溯、运行状态观察。系统模板里的短信模板、消息模板、打印模板、单据模板分别对应通知内容和单据编号规则。打印模板经常要按真实单据尺寸调整建议先按实际纸张出一版再迭代。单据模板控制单据编号格式订单号、申请号的前缀和流水位都在这里定义。运营层面在线用户模块能看到当前登录会话排查谁占了并发数、异常登录从哪个终端进来比翻日志快得多。系统公告和消息中心是通知触达的另外两个出口公告支持发送范围消息中心集中查看站内消息。5. 避坑指南V3.4.2 配置里最容易翻车的 5 个点前面几章把配置链路走完了这一章集中写实际搭建过程中反复踩过的坑。V3.4.2 的大多数问题不是功能缺失而是配置项之间的联动关系没理清。以下按“现象、原因、解决”展开每一条都能在配置界面上直接验证。5.1 主键策略保存后改不了建表单前就定雪花还是自增现象表单流程已经保存并跑过数据想把自增长 ID 改成雪花 ID保存时提示不可修改。原因主键策略在流程保存后锁定避免主键生成方式变更导致历史数据错乱。手册里对“流程保存后不可修改”写得很清楚但不少人等到数据量上来、要合并数据库时才想起来改。自增长 ID 在分布式部署下还可能撞号雪花 ID 没有这个问题但可读性差两者取舍要在建表单前定。解决项目初始化时统一约定主键策略。多库合并、数据迁移场景选雪花 ID单库单表单用自增长 ID 够用。真需要改就新建表单再迁移数据不要指望直接改字段这不是配置问题是数据一致性问题。另外子表建议跟主表保持同一策略混用会在关联查询时出现主键类型不一致的隐患。5.2 子表合计不显示或合计错误合计字段类型卡得死现象子表合计开关开了运行时子表下方没有合计行或者合计结果不对。注意合计栏出现的位置在子表区域底部不是每一行右侧很多人以为没生效其实是看错了位置。原因合计字段只识别子表内单行输入、数字输入、计算公式三种类型字段类型不在范围内勾了也不参与计算。解决回表单设计检查子表字段类型要合计的字段改成数字输入或计算公式。有多个合计字段时确认数值类型统一避免出现“1212”这种字符串拼接式的合计结果。配置完成后用预览跑一遍带小数的数据确认合计列的顺序和精度符合预期再发布。5.3 控件字段下拉找不到新字段先保存基础设置再进表单设计现象数据建模里新建了字段回到功能设计控件字段下拉列表里刷新不出来看起来像权限问题或数据源配置问题。原因控件字段来源是当前关联的表结构建模新增字段后功能设计打开时加载的是本次会话的表结构快照没有同步刷新。这类缓存问题有时候看着像玄学但本质上就是快照过期。解决先保存基础设置并重新进入表单设计页还不行就同步菜单后再试。如果基础设置里中途换过数据连接也要重新进入一次。这是缓存类问题刷新页面重进通常能解决别急着怀疑权限配置或数据库连接串那样排查方向就偏了。5.4 流程节点通知收不到节点通知和消息模板是两套配置现象审批流转到某个节点审批人没收到待办通知但流程本身流转正常。打开待办事宜这条记录其实在就是没有站内信或短信提醒。原因V3.4.2 流程节点通知改造后节点通知配置和系统模板里的消息模板是两套独立配置。节点开了通知但模板没启用或模板启用了但发送方式不对都会丢通知。解决流程设计里检查该节点的通知开关、通知对象系统模板里确认消息模板已启用。站内信走消息中心短信走短信通道要按通知场景分别确认别只配一种。两处都确认后再跑一次流程验证别只看节点配置就认为没问题。5.5 并发提交覆盖数据表单属性开启并发锁定现象两个用户同时打开同一单据编辑后提交的人把先提交的人的数据覆盖了没有任何冲突提示。这个问题在审批流里更隐蔽中间有节点流转数据被覆盖后很难追溯是谁改的。原因默认没有乐观锁后提交者基于旧版本数据覆盖写入。开启并发锁定后每次提交版本号加一版本不一致时后提交者拿的是旧版本号会被平台拦截。解决表单属性里开启并发锁定提交时启用乐观锁机制版本不一致时提示冲突由用户决定是否覆盖。高并发填报、高频编辑的表单建议全局开启同时给用户一句明确的冲突提示文案并给出“刷新最新数据”或“强制覆盖”两个出口不然会被当成系统 bug 报上来。6. 代码生成与扩展应用用内置示例跑通从配置到二开的衔接6.1 代码生成的定位在线配置与工程源码的分工代码生成模块分功能表单和流程表单功能表单下又有表单、列表、流程三类。它把在线开发的配置结果落成工程源码适合需要在现有工程里继续二开的团队。两者的边界在于在线开发以配置为主代码生成以产出源码为主。后续需求改动优先改配置还是改代码项目里要定个规矩。我建议主体功能留在在线开发里改二开只做平台覆盖不了的定制逻辑。在一个模拟项目里做订单管理功能时我就是先把表单、列表、流程配齐再用代码生成导出在生成代码里补了一个平台没有的库存校验逻辑。配置打底、代码补定制这条路线比纯代码路线稳得多。6.2 扩展应用当参考模板订单示例、百万数据与打印示例扩展应用是理解 JNPF 能力边界最快的入口。功能示例、门户示例、报表示例、大屏示例覆盖配置类场景表单示例、表格示例、图表示例覆盖组件类场景订单示例、项目管理覆盖完整业务闭环把表单、列表、流程、数据关系全部串起来。我拿到新环境的第一件事是把订单示例跑一遍看它怎么组织主表子表、怎么配流程节点、数据关系怎么落库再决定自己的业务模块按什么结构拆。百万数据示例拿来验证列表在大数据量下的性能导入导出示例验证大批量数据交换打印示例验证单据格式。这些都是现成的验证工具比自己造数据快得多。6.3 验证与交付按预览、发起、监控、日志四步自检一个功能交付前我固定按四个动作过一遍表单预览看字段与事件发起流程看数据落库流程监控看节点流转系统日志看异常记录。四个动作都正常才把功能交给业务验收。从 V3.4.2 的修订记录看每个版本都在补权限和流程的边界情况——数据权限、表单权限、流程异常处理这些恰恰是实施中最容易出问题的部分。从那以后我每次接手 JNPF 项目第一件事都是把修订记录从头到尾看一遍这份手册的 PDF 也一直放在项目文档目录里配置前先翻对应章节比临时找在线文档快。别高估自己的记忆力也别低估配置项之间的联动。希望帮到你。本文还有配套的精品资源点击获取
阅读完成 · 觉得有帮助？
