Camunda新手咨询：Node.js通过REST触发多流程的相关问题

作为Camunda老玩家，我完全懂你作为新手面对REST API文档时的懵圈感——尤其是想把Camunda当成业务逻辑黑盒来用的场景，抓对核心API和配置方式确实是关键。下面逐个解答你的问题：

1. 传递「新保险单售出」这类消息该用哪个REST API？ #

推荐用Signal API（就是你看到的POST /signal），这个API的广播特性完美匹配你的场景：一个事件触发多个流程实例化。

如果未来你需要针对特定流程实例发送一对一的业务消息，再考虑用Message API，但目前你的需求是“同一个事件触发任意数量的流程”，Signal的广播能力是最优解——非程序员后续新增流程时，只要在Camunda Modeler里给新流程的启动事件绑定同一个Signal名称，你的Node.js代码完全不用改，就能自动触发新增的流程。

2. 关于Signal API参数的困惑解答 #

针对你提到的几个参数：

• name参数：它要匹配的是你在Camunda Modeler里给Signal启动事件或中间信号捕获事件设置的信号名称（不是事件的ID！）。举个例子：你可以在Modeler里把多个流程的启动事件都绑定名为new-insurance-policy-sold的信号，发送Signal时name填这个字符串，就能触发所有绑定该信号的流程启动实例。
• executionId：完全可以省略！这个参数是给单个正在运行的流程实例发信号用的，你的场景是广播触发新流程，留空就会自动匹配所有绑定目标Signal的流程定义/运行中实例。
• tenantId：如果你的Camunda没有启用多租户（大部分新手场景都用不上），直接省略就行，不用传这个参数。

补充一句：Signal的name和流程启动事件的ID没关系，它是你定义的业务标识，用来关联事件和流程逻辑。

3. 怎么快速知晓启动流程需要传入哪些变量？ #

有几个实用的方法，兼顾程序员和非程序员的需求：

• Camunda Modeler直接查看：打开流程定义，选中Signal启动事件，看右侧属性面板的「表单」或「输入输出」模块，这里会明确标注流程启动需要的变量；另外也可以查看流程里的任务（比如用户任务、服务任务）用到的变量，这些都是启动时可能需要传入的。如果是非程序员维护流程，建议他们在Modeler里给变量加注释，或者用「表单字段」来明确必填项。
• 用REST API查询：调用GET /process-definition/key/{processDefinitionKey}/form-variables（把{processDefinitionKey}换成你的流程Key），能直接获取该流程启动需要的表单变量；或者调用GET /process-definition/{processDefinitionId}，返回的JSON里会包含流程定义的所有细节，包括变量配置。
• 测试时看错误提示：如果发送Signal时漏传了必要变量，Camunda会在返回的错误信息里明确指出缺少的变量名，这也是快速排查的小技巧。

额外给你个小建议：因为你希望Node.js只做事件通知、不耦合流程逻辑，所以尽量保持Signal的变量是通用的业务数据（比如保单ID、客户信息），流程内部的逻辑由Camunda维护——这样不管非程序员新增多少流程，你的Node.js代码只要负责把事件和通用数据发出去就行，完全不用关心流程细节。

内容的提问来源于stack exchange，提问作者JSLover