预定义内容指南 › 业务逻辑模块 › 库模块 › 工作日计数库

工作日计数库

此模块执行时间戳的实际操作，以确定工作日开始和结束时间。 提供了两个不同的逻辑：

• 在 X 天内 - 在统计天数时会考虑故障单的打开时间。 例如，如果故障单在 14:00 打开，并在下一工作日的 13:00 关闭，则会统计为一天。 如果该故障单在下一工作日的 15:00 关闭，则会统计为两天。
• 同一日、下一日 - 忽略故障单打开时间。 具有活动时间段的一天（因而被视为一个工作日）中的任何一秒会导致将该日统计为一个完整日。 例如，如果故障单是在第 1 天的时间段的最后一秒钟打开的，则会将该日统计为完整日。 如果故障单是在第 1 天的时间段之后打开的，则不统计该日。 如果故障单标记为同一日，该故障单必须在该日结束之前关闭。 请注意在打开故障单后第一个“时间段内”秒确定的日期。 在当天时间段退出后打开的故障单只在下一日才被视为活动，因此，如果某个同一日故障单在当天时间段退出后打开，必须在下一日结束时将它关闭。在打开日期的午夜后关闭的故障单将被统计为两天。

两种工作日逻辑都基于相同的模块，它们只有参数设置不同。

• 单时间段 - 此功能基于计算度量标准本身的单个时间段/时区。 需要实现以下参数：
  • WhatToCalculate - 此参数可让您确定是否要获取阈值范围内的故障单数，或者是否要从故障单总数中获取阈值范围内的故障单百分比 (PERCENT/CNTWITHINTHRESHOLD)。
  • CountWholeDays - 此参数确定您执行的是“同一日/下一日”功能 (TRUE) 还是“在 X 个工作日内”功能 (FALSE)。
  • DaysThreshold - 通知系统要将多少天视为成功。 对于“同一日”功能，还会统计第一天。 因此，同一日 = 1，下一日 = 2。 对于“在 X 个工作日内”，该数字更直观，因此，如果是在 3 天内，则该值应该是 3。

    注意：“同一日/下一日”功能实际上并不局限于这两个值，例如，可以在第三天结束时执行。

• 多时间段 - 除了以上有关单时间段功能的说明外，该新功能还支持多时间段事件。 此支持是通过一个名为“在 X 个工作日内(按时间段)扩展库”的附加扩展库实现的。 此库与度量标准本身连接。 它添加了时间段功能，并需要另外一对参数：
  • RegistrationList – 具有名为 LocationId 的单个字段的表参数。 应使用发送度量标准的、必须位于同一合同中的位置时间段事件列表来填充该表。
  • EventLocationId - 定义系统需要执行哪些操作来确定传入事件的位置。

  此外，为了启用此功能，还添加了一个新事件类型，以便处理跨故障单生命周期的夏令时变化。

  此事件类型名为 LocationDstChangeNotification，它的规范如下：

  • 字符串形式的 LocationId。
  • 整数形式的 DistanceFromUtc。

模块依存关系

下表列出了包含的模块。