【名称】

树形单据体

【功能说明】

数据行之间有父子关系，能将数据行按父子关系进行层级展示，支持折叠和展开的特殊的表格控件。

【设计时】

【运行时】

【元数据类全名】

Kingdee.BOS.Core.Metadata.EntityElement.TreeEntryEntity

Kingdee.BOS.Core.Metadata.EntityElement.TreeEntryEntityAppearance

【编程模型类全名】

Kingdee.BOS.Core.DynamicForm.PlugIn.ControlModel.TreeEntryGrid

【元数据XML】

【存储结构】

树形单据体几个特殊字段在数据库中的存储结构如下图，默认都是nvarchar类型。

【注意事项】

关于树形单据体的使用的有以下注意事项：

<1>主键、父级主键、行类型等关键字段不能用于界面录入，必须由后台二开插件分配好值数据。

<2>主键值既不能为空也不能重复。

<3>主键值和父级主键值不能构成循环引用。

<4>因为前端构造树时，强依赖主键和父级主键字段，建议将这些字段设置为锁定且不可见字段，避免因录入错误数据而导致树形单据体崩溃（具体表现为数据全部丢失无法显示）。

<5>树形单据体大部分异常行为（例如数据行不显示，上移下移失效，父子关系紊乱）通常最终都被定性为数据问题，可以通过在任意文本控件输入ShowGridData后执行Ctrl+Alt+F9快捷指令，实时查看树形单据体表格数据，排查异常。

【应用案例】

【二开案例.表单插件.树形单据体】https://vip.kingdee.com/article/383919630664259328

---------------------------------------------------------------------------------------------------------

【金蝶云星空BOS二次开发案例演示】https://vip.kingdee.com/article/94751030918525696

Jac_TreeEntity.rar

【表单插件】树形单据体.rar