关于 sap-fiori-tree-table
面向使用 CAP 或 ABAP RAP 的开发者,指导在 SAP Fiori 应用中配置递归层级树表。内容区分两种后端实现方式,并说明前置条件、实施路径和故障排查。
主要功能
- 01CAP 层级配置指南
- 02ABAP RAP 层级配置指南
- 03实施前的必需输入检查
- 04树表配置与测试步骤
- 05常见问题排查
适用场景
- 01展示实体的父子数据
- 02构建组织层级视图
- 03配置 Fiori 分类树
MCP 相关
该技能将 Fiori MCP Server 列为生成和修改 Fiori 应用的必需项。CAP 项目还需 CDS MCP Server 查询模型;ABAP RAP 项目需 ADT MCP server 执行 RAP 操作。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ sap/ open-ux-tools --skill sap-fiori-tree-table安装后在 Claude Code 中输入/sap-fiori-tree-table确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/cap-implementation.mdrap-editable-introduction.mdrap-editable-prerequisites.mdrap-editable-treeviews.mdrap-editable-with-generator.mdrap-generator-requirements.mdrap-implementation.mdrap-read-only-treeviews.mdrap-troubleshooting.md详细介绍
具有递归层级结构的 SAP Fiori 树表
用途
配置层级树表,以递归结构显示父子关系(组织层级、类别树、嵌套数据)。
环境要求
CAP 项目:
- ✅ VS Code 或 SAP Business Application Studio(BAS) - 两种环境均受支持
- ✅ Fiori MCP Server - 生成和修改 Fiori 应用所需(仅限 VS Code)
- ✅ CDS MCP Server - 查询 CDS 模型所需
ABAP RAP 项目:
- ✅ 仅限 VS Code - ABAP Development Tools 扩展仅适用于 VS Code
- ✅ Fiori MCP Server - 生成和修改 Fiori 应用所需
- ✅ ABAP Development Tools for VS Code 扩展 - 后端开发所需(包含用于 RAP 操作的 ADT MCP server)
必须:先收集所需输入
如果提示中缺少以下任一输入,请暂停并向用户询问所有这些信息:
对于 ABAP RAP 项目:
- 包名称 - 创建或查找后端层级对象的位置(本地包使用 $TMP,或指定的包,例如 Z_MAINT)
- 是否需要传输请求:取决于包类型(本地包如 $TMP 选择 No,可传输的包选择 Yes)
- 实体名称 - 要设置为层级结构的实体(例如,“Equipment”、“Category”、“FunctionalLocation”)
对于 CAP 项目:
- 实体名称 - 要设置为层级结构的实体(例如,“Travel”、“Category”、“ProductCategory”)
在确认所有输入之前,请勿继续实施。
CAP 实施
快速摘要:
- 6 步流程:检查实体 → 添加关联 → 添加 @hierarchy → 配置 manifest → 创建数据 → 测试
- 支持 UUID、String 和 Integer 键(仅支持单个键)
- 需要 @sap/cds 9.6.0+ 和 OData V4
- 编辑前使用 CDS MCP 搜索模型
ABAP RAP 实施
快速摘要:
- 4 步流程:检查现有层级结构 → 实施后端 → 配置 manifest → 测试
- 需要作出选择: 只读(仅 List Report)或可编辑(带 Object Page)
- 后端实施详情请参阅:
快速故障排除
CAP 常见问题
- “@hierarchy 不受支持” → 使用托管关联(不带
on条件) - “表没有列” → 在 CSV 中使用
parent_ID(带下划线) - “TreeTable 未渲染” → 检查 manifest 中的
type: "TreeTable"和hierarchyQualifier
ABAP RAP 常见问题
- “元素不得启用搜索” → 从层级投影视图中移除
@Search注解 - “主键不匹配” → 子表需要复合键(子级 UUID + 父级 UUID)
📖 完整错误参考请参阅实施指南
主要区别
CAP:
- 实体中使用托管关联
- 服务上使用
@hierarchy注解 - 使用带有
parent_ID列的 CSV 数据 - 测试请参阅
sap-fiori-app-development技能中的 Application Preview Guidelines 部分
ABAP RAP:
- 使用带有
@OData.hierarchy.recursiveHierarchy的 CDS 视图 - 元数据中设置限定符
- 数据库表中的测试数据
- 测试请参阅
sap-fiori-app-development技能中的 Application Preview Guidelines 部分
评论
支持 Markdown