[Script] MessageHandler: Nachrichten protokollieren +VIS

[Tirador]

Ich habe jetzt die Version 0.4 veröffentlicht. Ich habe den initialen Post und das README in Github überarbeitet.
Wichtig:
Bei der Installation ist das Skript MessageHandler initial einmal zu starten und wieder zu stoppen und erneut zu starten (wie bei der Erstinstallation).

Folgende Dinge haben sich geändert:

• kleinere Bugfixe (u.a. wurden bisher Trigger mehrfach ausgelöst)
• einige MSGIDs erweitert (auf Basis eurer Rückmeldungen, u.a. DWD, Internet Connection offline, Motion detected etc.)
• Nachrichten sind nun einzeln quittierbar in VIS
• Funktion Nachrichtenereignisse ermöglichen mit dem Auslösen einer Nachricht das gleichzeitige auslösen von Ereignissen (Senden einer Email oder Push-Telegram). Hierfür gibt es ein neues Attribut msgEvent, dass in den einzelnen Nachrichten oder global auf der SEVERITY-Ebene gesteuert werden kann.

Beispiele für die Konfiguration von Nachrichtenereignisse

Senden einer Telegram-Nachricht mit dem Briefkasteneinwurf:

        // Post im Briefkasten
        LAST_POSTENTRACE_INFO: {msgEvent: ['TELEGRAM'], logType: 'LAST',  severity: 'INFO',  msgHeader: "Briefkasten", msgText: "Neue Post im Briefkasten!", mdIcon: 'drafts', quit: true, mdIconColor: '', fontColor: '', backgroundColor: ''},

Auf den SEVERITYs können global Ereignisse vorgegeben werden.
In meinem Beispiel: Senden von TELEGRAM Nachrichten für alle WARN, ERROR und ALARM-Nachrichten.
Für ALARM-Nachrichten wird zusätzlich noch eine Email versendet.

const MESSAGE_DEFAULTS_BY_SEVERITY = {

    INFO: {msgEvent: [], logType: 'ALL',  severity: 'INFO',  priority: 1000, msgHeader: "", msgText: "", quit: false, mdIcon: 'info', mdIconColor: 'mdui-blue', fontColor: '', backgroundColor: 'mdui-blue-bg'},
    WARN: {msgEvent: ['TELEGRAM'], logType: 'ALL',  severity: 'WARN',  priority: 2000, msgHeader: "", msgText: "", quit: false, mdIcon: 'warning', mdIconColor: 'mdui-amber', fontColor: '', backgroundColor: 'mdui-amber-bg'},
    ERROR: {msgEvent: ['TELEGRAM'], logType: 'ALL',  severity: 'ERROR', priority: 3000, msgHeader: "", msgText: "", quit: false, mdIcon: 'error', mdIconColor: 'mdui-orange', fontColor: '', backgroundColor: 'mdui-orange-bg'},
    ALARM: {msgEvent: ['TELEGRAM', 'EMAIL'], logType: 'ALL',  severity: 'ALARM', priority: 4000, msgHeader: "", msgText: "", quit: false, mdIcon: 'error', mdIconColor: 'mdui-red', fontColor: '', backgroundColor: 'mdui-red-bg'}
};

Die Konfiguration der Nachrichtenereignisse kann über die neue Konstante MESSAGE_EVENTS erfolgen.
Eine Konfiguration ist nur sinnvoll, wenn abweichende Einstellungen notwendig sind.

const MESSAGE_EVENTS = {
	
	// Telegram-Konfiguration
	// - serviceName: 'TELEGRAM' (dieser Wert ist fix und steuert die Skriptlogik)
	// - telegramInstanz: 'telegram.0'
	// - telegramUser: optionale Vorgabe eines Benutzers. Sofern nicht vorgegeben, wird diese Einstellung vom Adapter übernommen.
	// - telegramChatId: optionale Vorgabe einer ChatID. Sofern nicht vorgegeben, wird diese Einstellung vom Adapter übernommen.
	//
    
	TELEGRAM: {serviceName: 'TELEGRAM', telegramInstance: 'telegram.0', telegramUser: '', telegramChatId: '', maxChar: 4000},
	
    
	// Email-Konfiguration
	// - serviceName: 'EMAIL' (dieser Wert ist fix und steuert die Skriptlogik)
	// - emailInstance: Vorgabe der Email-Instance (in der Regel ist dies 'email.0').
	// - emailFrom: optionale Vorgabe einer abweichenden Absenderadresse. Sofern nicht vorgegeben, wird diese Einstellung vom Adapter übernommen.
	// - emailTo: optionale Vorgabe von Zieladressen. Sofern nicht vorgegeben, wird diese Einstellung vom Adapter übernommen.
	
    EMAIL: {serviceName: 'EMAIL', emailInstance: 'email.0', emailFrom: '', emailTo: [''] },
    

};

[Saschag]

@Tirador

Würdest du die Skripte für deine „Steckdosen an“ und „Lichter an“ posten wollen

Danke für deine Arbeit!

[Tirador]

@Saschag dafür gibt es bisher nur die Nachrichten. Ich habe selbst noch kein Skript hierfür.

[Saschag]

@Tirador

Okay

[sigi234]

@Tirador

Warum habe ich unten das noch mal drinnen?

ERLEDIGT NACH SKRIPT NEUSTART!

[Tirador]

@sigi234 weil du jetzt zwei Nachrichten auslöst. Die eine Nachricht ist aber nicht im MessageHandler definiert. Nachrichten werden aktuell nicht abgelehnt, wenn sie nicht definiert wurden. Das ist Absicht, um solche Zustände auch an der Oberfläche zu erkennen.

[sigi234]

@Tirador sagte in [Script] MessageHandler: Nachrichten protokollieren +VIS:

Die eine Nachricht ist aber nicht im MessageHandler definiert.

Wo muss ich das machen?

[Tirador]

@sigi234 schau Mal im aktuellen MessageHandler Skript in Zeile 299. Eine Erklärung, wie das funktioniert ist als Beschreibung im Kopf des Skripts.

[Tirador]

@sigi234 noch ein Auszug aus der Dokumentation in GitHub

Konfiguration

Zur Konfiguration sind zwei Schritte erforderlich:

1.Die Grundkonfiguration erfolgt über die Festlegung von MESSAGE-IDs (Nachrichten-Ids) in der Konstante MESSAGE_IDS im Javascript "MessageHandler". Optional kann mit den Nachrichten auch ein sogenannten Nachrichtenereignisse ausgelöst werden (z.B. Senden einer Email oder TELEGRAM-Pushnachricht). Hierfür muss den Nachrichten ein sogenanntes msgEvent zugeordnet werden, dass über die Konstante MESSAGE_EVENT unten im Skript konfiguriert wird. Optional kann in der Funktion MessageHandler|doInit() eine Anpassung der KONFIGURATION vorgenommen werden.

2. Über das Javascript "MessageStateCreator" können Datenpunkte überwacht werden und Nachrichten automatisiert ausgelöst werden. Die Konfiguration erfolgt hierfür im Javascript "MessageStateCreator" über die Konstante MESSAGE_EVENTS. Im Javascript selbst sind auch Beispiele enthalten, wie die Konfiguration durchgeführt wird.

[uwe12489]

@Tirador Guten Morgen. Geht das nur mir so? Vers. 0.4 installiert und nichts in der Anzeige...

[Tirador]

@uwe12489 hast du das Skript MessageStateCreator Initial bearbeitet? Wahrscheinlich hast du Fehlermeldungen im Log beim Skriptstart. Der Grund wird sein, dass die Datenpunkte bei dir nicht existieren. Z.b. für die Wassermelder.

[sigi234]

@Tirador sagte in [Script] MessageHandler: Nachrichten protokollieren +VIS:

@uwe12489 hast du das Skript MessageStateCreator Initial bearbeitet? Wahrscheinlich hast du Fehlermeldungen im Log beim Skriptstart. Der Grund wird sein, dass die Datenpunkte bei dir nicht existieren. Z.b. für die Wassermelder.

War bei mir auch so, ist es nicht besser alle bis auf eine auszukommentieren?

[Tirador]

@sigi234 ja, im Prinzip sind es ja nur Beispiele von Konfiguration. Ich werde das in der Auslieferung ändern.

[uwe12489]

@Tirador Fehlerscript lesen hilft. Danke.

[uwe12489]

@Tirador
Auch auf die Gefahr hin, dass ich lästig werde
Wie kann ich eine eigen Nachricht "quittierter" machen?

[Tirador]

@uwe12489 ich habe die Prüfungen verschärft. Der MessageStateCreator startet nicht, wenn Datenpunkte konfiguriert sind, die nicht existieren.

[uwe12489]

@uwe12489 said in [Script] MessageHandler: Nachrichten protokollieren +VIS:

@Tirador
Auch auf die Gefahr hin, dass ich lästig werde
Wie kann ich eine eigen Nachricht "quittierbar" machen?

[Tirador]

@uwe12489 dafür musst du im MessageHandler in der Konfiguration der Nachricht das Attribut quit :true setzen.

Ein Beispiel ist die Nachricht für den Briefkasten

// Post im Briefkasten
        LAST_POSTENTRACE_INFO: {msgEvent: ['TELEGRAM'], logType: 'LAST',  severity: 'INFO',  msgHeader: "Briefkasten", msgText: "Neue Post im Briefkasten!", mdIcon: 'drafts', quit: true, mdIconColor: '', fontColor: '', backgroundColor: ''},

[uwe12489]

@Tirador klappt prima. Danke. Wann werden die ausgeblendeten Nachrichten wieder eingeblendet? Nächster Trigger? Nächster Tag?

[Tirador]

@uwe12489 nächster Trigger mit zutreffender Bedingung.