企业官网建设流程全解析

简介：由福建引迈信息技术有限公司发布的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 子表合计不显示或合计错误：合计字段类型卡得死

现象：子表合计开关开了，运行时子表下方没有合计行，或者合计结果不对。注意合计栏出现的位置在子表区域底部，不是每一行右侧，很多人以为没生效，其实是看错了位置。

原因：合计字段只识别子表内单行输入、数字输入、计算公式三种类型，字段类型不在范围内，勾了也不参与计算。

解决：回表单设计检查子表字段类型，要合计的字段改成数字输入或计算公式。有多个合计字段时确认数值类型统一，避免出现“1+2=12”这种字符串拼接式的合计结果。配置完成后用预览跑一遍带小数的数据，确认合计列的顺序和精度符合预期再发布。

5.3 控件字段下拉找不到新字段：先保存基础设置再进表单设计

现象：数据建模里新建了字段，回到功能设计，控件字段下拉列表里刷新不出来，看起来像权限问题或数据源配置问题。

原因：控件字段来源是当前关联的表结构，建模新增字段后，功能设计打开时加载的是本次会话的表结构快照，没有同步刷新。这类缓存问题有时候看着像玄学，但本质上就是快照过期。

解决：先保存基础设置并重新进入表单设计页，还不行就同步菜单后再试。如果基础设置里中途换过数据连接，也要重新进入一次。这是缓存类问题，刷新页面重进通常能解决，别急着怀疑权限配置或数据库连接串，那样排查方向就偏了。

5.4 流程节点通知收不到：节点通知和消息模板是两套配置

现象：审批流转到某个节点，审批人没收到待办通知，但流程本身流转正常。打开待办事宜，这条记录其实在，就是没有站内信或短信提醒。

原因：V3.4.2 流程节点通知改造后，节点通知配置和系统模板里的消息模板是两套独立配置。节点开了通知但模板没启用，或模板启用了但发送方式不对，都会丢通知。

解决：流程设计里检查该节点的通知开关、通知对象；系统模板里确认消息模板已启用。站内信走消息中心，短信走短信通道，要按通知场景分别确认，别只配一种。两处都确认后再跑一次流程验证，别只看节点配置就认为没问题。

5.5 并发提交覆盖数据：表单属性开启并发锁定

现象：两个用户同时打开同一单据编辑，后提交的人把先提交的人的数据覆盖了，没有任何冲突提示。这个问题在审批流里更隐蔽，中间有节点流转，数据被覆盖后很难追溯是谁改的。

原因：默认没有乐观锁，后提交者基于旧版本数据覆盖写入。开启并发锁定后，每次提交版本号加一，版本不一致时后提交者拿的是旧版本号，会被平台拦截。

解决：表单属性里开启并发锁定，提交时启用乐观锁机制，版本不一致时提示冲突，由用户决定是否覆盖。高并发填报、高频编辑的表单建议全局开启，同时给用户一句明确的冲突提示文案，并给出“刷新最新数据”或“强制覆盖”两个出口，不然会被当成系统 bug 报上来。

6. 代码生成与扩展应用：用内置示例跑通从配置到二开的衔接

6.1 代码生成的定位：在线配置与工程源码的分工

代码生成模块分功能表单和流程表单，功能表单下又有表单、列表、流程三类。它把在线开发的配置结果落成工程源码，适合需要在现有工程里继续二开的团队。两者的边界在于：在线开发以配置为主，代码生成以产出源码为主。后续需求改动优先改配置还是改代码，项目里要定个规矩。

我建议主体功能留在在线开发里改，二开只做平台覆盖不了的定制逻辑。在一个模拟项目里做订单管理功能时，我就是先把表单、列表、流程配齐，再用代码生成导出，在生成代码里补了一个平台没有的库存校验逻辑。配置打底、代码补定制，这条路线比纯代码路线稳得多。

6.2 扩展应用当参考模板：订单示例、百万数据与打印示例

扩展应用是理解 JNPF 能力边界最快的入口。功能示例、门户示例、报表示例、大屏示例覆盖配置类场景；表单示例、表格示例、图表示例覆盖组件类场景；订单示例、项目管理覆盖完整业务闭环，把表单、列表、流程、数据关系全部串起来。

我拿到新环境的第一件事是把订单示例跑一遍，看它怎么组织主表子表、怎么配流程节点、数据关系怎么落库，再决定自己的业务模块按什么结构拆。百万数据示例拿来验证列表在大数据量下的性能，导入导出示例验证大批量数据交换，打印示例验证单据格式。这些都是现成的验证工具，比自己造数据快得多。

6.3 验证与交付：按预览、发起、监控、日志四步自检

一个功能交付前，我固定按四个动作过一遍：表单预览看字段与事件，发起流程看数据落库，流程监控看节点流转，系统日志看异常记录。四个动作都正常，才把功能交给业务验收。

从 V3.4.2 的修订记录看，每个版本都在补权限和流程的边界情况——数据权限、表单权限、流程异常处理，这些恰恰是实施中最容易出问题的部分。从那以后，我每次接手 JNPF 项目，第一件事都是把修订记录从头到尾看一遍，这份手册的 PDF 也一直放在项目文档目录里，配置前先翻对应章节，比临时找在线文档快。别高估自己的记忆力，也别低估配置项之间的联动。希望帮到你。

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