.application 文件 Schema¶

位置：/{软件名}.application/{软件名}.application　|　XML 根：application　|　与技能对齐：agent-skills-usage/skills/generate-application-file 机制背景（索引/热加载/写盘）见 [[design/table-schema/overview]]。

1. 用途与落盘¶

软件（Application）元数据本体，JAXB XML，id 为**根属性**。目录名 = 文件名 = <name>，三者必须一致。

storage/workspace/LeaveOA.application/LeaveOA.application

2. 属性表¶

属性	XML 形态	类型	默认	说明
`id`	根属性	string	须生成	`__` + 短 UUID；`applicationid` 同值
`name`	子元素	string	—	必填；workspace 全局唯一；即目录名
`description` / `remark`	子元素 CDATA	string		描述/备注
`type`	子元素	int	0	见 type 表；保存后慎改
`orderNo`	子元素	int	0	软件列表排序（升序）
`activated`	子元素	bool	false	true 才参与运行初始化/前台列表
`category`	子元素	string		分类标签
`brief`	子元素	string		简介
`ico`	子元素	string		图标 JSON 串（见 §4）
`homePage`	子元素	string		自定义首页路径
`dependencies`	子元素	string		依赖的其他软件 name
`createDate`	子元素	datetime		如 `2023-09-06T08:00:00.000+08:00`
`url`/`token`/`encodingAESkey`	子元素	string		仅 type=1 BPM
`weixinAgentId`/`WeixinSecret`	子元素	string		微信（Secret 字段名历史大写 W）
`dingdingAgentId`/`dingdingAppSecret`/`dingdingAppKey`	子元素	string		钉钉
`feishuAgentId`/`feishuAppSecret`/`feishuAppKey`	子元素	string		飞书
`systemWidgetSetting`	子元素	string		系统 widget 设置串

不落盘/运行期解析：modules（从子目录读）、默认 DataSource（以 .datasource 的 defaultDataSource 为准）、debugging/edit/isEncrypt（一般不落盘）。历史 <datasourceId> 字段**新写忽略**。

3. type¶

值	含义
0	常规软件（业务默认）
1	BPM 平台软件（可配 url/token/encodingAESkey）
2	系统软件（前台无需本软件角色即可见；仍须域绑定 + activated）

4. ico 格式¶

字符串形式 JSON（非嵌套 XML）：{"icon":"/uploads/lib/icon/p14_label.png","icontype":"img"}；icontype：img/font/空。

5. XML 骨架¶

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<application id="__a1b2c3d4e5f6g7h8i9j">
  <name>LeaveOA</name>
  <description><![CDATA[请假办公]]></description>
  <type>0</type>
  <orderNo>0</orderNo>
  <activated>true</activated>
  <category>demo</category>
  <brief>请假与考勤</brief>
  <ico>{"icon":"/uploads/lib/icon/p14_label.png","icontype":"img"}</ico>
</application>

6. 保存副作用与可见性¶

走平台 save API 且 activated=true 时：解析默认数据源 → 初始化平台静态表 → 对软件下所有表单执行动态表 createOrUpdate → name 变更则销毁重建 DataSourceEnv。手写文件则依赖启动/导入/设计器保存触发。
前台可见（非 SYSTEM 软件）：域 BIND_APPLICATIONS 绑定 + activated=true + 用户有该软件下 status=1 角色。
同目录伴生文件：pid.index、url.index（新建时创建空文件，见 [[design/table-schema/overview]] §3）。

7. 相关¶

资源	文档
数据源	[[datasource-file]]
角色	[[role-file]]
模块	[[module-file]]
生成操作指南	`agent-skills-usage/skills/generate-application-file/SKILL.md`