Trigger 与 Action 配置
配置连接器的触发事件与执行动作。
概述
触发动作是指当一个事件发生时，触发数据流程。而产生触发事件的应用系统就是触发系统。Action 执行动作与 Trigger 操作差别不大。区别在于 Trigger 可作为集成流第一个节点，而接口若配置为 Action，则不能作为集成流的第一个触发事件。。
开始之前
[!IMPORTANT]
- 角色权限：你所在企业需经过研发灰度，可访问连接器开发页面
- 前置配置：已了解目标系统的触发事件类型和接口要求
第一步：选择触发事件
根据真实系统需求，选择哪些事件作为 Trigger（触发事件），选择新建。
实时触发：触发事件产生时，应用系统自动把数据推送到集成平台，集成平台随即响应并执行。
第二步：配置触发字段
根据接口要求，配置对应字段。
第三步：配置 Rest Hook
如果事件需要实时触发，需要选择 Rest Hook。Hook 地址有两种级别：
- 按照集成流生成：每个集成流都有不同 Hook 地址，用于不同事件区分
- 按照账号生成：系统级别（系统授权对应账号），多个事件共用一个 Hook 地址
Hook 地址需要在连接器配置完成后，进入集成流选择对应事件，生成对应 Hook 地址。
第四步：配置订阅请求
部分 SaaS 系统支持根据接口动态将 Hook 地址注册到对方系统。此时可按对方系统接口文档要求，配置对应接口及参数。。订阅请求中需要将平台生成的回调地址传给外部系统，使用 path("['input_data']['bundleUrl']") 引用。
第五步：配置轮询
如果事件需要轮询，配置轮询间隔或 cron 表达式。平台的轮询框架每次执行时会自动算好一组查询参数，塞进 pollingTimeArg 参数包中。
轮询占位符
| 占位符 | 含义 | 取值说明 |
|---|---|---|
path("['input_data']['pollingTimeArg']['startTime']") |
本次查询的时间窗口起点 | 毫秒时间戳（13 位数字）。取「上次拉到数据的时间」，没拉到过数据则往前回溯约 28 小时 |
path("['input_data']['pollingTimeArg']['endTime']") |
本次查询的时间窗口终点 | 毫秒时间戳，即本次轮询的执行时刻 |
path("['input_data']['pollingTimeArg']['limit']") |
每页条数 | 平台固定为 100，不需要你设置 |
path("['input_data']['pollingTimeArg']['offset']") |
翻页偏移量 | 第一页从 0 开始，每翻一页自动 +100，框架持续翻页直到取完（单轮上限 100 万条） |
轮询配置要点
你不需要自己填值。只需在连接器的请求配置（URL、Query 参数、Header、请求体）里用占位符把四个值「接」出来，再传给目标系统的查询接口。。
[!TIP]
时间单位是毫秒。如果目标接口要的是秒级时间戳，要把参数放到 Query 参数或请求体的值里，用整条表达式做除法：path("['input_data']['pollingTimeArg']['startTime']") / 1000。
配置 Action 类型
Action 执行动作与 Trigger 操作差别不大，配置方式相同。
预期结果与验证
配置完成后，Trigger 事件可以正常触发，Action 动作可以正常执行。
验证方法：
- 进入集成流，选择对应事件生成 Hook 地址。
- 触发一次事件，观察集成流是否按配置响应。
- 若未响应，检查触发字段、订阅请求与轮询配置是否正确。