企业官网建设流程全解析

简介：《JNPF产品功能使用手册_v3.4.2.pdf》面向JNPF软件开发平台的实施人员、业务配置人员与二次开发学习者，围绕V3.4.2版本的功能入口、配置路径和操作要点展开，适合日常查阅、功能核对与团队培训。包内为1个PDF文件，约40.01MB，按在线开发、门户设计、大屏设计、报表设计、代码生成、系统管理等章节编排，目录层级清晰，便于按模块检索。内容细化到表单、列表、流程与结果展示，门户新建与展示，大屏管理、地图管理、分类管理与数据源管理，以及功能表单、流程表单的代码生成；系统管理部分还包含基础设置、安全设置、第三方设置、超级管理员、系统公告、消息中心、系统调度、缓存、日志、监控、图标、菜单及权限配置。已有1343人学习，适合需要快速定位功能说明、核对配置项或搭建内部培训材料的读者查阅。

1. 先别急着拖控件：低代码平台V3.4.2手册的适用边界

拿到一份低代码平台产品功能使用手册，很多人第一反应是翻到“表单设计”照着拖控件。真到项目里，拖控件只占三成工作量，剩下七成是数据表、流程节点、权限颗粒度和接口联调的先后顺序。这份V3.4.2产品功能使用手册PDF覆盖在线开发、门户设计、大屏设计、报表设计、代码生成、系统管理、系统权限、工作流程和扩展应用，适合正在做拖拽式表单、流程审批、数据建模和私有化部署的实施人员，也适合刚接手零代码平台、需要快速判断功能边界的开发者。它解决的不是“会不会点按钮”，而是“先配哪一层、参数怎么填、出问题查哪页”。

2. 在线开发：表单字段、列表查询与流程节点的落地顺序

在线开发是这份手册里最厚的部分，也是实际项目最容易返工的地方。功能设计支持新建表单、列表、流程三种类型，桌面端与移动端切换分别设计，控件分基础控件、高级控件、系统控件。真正要落地一个功能，顺序不能乱：先定数据表，再配表单控件，然后补列表查询和流程节点，最后看结果展示。顺序反了，后面改字段、改外键、改权限都会连带返工。

2.1 表单设计先定数据表：主表、子表、外键与主键策略

新建表单类型后，先进入基础设置。这里有一个关键分支：不设置数据连接时，流程新建完成后平台会自动建表，主表按“mt+功能ID”命名，子表按“ct+雪花ID”命名；需要自定义表时，下拉数据连接选择数据库，再点新增一行绑定数据建模里的单表或多表。选多表必须配置子表外键字段和关联主键，选单表可以跳过。这个步骤不是形式，外键配错，后面子表合计、子表传递、流程字段写入都会错位。

我一般把基础设置当成数据库设计评审来做，先列三张清单：主表字段、子表字段、流程字段。主表放业务主键和审批状态，子表放明细行，流程字段放审批人、审批意见、节点时间。控件字段下拉时可以直接新建字段，字段设置窗口会展示当前数据表已有字段，已有字段不支持修改，新增字段才进入自定义配置。这个限制要提前知道，否则字段名拼错只能删掉重来。表单属性里的主键策略支持雪花ID和自增长ID，流程保存后不可修改；并发锁定开启后，并发提交表单会加乐观锁机制，保证数据提交准确性。审批类、订单类功能建议开并发锁定，纯台账类功能可以按并发量决定。

控件属性里要重点看三处：控件字段、组件样式、组件事件。控件字段决定数据写入哪一列；组件样式里的栅格、标题宽度、多端显示决定页面布局；组件事件支持发生变化时触发、失去焦点时触发，可以写JavaScript脚本。多端显示不是装饰项，移动端不展示的控件仍然可能参与表单校验，配置时要同步检查必填规则和提交前置脚本。

子表设计是另一个高频翻车点。需要子表时，先选设计子表控件，在右侧组件属性关联基础设置里添加的子表，才能把控件拖进子表区域。子表支持合计设置和动作设置：合计字段来源于子表内单行输入、数字输入、计算公式类型字段，可多选；动作设置可以配置子表传递，自定义弹窗标题、弹窗类型、弹窗宽度，远端数据联动选择数据接口后，接口参数会展示到参数设置区，再下拉主表字段做筛选，列表字段和关联字段分别配置展示列和映射规则。这里的配置顺序是“先接口、再参数、再列表字段、最后关联字段”，反过来配会出现接口返回有数据但子表填不进去的情况。

2.2 控件属性与事件脚本：把联动逻辑收在表单层

表单事件支持表单加载触发、提交前置触发、提交后置触发，控件事件支持发生变化时触发、失去焦点时触发。哪些逻辑放表单层，哪些放流程节点，要有边界：控件显隐、赋值、必填切换放控件事件；跨表单校验、提交前数据补全放提交前置；提交后通知、日志记录放提交后置。不要把审批逻辑写进控件事件，否则流程节点一变，表单脚本全要跟着改。

下面这段脚本只演示事件结构，方法名以平台脚本编辑器提示为准。控件编码要和表单设计里的字段编码一致，不要直接抄控件标题。

// 下拉选择控件编码：selectType // 目标控件编码：amount、detail、remark function onSelectTypeChange(value) { if (value === 'a') { // 选择a时，金额控件赋值为1 form.setValue('amount', 1); } else if (value === 'b') { // 选择b时，金额控件赋值为2 form.setValue('amount', 2); } else if (value === 'c') { // 选择c时，明细控件隐藏 form.setControlVisible('detail', false); } else if (value === 'd') { // 选择d时，备注控件变为必填 form.setControlRequired('remark', true); } }

逻辑说明：事件入口绑定在“发生变化时触发”，value是当前下拉值；setValue写值，setControlVisible控制显隐，setControlRequired控制必填。参数说明：selectType、amount、detail、remark是控件编码，不是控件显示名称；如果字段来自子表，编码要带子表前缀或按平台规则取子表字段编码。提交前置脚本里不要做异步接口调用，容易和提交动作抢时序；需要拉取远端数据的场景放到控件事件或子表动作设置里。表单属性里的表单尺寸、标题宽度、表单样式、表单宽度按端分别调，桌面端宽表单在移动端会挤压，多端显示要配合栅格一起看。

2.3 列表查询与流程节点的衔接：结果展示不是最后一步

新建类型选列表时，要配基础设置、表单设计和列表设计，桌面端与移动端切换分别设计。列表不是表单的附属页，它决定查询字段、列表字段、行内编辑和高级查询的入口。常见做法是先把查询字段控制在三到五个：业务编号、申请人、状态、时间范围，其余字段放进高级查询。列表字段不要一次全放，移动端列宽不够会横向滚动，用户找不到操作按钮。列表设计里还要看按钮权限和列表权限，系统菜单里的按钮权限、列表权限、表单权限、数据权限是四层，列表页的导出、批量审批、行内编辑都要在这层挂权限。

流程设计在在线开发里不是孤立模块。新建流程类型后，基础信息、表单设计、流程设计要连着看：基础信息定流程名称和分类，表单设计复用前面的表单配置，流程设计配节点、审批人、节点事件、超时提醒、异常处理、自动同意、节点变更、流程复活、子表传递。节点事件里可以挂脚本，但节点事件和表单事件的执行顺序要在测试环境验证。流程发起后，流程字段的数据会写入关联表对应字段；如果前面选了多表，流程字段和子表字段的映射要逐个核对。结果展示页要看我发起的、待办事宜、已办事宜、抄送事宜、流程委托、流程监控这些入口是否都能查到数据。只测发起不测抄送和委托，上线后一定有人问“为什么我的待办里没有这条”。

提示：在线开发阶段每改一次表结构，都要回到列表设计和流程设计各点一遍预览。表单能打开不代表列表能查，列表能查不代表流程能流转。

3. 代码生成与数据建模：从拖拽配置到可维护代码的五个依赖

代码生成是这份手册里容易被低估的一章。功能表单和流程表单都可以走代码生成，但生成时机、生成范围和维护方式不一样。在线开发适合快速迭代和业务人员自建，代码生成适合需要二开、需要把页面嵌进既有工程、需要走独立发布流程的场景。选型理由不是“代码生成更高级”，而是看后续谁来维护：业务字段频繁变、审批流经常调，留在线开发；页面要深度定制、要接内部前端框架、要走代码审计，再生成代码。

3.1 功能表单与流程表单：什么时候生成代码，什么时候留在线开发

功能表单的代码生成覆盖表单、列表、流程、结果展示，流程表单的代码生成更偏向审批链路。判断标准可以落成一张表：字段变更频率、页面定制深度、发布频率、维护人员。字段一周改三次，生成代码后每次都要重新拉分支合并，反而更慢；页面要嵌到既有后台、要复用一个内部组件库，在线开发的控件样式不够用，生成代码更合适。流程表单还要看节点事件复杂度，节点事件里大量脚本、子流程同步异步、审批汇总、流程评论，这些逻辑生成代码后要确认脚本挂载点还在。

生成代码前先把在线功能跑通，至少走完“新建—编辑—提交—审批—驳回—重新提交—抄送—导出”这条链。生成后不要立刻删在线版本，保留一个只读入口做对照。代码生成不是一次性动作，后续在线表单加字段，生成代码不会自动同步，要有字段变更记录。常见做法是给每个功能建一张字段变更表，记录字段编码、类型、是否必填、影响页面，生成代码前对照一遍。

3.2 数据连接、数据建模、数据字典的先后顺序

数据应用模块的顺序是数据连接、数据建模、数据字典、数据接口、接口认证、数据同步、行政区划。数据连接建好再建模，建模完成再配字典，字典稳定后再开接口，接口联调前配认证，最后做数据同步。这个顺序反了，接口字段和字典值对不上，联调时只能靠猜。数据建模来源是基础设置里多表选择的数据表，建模时要把主表、子表、外键关系标清楚。数据字典用来统一状态值、类型值、行政区划，字典编码一旦被表单引用，不要直接改编码，新增字典项比改编码安全。

数据接口配置时，参数设置区会展示接口含有的参数，表单字段下拉选择主表字段做筛选内容。子表动作设置的远端数据联动就依赖这里。接口返回字段和列表字段的对应关系要写进配置说明，不要只留在某个人脑子里。接口认证单独一章，说明认证参数和接口调用是分开管理的；联调前先确认认证参数有效期、调用方权限、接口路径，再测业务字段。数据同步要明确同步方向、同步频率、冲突策略，手工同步和定时同步的入口分开测试。

3.3 接口认证与数据同步：联调前先补的三张表

接口联调最容易出现“接口能通但数据不对”。我一般要求先补三张表：接口字段映射表、认证参数表、同步任务表。字段映射表记录接口字段名、类型、是否必填、对应表单控件编码；认证参数表记录参数名、获取方式、有效期、责任人；同步任务表记录源表、目标表、触发方式、失败重试次数。这三张表不需要多复杂，但能把联调从口头沟通变成可核对清单。

数据同步失败先看日志，再看接口认证，最后看字段类型。日期格式、金额精度、枚举值大小写是三类高频问题。接口认证参数过期时，页面可能只提示保存失败，不会直接告诉你是认证问题，所以联调阶段要把认证失败和业务失败分开记录。代码生成后的接口调用路径可能和在线开发不同，生成代码后要重新跑一遍认证和同步，不要默认在线能通生成后也能通。

4. 系统管理与权限：菜单、按钮、数据权限的颗粒度切法

系统管理不是上线后才配的“后台设置”，它决定前面做的表单、列表、流程能不能被正确的人看到。系统配置、系统公告、系统调度、系统缓存、系统日志、系统监控、系统图标、系统菜单、系统模板、数据应用，这些入口要按上线顺序排：先基础设置和安全设置，再菜单和权限，再模板和公告，最后调度、缓存、日志、监控。权限没配好就发公告，用户点进来看到空白页，后面解释成本很高。

4.1 系统配置的四个入口：基础设置、安全设置、第三方设置、超级管理员

基础设置放平台名称、Logo、登录页、图形验证、登录方式、锁定账户这类全局参数。安全设置放密码策略、会话时长、登录限制。第三方设置放外部集成参数，配置前先确认对方接口版本和认证方式，不要把测试参数带到生产。超级管理员账号要单独保管，日常业务操作不要用超级管理员，避免权限过大导致误删。系统公告支持新建、编辑、删除、详情、发布，发布时注意发送人员范围；消息中心看回执。系统图标和系统菜单影响导航，菜单新建后要配按钮权限、列表权限、表单权限、数据权限，导入导出菜单时先在小范围试。

系统模板里的短信模板、消息模板、打印模板、单据模板要提前建。短信和消息模板的变量名要和流程节点通知、系统公告的变量一致；打印模板和单据模板要绑定表单字段，字段编码变了模板会取不到值。系统调度支持内部方法类型，配调度任务时写清楚执行频率、失败重试、影响表。系统缓存清理要选低峰期，清理前确认哪些页面依赖缓存。系统日志分操作日志等类型，排查权限问题时先看操作日志，再看系统监控里的会话和资源指标。

4.2 菜单到数据权限的四层授权：按钮、列表、表单、数据

菜单权限不是只控制“看不看得到菜单”。系统菜单里有按钮权限、列表权限、表单权限、数据权限四层。按钮权限控制新建、编辑、删除、导出、批量审批；列表权限控制列表字段和查询字段；表单权限控制表单字段的可见、可编辑、必填；数据权限控制能看哪些组织、哪些角色、哪些分组的数据。四层要按“角色—菜单—按钮—字段—数据范围”的顺序配，先配角色再配菜单，先配按钮再配字段，最后收数据范围。

权限管理里还有分级管理、组织管理、岗位管理、用户管理、分组管理、角色管理、在线用户。用户管理支持新建、重置密码、解除锁定、导入导出；角色管理分角色成员和角色权限；分组管理用来做跨组织的临时授权。在线用户用来踢掉异常会话。数据权限常见做法是按组织树挂范围，再按角色补特殊规则，不要给单个用户直接开数据权限，人员变动后很难收。表单权限里的子表字段权限要单独看，主表字段权限放开不代表子表字段也放开。

4.3 调度、缓存、日志、监控：出问题先看哪一页

系统调度、系统缓存、系统日志、系统监控是排障入口，不是运维专属。调度任务失败先看执行日志和重试次数，再看任务里的内部方法是否被改过名。缓存问题表现为页面数据不刷新或列表总数不对，先确认最近有没有清缓存、有没有改字典、有没有改权限。系统日志按操作日志查人、查时间、查菜单；系统监控看会话数、资源占用、慢请求。在线用户里能看到当前登录会话，异常会话可以先踢再让用户重登。

排障顺序可以固定成：页面报错先看浏览器控制台和系统日志；数据不对先看数据权限和字典；流程不走先看节点审批人和流程监控；接口失败先看接口认证和字段映射；定时任务不跑先看系统调度。这个顺序写进项目交接文档，比口头传“有问题找某某”有用。系统公告和消息中心也要纳入验收，公告发布范围选错，用户看不到或看太多都是问题。

5. 避坑与排查：低代码项目最容易翻车的五个地方

低代码平台的坑很少是“按钮点不动”，更多是配置顺序、字段映射和权限缓存叠在一起。下面五条是实施过程中反复出现的翻车点，每条按现象、原因、解决写。第5章不按功能模块分，按问题类型分：表单与流程类三条，权限与接口类两条。看完再去翻手册对应章节，定位会快很多。

5.1 表单与流程类踩坑

现象一：子表保存后主表查不到明细，或者明细串到别的单据上。原因通常是基础设置里选了多表，但子表外键字段和关联主键没配，或者外键类型和主键类型不一致；也有情况是子表控件关联了子表，但控件字段没选对子表列。解决方法是回到基础设置看多表关联，再进表单设计逐个检查子表控件的控件字段；用两条测试数据交叉验证，确认主表ID和子表外键能对上。子表动作设置里的列表字段和关联字段也要复核，接口字段和子表字段同名不代表自动映射。

现象二：主键策略选错，流程跑到一半想改改不了。原因是表单属性里的主键策略在流程保存后不可修改，雪花ID和自增长ID的选择要在建流程前定。解决方法是新建功能时先确认数据来源：外部系统导入、需要全局唯一、分库分表场景偏雪花ID；单库自增、历史数据迁移偏自增长ID。已经保存的流程不要硬改，复制一个新流程做迁移，旧流程只读保留。这个坑没有后悔药，只能在基础设置阶段多问一句。

现象三：并发提交时后一条覆盖前一条，审批意见丢了。原因是表单属性里的并发锁定没开，或者开了但提交前置脚本里有异步写值，导致乐观锁校验时字段已经变了。解决方法是审批、订单、库存类功能开启并发锁定；提交前置脚本只做同步校验和赋值，不拉远端接口；提交后置脚本做通知和日志。压测时用两个账号同时提交同一单据，看第二条是否提示冲突。冲突提示文案要能在页面上看懂，不能只弹一个技术错误码。

现象四：流程节点改了审批人，待办里还是旧人。原因是节点变更后没有走流程监控刷新，或者审批人取的是角色成员缓存。解决方法是先看流程监控里的当前节点和审批人，再看角色成员是否变更，最后清系统缓存并让用户重新登录。节点事件里如果写了审批人赋值脚本，要确认脚本执行顺序在审批人解析之后。抄送事宜和流程委托也要一起测，只测待办会漏掉抄送人。

5.2 权限与接口类踩坑

现象五：接口认证参数过期，保存时只提示失败，看不出是认证问题。原因是接口认证和业务接口分开管理，认证参数有效期没有纳入巡检；联调时用临时参数，上线后没换正式参数。解决方法是建认证参数表，记录参数名、获取方式、有效期、责任人；接口失败时先看认证返回码，再看业务字段。数据同步任务失败也要先排除认证，再查字段类型和冲突策略。代码生成后的接口路径可能变化，生成代码后重新跑认证和同步，不要拿在线开发的测试结果直接上线。

现象六：菜单给了，按钮也给了，用户还是看不到数据。原因是数据权限按组织树挂范围，用户所在组织不在范围内；或者列表权限放开了但表单权限没放字段，页面打开是空表单。解决方法是按“角色—菜单—按钮—字段—数据范围”逐层核对，先用超级管理员看全量，再用目标角色看差异。子表字段权限单独检查，主表放开不代表子表放开。权限改完清缓存并重新登录，避免会话里带旧权限。

6. 大屏门户与扩展应用：上线前用一条验收链把手册跑通

大屏设计、门户设计、报表设计和扩展应用容易在项目后期被当成“展示层”草草收尾。真正上线前，我建议把手册当验收清单用，而不是当功能字典翻。门户设计先新建门户再配结果展示，门户里的组件要绑定有权限的菜单和数据接口；大屏设计按大屏管理、地图管理、分类管理、数据源管理的顺序配，数据源没通之前不要先调样式；报表设计先确认数据连接和数据集，再做图表和表格。扩展应用里的功能示例、门户示例、报表示例、大屏示例、图表示例、表格示例、表单示例可以当回归用例，百万数据、导入导出、电子签名、电子签章、日程安排、邮件收发、知识管理、文档预览、条码示例、打印示例、地图示例、订单示例、订单管理、项目管理按项目实际勾选。

验收链可以固定成一张表，从登录开始走到数据归档：

这张表不用一次全跑，按“先权限、再表单、再流程、后展示”的顺序跑。每跑完一轮，把失败项记在字段变更表旁边，不要只记在聊天记录里。手册里的修订记录也值得看：V3.2到V3.4.2之间补了数据权限、表单权限、打印模板、在线JS、单据组件、数据建模导入导出、审批设置候选人、保存草稿、节点事件、子表合计、审批汇总、流程评论、子流程同步异步、图形验证、登录方式、锁定账户、消息模板、短信模板、多组织、系统图标、超级管理员、系统公告发送人员范围、系统调度内部方法、操作日志、APP菜单按钮权限、分组管理、流程批量审批、弹窗选择属性、必填设置、自定义按钮、子表字段权限、同步菜单、接口认证、高级查询、行内编辑、列表查询、子系统等。版本越往后，权限和流程细节越多，照着旧版本习惯配新版本，容易漏掉子表字段权限和接口认证。

我自己的习惯是：每次拿到这类产品手册，先按第2章的字段顺序做一个最小功能，再按第5章的五条坑逐条试错，最后用第6章的验收表跑一遍。从那以后我每次上线低代码功能，都强制走一遍“权限—表单—流程—接口—展示”的验收链，不再凭感觉点页面。手册在资源包里，拿到后先翻到在线开发做一条主子表数据，再对照系统菜单配四层权限，比从头到尾通读更快。希望帮到你。

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