Guia de Implementação › Implementação › Criação de script de lógica de negócios (Especialista em lógica de negócios) › Dentro da lógica de negócios › Fluxo de eventos

Fluxo de eventos

Conforme mencionado anteriormente, as entradas para a lógica de negócios são os eventos do mecanismo e os eventos de dados brutos.

Os eventos de dados brutos recebidos pela lógica de negócios são determinados pela função de registro na qual o código solicita um conjunto específico de eventos de dados brutos definidos pelo tipo de evento e identificadores de recurso.

Na lógica de negócios, o registro também associa uma sub-rotina definida pelo usuário que é executada para lidar com o evento de dados brutos quando um evento for recebido. (Por padrão, é OnXXXEvent, que deve ser renomeado para algo mais significativo.)

Os eventos do mecanismo são acionados pelo mecanismo de acordo com o contrato e as definições de métrica associadas. Quando o evento do mecanismo é acionado e recebido, o mecanismo executa o manipulador de eventos pertinente. Cada evento do mecanismo tem um manipulador de eventos implícito. Esses manipuladores de eventos são as funções e os procedimentos definidos no VBScript. O manipulador de eventos que controla o registro e a função “Resultado” devem ser implementados no código. Todos os outros manipuladores de eventos são opcionais. No entanto, a lógica de negócios não lida com eventos do mecanismo para os quais manipuladores de eventos não estão implementados. Portanto, é uma boa prática mantê-los no local (mesmo que não estejam em uso) para permitir melhorias no futuro.

Observação: ao escrever o script de lógica de negócios, é importante implementar todos os eventos do mecanismo para que seja possível abranger todas as possibilidades finais. Por exemplo, se uma definição de período de atividade não for aplicável durante a primeira etapa da implementação, mas será aplicável no futuro, todas as fórmulas precisarão ser alteradas. Portanto, é recomendável que o Especialista em lógica de negócios defina o comportamento "no período de atividade" e "fora do período de atividade" com antecedência, mesmo que inicialmente ele não seja aplicável, para que quando o comportamento for apresentado, as alterações necessárias no sistema sejam triviais.

A seguir, há vários eventos do mecanismo e seus manipuladores de eventos:

• OnLoad (Time) - (opcional), chamado uma vez no início dos cálculos quando o contrato está sendo ativado. Pode ser usado para inicializar variáveis globais.
• OnRegistration (Dispatcher) - (necessário), procedimento para solicitar os eventos de dados brutos relevantes e associá-los com os procedimentos definidos pelo usuário com os quais serão manipulados. Os eventos são solicitados e associados a procedimentos usando os métodos do objeto Dispatcher.
  OnRegistration é chamado uma vez pelo mecanismo de cálculo no início do cálculo da métrica e novamente a cada vez que um recurso registrado para a métrica se torna vigente depois que o mecanismo avalia o conjunto de alterações feitas para o recurso que possam influenciar o conjunto de eventos transmitidos para a fórmula. O mecanismo tem a definição da solicitação do evento definida pelo tipo de evento e identificadores de recurso, e no caso de um recurso (ou um conjunto de alterações que contém diversos recursos) alterar alguma coisa relacionada a esse conjunto. Quando se torna vigente, um manipulador de eventos OnRegistration é acionado.
• OnPeriodStart (Time) - (opcional), chamado no início do período do agente (definido de acordo com a unidade de tempo). O primeiro OnPeriodStart é acionado quando o contrato se torna vigente, em que a comparação dos períodos começa com unidades de tempo de hora arredondada. Em geral, esse manipulador de eventos é usado para periodicamente inicializar variáveis, como um contador que controla o número de incidentes abertos durante o período de cálculo que, em seguida, deve ser inicializado para zero no início de cada período.
• OnPeriodEnd (Time,IsCompleteRecord) - (opcional), chamado no início do período do agente (definido de acordo com a unidade de tempo). É sempre chamado no final arredondado da unidade de tempo em horas arredondadas (por exemplo, 24h00). IsCompleteRecord é Verdadeiro quando o período da métrica estiver encerrado (de acordo com o tempo real do servidor de aplicativos) e é Falso ao fazer um cálculo intermediário. Em geral, esse manipulador de eventos é usado para fazer cálculos finais para o período de término a fim de preparar o terreno para o resultado final que será fornecido pela função Resultado.
• OnTimeslotEnter (Time) - (opcional), chamado ao inserir um período TimeSlot com base na definição da métrica associada. Por exemplo, se a métrica estiver associada a uma definição de período de atividade do horário comercial em que todos os dias às 8h00 será o início do período de atividade, esse manipulador de eventos será acionado nessa hora todos os dias.
• OnTimeSlotExit (Time) - (opcional), chamado ao sair de um período TimeSlot com base na definição da métrica associada. Por exemplo, se a métrica estiver associada a uma definição de período de atividade do horário comercial em que todos os dias termina às 17h00, esse manipulador de eventos será acionado nessa hora todos os dias.
• Target() - (opcional), chamado quando a métrica for especificada como tendo um destino dinâmico. Permite determinar o destino de nível de serviço de uma métrica durante o tempo de execução da lógica de negócios. Tais destinos podem incluir o consumo de componentes de serviço ou alterações na infraestrutura. Possui quatro valores, assim como a função Resultado; um para cada modo. Essa função é executada depois da função Resultado durante a execução normal.
• Forecast() - (opcional), chamado uma vez ao executar uma confirmação da versão do contrato por meio do cálculo do contrato executado uma vez no modo de previsão pelo mecanismo de cálculo. O modo de previsão executa um ciclo completo do mecanismo de cálculo no contrato (desde a data de início até a data de término da versão do contrato). A finalidade desse ciclo é calcular somente os valores de previsão. (Nenhum cálculo é feito na tabela T_RAW_DATA). Essa função é chamada no lugar da função Resultado durante esse modo de execução.
• Result() - (necessário), chamado pelo mecanismo de cálculo para obter o resultado do cálculo para um determinado período. A função Resultado sempre é chamada depois do manipulador de eventos OnPeriodEnd.

A seguir, estão as etapas seguidas pelo mecanismo de cálculo (serviço PslWriter) para processar uma única fórmula de lógica de negócios:

• O PslWriter carrega a fórmula na memória e executa cada instrução que existe na seção de declarações (a seção de declarações é o código que está fora de uma função ou sub-rotina). Observe também que todas as bibliotecas e módulos vinculados são incluídos e compilados nesse módulo de código único para execução.
• O PslWriter chama o manipulador de eventos OnLoad.
• O PslWriter chama o OnRegistration.
• O cálculo do período começa com a chamada do OnPeriodStart.
• Para cada evento de dados brutos registrado durante OnRegistration que está dentro do intervalo de datas do período, o PslWriter chama o manipulador de eventos definido pelo usuário e associado ao evento.
• Se o início ou o término do período de atividade estiver dentro do intervalo de datas do período, OnTimeslotEnter ou OnTimeSlotExit será chamado.
• Se houver uma alteração na infraestrutura relevante dentro do intervalo de datas do período, OnRegistration será chamado.
• O cálculo do período termina com a chamada de OnPeriodEnd.
• Se um destino dinâmico tiver sido especificado, essa função será chamada.
• O PslWriter chama a função Resultado para obter o resultado final do cálculo do período.

  Observação: quando a versão do contrato for confirmada pela primeira vez e uma projeção tiver sido selecionada, a função Previsão será chamada, em vez da função Resultado. No entanto, isso ocorre apenas dessa vez para cada versão.

Durante cada ciclo de cálculo, o mecanismo avalia quais são os eventos do mecanismo e os eventos de dados brutos relevantes com base no período de cálculo. Primeiro, irá classificá-los por hora e, em seguida, enviá-los às fórmulas relevantes para cálculo. A hora do evento de dados brutos é sua data e hora, e a hora do evento do mecanismo é sua hora de acionamento. Em seguida, esses dois tipos de eventos são combinados em uma sequência de tempo e enviados para cálculo.

Os períodos dos eventos estão de acordo com a métrica local associada, mas o parâmetro de hora dos manipuladores de eventos (isto é, OnPeriodStart (Time)) e a data e hora do evento de dados brutos estão de acordo com o valor em UTC. O mecanismo os compara de acordo com seus valores em UTC, de forma a usar um ponto de referência constante.

Exemplo:

Se a diferença de fuso horário de UTC de uma métrica for de duas horas (por exemplo, GMT+2), e um evento de abertura de incidente tiver data e hora de 10h00, dentro do mecanismo a data e hora que o manipulador de eventos usará na verdade será modificada de forma adequada e realmente inicia às 8h00 UTC. Supondo que o conector esteja configurado para usar esse mesmo fuso horário, os eventos de dados brutos também terão 2 horas reduzidas para UTC no banco de dados. Quando os eventos são passados para a lógica de negócios, o agente de cálculo responsável pelo cálculo dos eventos no período que inicia às 10h00 usará a hora em UTC para os eventos, que será das 8h00 em diante. No entanto, se você usar a mensagem out.log no código para imprimir as datas e horas, ela mostrará a data e hora modificada para UTC e, portanto, mostrará 8h00, apesar do período especificado (de acordo com a métrica) ser às 10 da manhã.

No seguinte requisito de cálculo, é importante converter a data e hora do evento antes de usá-lo:

Se uma métrica for para calcular o número de incidentes que foram fechados no mesmo dia em que foram abertos, será necessário comparar a hora de abertura e de fechamento de cada incidente. Se a hora de abertura e de fechamento de um incidente cair no mesmo dia (e em um período de atividade definido), o incidente será contado.

Há a possibilidade de que durante o processo de modificação do incidente para UTC a partir de sua hora local original, o dia mude (isto é, novamente usando GMT+2). Um incidente aberto à 1h será modificado para 23h no dia anterior em UTC. Desse modo, não será contado mesmo que devesse ter sido. Essa é uma situação em que a hora primeiro deve ser convertida de volta para a hora local da métrica e apenas depois ser comparada. Nesse caso, use o método GetLocaleTime(utcTime). Esse método converte uma hora determinada em um fuso horário UTC para o fuso horário da métrica local.

A seguir, há o código do manipulador de eventos:
Sub OnIncidentEvent(eventDetails)
   If dateDiff("d",Tools.GetLocaleTime(eventDetails.time),_
     Tools.GetLocaleTime(eventDetails("ClosedAt)))=0 then
          CountIncidents=CountIncidents+1
   End If
End Sub