实施指南 › 实施 › 业务逻辑脚本（业务逻辑专家） › 在业务逻辑内 › 违反根本原因注释和事件注释

违反根本原因注释和事件注释

可在业务逻辑中设置违反根本原因注释，以解释服务水平结果。 违反根本原因注释与度量标准相关联。

还可以生成事件标注，这些事件标注是与原始数据事件而非度量标准相关联的注释。 这两种类型的注释均可从报告数据中查看。

可以在业务逻辑“Tools”对象中通过两种方法来创建违反根本原因和事件标注记录：

• Tools.AddRootCauseComment (Text, Timestamp, [resourceId])
• 保存根本原因注释。 此信息稍后在生成的报告中非常有用。 保存的根本原因注释解释了在特定时刻执行业务逻辑公式期间的特定情况。Information 参数指定应写入的注释。该方法会接收一个要与注释一起保存的时间戳。 它还接受 ResourceId 参数，用于指定与方法上下文相关的资源。 （此参数为可选项，可以省略。）
• Tools.AddEventAnnotation (EventId, Text)
• 这些方法可以用在业务逻辑中的任意位置，需要考虑应用位置的上下文。 在计算期间结束时添加根本原因注释可能更有意义，因为此时已知道服务水平低于该期间预期值的原因。 例如，假设在一个月的期间内，有四次停机，全部都是由一台设备引起的。 然后，就可根据关于停机的这些信息编译根本原因注释，这样，在查看此期间的报告时，就能了解到导致此时间内任何服务水平违规的因素。 对于 OnPeriodEnd 事件处理程序例程或运行到计算期间结束的其他类似函数，AddRootCauseComment 命令最适合。
• 但在处理实际原始数据事件时，添加事件标注更合适，它偏向于使用 OnXXXEvent，这是在注册声明中指定的一个自定义事件处理程序。在此事件处理程序中，与实际事件相关的所有字段都可通过 eventDetails 对象来使用。
• 在业务逻辑中此示例可能如下所示：

  Sub OnPeriodEnd(Time)
          pctAvailable = (TotalTime-OutageTime) / TotalTime
          Tools.AddRootCauseComment “Violations caused by the
     following items: ” & ViolationCollection, Time
  End Sub
  …
  …
  Sub OnIncidentEvent(eventDetails)
      OutageTime = OutageTime + eventDetails(“TimeToResolve”)
  
      If eventDetails(“TimeToResolve”) > 6 Then
          ViolationCollection = ViolationCollection &
      eventDetails(“HardwareId”)
          Tools.AddEventAnnotation eventDetails.EventId, “Incident “ _
            eventDetails(“IncidentId”) & “ not resolved within target
      time 6 hours”
      End If
  End Sub