Filter

Definiert, welche Events vom Server abgefragt werden.

Engineering:

Über den Filter-Editor kann konfiguriert werden, welche Events angezeigt werden. Die Filter werden über die Eigenschaften von dem Event Grid definiert.

Aufbau des Filter-Editors

Filter 1:

  1. Add clause: Hinzufügen einer Bedingung
  2. Delete clause: Entfernen einer Bedingung
  3. And/Or: Verknüpfung von Bedingungen
  4. Path: Filtermöglichkeiten:
    • domain: Server Extension, welche den Alarm ausgeliefert hat (z.B. TcHmiEventLogger).
    • sourceDomain: Server Extension, welche den Alarm ausgelöst hat. Die sourceDomain kann sich von der Domain unterscheiden, wenn eine Server Extension die Alarme weiterreicht (z. B. TcHmiSqliteLogger).
    • name: Name des Events.
    • text: Text des Events.
    • Id: ID des Events.
    • timeRaised: Zeitpunkt, an welchem das Event ausgelöst wurde.
    • timeCleared: Zeitpunkt, an welchem ein Alarm zurückgesetzt wurde.
    • timeConfirmed: Zeitpunkt, an welchem ein Alarm bestätigt wurde.
    • type: Typ des Events (Alarm oder Meldung).
    • severity: Schweregrad des Events (Verbote, Info, Warnung, Error, kritischer Error).
    • alarmState: Zustand eines Alarmes (ausgelöst, bestätigt, gelöscht, bestätigt und gelöscht).
    • confirmationState: Status der Bestätigung eines Alarms (nicht erforderlich, nicht unterstützt, warten auf Bestätigung, bestätigt, zurückgesetzt).
    • „params::“: In das Textfeld des Pfades kann über das Schlüsselwort „params::“ (ohne Anführungsstriche) auf das Parameter-Objekt eines Events zugegriffen werden. Das Parameter-Objekt beinhaltet optionale Parameter, die sich je nach Event-Quelle unterscheiden können. Der TwinCAT Eventlogger liefert zum Beispiel zusätzliche Informationen über den Event-Ursprung in der SPS. Der Zugriff auf die Parameter erfolgt in camelCase, z. B.: params::sourceName
  5. Operator: Vergleichsoperator der Bedingung
  6. Value: Wert der Bedingung

Gruppierung von Bedingungen

Mehrere Bedingungen können gruppiert und verknüpft werden, wenn mehr als eine Bedingung selektiert ist. Die Selektion der Bedingungen erfolgt durch das Anklicken der Zeilen mit gedrückter STRG-Taste.

Filter 2:
  1. Group clause: Gruppieren von mehreren Bedingungen. Die Klammer verknüpft diese optisch.
  2. Ungroup clause: Aufheben vorhandener Gruppierungen.

Schema: tchmi:server#/definitions/eventFilter

Attribut-Getter

public getFilter(): TcHmi.Filter | null | undefined;

Parameter

Name

Typ

Beschreibung

-

-

-

Rückgabewert

Typ

Beschreibung

TcHmi.Filter, null, undefined

Der aktuelle Wert des Attributs.

Attribut-Setter

public setFilter(valueNew: TcHmi.Filter | null): void;

Parameter

Name

Typ

Beschreibung

valueNew

TcHmi.Filter, null

Der neue Wert des Attributs. Wird null übergeben, so wirkt der interne Standardwert.

Rückgabewert

Typ

Beschreibung

void

Kein Rückgabewert

Filter 3:

Verfügbar ab Version 1.12.748