本主题介绍如何为基于 API 的自定义事件源配置监控。
若要配置事件监控器工具来监控基于 API 的自定义事件源：
- 请双击事件监控器工具，打开工具配置面板。
在事件源选项卡中，从平台下拉菜单中选择自定义/基于 API 的事件源，并配置以下设置：
连接 指定连接设置。 事件检索 指定要使用的事件检索模式（在指定的时间间隔进行轮询、在每次测试执行之后进行轮询或订阅事件生成器）。 用户代码 指定自定义事件监控应用程序或脚本的位置。详情请参阅可扩展性 API 模式。 在选项选项卡中，根据需要修改设置。
每次事件监控器执行前清除事件查看器 启用此选项，可在事件监控器启动监控时自动清除事件监控器事件视图（包括文本和图形）。 输出到链接工具的 XML 事件中包含测试执行事件 启用此选项仅在事件查看器选项卡和 XML 输出显示中显示受监控的消息和事件。此选项还指示每次测试启动和完成的时间。如果您在测试套件中有多个测试，并且希望更好地识别事件并将它们与您的测试执行关联起来，那么启用该选项非常有帮助。 使用 CDATA 包裹监控的消息以确保 XML 事件输出格式标准化 如果您不希望被监控事件的消息内容是格式良好的 XML，则启用此选项。禁用此选项将使事件中的消息可以通过 XPath 访问，从而允许 XML 转换器提取消息内容或使用 XML 断言器工具进行验证。
如果消息内容不是 XML，则启用此选项。这确保了事件监控工具的 XML 输出（即，用于将链接工具链接到事件监控器的 XML 事件输出（而不是事件查看器下显示的内容）是格式良好的 XML，它转义了所有消息内容。这将使 XPath 无法访问这些消息的内容，因为从技术上讲，消息只是父元素的字符串内容。
比较工具的 XML 模式支持 XML 字符串内容。因此，比较工具仍然能够将消息区分为 XML 格式，包括使用 XPath 忽略值的功能，即使禁用了该选项。
等待监控器启动的最大时间 (毫秒) 指定在 SOAtest 运行套件中的其他测试之前，事件监控器应该等待连接到事件源的最大时间长度。这使 SOAtest 能够为这些测试捕获事件，并防止在事件监控器连接到它的事件源时过度阻塞其他测试的执行。如果连接到事件源花费的时间超过默认值，则增加该值。默认为 3000。监控器最大执行时间 (毫秒) 指定测试应该超时的点。例如，如果测试套件中的另一个测试挂起，或者没有运行其他测试（例如，如果您在测试套件之外执行事件监控测试，那么使用自定义应用程序向系统发送消息）。 每次测试结束执行后事件查询延迟时间 (毫秒) 指定事件监控器在测试结束和检索事件之间等待多长时间。
