SuperAPI AI 工具集

ui5-best-practices-integration-cards

通用与其它

查看项目

更新于 10-15 23:40

技能介绍

用途:为编码智能体提供 UI Integration Cards(UI5 集成卡片)开发规则,在创建、修改、校验、预览或审查卡片及其配置前加载,确保产出可用卡片。

主要能力与规则:优先使用声明式卡片(List、Table、Calendar、Timeline、Object、Analytical),仅在例外情况创建 Extension;新建声明式卡片时使用 create_integration_card MCP 工具。参数绑定用 {parameters>/parameterKey/value}(单花括号、> 分隔、value 后缀);目标绑定用 {{destinations.destinationName}}(双花括号、点号),在 sap.card/configuration/destinations/ 下配置并按名称引用,不得替换为原始 URL。所有外部服务 URL 需包装为 destination。非数据的用户可见字符串绑定 i18n 模型;链接使用 actions 属性,禁止内联 <a> 或手写 URL 处理。不得修改提供的数据。sap.card/data/request 后端必须返回 JSON,OData 服务需追加 $format=json。

数据放置:数据请求只能位于 sap.card/data/;sap.card/content/data/path 与 sap.card/header/data/path 可覆盖主路径,但请求本身不得放在 content/data 或 header/data 下。出现“No data to display”时优先检查此处。

校验与预览:manifest.json 必须可解析,sap.app/type 必须为 "card",使用 run_manifest_validation MCP 工具做 schema 校验,不得含废弃属性,除 Component 类型卡片外不应是 UI5 项目。预览时先查找卡片文件夹中已有的预览入口(package.json start 脚本、README.md 或现有 HTML 文件)并复用,否则创建含 <ui-integration-card> 元素指向 manifest 的 HTML 页面并通过 http 服务器提供。

配置编辑器:供 Administrator、Page/Content Administrator、Translator 角色在不直接编辑 manifest.json 的情况下定制卡片,由 dt/Configuration.js(导出返回 new Designtime({ form: {...} }) 的函数)与 manifest.json 中 sap.card/configuration/editor 引用组成。编辑器须精确镜像 manifest 结构,所有现有字段可编辑,不得添加 manifest 中不存在的字段,并保持同步。

Analytical 卡片:需设置 sap.card/content/chartType,feeds 的 measures、dimensions 与 feeds 须匹配图表类型期望的 UID,每个 feed 含 type(Dimension|Measure)、uid、values 三个键,chartProperties 用于标签、颜色、图例等,不得臆造键。

限制:资料未提供具体收费、价格、平台支持范围等信息;规则细节以官方 Card Explorer 与示例源码为准。