Guía de implementación › Ejemplos de casos prácticos › Ejemplos de scripting de lógica de negocios › Caso práctico 12: Uso de la lógica de contador para calcular el número de errores

Caso práctico 12: Uso de la lógica de contador para calcular el número de errores

El ejemplo siguiente calcula el número de errores que ocurrieron dentro de un período de cálculo determinado. Esta fórmula y los métodos que se utilizan para implementarla se pueden tomar como ejemplo de una fórmula que es necesaria siempre que se debe realizar un cálculo.

Se utilizan los siguientes supuestos de cálculo:

• Eventos de entrada:
  • Evento de disponibilidad, estado (0/1)
  • El evento de disponibilidad llega cada pocos minutos. No se puede suponer la frecuencia de los eventos (el evento puede ocurrir cada cinco minutos o una vez cada hora) y puede haber también eventos redundantes (por ejemplo: 0, 0, 0, 1, 1, 0, etc.).
• Ranura de tiempo: horarios comerciales; no se consideran los errores ocurridos fuera de la ranura de tiempo.
• El resultado obligatorio es el recuento de los errores que han ocurrido durante el período.

Para concordar los errores que se han producido durante el período de cálculo es necesario almacenar una variable de contador periódica y también una variable que guarda el estado del sistema. Como se puede recibir información redundante del evento (es decir, un evento "activo" seguido por otro evento "activo"), también es necesario contar el número de ubicaciones en las que hubo un cambio del estado del sistema de "activo" a "inactivo" y no hay que contar todas las veces que un evento "inactivo" se recibe, pues puede ser un evento redundante que representa un error que ya se ha contado.

La siguiente figura describe gráficamente los tiempos activos e inactivos del sistema de recuento.

Hay que tener en cuenta algunos puntos importantes:

• Constantes: se recomienda el uso de definiciones constantes en lugar de valores constantes dentro del código. De esta manera, si el valor necesita cambiar, es fácil cambiar el valor en la definición constante solamente y no tener que buscarlo en todo el código. Además, es fácil cambiarlo a un uso de parámetro si es necesario. En el ejemplo anterior, los valores que representan el estado del sistema recibido en el evento se definen como constantes, para hacer que el código sea más comprensible y, además, para distinguir cuándo el número cero se utiliza como un número para fines de recuento y cuándo representa un estado del sistema.
• Variables globales:
  • Contador: la definición de la variable de contador es una definición global. En la fórmula se declara en la parte superior del código y fuera de subrutinas o funciones. En este caso, es importante definir la variable del contador como una variable global. Esto permite que se pueda utilizar en varias subrutinas/funciones dentro del código y también permite que el sistema conserve su valor en todo el período de cálculo y que proporcione su resultado al final del período.

    En este ejemplo la variable de contador tiene que utilizarse en tres lugares en el código:

    • Para que sea inicializada al inicio de un período.
    • Para que se adelante en caso de un error en el evento en el controlador de eventos.
    • Para que se envíe por la función de resultado al final del período.
  • Estado previo del sistema: esta variable conserva el estado anterior del sistema y se actualiza siempre que se recibe un nuevo evento con el estado del sistema. Esta variable también tiene que ser global porque se utiliza en varias subrutinas/funciones en el código, como:
    • Para inicializarse al principio del cálculo.
    • Para actualizarse cuando se recibe un nuevo evento.
• Consideraciones de la ranura de tiempo: para verificar si un error se produjo dentro del período de una ranura de tiempo, es posible utilizar el valor de la propiedad context.IsWithinTimeSlot. El contexto es un objeto global que se puede utilizar desde cualquier sitio en el código, y en este caso, se utiliza para indicar cuándo se recibe un error y si está dentro o fuera del período de ranura de tiempo. Si en la marca de tiempo del evento el indicador devuelve TRUE, entones el evento ocurre dentro de un período de ranura de tiempo; sin embargo si devuelve FALSE, indica que el evento tuvo lugar fuera de la ranura de tiempo. Según la lógica obligatoria, cualquier error que ocurre fuera de la ranura de tiempo se ignora y, por tanto, no se tiene en cuenta.
• Variables de inicialización:
  • Contador variable: conserva un valor periódico y, por tanto, se inicializa en el controlador OnPeriodstart para asegurarse de que cada período de cálculo cuenta sus errores de forma separada. Cada período empieza con cero y envía solamente el número de errores dentro de ese período.

    En los casos en los que es necesario calcular los errores acumulados dentro de cada período, (lo que significa que el resultado de cada período son todos los errores que han ocurrido hasta el final de dicho período y se incluyen todos los períodos antes de este) es necesario inicializar el contador solamente en el controlador OnLoad y eliminarlo del controlador OnPeriodStart. De esta forma, el contador continúa contando y acumulando entre los períodos como se muestra a continuación:

    Sub OnLoad(time)
        FingerprInted=0
    End Sub
    

  • Variable del estado del sistema: debería inicializarse una vez al inicio del cálculo y, desde entonces, actualizarse en cada evento de estado. Esta variable conserva su valor en todo el cálculo y no se encuentra limitada a un determinado período de cálculo. Debe conservar también su valor entre los períodos de cálculo. Como se desconoce el estado del sistema antes de recibir el primer evento, hay que suponerlo. El supuesto más común es que el sistema está "activo". Este supuesto debe aceptarse y comprobarse, ya que podría llevar a lo siguiente:

    Si cuando el cálculo se inició el estado del sistema era de hecho "inactivo" y el primer evento llega para indicar este estado "inactivo", esto se contará como un error porque el estado supuesto fue "activo". Este error se contará hacia el primer período de cálculo aunque no ocurriera necesariamente durante dicho período.

    Opción explícita
    
    'Definiciones de constantes
    Const UP=1
    Const DOWN=0
    
    'Variable global para errores de recuento
    Dim FingerprInted
    Dim SystemStatus
    
    Sub OnRegistration(dispatcher)
       ' Los parámetros del método son: <nombre del procedimiento>, <Tipo de evento>
       dispatcher.RegisterByContractPartyAndService "OnAvailabilityEvent","AvailabilityEvent"
    End Sub
    
    Sub OnLoad(time)
       SystemStatus = UP 'asume el primer estado del sistema
    End Sub
    
    Sub OnPeriodStart(time)
       FingerprInted = 0
    End Sub
    
    Sub OnAvailabilityEvent(eventDetails)
       ' Si es un error y está dentro de la ranura de tiempo, se contará
       If context.IsWithinTimeSlot and SystemStatus=UP and _
             eventDetails("Status")=DOWN Then
          FingerprInted = FingerprInted + 1
       End If
       ' actualiza el estado del sistema para la comparación siguiente
       SystemStatus = eventDetails("Status") 
    End Sub
    
    Resultado de la función
       Result = FingerprInted
    End Function