第二十二章 开发Productions - ObjectScript Productions - 生成警报

生成警报

如果发生警报事件，警报会在生产运行时向适用的用户发送通知。目的是提醒系统管理员或服务技术人员存在问题。可以通过电子邮件、文本寻呼机或其他机制发送警报。所有警报还会将消息写入 IRIS 事件日志，类型为警报。

生产警报机制的工作原理如下：

• 当为Productions创建业务主机类时，包括以下代码：

  1. 检测用户必须解决的不良情况或其他情况。
  2. 在这些情况下生成警报。

• 定义并配置一个警报处理器，它是一个名为 Ens.Alert 的业务主机。警报处理器可以选择性地管理警报以跟踪解决事件的过程。有关定义警报处理器的详细信息，请参阅定义警报处理器。任何产品最多只能包含一个警报处理器。

在业务主机类（BPL 流程类除外）中，执行以下操作以生成警报：

1. 在创建 Ens.AlertRequest的实例。
2. 设置此实例的 AlertText 属性。将其指定为提供足够信息的字符串，以便技术人员清楚地了解如何解决问题。
3. 调用业务宿主类的 SendAlert() 方法。该方法异步运行，不会耽误业务宿主的正常活动。

注意：有关在 BPL 中生成警报的信息，请参阅开发 BPL 流程。

添加Trace Elements

跟踪是主要在开发期间使用的工具。添加跟踪元素，以便可以查看生产中各种元素的行为，以进行调试或诊断。要将跟踪元素添加到产品中，需要在代码（通常是业务主机类）中确定希望查看运行时信息的区域。在这些区域中，添加（可能）编写跟踪消息的代码行。请注意，这些只是一般意义上的消息；跟踪消息只是字符串，与 Ens.Message 及其子类无关。

在大多数情况下，可以定义两种跟踪元素：用户元素和系统元素。在大多数情况下，定义用户跟踪元素更为合适。

注意：有关在 BPL、DTL 或业务规则中编写跟踪元素的信息，请参阅开发 BPL 流程、开发 DTL 转换和开发业务规则。

此外，有关启用跟踪的信息，请参阅在监控产品中启用跟踪。

在 ObjectScript 中编写跟踪消息

要在 ObjectScript 中编写跟踪消息，请使用以下代码行：

• 要编写用户跟踪消息：

 $$$TRACE(trace_message)

其中 trace_message 是一个字符串，其中包含有关在其中添加这行代码的上下文的有用信息。

• 编写系统跟踪消息（不太常见）：

 $$$sysTRACE(trace_message)

可能会在 IRIS系统代码中看到$sysTRACE，但是自己的业务主机类的适当选择通常是$TRACE。

$$$TRACE("received application for "_request.CustomerName)

用BPL或DTL编写跟踪消息

要在BPL业务流程或DTL数据转换中编写用户跟踪消息，请使用<trace>元素。请参阅《业务流程和数据转换语言参考》或《数据转换语言参考》。