SuperAPI AI 工具集

localization

通用与其它

查看项目

更新于 10-16 02:37

技能介绍

用途:在 SAP CAP 项目中实现国际化(i18n)与本地化,包括可翻译数据、消息包与注解翻译。

主要能力:用 localized 标记可翻译字段(如 title、description),CAP 自动生成 Products_texts 表(locale 与 ID 为键),按 req.locale 自动返回译文;用 _i18n/i18n.properties 及 i18n_de.properties 等管理 UI 标签与带占位符的错误消息;在注解中用 '{i18n>Products}' 引用键;在处理器中用 req.reject(404, 'PRODUCT_NOT_FOUND', [productId]) 等按 locale 解析消息;从 @sap/cds/common 复用 Currency、Country、Language 类型;用 temporal 支持时间相关数据。

使用方式:种子数据 CSV 需用逗号分隔(2025 年 11 月文档更新),主数据与 _texts 文件分别提供;安装 @sap/cds-common-content 并在 cds.requires.db.model 中加入该模型以填充货币/国家/语言;req.locale 由 Accept-Language 自动设置,必要时可用 .localized(req.locale) 手动覆盖。

限制与常见错误:CSV 勿用分号;勿在处理器硬编码译文;勿用 String(3) 代替复用类型;勿遗漏 _texts CSV;勿用硬编码 @title;勿忘将 common-content 加入模型。具体版本与平台细节以官方文档为准。