remote-services

用途：指导在 SAP CAP 应用中集成远程服务，包括外部 OData、S/4HANA 对接、BTP Connectivity 与 REST 服务消费。主要能力：用 cds import 导入外部服务定义（如 cds import ./BusinessPartner_A2X.edmx --as cds，或从实时系统导入并加 --force），生成 srv/external 下的 .cds 文件；在 package.json 的 cds.requires 中配置服务绑定（kind、model、credentials、destination、path）；在 init() 中用 cds.connect.to 连接并缓存连接，通过 this.S4.run(req.query) 将 OData 查询委托给远程；支持本地数据与远程数据混搭、转发 $filter/$top/$skip、REST 服务（kind: rest，api.get/api.post）、本地 mock 与 BTP Destination/Connectivity 配置。使用方式：导入定义后提交生成的 .cds 文件，在 init() 中连接，处理请求时委托查询；本地开发用 default-env.json（勿提交），生产用 Destination。限制与注意：勿在处理器内每次新建连接、勿硬编码密钥、勿先取全量再本地过滤、本地系统需加 connectivity 服务、需处理远程错误；CDS 10+ 可用 cds export 发布 API 包。具体版本与平台细节以官方文档为准。