简介:本资源是阿里巴巴官方出品的《0 代码,搭应用——宜搭开发手册》PDF电子手册,面向企业数字化负责人、业务部门人员及低代码初学者,聚焦解决传统信息化建设中系统缺失、流程脱节、信息孤岛、开发成本高等痛点。手册系统讲解宜搭平台的核心能力与落地实践,涵盖零代码搭建逻辑、页面/表单/流程配置方法、双端适配、权限管理、消息通知及数据安全机制,并提供“T恤尺码收集”“设备报修”“企业进销存”“报销流程”等7个完整案例的分步实现。资源为单文件PDF格式,共1个文件,大小22.76MB,内容结构清晰,含开篇导引、产品优势、客户案例(杭州一医院、老板电器等)、核心要素详解及从入门到进阶的实操教程。已有6752人学习下载,是掌握宜搭平台全链路应用搭建能力的权威入门与参考指南。
1. 不写一行代码,也能把业务流程跑起来:宜搭不是“拖拽玩具”,而是可交付的轻量级应用底座
很多刚接触宜搭的人第一反应是:“这不就是个表单设计器?”——直到他们用三天时间上线了一个采购审批流,连数据库建模、权限分组、移动端适配、钉钉消息通知都自动完成。宜搭真正的价值不在“零代码”这个标签,而在于它把企业级应用开发中重复度最高、标准化最强的那70%环节(数据建模、流程编排、角色授权、页面渲染、集成触发)封装成可配置的原子能力。它不替代Java或Python写复杂算法,但能让你跳过Spring Boot项目初始化、MyBatis映射配置、Vue路由嵌套、Nginx反向代理这些耗时环节,直接聚焦在“这个审批要加一个法务会签节点”“销售报表要按区域+产品线交叉汇总”这类业务逻辑本身。适合业务部门自主提需、IT快速复核、一线运营人员持续迭代的协作场景——尤其当你的需求变更频率高于开发排期节奏时,宜搭不是备选方案,而是效率底线。
2. 从空白画布到可运行应用:宜搭开发的四层结构与最小闭环路径
宜搭的应用构建不是线性流水线,而是围绕“数据—流程—界面—集成”四层能力展开的网状配置。理解这四层的依赖关系和配置顺序,比记住按钮位置更重要。下面以一个典型的“差旅报销申请”应用为例,拆解如何用最简路径跑通首个可用版本。
2.1 数据模型层:用「数据管理」定义业务实体,而非手动建表
宜搭的数据模型本质是可视化的关系型数据库抽象。你不需要连接MySQL或创建SQL脚本,所有字段类型、主外键、校验规则都在图形界面中完成。关键点在于:主表必须有唯一标识字段(系统自动生成ID),关联表必须通过“关联字段”显式绑定,且关联方向决定数据查询路径。
提示:不要在“单行文本”字段上设置“必填”,而应使用“数字”“日期”“单选”等强类型字段——宜搭的校验逻辑深度绑定字段类型,文本字段的“必填”仅前端拦截,后端仍可绕过;而数字字段的“必填”会强制数据库级约束。
2.1.1 创建主表「报销单」并配置核心字段
进入「数据管理」→「新建数据表」→ 表名填“报销单”,点击创建。随后添加以下字段(括号内为字段类型):
| 字段名 | 类型 | 说明 |
|---|---|---|
| 报销人 | 人员选择 | 关联组织架构,支持搜索 |
| 报销日期 | 日期 | 默认值设为“今天” |
| 总金额 | 数字 | 小数位数设为2,添加校验“大于0” |
| 费用明细 | 子表 | 关联新建的「费用明细」表(见下) |
| 状态 | 单选 | 选项:草稿/待提交/财务审核中/已归档 |
# 宜搭后台实际执行的等效SQL(仅供理解,无需手动执行) CREATE TABLE `expense_form` ( `id` BIGINT PRIMARY KEY AUTO_INCREMENT, `creator_id` VARCHAR(32) NOT NULL, -- 报销人ID `submit_date` DATE DEFAULT (CURRENT_DATE), `total_amount` DECIMAL(10,2) CHECK (`total_amount` > 0), `status` ENUM('draft','pending','reviewing','archived') DEFAULT 'draft' );这段SQL不会出现在你操作界面,但它揭示了宜搭字段配置背后的约束逻辑:“数字”类型对应DECIMAL,“单选”对应ENUM,“人员选择”对应VARCHAR外键引用。配置时若漏掉“校验规则”,就等于放弃数据库层防护。
2.1.2 构建子表「费用明细」并建立一对多关系
新建数据表「费用明细」,字段包括:费用类型(单选:交通/住宿/餐饮)、金额(数字)、发票图片(附件)。关键步骤:回到「报销单」表编辑页 → 「字段管理」→ 新增字段 → 类型选“子表” → 关联表选“费用明细” → 关联字段选“报销单ID”。此时宜搭自动在「费用明细」表中生成一个隐藏的expense_form_id外键字段。
注意:子表字段不能直接在主表页面添加,必须先建独立子表再关联。常见错误是试图在主表里加“费用类型”文本字段,结果导致无法按费用类型统计——因为文本字段无法做聚合分组,而子表的单选字段天然支持“按费用类型求和”。
2.2 流程引擎层:用「流程设计」驱动状态跃迁,而非写if-else
宜搭流程不是简单审批链,而是带条件分支、自动动作、超时处理的状态机。一个报销单从“草稿”到“已归档”,本质是status字段值的受控变更,而流程图就是这个变更的可视化契约。
2.2.1 绘制基础审批流:三个节点与两个流转条件
进入「流程设计」→ 新建流程 → 绑定「报销单」数据表。拖入三个节点:
- 开始节点:自动触发,设置“创建时触发”
- 财务审核节点:指定审批人角色(如“财务部负责人”)
- 结束节点:状态设为“已归档”
关键配置在流转线上:
- 从开始到财务审核:条件设为
status == "待提交"(注意双等号,宜搭条件表达式语法) - 从财务审核到结束:条件设为
approval_result == "通过"
2.2.2 添加自动动作:让流程自己“干活”
在财务审核节点后添加「自动节点」:
- 动作类型:更新数据
- 更新对象:当前报销单
- 设置字段:
status = "已归档" - 执行时机:审批通过后立即执行
此时流程图中会出现一条虚线箭头指向自动节点。这意味着:审批通过后,系统不仅改状态,还同步触发后续动作(如发送归档通知)。如果只靠节点间流转条件,状态变更只能发生在人工操作瞬间;而自动节点让状态变更与业务动作解耦。
2.3 页面构建层:用「页面设计」组装交互视图,而非写HTML/CSS
宜搭页面不是静态模板,而是数据驱动的响应式容器。每个组件(表格、表单、图表)都绑定具体数据源,修改数据模型后,页面组件会自动提示“字段已变更,请刷新”。
2.3.1 创建「报销单列表页」:用「数据表格」组件呈现主表
新建页面 → 拖入「数据表格」组件 → 数据源选「报销单」表 → 字段勾选:报销人、报销日期、总金额、状态。关键设置:
- 操作列:启用“查看”“编辑”“删除”(需提前配置权限)
- 筛选器:添加“状态”下拉筛选,选项来源设为「报销单」表的“状态”字段枚举值
- 分页:每页显示20条(避免大数据量卡顿)
2.3.2 创建「报销单详情页」:用「表单」组件承载主子表联动
新建页面 → 拖入「表单」组件 → 数据源选「报销单」表。自动加载主表字段后,重点配置子表区域:
- 在表单底部添加「子表」组件
- 数据源选「费用明细」表
- 关联字段选“报销单ID”(系统自动识别外键)
- 子表字段勾选:费用类型、金额、发票图片
此时用户在详情页填写报销单时,可直接在子表区域新增多条费用记录,保存后自动写入关联数据。子表组件的“新增”按钮本质是调用INSERT INTO expense_detail (expense_form_id, ...) VALUES (...),无需任何JS代码。
3. 权限、集成与发布:让应用真正进入生产环境的三道关卡
一个能在测试环境跑通的应用,距离被业务部门天天使用还有三道硬性门槛:谁能看到、怎么连外部系统、如何确保每次更新不影响线上。这三步配置失误,会导致“明明功能都对,但销售总监打不开报表”或“钉钉消息发不到新员工”这类典型故障。
3.1 角色权限体系:用「权限管理」实现最小权限原则,而非全公司可见
宜搭权限模型是“角色→数据范围→操作权限”三级控制。常见误区是给角色赋“全部数据”权限,结果法务部能看到销售合同金额。正确做法是按业务域切分数据范围。
3.1.1 创建角色并绑定组织架构节点
进入「权限管理」→ 「新建角色」→ 名称填“区域销售经理”。关键操作:
- 在“数据范围”页签 → 选择「报销单」表 → 数据范围类型选“按字段过滤”
- 过滤条件设为:
报销人.所属部门 == 当前用户.所属部门 - 同时勾选“子表数据自动继承主表范围”(确保费用明细也受部门限制)
提示:“当前用户.所属部门”是宜搭内置变量,代表登录者所在部门。若用“报销人.所属部门 == '华东区'”这种固定值,后期部门调整需手动改权限——动态变量才是可持续方案。
3.1.2 配置页面级操作权限:细化到按钮级别
在「报销单列表页」编辑模式下 → 右侧「权限设置」面板 → 展开“操作权限” → 找到“删除”操作 → 取消勾选“区域销售经理”角色。这样该角色能看到列表、能编辑,但不能删单——符合财务审计要求。页面权限优先级高于角色全局权限,可实现同一角色在不同页面有不同操作权。
3.2 外部系统集成:用「连接器」对接钉钉/企微/数据库,而非写API脚本
宜搭原生支持主流办公平台和数据库,集成动作在可视化界面完成,无需Postman调试或Token管理。
3.2.1 钉钉消息通知:在流程节点后自动推送
回到「财务审核」节点 → 「节点设置」→ 「审批后动作」→ 添加“发送钉钉消息”。配置项:
- 消息类型:工作通知(非群聊,精准触达)
- 接收人:
审批人(自动取当前审批人) - 消息模板:
【报销审批】{{报销单.报销人}}提交了报销单 金额:{{报销单.总金额}}元 请于24小时内处理 → {{报销单.详情页链接}} - 链接字段必须是页面URL(可在页面编辑页右上角复制“分享链接”)
注意:
{{报销单.详情页链接}}是宜搭动态变量,生成的是带参数的短链(如https://xxx/xxx?recordId=123),点击直接打开对应单据。若手写URL,参数缺失将导致页面白屏。
3.2.2 MySQL数据同步:定时拉取外部系统订单数据
进入「数据管理」→ 「新建外部数据源」→ 类型选“MySQL” → 填写数据库地址、账号密码(宜搭加密存储)。创建成功后:
- 新建数据表「外部订单」→ 数据源选刚建的MySQL连接
- 字段映射:将MySQL的
order_id映射为宜搭主键,amount映射为数字字段 - 同步策略:设为“每小时全量同步”(首次全量,后续增量需在MySQL开启binlog)
此时「外部订单」表在宜搭中表现为只读视图,可作为报表数据源,也可在流程中用作条件判断(如“订单金额>10万时触发法务审核”)。
3.3 应用发布与版本管理:用「发布中心」控制灰度与回滚,而非直接上线
宜搭应用发布不是“一键上线”,而是分环境、带版本号、可追溯的发布流程。未发布的应用仅开发者可见,发布后才对目标角色生效。
3.3.1 创建发布版本并指定目标环境
进入「发布中心」→ 「新建发布」→ 版本号填v1.2.0(遵循语义化版本)。关键设置:
- 发布环境:选“生产环境”(非测试环境)
- 影响范围:选“指定角色”,勾选“区域销售经理”“财务部负责人”
- 发布说明:写明变更点,如“新增费用明细导出功能,优化审批超时提醒逻辑”
3.3.2 回滚操作:当新版本引发问题时秒级恢复
若v1.2.0发布后发现子表导出格式错乱,无需重做配置:
- 进入「发布中心」→ 找到v1.2.0记录 → 点击「回滚」→ 选择回滚到
v1.1.0 - 系统自动将页面、流程、权限配置还原至v1.1.0快照,5秒内生效
- 所有用户无感知,历史数据不受影响(因数据表结构未变)
提示:回滚仅还原配置,不删除v1.2.0期间产生的新数据。宜搭的版本管理本质是“配置快照”,与Git类似,但操作更轻量。
4. 高频实战技巧:解决90%新手卡点的五个关键配置项
宜搭学习曲线平缓,但几个关键配置项若设错,会导致整个应用无法推进。这些不是文档里强调的“高级功能”,而是日常搭建中反复踩坑的细节。掌握以下五点,能避开80%的咨询工单。
4.1 字段校验的双重生效机制:前端提示 + 后端拦截
宜搭字段校验分两层:
- 前端校验:用户输入时实时提示(如“金额必须大于0”)
- 后端校验:提交时数据库级约束(如
CHECK (amount > 0))
两者必须同时启用才真正有效。常见错误是只设前端校验,结果通过API或批量导入绕过验证。正确做法:
- 进入字段编辑页 → 「校验规则」→ 勾选“启用校验”
- 同时在「高级设置」→ 勾选“数据库校验”(此选项默认关闭)
验证方法:用浏览器开发者工具禁用JS,尝试提交非法数据——若仍被拦截,说明后端校验生效。
4.2 子表数据导出:用「数据表格」组件替代手动拼接
用户常问:“怎么把报销单和它的费用明细一起导出Excel?”答案不是写代码,而是利用组件联动:
- 在「报销单详情页」中,将「子表」组件替换为「数据表格」组件
- 数据源选「费用明细」表
- 关联条件设为:
报销单ID == {{当前记录.id}} - 开启表格的“导出Excel”按钮
此时导出的Excel包含费用明细所有字段,且文件名自动带报销单编号(如报销单_20240520001.xlsx)。子表组件无导出功能,但数据表格组件天然支持,这是宜搭组件设计的隐含逻辑。
4.3 流程超时自动处理:用「定时器节点」替代人工催办
审批流卡在某人手里是高频问题。宜搭提供「定时器节点」实现自动升级:
- 在「财务审核」节点后添加「定时器节点」
- 设置超时时间:
24小时 - 超时动作:发送钉钉消息给该审批人的上级,并将流程转交上级处理
- 注意:定时器节点必须放在人工节点之后,且不能跨流程分支
提示:超时时间单位是“小时”,非“天”。设
1表示1小时,24表示24小时。若填1天,系统报错。
4.4 页面URL参数传递:用「页面参数」实现跨页数据透传
从列表页跳转到详情页时,需把单据ID传过去。宜搭通过URL参数自动完成:
- 列表页的“查看”按钮 → 「动作设置」→ 选择“跳转页面” → 目标页选「报销单详情页」
- 参数映射:左侧
recordId(页面预设参数名),右侧{{当前行.id}} - 详情页的表单组件 → 「数据源设置」→ 主键字段选
recordId(系统自动识别URL参数)
此时访问https://xxx/detail?recordId=123,表单自动加载ID为123的报销单。recordId是宜搭保留参数名,不可自定义,否则详情页无法识别。
4.5 权限继承陷阱:子表数据范围必须显式开启
即使主表设置了“按部门过滤”,子表数据默认不继承——这是最大权限漏洞。修复方法:
- 进入「权限管理」→ 编辑对应角色 → 「数据范围」→ 找到子表「费用明细」
- 勾选“继承主表数据范围”
- 或手动设置过滤条件:
报销单ID IN (SELECT id FROM expense_form WHERE 报销人.所属部门 == 当前用户.所属部门)
验证:用非本部门账号登录,检查列表页是否只显示本部门报销单,且点进详情页后子表数据为空——若子表仍有数据,说明继承未生效。
| 配置项 | 正确值 | 错误示例 | 后果 |
|---|---|---|---|
| 数字字段校验 | 同时启用前端+后端校验 | 仅前端校验 | API批量导入非法数据 |
| 子表导出 | 用「数据表格」组件 | 用「子表」组件 | 无法导出明细 |
| 定时器超时 | 填数字24 | 填文字24小时 | 节点配置失败 |
| URL参数名 | recordId | id或formId | 详情页加载空白 |
| 子表权限继承 | 勾选“继承主表范围” | 未勾选且无手动过滤 | 跨部门数据泄露 |
宜搭的“零代码”不是消灭技术决策,而是把技术决策封装成可配置项。真正节省的不是编码时间,而是跨团队对齐成本——业务方描述需求时,可以直接指着流程图说“这里加个超时转交”,而不是等待开发排期、评审接口、联调测试。当你能把这五个技巧变成肌肉记忆,你就已经越过“使用者”阶段,进入“配置架构师”的角色。
本文还有配套的精品资源,点击获取