简介JNPF软件开发平台V3.4.2操作手册由福建引迈信息技术有限公司编制是一份面向JNPF产品使用者的功能指南适合低代码开发人员、项目实施与系统管理人员参考学习。压缩包内为单个PDF文件大小40.01MB目录涵盖在线开发、门户设计、大屏设计、报表设计、代码生成与系统管理六大模块每个模块均按功能拆解为具体操作章节结构清晰便于按需检索。手册详细介绍了表单设计、列表设计、流程设计和结果展示的在线开发步骤门户与大屏的新建、地图、分类和数据源管理方法以及功能表单、流程表单的代码生成流程系统管理部分则覆盖系统配置、公告、调度、缓存、日志、监控和菜单权限等运维功能。目前已有1339人学习下载可作为JNPF V3.4.2平台的上手教程与日常配置参考帮助开发与管理人员快速定位功能、理解参数含义。1. 程序员才做的软件现在你也可以拖出来先认识 JNPF 到底是什么第一次听说 JNPF你可能会冒出三个问题它是个编程框架吗是不是要会写代码才能用我这种零基础的新手碰它会不会太早我第一次接触它的时候这三个问题在我脑子里转了好几圈。把话说直白一点JNPF 是一个低代码软件开发平台它把过去一行行敲代码才能做出来的业务系统变成了像拼乐高一样拖拖拽拽就能搭出来。表单、列表、审批流程、数据报表、大屏看板这些传统开发里很费劲的东西在这里都有可视化的编辑页面。你不用先学会 Java 或写前端只需要理解业务逻辑就能动手做出一个能真正运行的应用。如果你正想学一套能快速落地业务系统的工具或者受够了被开发排期卡住的日子这篇入门就能带你迈出第一步。2. 先搞懂一个概念低代码到底在解决什么问题很多人第一次听到“低代码”三个字容易把它理解成“代码少一点”甚至觉得是“不用写代码的玩具”。这个误会如果带着上路后面很容易翻车。这一章我们先把概念掰开揉碎再告诉你 JNPF 真正帮你省掉的是什么。2.1 “拖拽生成系统”到底是怎么一回事传统开发一个管理系统流程大致是这样的业务部门提需求开发人员写后端接口、建数据库表、写前端页面、联调、测试、上线。一套下来少说几周多则几个月。中间只要需求变一次前后端都要跟着改排期又往后推。JNPF 换了一个思路它把系统开发里最常用、最重复的部分提前做成了一个个有图形界面的积木块。你负责拼积木它负责把积木转换成真正能运行的代码和页面。比如你想做一个“客户信息登记表”不用去写表单页面的 HTML 和 JS直接在表单设计页面里拖一个文本框、一个日期控件、一个下拉选项再把它们和数据库字段绑定好保存以后一个能填数据的表单就生成了。这里的关键是“绑定字段”。很多新手拖完控件就以为完事了结果保存后发现数据存不进去就是因为控件和数据库字段之间没有建立关联。在 JNPF 里选择一个控件右侧会有“控件字段”的属性你要在这里选择它对应数据库里的哪个字段。如果字段不存在还可以当场新建。这一步看着不起眼却是整个表单能不能存数据的分水岭。2.2 一句话看懂 JNPF 的六块核心能力打开这份手册的目录你会看到在线开发、代码生成、系统管理、系统权限、工作流程、扩展应用这六大块。对新手来说把它们理解成一个装修队会更轻松。模块一句话理解新手建议在线开发拖拽搭建表单、列表、流程是主战场第一个学它代码生成把搭好的东西自动生成前端后端代码有一定基础后再碰系统管理配置公告、日志、缓存、菜单、数据源随用随查系统权限管谁能看、谁能改、谁能审批做第二个应用时学工作流程请假、报销、合同审批这类流转逻辑跟着案例走扩展应用官方做好的示例直接模仿最值得抄作业这六块里在线开发是绝对的核心它对应着 JNPF 功能设计下的表单、列表、流程三大件。剩下的模块可以理解为围绕这个核心的配套服务。系统管理负责平台的日常运转系统权限负责分清楚谁能干什么工作流程负责让表单在不同人之间转起来。2.3 什么样的场景真正需要它你可能会问这东西适合我吗我举个最典型的场景。某个公司的行政部想要一个“办公用品领用登记系统”功能很简单一张领用表单一个记录列表一个审批环节。如果走传统开发你得排期、提需求、等上线用 JNPF行政人员自己在功能设计里新建一个表单拖几个控件再做列表和流程当天就能用上。所以 JNPF 最适合三类人第一类是懂业务但不会写代码的人比如行政、运营、项目助理他们能把线下纸质流程变成线上应用第二类是刚入行的开发新手需要一个平台快速理解业务系统是怎么组装出来的第三类是需要快速验证想法的开发者比如做个内部工具原型先跑起来再谈要不要精细打磨。这份 v3.4.2 的手册就是围绕这些场景把每个操作步骤都掰开讲清楚了。3. 零基础第一个例子用 JNPF 拖出你的“报销申请”表单和列表概念讲得再多不如亲手做一次。这一章我会带你从零走通一个最小例子做一个“报销申请”表单再看它变成可查询的列表。整个过程你会完整走一遍 JNPF 在线开发的核心路径。3.1 打开功能设计页面先认识这个“主入口”进入系统后在左侧菜单找到“在线开发”点击“功能设计”这是 JNPF 里最核心的工作台。页面顶部有一排操作按钮查询、重置、刷新、导入、新建表单。基本信息很简单查询和重置是配合列表用的刷新是让你在做完改动后看到最新状态。点左上角的“新建表单”会弹出一个选择窗口让你决定新建三种类型中的哪一种表单、列表、流程。这里要先把区别说清楚。表单是单张录入界面适合做登记列表是“表单 表格”的组合适合做台账流程是带审批环节的表单适合做需要多人协作的场景。第一个例子建议先选“表单”等摸熟了再加审批。3.2 第一步新建一个表单把主表和子表弄清楚选择“新建表单”后会进入基础设置页面。这里需要填表单名称、分类等基本信息。最关键是下面这个设置项数据连接。如果你不选任何数据连接JNPF 会在流程新建完成后自动帮你建数据表。它的命名规则是主表叫“mt 功能ID”子表叫“ct 雪花ID”。对新手来说这个名字看起来像天书但你不用慌这是系统内部的牵线逻辑你只需要知道“它已经自动建好了表”就行。如果你希望数据落到自己指定的表里可以下拉选择已经配置好的数据连接然后点“新增一行”按钮在弹出的窗口里选择数据库表。这里支持单表或者多表。选多表时系统会要求你配置子表的外键字段和关联主键让主表和子表之间建立关联。我的建议是第一次练习直接用默认的自动建表把主表子表的概念先跑通再考虑自定义数据源。3.3 第二步拖控件的时候心里要有“字段”这根弦填完基础设置点“下一步”进入表单设计页面。左侧是控件区有基础控件、高级控件、系统控件中间是画布右侧是属性配置区。选择左侧的“单行输入”点击或拖到中间画布一个控件就放上去了。重复几次放入“数字输入”和“日期”控件形成一张报销申请单的雏形。现在关键的一步来了选中画布里的任意一个控件右侧会出现它的属性配置。找到“控件字段”下拉选择它对应的数据表字段。因为你用的是自动建表这里可以选择系统预先生成的字段也可以点添加按钮新建自定义字段。新手最容易翻车的地方就在这一步——控件拖上去了但“控件字段”没选结果数据存不进去。在控件属性里还可以配置“组件事件”支持“发生变化时触发”和“失去焦点时触发”两种时机。比如想让“报销金额”输入框在失去焦点时自动校验可以写一段简单的 JavaScript// 失去焦点时触发的事件 if (this.value 5000) { // 超过 5000 元给出提示 this.$message.warning(金额超过 5000 元需要走总监审批); }这里this.value取的是当前控件的值$message.warning是平台提供的弹窗提示方法。你可以把它理解成“当用户填完这个框、鼠标一离开这段代码就跑一遍”。每个控件的属性面板都不一样但“控件字段”这个参数几乎每个控件都有你只要记住凡是打算存进数据库的控件就一定要把字段挂上。3.4 第三步把表单升级成列表加上查询功能表单做好后回到功能设计列表找到刚才创建的表单。很多新手到这里以为结束了但业务场景里几乎都会有一个诉求我想看所有人填过哪些记录。这就需要把表单升级成列表。回到新建表单的选择窗口这次选择“列表”类型。进入后你会发现它比表单多了一个“列表设计”页签。基础设置和表单设计的过程和刚才一模一样你可以把之前做好的表单配置复制过来。区别就在列表设计这个环节。列表设计页面会展示已经绑定字段的列。默认情况下表单里的字段会以列的形式显示。你要做两件事第一勾选哪些字段要在表格里展示比如“报销人”“报销事由”“报销金额”“报销日期”第二配置查询字段。比如让用户按“报销人”和“报销日期”筛选数据就在查询设计里把这两个字段加进去。配置完成后保存这个列表应用就同时具备“填单”和“回看记录”两个能力了。3.5 保存后发生了什么JNPF 是怎么自动建表的整个配置过程中你可能有一个疑问设计界面里没看到建表语句数据库表到底怎么来的这就是 JNPF 零代码体验的精髓。你在表单设计里添加的每个控件只要绑定了“控件字段”JNPF 就会在后台自动创建或者更新对应的表结构。提示在表单属性里有一个“主键策略”选项支持雪花 ID 和自增长 ID。流程保存后主键策略不可修改所以创建之前先想清楚你的数据量级。雪花 ID 是分布式场景下很常见的方案自增长 ID 更直观适合小数据量。另外表单属性里还有个“并发锁定”开关。开启之后系统会加乐观锁机制当两个人同时提交同一份表单时能避免后提交的人把先提交的数据覆盖掉。做报销、工单这类并发提交比较多的场景建议你把这个开关打开。在组合表设计上JNPF 支持副表和子表两种结构。副表适合把固定信息横向扩展比如报销单的基本信息和财务信息分两张表子表适合一个表单里有多条明细的情况比如一张报销单里有多笔费用明细。子表控件在组件库里能找到先把子表关联到基础设置里添加的子表再往子表区域拖控件并在右侧属性里关联各自的控件字段就能实现“一单多明细”的效果。4. 从表单到审批工作流程、门户和大屏该按什么顺序学第一个表单跑通之后你的信心应该有了。接下来最顺理成章的进阶方向是给表单加上“审批流转”也就是工作流程模块。这一章我给你一条清晰的进阶路径让你分清轻重缓急。4.1 什么时候才需要学流程从报销单说起还是拿报销单举例。表单做好后员工可以填单但填完给谁审批财务怎么知道这笔钱核没核销如果没有流程这些全靠线下沟通线上线下两张皮。JNPF 的工作流程模块就是解决这个问题的。在“工作流程”菜单下找到“流程设计”点“新建”你会看到三个页签基础信息、表单设计、流程设计。基础信息是填流程名称和分类表单设计就是你已经熟悉的拖拽操作流程设计才是这个模块的重头戏。它是画流程图的地方你可以把“发起申请”“部门审批”“财务复核”“办结”这几个节点拖出来连成一条线。4.2 流程设计里值得记住的五个关键词在 v3.4.2 这个版本里流程功能补强了不少。作为新手先记住五个关键词就够了。第一个是“候选人”。一个审批节点不是只能指定某一个人它可以指定一组候选人任务分派给他们后其中任意一个人处理这个节点就算通过。第二个是“子表传递”。报销单里的多笔明细在审批时也要跟着主表信息一起流转开启子表传递后审批人才能看到完整数据。第三个是“超时提醒”。节点设置了超时时间后系统会自动提醒审批人不用你天天盯着催。第四个是“自动同意”。某些低风险节点比如行政类的例行申请可以设置条件满足时自动通过不用每次手动点。第五个是“异常处理”。如果某个节点没人处理或流程卡住系统可以按预设规则自动转到指定节点而不是让流程永远悬在那里。这五个关键词你第一次接触时不用全记住只要知道流程设计里藏着这些能力真到用时知道去哪里查手册就行。真正的重点是把“节点”和“连线”这两个概念吃透节点是要做的事连线是流转的方向。4.3 大屏和门户别被“大”字吓到做了表单跑了列表管了流程你的下一个里程碑可能是“大屏”。很多人一听到大屏设计就觉得是给领导看的复杂可视化系统其实 JNPF 的“大屏设计”也没那么高不可攀。在“在线开发”下的“门户设计”和“大屏设计”逻辑和表单设计是一脉相承的。门户设计是搭一个系统首页把常用功能、待办事项、通知公告摆在一个页面里大屏设计是拖拽图表组件把数据以折线图、柱状图、地图等形式展示出来。大屏管理里可以做分类管理把不同主题的大屏分门别类地图管理支持地理数据展示数据源管理则是给大屏指定数据从哪来。新手学大屏我建议先别追求视觉效果把重点放在“数据源管理”上。搞清楚大屏展示的数据来自哪个数据接口或数据表比研究怎么配色重要得多。数据源没配对后面所有的图表都是空的。4.4 系统管理到底管什么新手先抓这四个模块“系统管理”这个大模块下还有很多子模块新手容易一进去就迷路。我建议按以下顺序抓重点系统配置、系统菜单、数据应用、系统日志。系统配置里做的是基础设置、安全设置、第三方设置相当于平台的“总闸”。安全设置里能找到登录方式、图形验证、锁定账户等选项第一次部署时可以改一改。系统菜单是入口的骨架新建菜单、导入导出、按钮权限、列表权限、表单权限、数据权限都挂在这里。数据应用下则是数据连接、数据建模、数据字典、数据接口、接口认证、数据同步这些内容它们管的是“数据从哪里来、长什么样”。注意系统菜单里有个“同步菜单”的操作。当你改了功能设计新增了表单或列表记得去同步一下否则新的功能可能不会出现在前端页面上。这是我见过的新手最容易漏掉的一步。系统日志是排查问题用的好帮手谁在什么时候做了什么操作都能在这里找到记录。剩余的系统公告、系统调度、系统缓存、系统监控之类的模块用到时再翻手册也不迟它们属于运维型功能不阻碍你入门。5. 新手最容易翻车的 5 个地方这些坑我替你踩过了这一章我不讲新功能专门讲血泪经验。以下五条是新手在 JNPF 上最常遇到的翻车现场每一条我都按“现象 → 原因 → 解决”给你写清楚。5.1 表单保存了却没数据大概率是字段没挂到数据表现象在表单页面填了一堆内容点保存系统提示成功但打开列表空空如也或者数据库表里没有任何记录。原因这是最经典的新手失误。控件是拖上去了但它的“控件字段”属性没有选择等于这个控件只是一个摆设没有和数据库表的任何字段绑定关系。系统不知道把填进去的内容存到哪一列自然就丢弃了。解决回到表单设计里把要保存数据的控件逐个选中在右侧属性区域找到“控件字段”下拉选择对应的字段。如果没有现成字段就新建一个再绑定。改完后保存重新测试。我习惯的做法是每拖一个控件就立刻绑字段绝不攒到最后一起做这样出错时能立刻定位。5.2 列表查询“查不出来”先看查询字段再看数据权限现象列表做好了查询条件也加了但点查询后返回的结果不对要么查不到要么查出来的数据缺了一部分。原因这个问题通常是两个原因叠加造成的。第一查询字段没有配置到列表的“查询设计”里系统根本不知道你想按什么过滤。第二当前登录用户的数据权限限制了可见范围比如他只能看自己创建的数据而你用管理员账户之外的账号去测试时发现数据“变少了”。解决先到功能设计的列表设计里把需要参与过滤的字段加进查询字段。然后用管理员账号排查数据权限在系统权限的角色管理里看一下该角色数据权限是什么范围是本人、本部门还是全部。测试阶段为了方便可以先给测试角色放开数据权限等功能没问题了再收紧。5.3 流程发起后数据没写进去主表子表的外键是关键现象流程审批都走完了流程也没报错但打开业务列表发现表单数据没有进去或者主表有记录子表是空的。原因新建流程时如果你选择了多表结构的数据连接系统要求在基础信息页面配置子表的外键字段和关联主键让主表和子表能关联起来。漏掉这一步子表数据在保存时就找不到自己的“父亲”就丢失了。解决回到流程的基础设置检查是否选择了主表和子表并确认外键字段已正确关联。关联原则是标准的数据库关系设计子表里添加一列存主表主键的值以此把子表记录挂到主表记录下面。5.4 改了配置不生效先清缓存再同步菜单现象明明在功能设计里把表单的字段改了也保存了但前端页面还是老样子。有时候新加了一个表单菜单里根本找不到。原因JNPF 有系统缓存配置改动后可能需要刷新缓存才能生效。另外新功能不经过“同步菜单”这一步前端导航是不会自动多出入口的。解决去系统管理下的“系统缓存”执行一次清理动作把缓存刷新掉。同时在系统菜单里找到同步菜单的操作重新同步。顺序上建议先清缓存再同步菜单然后重新登录系统。这一套组合拳能解决绝大多数“改了没反应”的玄学问题。5.5 权限看着都勾了别人还是进不来按钮权限和数据权限是两回事现象你在角色管理里给某个角色分配了“系统管理”的权限但该角色的用户登录后还是看不到菜单或者看得到菜单但点进去没有操作按钮。原因JNPF 的权限体系是分层的。菜单权限决定能不能看到模块按钮权限决定能不能操作某个具体动作数据权限决定能看哪些数据。这三者是相互配合的缺一层都不行。你以为“给了角色权限”就全通了其实只是通了第一层。解决在系统权限的角色管理里进入“角色权限”设置确认三块都配了。菜单权限勾选大项按钮权限勾选你要开放的动作如新增、编辑、删除、导入、导出列表权限、表单权限分别约束列表字段和表单字段的可见性数据权限设置数据范围。对新手来说一条实操建议是先按角色把菜单和按钮配齐再去调整数据权限层级从大到小不容易乱。6. 下一步学什么一份照着做就行的小白学习顺序到这一章你已经把 JNPF 最核心的开发路径走通了一遍。“下一步学什么”这个问题我的答案是别再继续零散地看功能了而是找一个完整的业务场景把它从头到尾做透。阶段做什么对应模块第 1 周做三个表单员工登记、报销申请、固定资产台账在线开发 → 功能设计 → 表单第 2 周给每个表单配上列表和查询在线开发 → 功能设计 → 列表第 3 周挑报销流程加审批链工作流程 → 流程设计第 4 周给员工配角色把菜单和数据权限锁好系统权限 → 角色管理第 5 周照着扩展应用里的订单示例模仿做一个应用扩展应用 → 订单示例扩展应用模块里有现成的功能示例、门户示例、报表和大屏示例还有订单管理、项目管理这种完整的业务示例。这些就是最好的模仿对象。我的学习方法是不看任何说明先自己去尝试配置卡住了再翻手册整个流程走通一遍后再对照示例找差距。这个过程比泛泛地翻手册要有效得多。关于这份 v3.4.2 操作手册本身我建议第一遍只先通读在线开发和系统权限这两章其余章节全部当成工具书用到再查。工作流程那章比较长等做到审批场景时再精读。从那以后我每次拿到新平台的第一天都强制自己先跑出一个完整的小例子再学别的高深功能——这个习惯帮我少走了很多弯路希望帮到你。本文还有配套的精品资源点击获取
简介JNPF软件开发平台V3.4.2操作手册由福建引迈信息技术有限公司编制是一份面向JNPF产品使用者的功能指南适合低代码开发人员、项目实施与系统管理人员参考学习。压缩包内为单个PDF文件大小40.01MB目录涵盖在线开发、门户设计、大屏设计、报表设计、代码生成与系统管理六大模块每个模块均按功能拆解为具体操作章节结构清晰便于按需检索。手册详细介绍了表单设计、列表设计、流程设计和结果展示的在线开发步骤门户与大屏的新建、地图、分类和数据源管理方法以及功能表单、流程表单的代码生成流程系统管理部分则覆盖系统配置、公告、调度、缓存、日志、监控和菜单权限等运维功能。目前已有1339人学习下载可作为JNPF V3.4.2平台的上手教程与日常配置参考帮助开发与管理人员快速定位功能、理解参数含义。1. 程序员才做的软件现在你也可以拖出来先认识 JNPF 到底是什么第一次听说 JNPF你可能会冒出三个问题它是个编程框架吗是不是要会写代码才能用我这种零基础的新手碰它会不会太早我第一次接触它的时候这三个问题在我脑子里转了好几圈。把话说直白一点JNPF 是一个低代码软件开发平台它把过去一行行敲代码才能做出来的业务系统变成了像拼乐高一样拖拖拽拽就能搭出来。表单、列表、审批流程、数据报表、大屏看板这些传统开发里很费劲的东西在这里都有可视化的编辑页面。你不用先学会 Java 或写前端只需要理解业务逻辑就能动手做出一个能真正运行的应用。如果你正想学一套能快速落地业务系统的工具或者受够了被开发排期卡住的日子这篇入门就能带你迈出第一步。2. 先搞懂一个概念低代码到底在解决什么问题很多人第一次听到“低代码”三个字容易把它理解成“代码少一点”甚至觉得是“不用写代码的玩具”。这个误会如果带着上路后面很容易翻车。这一章我们先把概念掰开揉碎再告诉你 JNPF 真正帮你省掉的是什么。2.1 “拖拽生成系统”到底是怎么一回事传统开发一个管理系统流程大致是这样的业务部门提需求开发人员写后端接口、建数据库表、写前端页面、联调、测试、上线。一套下来少说几周多则几个月。中间只要需求变一次前后端都要跟着改排期又往后推。JNPF 换了一个思路它把系统开发里最常用、最重复的部分提前做成了一个个有图形界面的积木块。你负责拼积木它负责把积木转换成真正能运行的代码和页面。比如你想做一个“客户信息登记表”不用去写表单页面的 HTML 和 JS直接在表单设计页面里拖一个文本框、一个日期控件、一个下拉选项再把它们和数据库字段绑定好保存以后一个能填数据的表单就生成了。这里的关键是“绑定字段”。很多新手拖完控件就以为完事了结果保存后发现数据存不进去就是因为控件和数据库字段之间没有建立关联。在 JNPF 里选择一个控件右侧会有“控件字段”的属性你要在这里选择它对应数据库里的哪个字段。如果字段不存在还可以当场新建。这一步看着不起眼却是整个表单能不能存数据的分水岭。2.2 一句话看懂 JNPF 的六块核心能力打开这份手册的目录你会看到在线开发、代码生成、系统管理、系统权限、工作流程、扩展应用这六大块。对新手来说把它们理解成一个装修队会更轻松。模块一句话理解新手建议在线开发拖拽搭建表单、列表、流程是主战场第一个学它代码生成把搭好的东西自动生成前端后端代码有一定基础后再碰系统管理配置公告、日志、缓存、菜单、数据源随用随查系统权限管谁能看、谁能改、谁能审批做第二个应用时学工作流程请假、报销、合同审批这类流转逻辑跟着案例走扩展应用官方做好的示例直接模仿最值得抄作业这六块里在线开发是绝对的核心它对应着 JNPF 功能设计下的表单、列表、流程三大件。剩下的模块可以理解为围绕这个核心的配套服务。系统管理负责平台的日常运转系统权限负责分清楚谁能干什么工作流程负责让表单在不同人之间转起来。2.3 什么样的场景真正需要它你可能会问这东西适合我吗我举个最典型的场景。某个公司的行政部想要一个“办公用品领用登记系统”功能很简单一张领用表单一个记录列表一个审批环节。如果走传统开发你得排期、提需求、等上线用 JNPF行政人员自己在功能设计里新建一个表单拖几个控件再做列表和流程当天就能用上。所以 JNPF 最适合三类人第一类是懂业务但不会写代码的人比如行政、运营、项目助理他们能把线下纸质流程变成线上应用第二类是刚入行的开发新手需要一个平台快速理解业务系统是怎么组装出来的第三类是需要快速验证想法的开发者比如做个内部工具原型先跑起来再谈要不要精细打磨。这份 v3.4.2 的手册就是围绕这些场景把每个操作步骤都掰开讲清楚了。3. 零基础第一个例子用 JNPF 拖出你的“报销申请”表单和列表概念讲得再多不如亲手做一次。这一章我会带你从零走通一个最小例子做一个“报销申请”表单再看它变成可查询的列表。整个过程你会完整走一遍 JNPF 在线开发的核心路径。3.1 打开功能设计页面先认识这个“主入口”进入系统后在左侧菜单找到“在线开发”点击“功能设计”这是 JNPF 里最核心的工作台。页面顶部有一排操作按钮查询、重置、刷新、导入、新建表单。基本信息很简单查询和重置是配合列表用的刷新是让你在做完改动后看到最新状态。点左上角的“新建表单”会弹出一个选择窗口让你决定新建三种类型中的哪一种表单、列表、流程。这里要先把区别说清楚。表单是单张录入界面适合做登记列表是“表单 表格”的组合适合做台账流程是带审批环节的表单适合做需要多人协作的场景。第一个例子建议先选“表单”等摸熟了再加审批。3.2 第一步新建一个表单把主表和子表弄清楚选择“新建表单”后会进入基础设置页面。这里需要填表单名称、分类等基本信息。最关键是下面这个设置项数据连接。如果你不选任何数据连接JNPF 会在流程新建完成后自动帮你建数据表。它的命名规则是主表叫“mt 功能ID”子表叫“ct 雪花ID”。对新手来说这个名字看起来像天书但你不用慌这是系统内部的牵线逻辑你只需要知道“它已经自动建好了表”就行。如果你希望数据落到自己指定的表里可以下拉选择已经配置好的数据连接然后点“新增一行”按钮在弹出的窗口里选择数据库表。这里支持单表或者多表。选多表时系统会要求你配置子表的外键字段和关联主键让主表和子表之间建立关联。我的建议是第一次练习直接用默认的自动建表把主表子表的概念先跑通再考虑自定义数据源。3.3 第二步拖控件的时候心里要有“字段”这根弦填完基础设置点“下一步”进入表单设计页面。左侧是控件区有基础控件、高级控件、系统控件中间是画布右侧是属性配置区。选择左侧的“单行输入”点击或拖到中间画布一个控件就放上去了。重复几次放入“数字输入”和“日期”控件形成一张报销申请单的雏形。现在关键的一步来了选中画布里的任意一个控件右侧会出现它的属性配置。找到“控件字段”下拉选择它对应的数据表字段。因为你用的是自动建表这里可以选择系统预先生成的字段也可以点添加按钮新建自定义字段。新手最容易翻车的地方就在这一步——控件拖上去了但“控件字段”没选结果数据存不进去。在控件属性里还可以配置“组件事件”支持“发生变化时触发”和“失去焦点时触发”两种时机。比如想让“报销金额”输入框在失去焦点时自动校验可以写一段简单的 JavaScript// 失去焦点时触发的事件 if (this.value 5000) { // 超过 5000 元给出提示 this.$message.warning(金额超过 5000 元需要走总监审批); }这里this.value取的是当前控件的值$message.warning是平台提供的弹窗提示方法。你可以把它理解成“当用户填完这个框、鼠标一离开这段代码就跑一遍”。每个控件的属性面板都不一样但“控件字段”这个参数几乎每个控件都有你只要记住凡是打算存进数据库的控件就一定要把字段挂上。3.4 第三步把表单升级成列表加上查询功能表单做好后回到功能设计列表找到刚才创建的表单。很多新手到这里以为结束了但业务场景里几乎都会有一个诉求我想看所有人填过哪些记录。这就需要把表单升级成列表。回到新建表单的选择窗口这次选择“列表”类型。进入后你会发现它比表单多了一个“列表设计”页签。基础设置和表单设计的过程和刚才一模一样你可以把之前做好的表单配置复制过来。区别就在列表设计这个环节。列表设计页面会展示已经绑定字段的列。默认情况下表单里的字段会以列的形式显示。你要做两件事第一勾选哪些字段要在表格里展示比如“报销人”“报销事由”“报销金额”“报销日期”第二配置查询字段。比如让用户按“报销人”和“报销日期”筛选数据就在查询设计里把这两个字段加进去。配置完成后保存这个列表应用就同时具备“填单”和“回看记录”两个能力了。3.5 保存后发生了什么JNPF 是怎么自动建表的整个配置过程中你可能有一个疑问设计界面里没看到建表语句数据库表到底怎么来的这就是 JNPF 零代码体验的精髓。你在表单设计里添加的每个控件只要绑定了“控件字段”JNPF 就会在后台自动创建或者更新对应的表结构。提示在表单属性里有一个“主键策略”选项支持雪花 ID 和自增长 ID。流程保存后主键策略不可修改所以创建之前先想清楚你的数据量级。雪花 ID 是分布式场景下很常见的方案自增长 ID 更直观适合小数据量。另外表单属性里还有个“并发锁定”开关。开启之后系统会加乐观锁机制当两个人同时提交同一份表单时能避免后提交的人把先提交的数据覆盖掉。做报销、工单这类并发提交比较多的场景建议你把这个开关打开。在组合表设计上JNPF 支持副表和子表两种结构。副表适合把固定信息横向扩展比如报销单的基本信息和财务信息分两张表子表适合一个表单里有多条明细的情况比如一张报销单里有多笔费用明细。子表控件在组件库里能找到先把子表关联到基础设置里添加的子表再往子表区域拖控件并在右侧属性里关联各自的控件字段就能实现“一单多明细”的效果。4. 从表单到审批工作流程、门户和大屏该按什么顺序学第一个表单跑通之后你的信心应该有了。接下来最顺理成章的进阶方向是给表单加上“审批流转”也就是工作流程模块。这一章我给你一条清晰的进阶路径让你分清轻重缓急。4.1 什么时候才需要学流程从报销单说起还是拿报销单举例。表单做好后员工可以填单但填完给谁审批财务怎么知道这笔钱核没核销如果没有流程这些全靠线下沟通线上线下两张皮。JNPF 的工作流程模块就是解决这个问题的。在“工作流程”菜单下找到“流程设计”点“新建”你会看到三个页签基础信息、表单设计、流程设计。基础信息是填流程名称和分类表单设计就是你已经熟悉的拖拽操作流程设计才是这个模块的重头戏。它是画流程图的地方你可以把“发起申请”“部门审批”“财务复核”“办结”这几个节点拖出来连成一条线。4.2 流程设计里值得记住的五个关键词在 v3.4.2 这个版本里流程功能补强了不少。作为新手先记住五个关键词就够了。第一个是“候选人”。一个审批节点不是只能指定某一个人它可以指定一组候选人任务分派给他们后其中任意一个人处理这个节点就算通过。第二个是“子表传递”。报销单里的多笔明细在审批时也要跟着主表信息一起流转开启子表传递后审批人才能看到完整数据。第三个是“超时提醒”。节点设置了超时时间后系统会自动提醒审批人不用你天天盯着催。第四个是“自动同意”。某些低风险节点比如行政类的例行申请可以设置条件满足时自动通过不用每次手动点。第五个是“异常处理”。如果某个节点没人处理或流程卡住系统可以按预设规则自动转到指定节点而不是让流程永远悬在那里。这五个关键词你第一次接触时不用全记住只要知道流程设计里藏着这些能力真到用时知道去哪里查手册就行。真正的重点是把“节点”和“连线”这两个概念吃透节点是要做的事连线是流转的方向。4.3 大屏和门户别被“大”字吓到做了表单跑了列表管了流程你的下一个里程碑可能是“大屏”。很多人一听到大屏设计就觉得是给领导看的复杂可视化系统其实 JNPF 的“大屏设计”也没那么高不可攀。在“在线开发”下的“门户设计”和“大屏设计”逻辑和表单设计是一脉相承的。门户设计是搭一个系统首页把常用功能、待办事项、通知公告摆在一个页面里大屏设计是拖拽图表组件把数据以折线图、柱状图、地图等形式展示出来。大屏管理里可以做分类管理把不同主题的大屏分门别类地图管理支持地理数据展示数据源管理则是给大屏指定数据从哪来。新手学大屏我建议先别追求视觉效果把重点放在“数据源管理”上。搞清楚大屏展示的数据来自哪个数据接口或数据表比研究怎么配色重要得多。数据源没配对后面所有的图表都是空的。4.4 系统管理到底管什么新手先抓这四个模块“系统管理”这个大模块下还有很多子模块新手容易一进去就迷路。我建议按以下顺序抓重点系统配置、系统菜单、数据应用、系统日志。系统配置里做的是基础设置、安全设置、第三方设置相当于平台的“总闸”。安全设置里能找到登录方式、图形验证、锁定账户等选项第一次部署时可以改一改。系统菜单是入口的骨架新建菜单、导入导出、按钮权限、列表权限、表单权限、数据权限都挂在这里。数据应用下则是数据连接、数据建模、数据字典、数据接口、接口认证、数据同步这些内容它们管的是“数据从哪里来、长什么样”。注意系统菜单里有个“同步菜单”的操作。当你改了功能设计新增了表单或列表记得去同步一下否则新的功能可能不会出现在前端页面上。这是我见过的新手最容易漏掉的一步。系统日志是排查问题用的好帮手谁在什么时候做了什么操作都能在这里找到记录。剩余的系统公告、系统调度、系统缓存、系统监控之类的模块用到时再翻手册也不迟它们属于运维型功能不阻碍你入门。5. 新手最容易翻车的 5 个地方这些坑我替你踩过了这一章我不讲新功能专门讲血泪经验。以下五条是新手在 JNPF 上最常遇到的翻车现场每一条我都按“现象 → 原因 → 解决”给你写清楚。5.1 表单保存了却没数据大概率是字段没挂到数据表现象在表单页面填了一堆内容点保存系统提示成功但打开列表空空如也或者数据库表里没有任何记录。原因这是最经典的新手失误。控件是拖上去了但它的“控件字段”属性没有选择等于这个控件只是一个摆设没有和数据库表的任何字段绑定关系。系统不知道把填进去的内容存到哪一列自然就丢弃了。解决回到表单设计里把要保存数据的控件逐个选中在右侧属性区域找到“控件字段”下拉选择对应的字段。如果没有现成字段就新建一个再绑定。改完后保存重新测试。我习惯的做法是每拖一个控件就立刻绑字段绝不攒到最后一起做这样出错时能立刻定位。5.2 列表查询“查不出来”先看查询字段再看数据权限现象列表做好了查询条件也加了但点查询后返回的结果不对要么查不到要么查出来的数据缺了一部分。原因这个问题通常是两个原因叠加造成的。第一查询字段没有配置到列表的“查询设计”里系统根本不知道你想按什么过滤。第二当前登录用户的数据权限限制了可见范围比如他只能看自己创建的数据而你用管理员账户之外的账号去测试时发现数据“变少了”。解决先到功能设计的列表设计里把需要参与过滤的字段加进查询字段。然后用管理员账号排查数据权限在系统权限的角色管理里看一下该角色数据权限是什么范围是本人、本部门还是全部。测试阶段为了方便可以先给测试角色放开数据权限等功能没问题了再收紧。5.3 流程发起后数据没写进去主表子表的外键是关键现象流程审批都走完了流程也没报错但打开业务列表发现表单数据没有进去或者主表有记录子表是空的。原因新建流程时如果你选择了多表结构的数据连接系统要求在基础信息页面配置子表的外键字段和关联主键让主表和子表能关联起来。漏掉这一步子表数据在保存时就找不到自己的“父亲”就丢失了。解决回到流程的基础设置检查是否选择了主表和子表并确认外键字段已正确关联。关联原则是标准的数据库关系设计子表里添加一列存主表主键的值以此把子表记录挂到主表记录下面。5.4 改了配置不生效先清缓存再同步菜单现象明明在功能设计里把表单的字段改了也保存了但前端页面还是老样子。有时候新加了一个表单菜单里根本找不到。原因JNPF 有系统缓存配置改动后可能需要刷新缓存才能生效。另外新功能不经过“同步菜单”这一步前端导航是不会自动多出入口的。解决去系统管理下的“系统缓存”执行一次清理动作把缓存刷新掉。同时在系统菜单里找到同步菜单的操作重新同步。顺序上建议先清缓存再同步菜单然后重新登录系统。这一套组合拳能解决绝大多数“改了没反应”的玄学问题。5.5 权限看着都勾了别人还是进不来按钮权限和数据权限是两回事现象你在角色管理里给某个角色分配了“系统管理”的权限但该角色的用户登录后还是看不到菜单或者看得到菜单但点进去没有操作按钮。原因JNPF 的权限体系是分层的。菜单权限决定能不能看到模块按钮权限决定能不能操作某个具体动作数据权限决定能看哪些数据。这三者是相互配合的缺一层都不行。你以为“给了角色权限”就全通了其实只是通了第一层。解决在系统权限的角色管理里进入“角色权限”设置确认三块都配了。菜单权限勾选大项按钮权限勾选你要开放的动作如新增、编辑、删除、导入、导出列表权限、表单权限分别约束列表字段和表单字段的可见性数据权限设置数据范围。对新手来说一条实操建议是先按角色把菜单和按钮配齐再去调整数据权限层级从大到小不容易乱。6. 下一步学什么一份照着做就行的小白学习顺序到这一章你已经把 JNPF 最核心的开发路径走通了一遍。“下一步学什么”这个问题我的答案是别再继续零散地看功能了而是找一个完整的业务场景把它从头到尾做透。阶段做什么对应模块第 1 周做三个表单员工登记、报销申请、固定资产台账在线开发 → 功能设计 → 表单第 2 周给每个表单配上列表和查询在线开发 → 功能设计 → 列表第 3 周挑报销流程加审批链工作流程 → 流程设计第 4 周给员工配角色把菜单和数据权限锁好系统权限 → 角色管理第 5 周照着扩展应用里的订单示例模仿做一个应用扩展应用 → 订单示例扩展应用模块里有现成的功能示例、门户示例、报表和大屏示例还有订单管理、项目管理这种完整的业务示例。这些就是最好的模仿对象。我的学习方法是不看任何说明先自己去尝试配置卡住了再翻手册整个流程走通一遍后再对照示例找差距。这个过程比泛泛地翻手册要有效得多。关于这份 v3.4.2 操作手册本身我建议第一遍只先通读在线开发和系统权限这两章其余章节全部当成工具书用到再查。工作流程那章比较长等做到审批场景时再精读。从那以后我每次拿到新平台的第一天都强制自己先跑出一个完整的小例子再学别的高深功能——这个习惯帮我少走了很多弯路希望帮到你。本文还有配套的精品资源点击获取
