SuperAPI AI 工具集

sap-fiori

编程与开发

查看项目

更新于 11-06 17:04

技能介绍

用途

该技能是一个面向 SAP Fiori Elements 开发的 MCP 优先(MCP-First)工作规范。在编写、修改、调试或修复 CDS 注解、Fiori Elements 页面配置或 manifest.json 之前,必须先查询 Fiori MCP 服务器并应用其指导。

主要能力

涉及的注解范围:

  • CDS 注解:@UI、@Common、@Capabilities、@Communication
  • Fiori Elements 楼层平面:List Report、Object Page、Analytical List Page
  • manifest.json 配置:路由、数据源、控件配置
  • manifest 中的自定义操作(controlConfiguration.actions)

使用方式

使用 mcp__fiori__* 系列工具,主要包括:

  • mcp__fiori__search_docs
  • mcp__fiori__list_functionality
  • mcp__fiori__get_functionality_details
  • mcp__fiori__execute_functionality

工作流要求:

  1. 编码前查询:调用 mcp__fiori__search_docs 获取注解模式、楼层平面配置或 manifest 结构。
  2. 信任 MCP 优先于训练知识:若 MCP 指导与已有认知冲突,遵循 MCP。
  3. 修改时优先使用 Fiori MCP 工具:手工编辑 manifest.json 或注解前,先检查 mcp__fiori__list_functionality 是否提供自动化功能。
  4. 当 MCP 返回多个有效方案时,优先选择最简单的模式。

应用规则

创建或修改 SAP Fiori Elements 应用时:

  • 应用通常以 List Report 页面开始,用表格显示基础实体;行详情在基于同一实体的 ObjectPage 中展示。
  • ObjectPage 可包含基于一对多关联的表格区域;表格区域中的行详情可打开基于关联目标实体的另一个 ObjectPage。
  • 数据模型须有一个主实体,并通过导航属性关联到相关实体。
  • 每个属性必须有合适的数据类型。
  • 所有实体须提供 UUID 类型的主键。
  • 在 CSV 文件中创建示例数据时,所有主键和外键必须为 UUID 格式(例如 550e8400-e29b-41d4-a716-446655440001)。
  • 修改应用(如增加列)时不要使用屏幕个性化,应修改项目代码,并先检查 mcp__fiori__list_functionality 是否提供合适功能。
  • 预览时,使用 package.json 中该应用最具体的 npm run watch-* 脚本。

适用场景

SAP Fiori Elements 应用开发与维护,尤其是涉及 CDS 注解、页面布局配置和 manifest.json 编写的任务。

限制

资料未提供该技能的安装命令、调用示例及具体工具参数说明,暂未提供。