实施指南 › 实施 › 业务逻辑脚本（业务逻辑专家） › 在业务逻辑内 › 事件流

事件流

如前所述，业务逻辑的输入是引擎事件和原始数据事件。

业务逻辑接收的原始数据事件由注册函数决定，该函数中的代码会请求由其事件类型和资源标识符定义的一组特定原始数据事件。

在业务逻辑中，注册还关联了已执行的用户定义的子例程，以便在接收原始数据事件时对其进行处理。 （默认情况下，它是 OnXXXEvent，应将其重命名为更有意义的名称。）

引擎事件由引擎根据关联的合同和度量标准定义来触发。 一旦触发并接收引擎事件，引擎将执行相关的事件处理程序。 每个引擎事件都有一个隐式事件处理程序。 这些事件处理程序是基于 VBScript 定义的函数和过程。 处理注册的事件处理程序和“结果”函数都是在代码中实施时必需的。 所有其他事件处理程序都是可选的。 但是，业务逻辑不处理未实施事件处理程序的引擎事件。 因此，最好将其全部准备就绪（即使未使用），以允许将来增强功能。

注意：在编写业务逻辑脚本时，实施所有引擎事件以便能够涵盖所有最终的可能性，这是非常重要的。 例如，即使在实施的第一阶段，时间段定义不适用，但将来所有公式将需要修改。 因此，建议业务逻辑专家提前定义“时间段内”和“时间段外”行为，即使最初不适用，但当引入该行为时，只需对系统进行少量更改。

以下是各种引擎事件及其事件处理程序：

• OnLoad (Time) -（可选），激活合同后，在计算开始时调用一次。 可用于初始化全局变量。
• OnRegistration (Dispatcher) -（必选），请求关联的原始数据事件并将其与要处理的用户定义过程关联的过程。 通过使用 Dispatcher 对象的方法请求事件并将其与过程关联。
  OnRegistration 由计算引擎在度量标准的计算开始时调用一次，每当为该度量标准注册的资源生效时再调用一次，此时引擎将评估对该资源执行的更改集，这会影响流向公式的事件集。 引擎具有通过事件类型和资源标识符定义的事件请求定义，有时资源（或包含多个资源的更改集）会发生与此集合相关的更改。 一旦它生效，便会触发 OnRegistration 事件处理程序。
• OnPeriodStart (Time) -（可选），在代理时段（根据时间单位设置）开始时调用。 一旦合同生效，便会触发第一个 OnPeriodStart，其中期间的平衡始于整点时间单位。 此事件处理程序通常用于周期性初始化变量，如一个计数器，它保存在计算期间内打开、然后应在每个期间开始时初始化为零的突发事件的数量。
• OnPeriodEnd (Time,IsCompleteRecord) -（可选），在代理时段（根据时间单位设置）结束时调用。 它始终在整点的输入结束时间单位调用（例如，24:00）。 当度量标准的期间已结束（根据应用程序服务器的真实世界时间）时，IsCompleteRecord 为 True，在进行中间计算时，IsCompleteRecord 为 False。 此事件处理程序通常用于结束期间的最终计算，以便为通过 Result 函数提供的最终结果做好基本准备。
• OnTimeslotEnter (Time) -（可选），在根据关联的度量标准定义进入 TimeSlot 期间时调用。 例如，如果度量标准与营业时间的时间段定义关联，其中每天上午 8:00 是时间段的开始，则每天的这一时间都会触发此事件处理程序。
• OnTimeSlotExit (Time) -（可选），在根据关联的度量标准定义退出 TimeSlot 期间时调用。 例如，如果度量标准与营业时间的时间段定义关联，其中每天在下午 17:00 结束，则每天的这一时间都会触发此事件处理程序。
• Target() -（可选）在将度量标准指定为具有动态目标时调用。 它允许您在业务逻辑运行时期间确定度量标准的服务水平目标。 此类目标可以包括服务组件或基础架构更改的消耗。 它具有四个值，与“结果”函数类似；每种模式对应一个值。 此函数在正常执行期间在 Result 函数之后执行。
• Forecast() -（可选）在通过让计算引擎以预测模式计算一次合同来执行合同版本的提交时调用一次。 预测模式将会针对合同执行完整的计算引擎周期（从合同版本的开始日期到结束日期）。 此周期的目的只是为了计算预测值。 （不对 T_RAW_DATA 表执行计算）。在此执行模式中，调用此函数来代替 Result 函数。
• Result() -（必选），由计算引擎调用，以便获取给定期间的计算结果。 总是在 OnPeriodEnd 事件处理程序之后调用 Result 函数。

以下是为了处理单个业务逻辑公式，计算机制（PslWriter 服务）需要执行的步骤：

• PslWriter 将公式加载到内存中，并执行声明部分（声明部分是在函数或子例程之外的所有代码）中存在的每条语句。 还请注意，所有附加的模块和库都包括并编译到这个代码模块中，以供执行。
• PslWriter 调用 OnLoad 事件处理程序。
• PslWriter 调用 OnRegistration。
• 期间的计算从调用 OnPeriodStart 开始。
• 对于在属于期间时间范围的 OnRegistration 期间注册的每个原始数据事件，PslWriter 都会调用与该事件关联的用户定义的事件处理程序。
• 如果时间段的开始或结束在该期间的时间范围内，将会调用 OnTimeslotEnter 或 OnTimeSlotExit。
• 如果在期间的时间范围中存在相关的基础架构更改，将调用 OnRegistration。
• 期间的计算以调用 OnPeriodEnd 结束。
• 如果已指定动态目标，则会调用此函数。
• PslWriter 调用 Result 函数，以获得期间计算的最终结果。

  注意：在最初提交合同版本并已选择预测时，将调用 Forecast 函数，而不是 Result 函数。 但是，对于每个版本而言，只会发生这一次。

在每个计算周期期间，引擎将评估计算时间段基于哪些相关的引擎事件和原始数据事件。 它先按时间对其排序，然后将其发送给相关公式进行计算。 原始数据事件的时间是其时间戳，引擎事件的时间是其触发时间。 然后，将这两种类型的事件组合在一个时间序列中，并发送以供计算。

事件的时间基于关联的本地度量标准，但事件处理程序的 Time 参数（即 OnPeriodStart (Time)）和原始数据事件的时间戳基于其 UTC 值。 引擎根据其 UTC 值对其进行比较，以使用不变的参考点。

示例：

如果度量标准与 UTC 的时区差异是两小时（即 GMT+2），并且突发事件开始时间的时间戳为上午 10:00，那么在引擎中，事件处理程序将使用的时间戳实际会进行相应转换，在 UTC 上午 8:00 真正开始。 假定适配器配置为使用同一时区，那么原始数据事件也将在数据库中转换回 UTC 2 个小时。 在将事件传递给业务逻辑时，负责为从上午 10:00 开始的期间计算事件的计算代理将实际对事件使用 UTC 时间，即从上午 8:00 开始。 但是，如果在代码中使用 out.log 消息来打印时间戳，则会显示转换为 UTC 的时间戳，因此将显示上午 8:00，尽管指定的期间为上午 10 点（根据度量标准）。

在下面的计算要求中，在使用事件的时间戳之前对其进行转换非常重要：

如果度量标准要计算在同一天打开和关闭的突发事件数，则需要比较每个突发事件的开始和结束时间。 如果突发事件的开始和结束时间在同一天（并在定义的时间段内），将计算该突发事件。

在突发事件从其原始本地时间转换为 UTC 的过程中，可能会出现天更改的情况。（即 再次使用 GMT+2）。 在凌晨 1 点打开的突发事件将转换回 UTC 时间前一天的晚上 11 点。那么即使本应计算该突发事件，也不会将其计算在内。 在此情况下，必须先将时间转换回本地度量标准时间，然后才能进行比较。 对于此类情况，请使用 GetLocaleTime(utcTime) 方法。 此方法可将以 UTC 时区给定的时间转换为本地度量标准的时区。

以下是事件处理程序代码：
Sub OnIncidentEvent(eventDetails)
   If dateDiff("d",Tools.GetLocaleTime(eventDetails.time),_
     Tools.GetLocaleTime(eventDetails("ClosedAt)))=0 then
          CountIncidents=CountIncidents+1
   End If
End Sub