Guia de Implementação › Exemplos de estudo de caso › Exemplos de script de lógica de negócios › Estudo de caso 12: Usando a lógica do contador para calcular o número de falhas

Estudo de caso 12: Usando a lógica do contador para calcular o número de falhas

O exemplo a seguir calcula o número de falhas ocorridas em um determinado período do cálculo. A fórmula e os métodos usados para implementar podem ser usados como um exemplo de uma fórmula obrigatória sempre que for necessário calcular alguma coisa.

As suposições de cálculo a seguir são usadas:

• Eventos de entrada:
  • Disponibilidade do evento, status (0/1)
  • O evento de disponibilidade chega com intervalo de alguns minutos. Não foi possível presumir a frequência do evento (o evento pode ocorrer a cada 5 minutos ou uma vez por hora) e também pode haver eventos redundantes (por exemplo: 0, 0, 0, 1, 1, 0, etc.).
• Período de atividade - horário comercial; as falhas que ocorrerem fora do período de atividade não são contadas.
• O resultado obrigatório é a contagem de quantas falhas ocorreram durante o período.'

Para calcular as falhas ocorridas durante o cálculo do período é necessário armazenar uma variável de contador periódico, bem como uma variável que armazena o status do sistema. Uma vez que as informações redundantes de eventos podem ser recebidas (ou seja, um evento Ativo seguido por outro evento Ativo), também é necessário contar o número de locais nos quais ocorreu uma alteração de status do sistema de Ativo para Inativo e não contar cada vez que um evento Inativo é recebido, pois isso pode ser um evento redundante que representa uma falha que já foi registrada.

A figura a seguir ilustra graficamente a contagem de horas ativas e inativas do sistema.

Pontos importantes que devem ser considerados:

• Constantes - é recomendado o uso de definições constantes, em vez de valores constantes no código. Dessa forma, se o valor precisar de alteração, é fácil alterá-lo apenas na definição constante e não é preciso pesquisá-lo em todo o código. Além disso, é fácil alterá-lo a um parâmetro, se necessário. No exemplo anterior, os valores que representam o status do sistema recebido no evento são definidos como constantes a fim de tornar o código mais compreensível, e também para diferenciar quando o número zero foi usado como um número para fins de contagem em vez de quando ele representa um status do sistema.
• Variáveis globais:
  • Contador - a definição da variável de contador é uma definição global. Na fórmula, isto é declarado no início do código e fora de quaisquer subrotinas ou funções. É importante definir a variável de contador nesse caso como uma variável global. Isso permite que ele seja usado em várias subrotinas/funções no código, e também permite que o sistema mantenha seu valor durante todo o período do cálculo e forneça seu resultado no final do período.

    Neste exemplo, a variável de contador precisa ser usada em três locais no código:

    • Para ser inicializada no início de um período.
    • Para ser antecipada no caso de uma falha no evento no manipulador de eventos.
    • Para ser enviada pela função de resultados no final do período.
  • Status anterior do sistema - esta variável contém o status do sistema e será atualizada sempre que um novo evento com o status do sistema for recebido. Essa variável também precisa ser global, pois é usada em algumas subrotinas/funções no código, como:
    • Para ser inicializada no início do cálculo.
    • Para ser atualizada quando um evento for recebido.
• Considerações sobre o período de atividade - para verificar se uma falha ocorre em um período de atividade, é possível usar o valor da propriedade context.IsWithinTimeSlot. O contexto é um objeto global que pode ser usado em qualquer lugar no código e, nesse caso, é usado para indicar quando uma falha é recebida e se ela está dentro ou fora do período de atividade. Se na data e hora do evento o sinalizador retornar o valor TRUE, significa que o evento ocorre dentro do período de atividade; no entanto, se ele retornar o valor FALSE, indica que o evento ocorreu fora do período de atividade. De acordo com a lógica necessária, qualquer falha que ocorrer fora do período de atividade é ignorada e, portanto, não é contabilizada.
• Iniciar variáveis:
  • Variável de contador - contém um valor periódico e é iniciada no manipulador OnPeriodstart para garantir que cada período de cálculo conte as falhas separadamente. Cada período se inicia com zero e registra apenas o número de falhas desse período.

    Nos casos em que é necessário calcular as falhas acumuladas em cada período (o que significa que o resultado de cada período consiste em todas as falhas ocorridas até o fim deste período, incluindo todos os períodos antes disso) é necessário inicializar o contador apenas no manipulador OnLoad e removê-lo do manipulador OnPeriodStart. Assim, o contador continua a contagem e a acumulação entre os períodos, como mostrado a seguir:

    Sub OnLoad(time)
        FingerprInted=0
    End Sub
    

  • Variável de status do sistema - deve ser iniciada uma vez no início do cálculo e, a partir desse ponto, ser atualizada em cada evento de status. Essa variável retém seu valor em todo o cálculo e não está restrita a um determinado período do cálculo. Ela também deve conter seu valor entre os períodos de cálculo. Como o status do sistema antes de receber o primeiro evento é desconhecido, deve-se fazer uma suposição para o status do sistema. A suposição comum é de que o sistema está Ativo. Essa suposição deve ser definida de comum acordo e verificada, pois ela pode conduzir ao seguinte:

    Se quando o cálculo for iniciado, o status do sistema estiver, de fato, Inativo e o primeiro evento chegar para indicar esse status, ele será contado como uma falha, pois o status presumido era Ativo. A falha será contabilizada no primeiro período do cálculo, mesmo se não ocorreu necessariamente durante esse período.

    Option Explicit
    
    Definições de constantes
    Const UP=1
    Const DOWN=0
    
    Variável global de contagem de falhas
    Dim FingerprInted
    Dim SystemStatus
    
    Sub OnRegistration(dispatcher)
       'Os parâmetros de método são: <procedure name>, <Event Type>
       dispatcher.RegisterByContractPartyAndService "OnAvailabilityEvent","AvailabilityEvent"
    End Sub
    
    Sub OnLoad(time)
       SystemStatus = UP 'assume the first system status
    End Sub
    
    Sub OnPeriodStart(time)
       FingerprInted = 0
    End Sub
    
    Sub OnAvailabilityEvent(eventDetails)
       Se ocorrer uma falha e estiver dentro do período de atividade, ela será contabilizada
       If context.IsWithinTimeSlot and SystemStatus=UP and _
             eventDetails("Status")=DOWN Then
          FingerprInted = FingerprInted + 1
       End If
       'atualizar o status do sistema para a próxima comparação
       SystemStatus = eventDetails("Status") 
    End Sub
    
    Function Result
       Result = FingerprInted
    End Function