Struktur der Kriterienparameter

Handbuch zu vordefiniertem Inhalt › Business-Logik-Module › Allgemeine Business-Logik-Module › Success Calculations-Modul › Struktur der Kriterienparameter

Struktur der Kriterienparameter

Es gibt zwei Parameter, die Kriterien im Success Calculations-Modul definieren: die Filterkriterien und die Erfolgskriterien. Die Struktur dieser Parameter ist identisch.

Die Funktion wird mit den aktuellen Event-Details (d. h. die eventDetails-Parameter des Event-Handlers) aufgerufen, um den Erfolgstest auf den Details des zu verarbeitenden Events zu basieren. Dieser Tabellenparameter schließt alle Informationen ein, die benötigt werden, um zu entscheiden, ob das aktuelle Event erfolgreich ist oder nicht.

Der Rückgabewert ist basierend auf dem berechneten Ergebnis entweder "True" oder "False".

Sind keine Einträge in dieser Tabelle vorhanden, weist dies darauf hin, dass alle Einträge als erfolgreich eingestuft werden.

Die Erfolgskriterien werden basierend auf einem Vergleich eines einzelnen oder mehrerer Felder mit bestimmten Werten oder basierend auf der Auswertung von Ausdrücken berechnet. Mehrere Kriterienzeilen können mithilfe von benutzerdefinierten logischen Beziehungen miteinander verknüpft werden.

Wenn ein erfolgreiches Event beispielsweise als Event definiert ist, das einen Wert zwischen 3 und 6 im Feld "Ergebnis" aufweist, würde der Anwender zwei Zeilen verwenden (unter Verwendung der "and"-Beziehung) und fragen nach:

result > 3 and result < 6

Das Format der Tabelle ist wie folgt:

Row #	Argument 1	Operator	Argument 2	Inter-row logical link
1
2
…

Die Tabellenfelder sind folgende:

Argument 1 - Dieses Feld sollte mit dem Namen eines Feldes in den Event-Details gefüllt werden, aus denen ein Wert extrahiert werden soll. Wenn der Operator Eval verwendet wird, wird dieses Feld ignoriert und kann leer gelassen werden. Dieses Feld kann auch Folgendes enthalten:
- @Resource - Dies gibt den Namen der Event-Ressource zurück (eventDetails.Resource).
- @EventType - Dies gibt den Event-Typ des Events zurück (eventDetails.EventType).
- @SenderMetric - Dies gibt die Details der Metrik zurück, die das Event-Wiederverwendbarkeits-Event gesendet hat, das verarbeitet wurde (eventDetails.Sender).
Operator - Dieses Feld sollte den Operator enthalten, mit dem Argumente 1 und 2 verglichen werden. Dieses Feld kann einen der folgenden Werte enthalten:
- <
- >
- <=
- >=
- <> (nicht gleich)
- Eval
Wenn einer der normalen Komparatoren verwendet wird, übernimmt das System den Inhalt des in Argument 1 angegebenen Feldes und vergleicht es unter Verwendung des ausgewählten Komparators mit dem Wert in Argument 2.

Wenn der Eval-Komparator angegeben ist, wird das argument1-Feld ignoriert. Statt dessen wird der Inhalt von Argument 2 verwendet und direkt als Ausdruck ausgewertet.
Argument 2: Dieses Feld sollte den Wert enthalten, der mit dem Inhalt des in Argument 1 angegebenen Feldes zu vergleichen ist. Wenn z. B. ein Wert größer 5 im Feld "Ergebnis" für einen erfolgreichen Eintrag steht, wird der String "Ergebnis" in "Argument 1", > im Operatorfeld und der Wert 5 im Feld "Argument 2" platziert.
Wenn Eval im Operatorfeld angegeben ist, muss dieses Feld einen Ausdruck enthalten. Ein Ausdruck ist in Visual Basic eine Bedingung, die entweder "True" oder "False" ergibt. Eine Auswertungsbedingung kann z. B. verwendet werden, um das Ergebnisfeld mit dem Wert 5 zu vergleichen, wie oben durchgeführt, durch Angabe des folgenden Ausdrucks (in Argument 2):
```
eventDetails("result") > 5
```
In diesem Beispiel ist die Auswertungsbedingung der Vergleich zwischen dem Inhalt des Ergebnisfelds und dem Wert 5. Natürlich können noch komplexere Bedingungen ausgewertet werden. Ein komplexeres Beispiel ist z. B. folgendes:
```
Tools.NetTime(eventDetails("startDate"),eventDetails("endDate")) > eventDetails("MaxTimeSpan")
```
In diesem Beispiel ist die Bedingung ein Vergleich des Ergebnisses der Nettozeitmethode im Tools-Objekt (in Form von Werten aus zwei Feldern) mit dem Wert aus einem dritten Feld.
Inter-row logical link: Hier sollte die logische Beziehung zwischen dem Vergleich der aktuellen Zeile und der nächsten enthalten sein. Der Anwender kann mehrere Vergleiche implementieren. Jeder Vergleichs- oder Evaluationsausdruck wird in der Tabelle in eine separate Zeile eingeordnet. Dieses Feld gibt an, wie die Ergebnisse des Vergleichs miteinander verknüpft sind. Vergleichsbeziehungen folgen nicht den normalen logischen Prioritätsregeln. Statt dessen werden sie immer in der Reihenfolge ausgewertet, in der sie in der Tabelle vorkommen. Zulässige Werte für dieses Feld sind nur 'and', 'or'. Wenn die Tabelle nur eine Zeile enthält, wird dieses Feld ignoriert und kann leer gelassen werden.

Modulschnittstelle "Success Calculation"

In der folgenden Tabelle werden die Parameter aufgelistet.

Name	Beschreibung
IgnoreTimeslots	(optional, String [True/False]): Gibt an, ob Events verarbeitet werden, die außerhalb des Zeitfensters auftreten.
Debug	(optional, String [True/False]): Gibt an, ob Debugging-Kommentare in das Protokoll eingefügt werden.
AggregationType	(optional, String [SUCCESSCOUNT,PERCENTOFSUCCESS]): Gibt an, ob die Erfolgsrate oder der Anteil an erfolgreichen Einträgen berechnet werden soll.
SuccessCriteria	(obligatorisch, Tabelle): Gibt an, wie festgelegt wird, ob ein Event erfolgreich ist oder nicht
FilteringCriteria	(optional, Tabelle): Gibt an, wie festgelegt wird, ob ein Event verarbeitet oder herausgefiltert werden soll.
EventIdFieldName	(optional, String): Der Name des Feldes, das als Event-Bezeichner für die Erkennung von sich wiederholenden Events verwendet werden soll.

Modulabhängigkeiten

In der folgenden Tabelle werden die enthaltenen Module aufgelistet.

Name	Beschreibung
Log Library (LL)	Bibliothek für erweiterte Protokollierungsfunktionalität.
Parameters Kernel Library (PKL)	Bibliothek zur Überprüfung und Auffüllung von Modulparametern
Aggregation Library (AL)	Bibliothek zur Ergebniserstellung für allgemeine Berechnungen.
Callback Kernel Library (CKL)	Bibliothek, die die Rückruffunktionalität aktiviert.
Parameters Overlay - Basic Action Library (POBAL)	Bibliothek, die bestimmte Parameterladefunktionen enthält und die Parameterkernelbibliothek für das eigentliche Laden der Informationen aufruft.
Distinct Entity Library (DEL)	Bibliothek, die dem Anrufer mitteilt, ob eine bestimmte Entität bereits gesehen wurde.
Filtering Criteria Evaluation Library (FCEL)	Bibliothek, die Events entsprechend der Anwendervorgaben filtert.
Success Criteria Evaluation Library (SCEL)	Diese Bibliothek ist für die Entscheidung verantwortlich, ob das aktuelle Event als Erfolg oder als Ausfall gilt.

Senden Sie CA Technologies eine E-Mail zu diesem Thema.