# @cap-js/advanced-event-mesh 中文文档 规范地址：https://npmcn.com/package/%40cap-js/advanced-event-mesh/ 版本：1\.1\.0 npm 元数据更新时间：2026-10-19T07:46:20.066Z 中文译文更新时间：2026-11-09T05:40:10.097Z 软件包许可：Apache-2\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40cap-js/advanced-event-mesh 原文对照：https://npmcn.com/package/%40cap-js/advanced-event-mesh/?lang=original 项目主页：https://cap.cloud.sap/ 源码仓库：https://github.com/cap-js/advanced-event-mesh ## 关键信息（来自 npm 元数据） - 包体积（解压后）：38.2 kB，4 个文件 - 模块格式：CommonJS - TypeScript 类型：未声明 - 运行依赖：2 个 - peer 依赖：@sap/cds ^10 \|\| ^9 - 首次发布：2025-03-11T14:07:24.952Z - 最新版本发布：2026-10-19T07:46:19.648Z - 近 30 天下载量：6233（2026-10-09 至 2026-11-07，npm 官方下载统计） - 已发布版本数：6（近 12 个月 1 个） ## 中文简介 CDS 插件提供与 SAP 集成套件集成, 高级事件网格 ## 安装 ```sh npm install @cap-js/advanced-event-mesh ``` 也可以使用：`pnpm add @cap-js/advanced-event-mesh`、`yarn add @cap-js/advanced-event-mesh`、`bun add @cap-js/advanced-event-mesh` ## README # 欢迎来到 @cap-js/高级事件mesh [![REUSE status](https://api.reuse.software/badge/github.com/cap-js/advanced-event-mesh)](https://api.reuse.software/info/github.com/cap-js/advanced-event-mesh) ## 关于这个项目 CDS插件提供集成SAP集成套件,高级事件网. ## 目录 - [关于这个项目](https://npmcn.com/package/%40cap-js/advanced-event-mesh/#readme-about-this-project) - [所需资源](https://npmcn.com/package/%40cap-js/advanced-event-mesh/#readme-requirements) - [设置](https://npmcn.com/package/%40cap-js/advanced-event-mesh/#readme-setup) - [设置经纪人](https://npmcn.com/package/%40cap-js/advanced-event-mesh/#readme-setting-up-the-broker) - [经纪人验证](https://npmcn.com/package/%40cap-js/advanced-event-mesh/#readme-broker-validation) - [其他配置选项](https://npmcn.com/package/%40cap-js/advanced-event-mesh/#readme-additional-configuration-options) - [支持、反馈、贡献](https://npmcn.com/package/%40cap-js/advanced-event-mesh/#readme-support-feedback-contributing) - [行为守则](https://npmcn.com/package/%40cap-js/advanced-event-mesh/#readme-code-of-conduct) - [许可证发放](https://npmcn.com/package/%40cap-js/advanced-event-mesh/#readme-licensing) ## 所需资源 见 [开始](https://cap.cloud.sap/docs/get-started/in-a-nutshell) 在SAP Cloud应用程序编程模型(CAP)中,如何启动您的开发并成长. 欲了解联合呼吁程序中的信息,请查阅以下指南: [事件和通讯](https://cap.cloud.sap/docs/guides/messaging/)。 。 。 . ## 设置 通过 : ```bash npm add @cap-js/advanced-event-mesh ``` 然后,设置 `kind` 您的邮件服务 `advanced-event-mesh`数字 : ```jsonc { "cds": { "requires": { "messaging": { "kind": "advanced-event-mesh" } } } } ``` ### 设置经纪人 经纪人本身必须在SAP集成套件、高级事件网点中手工创建,并且必须建立对相关应用程序的信任 [SAP 云身份服务](https://help.sap.com/docs/cloud-identity-services/cloud-identity-services)苏拉斯经纪人和 [SEMP API (英语)](https://docs.solace.com/Admin/SEMP/Using-SEMP.htm)。 。 。 . 详情请查阅SAP Information Suite、高级事件网点的文件 [帮助. pubsub.em. services.cloud.sap (英语)](https://help.pubsub.em.services.cloud.sap/Get-Started/get-started-lp.htm) 财务报告和审定财务报表 [帮助. sap.com](https://help.sap.com/docs/sap-integration-suite/advanced-event-mesh)。 。 。 . 具体来说, 您需要配置 SAP 集成套件, 高级事件网目, 以便您的 CAP 应用程序连接到经纪人 . 为此,遵循指南 [SAP 集成套件、高级事件网格的 CAP 插件](https://help.sap.com/docs/sap-integration-suite/advanced-event-mesh/cap-plugin-for-sap-integration-suite-advanced-event-mesh)。 。 。 . 最后,经纪人的证书必须通过下列方式提供: [用户提供的服务实例](https://docs.cloudfoundry.org/devguide/services/user-provided.html) 名称 `advanced-event-mesh` 以下列形式提交的全权证书: ```jsonc { "authentication-service": { "tokenendpoint": "https:///oauth2/token", "clientid": "", "clientsecret": "" }, "endpoints": { "advanced-event-mesh": { "uri": "https://:", "smf_uri": "wss://:" } }, "vpn": "" } ``` 对于故障连接问题, 设置组件的日志级别 `messaging` 改为 `DEBUG`。 。 。 . 检查 [`cds.log()`](https://cap.cloud.sap/docs/node.js/cds-log) 如何维持日志水平. ### 经纪人验证 您的应用程序必须附带服务 `SAP Integration Suite, advanced event mesh` 有计划 `aem-validation-service`。 。 。 . 请看 [VMR的验证](https://help.sap.com/docs/sap-integration-suite/advanced-event-mesh/validation-of-vmr-provisioning) 更多信息. ### 其他配置选项 消息服务的其他配置选项(即:, `cds.requires.messaging`它们是: | 财产 | 类型 | 说明 | | --- | --- | --- | | `skipManagement` | `boolean` | 如果设置为 `true`,插件不会创建队列或订阅。 如果您想要手动管理这些资源, 则此选项有用 : `false` | | `subaccountId` | `string` | 订阅 SAP 集成套件的子账户的标识 。 如果应用程序运行在另一个子账户中,则有必要这样做. | | `session` | [会话属性](https://docs.solace.com/API-Developer-Online-Ref-Documentation/nodejs/solace.SessionProperties.html) | 用于 [`createSession`](https://docs.solace.com/API-Developer-Online-Ref-Documentation/nodejs/solace.SolclientFactory.html#createSession) | | `queue` | [创建 MSGVpn 队列](https://docs.solace.com/API-Developer-Online-Ref-Documentation/swagger-ui/software-broker/config/index.html#/msgVpn/createMsgVpnQueue) | 通过 : [SEMP API (英语)](https://docs.solace.com/Admin/SEMP/Using-SEMP.htm) | | `consumer` | [信件消费者财产](https://docs.solace.com/API-Developer-Online-Ref-Documentation/nodejs/solace.MessageConsumerProperties.html) | 用于 [`createMessageConsumer`](https://docs.solace.com/API-Developer-Online-Ref-Documentation/nodejs/solace.Session.html#createMessageConsumer) | | `clientFactory` | [客户真品](https://docs.solace.com/API-Developer-Online-Ref-Documentation/nodejs/solace.SolclientFactoryProperties.html#SolclientFactoryProperties) | 用于创建 [客户端事实](https://docs.solace.com/API-Developer-Online-Ref-Documentation/nodejs/solace.SolclientFactory.html) 实例 | 手动管理资源示例( 插件未创建队列/ 订阅) : ```jsonc { "cds": { "requires": { "messaging": { "kind": "advanced-event-mesh", "skipManagement": true, "queue": { "queueName": "" } } } } } ``` 与 `skipManagement: true`,队列及其主题订阅必须在经纪人上已经存在——插件只将消费者绑定在现有队列上,不会创建. 默认值可以在插件中找到 [软件包.json](https://github.com/cap-js/advanced-event-mesh/blob/main/package.json)。 。 。 . 一如既往,您工程的有效配置可以通过 CLI 命令查询 [`cds env`](https://cap.cloud.sap/docs/node.js/cds-env)。 。 。 . 详细情况请参见 [通讯部分](https://cap.cloud.sap/docs/node.js/messaging) cAP节点js文件. ## 支持、反馈、贡献 此项目可通过下列方式对特性请求/建议、错误报告等开放: [GitHub 问题](https://github.com/cap-js/advanced-event-mesh/issues)鼓励并始终欢迎各方作出贡献和反馈。 关于如何作出贡献的更多信息,项目结构以及额外贡献信息见我们 [贡献准则](https://npmcn.com/package/%40cap-js/advanced-event-mesh/CONTRIBUTING.md)。 。 。 . ## 安全/披露 如果您发现任何可能存在安全问题的漏洞,请遵照我们的指示 [我们的安全政策](https://github.com/cap-js/advanced-event-mesh/security/policy) 如何报告。 请不要为与安全有关的疑问或问题创建 GitHub 问题 . ## 行为守则 作为成员、贡献者和领导人,我们保证使参加我们的社区成为每个人不受骚扰的经历。 通过参与这个项目,你同意遵守 [行为守则](https://github.com/cap-js/.github/blob/main/CODE_OF_CONDUCT.md) 在任何时间. ## 许可证发放 版权2024 SAP SE或一家SAP附属公司和高级活动参与者。 请看我们的 [自由主义](https://npmcn.com/package/%40cap-js/advanced-event-mesh/LICENSE) 版权和许可证信息。 详细信息,包括第三方组成部分及其许可证/版权信息 [通过REUSE工具](https://api.reuse.software/info/github.com/cap-js/advanced-event-mesh)。 。 。 . ## 常见问题 ### @cap-js/advanced-event-mesh 是什么？ CDS 插件提供与 SAP 集成套件集成, 高级事件网格 ### 如何安装 @cap-js/advanced-event-mesh？ 在项目目录运行 npm install @cap-js/advanced-event-mesh，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@sap/cds（^10 \|\| ^9）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### @cap-js/advanced-event-mesh 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/cap-js\_\_advanced-event-mesh 是否存在。 ### @cap-js/advanced-event-mesh 支持 ESM 还是 CommonJS？ 以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。 ### @cap-js/advanced-event-mesh 可以商用吗？ @cap-js/advanced-event-mesh 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。 ### @cap-js/advanced-event-mesh 的下载量有多少？ 根据 npm 官方下载统计，@cap-js/advanced-event-mesh 在 2026/10/09 – 2026/11/07 这 30 天内被下载 6,233 次，日均约 208 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @cap-js/advanced-event-mesh 还在维护吗？ 最新版本 1\.1\.0 发布于 2026/10/19（21 天前）；至今共发布 6 个版本，其中过去 12 个月发布了 1 个；首次发布于 2025/03/11。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。