sap-fiori-url-generator

用途

该技能用于根据应用名称生成 SAP Fiori Launchpad（FLP）URL。它从 AppList.json 应用清单中查找应用信息，并构造可直接用于启动 Fiori 应用的 FLP 链接。

主要能力

• 按应用名称搜索：支持不区分大小写、部分匹配的查找方式。
• 提取导航目标：从应用条目中读取“Semantic Object - Action”字段，用于生成 URL 的锚点部分。
• 构造完整 FLP URL：按固定结构拼接基础 URL、客户端、语言与语义对象-动作。
• 展示应用详情：可返回 App ID、App Description、Technical Catalog、Transaction Codes、Application Component 等信息。
• 相似应用建议：当未找到精确匹配时，列出名称包含搜索词的应用（默认最多 5 个）。
• 错误处理：覆盖应用未找到、缺少 Semantic Object-Action、多个匹配等情况，并给出提示。

URL 结构

{BASE_URL}/sap/bc/ui2/flp?sap-client={CLIENT}&sap-language={LANGUAGE}#{SEMANTIC_OBJECT}-{ACTION}

必填参数（必须由用户提供）

• BASE_URL：SAP 系统基础 URL，例如 https://myserver.com:44300，无默认值。
• sap-client：SAP 客户端号，例如 100，无默认值。

可选参数

• sap-language：语言代码，例如 EN、DE、FR；未指定时默认 EN。

自动生成参数

• SEMANTIC_OBJECT-ACTION：从 AppList.json 的“Semantic Object - Action”字段自动提取，无需用户输入。

使用方式

1. 读取 AppList.json 文件并解析为应用列表。
2. 按应用名称进行不区分大小写、部分匹配的搜索。
3. 提取匹配应用的“Semantic Object - Action”字段；若该字段缺失、为 NaN 或 null，则报错。
4. 校验用户是否提供 BASE_URL 与 sap-client；若缺失则提示用户补充。
5. 去除 BASE_URL 末尾的斜杠，拼接生成完整 FLP URL。

示例：

输入：

• Base URL：https://myserver.com:44300（用户提供）
• SAP Client：100（用户提供）
• App Name：Create Maintenance Request（用户提供）
• Language：EN（可选，默认 EN）

输出： https://myserver.com:44300/sap/bc/ui2/flp?sap-client=100&sap-language=EN#MaintenanceWorkRequest-create

适用场景

• 需要快速获得某个 SAP Fiori 应用的 FLP 启动链接。
• 需要按名称查找应用并确认其 Semantic Object-Action、App ID 等信息。
• 需要在生成链接时指定语言（如德语 DE、中文 ZH 等）。

限制与注意事项

• BASE_URL 与 sap-client 必须由用户提供，技能不会假设默认值。
• 若应用在 AppList.json 中不存在，或缺少 Semantic Object-Action，则无法生成 FLP URL。
• 若搜索词匹配到多个应用，需要用户指定具体应用。
• AppList.json 的数据可从 SAP Fiori Apps Library（https://pr.alm.me.sap.com/launchpad#FALApp-display）导出 Excel 后转换为 JSON，以保持应用列表更新。
• 部分应用字段可能为 NaN 或 null，生成 URL 时仅“Semantic Object - Action”为必需。

语言代码参考

EN 英语、DE 德语、ES 西班牙语、FR 法语、IT 意大利语、PT 葡萄牙语、ZH 中文、JA 日语、KO 韩语。