本主题解释如何为基于 API 的自定义事件源配置监视。

若要配置事件监控工具来监控基于 API 的自定义事件源：

1. 请双击事件监视器工具，打开工具配置面板。

2. 在 Event Source 选项卡中，从 platform 下拉菜单中选择 Custom API-Based Events Source ，并配置以下设置：

   

   Connection	指定连接设置。
   Event Retrieval	指定要使用的事件检索模式（在指定的时间间隔进行轮询、在每次测试执行之后进行轮询或订阅事件生成器）。
   User Code	指定自定义事件监视应用程序或脚本的位置。有关更多详情，请查阅 Extensibility API Patterns 。

3. 在 Options 选项卡中，根据需要修改设置。

   

   Clear the event viewer before each event monitor run	启用此选项，可在事件监视器启动监视时自动清除事件监视器事件视图（包括文本和图形）。
   Include test execution events in the XML event output to chained tools	启用此选项 仅在事件查看器选项卡和 XML 输出显示中显示受监视的消息和事件。 。此选项还指示每次测试启动和完成的时间。如果您在测试套件中有多个测试，并且希望更好地识别事件并将它们与您的测试执行关联起来，那么启用该选项非常有帮助。
   Wrap monitored messages with CDATA to ensure well-formedness of the XML event output	如果您不希望被监视事件的消息内容是格式良好的 XML，则启用此选项。禁用此选项将使事件中的消息可以通过 XPath 访问，从而允许 XML 转换器提取消息内容或使用 XML 断言器工具进行验证。 如果消息内容不是 XML，则启用此选项。这确保了事件监控工具的 XML 输出（即，用于将链接工具链接到事件监视器的 XML 事件输出（而不是事件查看器下显示的内容）是格式良好的 XML，它转义了所有消息内容。这将使 XPath 无法访问这些消息的内容，因为从技术上讲，消息只是父元素的字符串内容。 Diff 工具的 XML 模式支持 XML 字符串内容。因此，Diff 工具仍然能够将消息区分为 XML 格式，包括使用 XPath 忽略值的功能，即使禁用了该选项。
   Maximum time to wait for the monitor to start (milliseconds)	指定在 SOAtest 运行套件中的其他测试之前，事件监视器应该等待 连接到事件源的最大时间长度 。这使 SOAtest 能够为这些测试捕获事件，并防止在事件监视器连接到它的事件源时过度阻塞其他测试的执行。如果连接到事件源花费的时间超过默认值，则增加该值。默认为 3000。
   Maximum monitor execution duration (milliseconds)	指定测试应该超时的点。例如，如果测试套件中的另一个测试挂起，或者没有运行其他测试（例如，如果您在测试套件之外执行事件监视器测试，那么使用自定义应用程序向系统发送消息）。
   Maximum monitor execution duration (milliseconds)	指定测试应该超时的点。例如，如果测试套件中的另一个测试挂起，或者没有运行其他测试（例如，如果您在测试套件之外执行事件监视器测试，那么使用自定义应用程序向系统发送消息）。
   Event polling delay after each test finishes execution (milliseconds)	指定事件监视器在测试结束和检索事件之间等待多长时间。