用 SmartPage 生成并调整业务页面

TIP

这篇文档用于指导你用 SmartPage 生成一个业务页面，并在发布前完成预览、编辑和自检。 读完后，你可以写清楚页面需求，生成页面初稿，进入「编辑页面」调整页面，并判断页面是否可以保存或发布。

开始前准备

准备项	怎么准备
账号权限	确认你可以进入目标应用，并有页面创建、编辑或发布权限。
目标应用	确认页面要放在哪个应用里。不要在错误应用里生成页面。
数据来源	确认页面要使用的数据集、SQL、BFF 或 Backend Function 已经可用。
真实记录	准备 1 条可以检查的真实记录，用来确认列表、详情和表单字段是否正确。
页面需求	先写清楚页面给谁用、展示哪些字段、需要哪些按钮、保存后看到什么结果。

---

操作步骤

1. 进入 Lovrabet 站点，打开要配置页面的目标应用。
2. 进入页面管理或页面配置入口，选择使用 SmartPage 创建页面。
3. 在需求输入框里写清楚页面目标、使用对象、列表字段、筛选条件和操作按钮。
4. 如果系统要求选择数据来源，选择与页面目标匹配的数据集、SQL、BFF 或 Backend Function。
5. 点击生成，等待 SmartPage 生成页面初稿。
6. 打开页面预览，先检查标题、列表字段、按钮、筛选项和数据展示。
7. 如果页面需要调整，点击「编辑页面」进入编辑器。
8. 编辑完成后先点「预览」检查效果。确认无误后，再按团队流程保存、提交审核或发布。

TIP

**写需求时尽量具体。**不要只写“做一个管理页面”。把使用人、字段、筛选条件和按钮动作写出来，生成结果会更接近预期。

为运营人员生成一个供应商管理页面。
页面展示供应商列表，支持按供应商渠道、联系人和跟进人筛选。
列表字段包括供应商渠道、联系人、电话、邮箱和跟进人。
每行提供查看详情和更新操作。
页面支持新增供应商，新增时需要填写供应商渠道、联系人、电话、邮箱和跟进人。

生成页面

操作页面

---

编辑页面

INFO

当页面初稿和预期不一致时，先进入「编辑页面」调整页面。没有确认改动内容前，不要点击「保存」或「保存并预览」。

要做什么	怎么操作
进入编辑器	在页面预览里点击「编辑页面」。编辑器打开后，应能看到当前页面的画布预览。
检查页面内容	检查页面标题、字段名称、按钮名称、筛选项和空状态文案。
调整页面	在编辑器里调整页面文案、布局、字段显示和按钮配置。
预览效果	点击「预览」，确认页面展示和操作入口符合需求。
保存改动	只有确认改动正确时，才点击「保存」或「保存并预览」。

WARNING

如果直接打开页面地址后出现空白页，或提示页面未选中，先回到应用页面列表，重新选择目标页面，再进入预览或编辑器。

进入编辑页面

编辑列表信息

---

发布前检查

保存或发布前，按下面清单检查页面。示例页面可以使用 业务页面，但检查方法适用于其他页面。

检查项	看到什么算完成
页面能打开	页面标题、列表区域、主要按钮和分页能正常显示。
数据能看懂	字段名称是业务语言，列表里能看到真实记录。
编辑器能打开	点击「编辑页面」后能进入编辑器，画布能显示当前页面预览。
表单能提交	新增或更新表单里的必填项能被正确识别，提交后能看到保存结果。
记录能操作	按团队要求完成新增、更新、详情和删除验证。
内容可发布	页面没有测试文案、接口名、调试信息或无意义字段。

WARNING

如果新增提交时一直停留在「供应商渠道」这类必填校验，先检查选项绑定和校验配置。问题修复前，不要发布页面。

---

常见问题

生成的页面和预期不一致怎么办？

回到需求输入，补充使用对象、数据字段、筛选条件、按钮动作和保存结果后重新生成。不要只写“优化一下”。

页面没有数据显示怎么办？

先检查数据来源是否选对，再检查筛选条件是否过窄。必要时用一条真实记录验证字段是否能返回。

打开页面后是空白页怎么办？

先从应用页面列表重新选择目标页面，再进入预览或编辑器。不要在空白状态下保存页面。

新增提交一直提示必填怎么办？

先检查对应字段的选项绑定和必填校验。比如「供应商渠道」已经选择但仍提示必填时，需要先修复字段绑定，再继续新增、更新和发布检查。

什么时候需要 Backend Function、SQL 或 BFF？

当页面需要复杂查询、权限判断、跨数据来源读取或稳定写入动作时，先把这部分能力封装成 Backend Function、SQL 或 BFF，再让页面调用。

---

下一步

• 页面通过发布前检查后，再按团队流程保存、提交审核或发布。
• 把生成需求、关键截图和发布前检查结果留在需求记录中，方便后续追溯。
• 如果页面写入链路没有跑通，先修复字段绑定、校验或后端能力，再重新检查。