用途:数据视图是在单一数据源记录之上的已保存命名配置,不改变 schema 或数据,只控制网格/画廊(基于 TanStack Table + react-querybuilder)的呈现方式,如显示哪些列、列顺序、行筛选/排序/分组/着色,以及分页、行内编辑和表单行为。这些视图支撑 Docyrus 列表页的视图切换器。
主要能力:用 docyrus studio 的一组 *-data-view 命令完成列表、创建、读取、更新、删除。视图在后台存为一行记录(tenant_app_config_data_view),含四个不透明 jsonb 列 columns、filters、sort、color_rules 及 name、description、icon、color、is_default、sort_order、quick_filter_fields、archived 等标量列。存储子键名与 UI 属性名不同,如可见列存为 columns.visibility(非 columnVisibility)、颜色规则为 color_rules.row/cell。写错键视图仍能保存但渲染为默认。
使用方式:先确认认证、应用与数据源:docyrus auth who --json、docyrus apps list --json、docyrus studio list-fields --appSlug <app> --dataSourceSlug <ds> --json;枚举值需用 docyrus studio list-enums ... --fieldSlug <f> --json 获取 UUID。复杂视图建议用 --from-file ./view.json,小视图可用 --columns、--filters 等 JSON 字符串标志。创建示例:docyrus studio create-data-view --appSlug crm --dataSourceSlug contacts --from-file ./active-leads-view.json --json。创建后用 get-data-view 回读校验,再做往返与筛选测试。
适用场景与限制:适合为含状态字段的数据源按状态设计视图(选项 3–4 个时每状态一视图,更多则分组),并保留 All 视图。is_default 按数据源计,服务端不会自动取消其他默认。后端不校验 blob 内部结构,列 id 或枚举值写错会被静默忽略,因此必须校验并测试。缺失事实:具体定价、界面截图与官方支持范围暂未提供。