SAP Gateway $metadata 长文本扩展支持详解，从 DDIC 文本到 F1 文档的完整语义链路

在 SAP Gateway 项目里，经常会遇到一个看起来很小、实际却直接影响前端体验的问题。后台明明已经在 ABAP Dictionary 的 Data Element 里维护了字段标签、标题、描述甚至完整的 F1 帮助文档，可是调用 OData 服务的$metadata时，前端看到的往往只有一个简短的sap:label。表格列头、鼠标悬停提示、字段帮助等位置想复用 DDIC 里已经存在的文本，却发现 metadata 里根本没有。这并不是 Gateway 忘记输出这些内容，而是 SAP Gateway 对 metadata 文本采用了分层输出策略。SAP Gateway 可以为一个 OData Property 提供多种 UI 语义文本，其中最核心的三个 SAP 扩展 annotation 是sap:label、sap:heading和sap:quickinfo。当 Property 与 ABAP Dictionary Data Element 建立绑定关系时，Gateway 可以直接从底层 Data Element 读取对应文本，而不需要 OData 服务开发人员重新维护一套描述。SAP 官方文档明确说明了这种 DDIC 到 OData metadata 的继承关系。这套机制很有 SAP 味道。在传统 ABAP 开发里，我们很少把一个字段理解成单纯的 CHAR、NUMC、DATS 或 DEC 数据类型。字段通常通过 Data Element 获得业务语义。Data Element 背后又可以关联 Domain，并维护 Field Label、Headin