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

生成警报

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

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

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

    1. 检测用户必须解决的不良情况或其他情况。
    2. 在这些情况下生成警报。
  • 定义并配置一个警报处理器,它是一个名为 Ens.Alert 的业务主机。警报处理器可以选择性地管理警报以跟踪解决事件的过程。有关定义警报处理器的详细信息,请参阅定义警报处理器。任何产品最多只能包含一个警报处理器。

在业务主机类(BPL 流程类除外)中,执行以下操作以生成警报:

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

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

添加Trace Elements

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

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

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

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

ObjectScript 中编写跟踪消息

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

  • 要编写用户跟踪消息:
 $$$TRACE(trace_message)

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

  • 编写系统跟踪消息(不太常见):
 $$$sysTRACE(trace_message)

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

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

BPLDTL编写跟踪消息

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

06-02 10:33