.chart 文件 Schema¶

位置：/{应用}.application/module/{模块}.module/{图表名}.chart（单文件）　|　XML 根：chart 资源元素　|　与技能对齐：generate-chart-file 机制背景见 [[design/table-schema/overview]]。

1. 用途与落盘¶

统计图 = 一段返回 ECharts option 的 iScript + 展示配置。挂在**模块**下（区别于菜单/角色等应用级资源）。

/{应用}.application/module/{模块}.module/{图表名}.chart

2. 属性表¶

属性	XML 形态	类型	默认	说明
`id`	根属性	string	须生成	`__` + 短 UUID；菜单 linkType=02 / Widget 的 `actionContent` 引用
`name`	子元素	string	—	必填；文件名；模块内唯一
`parentId`	子元素	string	—	= 模块 id
`applicationid`	子元素	string		软件 id（勿写 `undefined`）
`scripttext`	CDATA	string	—	必填；iScript，return ECharts option
`chartName`	子元素	string	lineChart	图表类型键（§3）
`type`	子元素	string		历史字段；可与 chartName 同值
`viewId`	子元素	string	可空	点击图元跳转视图 id
`searchFormId`	子元素	string	可空	查询表单 id（配合 commonFilterCondition）
`commonFilterCondition`	CDATA	string	`[]`	JSON 数组 `[{"field":"查询表单字段id"}]`；空写 `[]`
`fontSize`	子元素	int	12	12–26
`description`	CDATA	string	可空

3. chartName 类型键¶

chartName	含义	chartName	含义
lineChart	折线	ringChart	环形
barChart	柱状	rectangleChart	矩形树图
pieChart	饼图	basicAreaChart	基础面积
funnelChart	漏斗	stackedAreaChart	堆叠面积
stepChart	阶梯	stackedBarChart	堆叠柱

设计器样例仅给静态演示脚本；业务图须把 scripttext 改为查库汇总后组装 option。

4. scripttext 形态¶

必须是**立即执行的 iScript**，return 一个 ECharts option 对象；推荐骨架：查库（queryByDSName/DQL）→ 汇总 → 组装 option → return。脚本内可用 getOption() 等上下文，详见技能文档 §3。

5. 入口挂接¶

PC/移动菜单：linkType=02 + actionContent=本图表 id + moduleid（见 [[menu-file]]）
首页 Widget：type=chart 类型组件（见 [[widget-file]]）

6. XML 骨架（最小折线占位）¶

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<chart id="__chartLeave00000001">
  <name>请假统计</name>
  <parentId>模块id</parentId>
  <applicationid>软件id</applicationid>
  <chartName>lineChart</chartName>
  <fontSize>12</fontSize>
  <viewId></viewId>
  <searchFormId></searchFormId>
  <commonFilterCondition><![CDATA[[]]]></commonFilterCondition>
  <scripttext><![CDATA[(function(){
    var option = { /* ECharts option（查库组装） */ };
    return option;
})()]]></scripttext>
</chart>

7. 相关¶

资源	文档
所属模块	[[module-file]]
菜单挂接	[[menu-file]]
Widget 挂接	[[widget-file]]
生成操作指南	`agent-skills-usage/skills/generate-chart-file/SKILL.md`（含查库拼 option 骨架、跳转配置）