.view 文件 Schema¶
位置：
/{应用}.application/module/{模块}.module/{视图名}.view（目录） | XML 根：视图类型类名（ListView等） | 与技能对齐：generate-view-file机制背景见 [[design/table-schema/overview]]。
1. 用途与落盘¶
视图 = 数据展示定义。**目录**形态，内含同名元数据 + .column 列 + .activity 操作（+ 可选 .event）：
/{应用}.application/module/{模块}.module/{视图名}.view/{视图名}.view
/{应用}.application/module/{模块}.module/{视图名}.view/{列名}.column
/{应用}.application/module/{模块}.module/{视图名}.view/{操作名}.activity
落盘硬规则¶
id一律写根元素属性（<ListView id="...">、<column id="...">、<activity id="...">）；写成子元素<id>则不进url.index，等于不存在。- 列与操作必须同时写
<parentId>= 视图 id、<parentView>= 视图 id、<applicationid>= 应用 id。pid.index父子关系**只认<parentId>**。
2. XML 根 ↔ 视图类型¶
| XML 根 | 含义 | XML 根 | 含义 |
|---|---|---|---|
ListView |
列表（默认） | CollapsibleView |
折叠 |
CalendarView |
日历 | SheetView |
Sheet |
TreeView |
树形 | CardView |
卡片 |
MapView |
地图 | GanttView |
甘特 |
— 历史根 view/NormalView → ListView |
读盘按**根元素名**选型；改类型 = 改根标签。
3. 视图属性表（AbstractView 子元素）¶
| 元素 | 类型 | 默认 | 说明 |
|---|---|---|---|
id |
根属性 | 须生成 | __ + 短 UUID |
name |
string | — | 必填；文件名 |
parentId / applicationid |
string | — | 模块 id / 应用 id |
editMode |
string | 00 |
数据查询模式：00 设计（DQL 生成）/01 DQL 脚本/02 SQL/03 存储过程/04 脚本数据 |
relatedForm |
string | — | 数据来源表单 id（不是 formId） |
searchFormId |
string | — | 查询表单 id（表单 type=256） |
openType |
int | 1 | 打开方式 |
filterCondition |
CDATA | — | 设计模式过滤；**JSON 数组**字符串 |
commonFilterCondition |
CDATA | — | 常用查询配置；JSON 数组；无则 [] |
filterScript / sqlFilterScript / procedureFilterScript / scriptDataFilterScript |
CDATA | — | 对应 editMode 01/02/03/04 的数据脚本 |
dataSourceId |
string | — | 数据源 |
pagination / pageLines / showTotalRow |
bool/string | true | 分页；折叠视图须 pagination=false |
expandQueryForm |
bool | false | 展开查询表单；默认否，需展开显式 true |
readonly / selectCheckbox / isAllowDrag / autoCompose |
bool | ||
permissionType / styleId / orderno |
string/int | public | |
showWaterMark / waterMarkScript |
bool/CDATA | 水印 | |
mobileDisplayMode |
string | list/card | |
orderField / orderType |
string | 默认排序 | |
auth_user/auth_role/auth_fields/authFieldScope/departments |
string | 私有权限 |
4. .column 列文件¶
XML 根 column；表单 id 标签为 <formid>（全小写）。通用元素：id（根属性）、name、parentId/parentView（= 视图 id）、applicationid、type（列类型文本）、width、orderno、formid、fieldName 等。
要点：
- 字段列
type=FIELD，配formid+fieldName - 状态类列 → 脚本列 + HTML tag（非纯文本）
OPERATE操作列配buttonType- 树视图用三个列文件（树三列）；日历视图需日期映射列
mappingField支持映射列
5. .activity 操作文件¶
与表单 activity 同构（XML 根 activity、camelCase）。视图常用 type：2=创建、3=删除，以及导出/打印/批量操作等。详见技能文档 type 表。
6. 相关¶
| 资源 | 文档 |
|---|---|
| 数据来源表单 | [[form-file]] |
| 所属模块 | [[module-file]] |
| 甘特/地图视图设计 | design/core-components/gantt-view.md、map-view.md |
| 生成操作指南 | agent-skills-usage/skills/generate-view-file/SKILL.md（含各 editMode 完整示例、列类型全表） |