Implementierungshandbuch › Beispiele für Fallstudien › Beispiele für das Business-Logik-Skripting › Fallstudie 12: Verwenden der Zähler-Logik, um die Anzahl der Fehler zu berechnen

Fallstudie 12: Verwenden der Zähler-Logik, um die Anzahl der Fehler zu berechnen

Das folgende Beispiel berechnet die Anzahl der Fehler, die innerhalb eines bestimmten Berechnungszeitraums auftraten. Diese Formel und die Methoden, mit denen sie implementiert wurde, können als Beispiel einer Formel verwendet werden, die immer erforderlich ist, wenn etwas berechnet werden soll.

Es wurden folgende Annahmen für die Berechnung getroffen:

• Eingabe-Events:
  • Verfügbarkeits-Events, Status (0/1)
  • Das Verfügbarkeits-Event trifft alle paar Minuten ein. Es ist nicht möglich, die Häufigkeit von Events zu schätzen (das Event kann alle fünf Minuten oder einmal pro Stunde auftreten), und es gibt möglicherweise auch redundante Events (zum Beispiel: 0, 0, 0, 1, 1, 0, usw.).
• Zeitfenster - Business-Stunden, Fehler, die außerhalb eines Zeitfenster auftreten, werden nicht gezählt.
• "Erforderliches Ergebnis" zeigt an, wie viele Fehler während des Zeitraums aufgetreten sind.

Es ist notwendig, eine periodische Zähler-Variable und auch eine Variable zur Speicherung des Systemzustands zu speichern, um die Fehler, die während des Berechnungszeitraums auftreten, zu zählen. Da redundante Event-Informationen aufgenommen werden können (d. h. ein "Aufwärts"-Event gefolgt von einem anderen "Aufwärts"-Event), ist es auch notwendig, die Anzahl von Orten, an denen eine Änderung des Systemstatus von "Aufwärts" zu "Abwärts" vorkommt, und nicht nur den Empfang eines "Abwärts"-Events zu zählen. Dies könne ein redundantes Event sein, dass einen bereits gezählten Fehler repräsentiert.

Die folgende Abbildung zeigt grafisch, wie die "Aufwärts"- und "Abwärts"-Zeiten des Systems gezählt werden.

Wichtige Punkte, die berücksichtigt werden sollten:

• Konstanten - Es wird empfohlen, eine Konstantendefinition anstatt eines Konstantenwerts in einem Code zu verwenden. Auf diese Weise ist es einfacher, wenn ein Wert geändert werden muss. Sie müssen einfach den Wert in der Konstantendefinition ändern und nicht den ganzen Code nach diesem Wert durchsuchen. Außerdem ist es so leicht, den Wert bei Bedarf in einen Parameter zu verwandeln. Im obigen Beispiel werden die Werte, die den im Event empfangenen Systemstatus repräsentieren, als Konstante festgelegt, um den Code verständlicher zu machen und auch um zu differenzieren, wann die Null als Zahl (für Zählzwecke) verwendet wird und wann sie einen Systemstatus wiedergibt.
• Globale Variablen:
  • Zähler - Die Definition der Zählervariablen ist eine globale Definition. In der Formel wird sie oben im Code und außerhalb von Subroutinen oder Funktionen angegeben. Es ist wichtig, die Zählervariable in diesem Fall als eine globale Variable festzulegen. So kann sie in mehreren Subroutinen/Funktionen innerhalb des Codes verwendet werden. Ferner kann dadurch das System seinen Wert über den Berechnungszeitraum behalten und sein Ergebnis am Ende des Zeitraums bereitstellen.

    In diesem Beispiel muss die Zählervariable an drei Stellen im Code verwendet werden:

    • Sie muss am Anfang eines Zeitraums initialisiert werden.
    • Sie muss im Falle eines fehlgeschlagenen Events im Event-Handler erhöht werden.
    • Sie muss von der Ergebnisfunktion am Ende des Zeitraums ausgegeben werden.
  • Vorheriger Systemstatus - Diese Variable repräsentiert den Status des Systems und wird jedes Mal aktualisiert, wenn ein neues Event mit dem Systemstatus empfangen wird. Diese Variable muss auch global sein, weil es in mehreren Subroutinen/Funktionen im Code verwenden wird, wie z. B.:
    • Sie muss am Anfang der Berechnung initialisiert werden.
    • Sie muss aktualisiert werden, wenn ein neues Event empfangen wird.
• Überlegungen zum Zeitfenster - Es ist möglich den Wert der Eigenschaft context.IsWithinTimeSlot zu verwenden, um zu verifizieren, ob ein Fehler in einem Zeitfenster aufgetreten ist oder nicht. Der Kontext ist ein globales Objekt, das überall im Code verwendet werden kann. In diesem Fall wird es verwendet, um anzuzeigen, wann ein Fehler empfangen wurde und ob dies innerhalb oder außerhalb des Zeitfensters war. Wenn das Kennzeichen zum Zeitpunkt des Event-Zeitstempels "WAHR" zurückgibt, dann tritt das Event innerhalb eines Zeitfensters auf. Wenn er jedoch "FALSCH" ausgibt, findet das Event außerhalb des Zeitfensters statt. Entsprechend der erforderlichen Logik wird jeder Fehler, der außerhalb des Zeitfensters auftritt, ignoriert und somit nicht gezählt.
• Variable initialisieren:
  • Zählervariable - Die Variable repräsentiert einen periodischen Wert und wird daher in der OnPeriodstart-Routine initialisiert, um sicherstellen, dass jeder Berechnungszeitraum seine Fehler gesondert zählt. Jeder Zeitraum startet mit Null und gibt nur die Anzahl der Fehler in diesem Zeitraum aus.

    Wenn es notwendig ist, die akkumulierten Fehler innerhalb jedes Zeitraums zu berechnen (d. h. das Ergebnis von jedem Zeitraum umfasst alle bis zum Ende dieses Zeitraums aufgetretenen Fehler, einschließlich aller vorherigen Zeiträume), dann muss der Zähler nur in der OnLoad-Routine initialisiert und aus der OnPeriodStart-Routine gelöscht werden. Auf diese Weise fährt der Zähler fort, zu zählen und die Ergebnisse zwischen den Zeiträumen wie nachfolgend gezeigt zu akkumulieren:

    Sub OnLoad(time)
        FingerprInted=0
    End Sub
    

  • Systemstatus-Variable - Die Variable sollte einmal am Anfang der Berechnung initialisiert und dann bei jedem Status-Event aktualisiert werden. Diese Variable behält seinen Wert während der Berechnung und ist nicht auf einen bestimmten Berechnungszeitraum beschränkt. Sie muss ihren Wert auch zwischen den Berechnungszeiträumen beibehalten. Da der Status des Systems vor dem Empfang des ersten Events unbekannt ist, muss eine Annahme bezüglich des Systemstatus getroffen werden. Die übliche Annahme ist, dass das System den Status "Aufwärts" hat. Diese Annahme sollte zuvor vereinbart und geprüft werden, da sie zu Folgendem führen kann:

    Wenn die Berechnung gestartet wurde und das System in Wirklichkeit den Status "Abwärts" hat und dann das erste Event den Status "Abwärts"-Status anzeigt, wird dies als Fehler gezählt, da der angenommene Status "Aufwärts" war. Dieser Fehler wird für den ersten Berechnungszeitraum gezählt, auch wenn er nicht notwendigerweise während dieses Zeitraums aufgetreten.

    Option Explicit
    
    'Konstantendefinitionen
    Const UP=1
    Const DOWN=0
    
    'Global variable for counting failures
    Dim FingerprInted
    Dim SystemStatus
    
    Sub OnRegistration(dispatcher)
       ' The parameters of the method are: <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)
       ' In case it's a failure and within the timeslot then it is counted
       If context.IsWithinTimeSlot and SystemStatus=UP and _
             eventDetails("Status")=DOWN Then
          FingerprInted = FingerprInted + 1
       End If
       ' update the system status for next comparison
       SystemStatus = eventDetails("Status") 
    End Sub
    
    Function Result
       Result = FingerprInted
    End Function