为消息事件创建和配置 Undercover Agent

您可以创建由于发生入局或出局消息事件而调用特定服务的 Undercover Agent (UCA)。

1. 打开 Process Designer 桌面编辑器。
2. 在 Designer 视图中，单击实现旁边的加号 (+)，然后从列表中选择 Undercover Agent。
3. 在“新建 Undercover Agent”窗口中，输入以下信息：
   • 名称：输入新 Undercover Agent 的名称。
   • 调度类型：从下拉列表中选择 OnEvent。
   • 单击完成。
4. 在“公共”部分的文档文本框中，可以输入 Undercover Agent 的描述。
5. 在“调度程序”部分中的调度类型字段中，可查看当前 Undercover Agent 的调度类型。
6. 在事件标记区域旁边，接受缺省事件标记消息。如果需要，稍后还可以单击选择，然后选择内容。（内容选项用于源自 ECM 服务器的内容事件。相比之下，消息选项用于源自已创建的业务流程定义、JMS 侦听器或 Web Service 的消息事件。）
7. 在“详细信息”下，单击队列名称旁边的下拉列表以从以下选项中选择所需的队列：

   表 1. 可用的队列选项

   选项	描述
   异步队列	允许 Event Manager 作业同时运行。
   SYNC_QUEUE_1	强制一个作业完成以便下一个作业可开始。缺省情况下，提供三个同步队列。
   SYNC_QUEUE_2	强制一个作业完成以便下一个作业可开始。缺省情况下，提供三个同步队列。
   SYNC_QUEUE_3	强制一个作业完成以便下一个作业可开始。缺省情况下，提供三个同步队列。

   注： 有关 Event Manager 作业、监视这些作业以及创建和维护 Event Manager 执行队列的更多信息，请参阅维护和监控 IBM Business Process Manager Event Manager。 在测试或生产环境中，在 Process Server 上安装并运行流程时，所选队列必须存在于该环境中，才能运行 Undercover Agent。
8. 在实现区域旁边，接受缺省选项变量或选择服务（如果需要）。使用变量实施将事件从 Undercover Agent 直接传递到业务流程定义 (BPD)。 相比之下，通过添加业务逻辑或决策来使用服务实现以处理关于事件的信息。
9. 如果您选择了变量，那么缺省变量类型 NameValuePair 已选中。但是，您可以单击选择来选择其他现有的变量类型，或者可以单击新建来创建新的变量类型。
10. 如果您选择了服务，那么缺省附加的服务缺省 BPD 事件已选中。但是，您可以单击选择来选择其他现有的服务，或者也可以单击新建来创建新的 General System Service。
11. 确保选中了已启用复选框。
    注： 如果未选中此复选框，那么在收到或发送消息时，Event Manager 不会运行 Undercover Agent。（Event Manager 监视器可能会显示 Event Manager 已运行 Undercover Agent，但如果未选中此复选框，那么不会发生执行。）
12. 在“参数映射”部分中，如果希望在附加的服务中使用输入变量的缺省值，请选中使用缺省值复选框。如果连接的服务的输入变量没有缺省值，那么此复选框会禁用。

    如果要将常量值映射到连接的服务的输入变量，请在文本框中输入值。例如，可能会出于测试目的而使用常量。

    在大多数情况下，必需值会包含在入局消息中，在此无需任何操作。

13. 在“事件”部分中，IBM BPM 提供了一个缺省标识，此标识在事件消息字段中唯一。此标识表示用于 IBM BPM 处理的事件消息。

    如果要将消息从外部系统记入 IBM BPM Event Manager，那么此字段中的标识为需要包含在 XML 消息中的事件名称。有关消息结构的更多信息，请参阅将消息发布到 IBM Business Process Manager Event Manager。

    如果正在使用 Web service 来使外部应用程序能够调用 IBM BPM，那么不应更改此标识。如果如构建样例入站集成中所述创建了入站集成，那么 IBM BPM 会无缝使用此标识。

14. 打开包含要将 Undercover Agent 附加到的消息事件的 BPD。例如，如果在外部系统中创建新客户记录时，希望启动特定流程，那么可以将 BPD 中的开始事件与处理该入局事件的 Undercover Agent 相关联。
    注： 请确保消息的发送方和接收方均使用同一 Undercover Agent。例如，如果消息的发送方是另一个 BPD 中的消息结束事件，那么为另一个 BPD 中的接收开始事件和发送消息结束事件均选择同一 Undercover Agent。
    提示： 如果您偶尔使用入站消息，请考虑使用持久预订事件。持久预订是一种 Java 消息服务 (JMS) 预订，会持久存储预定的消息，即使客户机未连接亦如此。即使您选中复选框以使这些持久消息可消耗，但是它们仍会不断累积。请定期使用 BPMDeleteDurableMessages 命令来删除持久预订事件。
15. 单击以选择 BPD 中的消息事件。
16. 单击属性中的实现选项。
17. 在“消息触发器”部分中，单击附加的 UCA 旁边的选择，然后选择在先前步骤中创建的 Undercover Agent。
18. 单击保存并切换回到 Undercover Agent 编辑器。
19. 如果要按维护和监控 IBM Business Process Manager Event Manager中所述测试该 Undercover Agent 并对其进行监视，可在 Undercover Agent 编辑器中单击立即运行。