通过审批任务,您可以配置基于审批的集成。您还可以通过审批任务控制集成流程。
您可以使用审批任务向一个或多个集成用户发送审批请求电子邮件。该电子邮件会包含一个集成链接,用户可手动批准或拒绝该请求。
在集成执行期间,当控制项到达审批任务时,执行将停止,并且审批任务后面的所有任务都将暂停。仅当用户手动批准或拒绝审批请求时,集成才会恢复执行。
审批任务具有以下用途:
- 根据用户是批准还是拒绝审批请求来暂停和拆分集成。
- 暂停集成直到经过指定时长。
- 用作调试集成的断点。
比较审批任务、暂停任务和计时器任务
所有三个(审批、暂停和计时器)任务都执行类似的集成暂停和恢复功能。但它们之间存在细微差异。下表介绍了三个任务之间的差异。
审批任务 | 暂停任务 | 计时器任务 |
---|---|---|
不支持自动恢复集成,需要人工干预来恢复集成。 | 支持手动和自动恢复集成。如果没有人工干预来撤消暂停,则集成会在暂停时间限制到期后自动恢复执行。 | 仅支持自动恢复集成。集成执行会在暂停时间限制到期后自动恢复。 |
无法通过 API 调用恢复集成。您必须使用集成界面手动解决暂停。 | 可以使用适用于集成的 Suspensions API 来恢复集成。 |
仅支持自动恢复集成。 |
集成暂停(已暂停)时,用户会收到通知。 | 集成暂停(已暂停)时,用户不会收到任何通知。 | 集成暂停(已暂停)时,用户不会收到任何通知。 |
支持输出变量(布尔值),可让您在恢复集成之前执行条件检查。但是,输出变量的值只能为 true 或 false 。 |
支持输出变量(字符串),可让您在恢复集成之前执行条件检查。您可以为输出变量设置任何值。 | 不支持任何输出变量。 |
配置审批任务
如需配置审批任务,请执行以下操作:
- 在 Apigee 界面中,选择您的 Apigee 组织。
- 点击开发 > 集成。
- 选择现有集成,或通过点击创建集成来创建新集成。
要创建新的集成,请执行以下操作:
- 在创建 Integrations对话框中输入名称和说明。
- 从支持的区域列表中选择集成的区域。
- 点击创建。
这将在集成设计器中打开集成。
- 在集成设计器导航栏中,点击 + 添加任务/触发器 > 任务以查看可用任务列表。
- 点击审批任务元素,并将其放入集成编辑器中。
- 点击设计器上的审批任务元素以打开审批任务配置窗格。
- 使用任务的配置属性配置显示的字段,详见下表。
系统会自动保存对属性的所有更改。
配置属性
下表介绍了审批任务的配置属性。
属性 | 数据类型 | 说明 |
Recipients
|
字符串数组 | 任务暂停时向其发送通知的电子邮件地址。 输入多个电子邮件地址,以英文逗号分隔。 |
Custom notification message
|
字符串 | 任务暂停时电子邮件通知中包含的自定义消息。 值可以是字面量,也可以是变量。如果变量包含自定义消息,请点击 VAR 并选择该变量。 |
Reminder frequency (in hours)
|
整数 | 提醒通知的频率。 如果暂停处于未解决状态,您可以发送提醒电子邮件通知,请求授权用户解决暂停。 |
Time until expiration (in hours)
|
整数 | 暂停的时间段。 如果暂停未在指定时间内解除,则暂停将默认被拒绝。 |
On expiration
|
布尔值 | 暂停到期后采取的操作。 您可以选择拒绝暂停或解除暂停。默认情况下,暂停会被拒绝。 |
isApproved (Approval)
|
布尔值 | 包含暂停解决后的状态的输出变量。
如果暂停得到批准,则 |
错误处理策略
任务的错误处理策略指定当任务因暂时性错误而失败时要执行的操作。如需了解如何使用错误处理策略,以及了解不同类型的错误处理策略,请参阅错误处理策略。