宜搭低代码高级认证:待办列表自定义页面实战指南
本文档详细记录了在钉钉宜搭平台中,通过自定义页面实现待办事项管理功能的完整流程。主要涉及表单设计、自定义页面搭建以及 JavaScript 逻辑编写,涵盖数据的增删改查及状态流转。
1. 基础环境准备
首先需要在钉钉组织中完成相关配置。如果二维码扫描失效,可通过手机钉钉右下角【我的】->【客服与帮助】->【快捷工具】->【加入团队】搜索组织名称加入。
1.1 创建数据表单
我们需要两个核心表单:'进行中待办'和'已完成待办'。
- 进行中待办:包含待办事项(单行文本)、分类(单选)、重要度(评分,默认值 1)、提醒日期(日期)、详情(多行文本)。
- 已完成待办:复制上述表单并修改名称即可。
注意:组件的唯一标识(如
rateField_me2n0yf0)每次创建都会不同,后续代码中需替换为你实际获取到的标识。

2. 自定义页面搭建
新建自定义页面时,选择【工作台模板 -01】作为基础,删除不需要的布局容器,将标题改为'待办列表'。
2.1 页面布局
使用分组组件将页面分为'进行中待办'和'已完成待办'两部分。每个部分内部放置表格组件,并根据表单字段调整列显示。 对于'重要度'等枚举字段,需在表格配置中定义样式映射,例如:
[ { "color": "grey", "text": "1", "value": 1 }, ... ]
设置页面背景色为白色以保持界面整洁。
2.2 关键参数获取
在编写 JS 逻辑前,需要获取应用编码(AppType)和表单 UUID(formUuid)。
- AppType: 浏览器地址栏中查找
appType参数。 - formUuid: 在表单设计器顶部地址栏或属性面板中获取。 这些参数是调用后端 API 的必填项。



