EventMap: Unterschied zwischen den Versionen
(Erste Version der Seite) |
K (Rechtschreibung) |
||
Zeile 2: | Zeile 2: | ||
<!-- Infobox Attribut sinnvoll? --> | <!-- Infobox Attribut sinnvoll? --> | ||
Das Attribut [[eventMap]] dient dazu, Ereignisse (bzw. | Das Attribut [[eventMap]] dient dazu, Ereignisse (bzw. Status), die ein Device unterstützt, auf | ||
eine andere Schreibweise oder Übersetzung umzuleiten (zu '''mappen''') oder mehrere gleichartige Werte auf einen einzelnen neuen Wert zusammenzufassen. | eine andere Schreibweise oder Übersetzung umzuleiten (zu '''mappen''') oder mehrere gleichartige Werte auf einen einzelnen neuen Wert zusammenzufassen. | ||
Version vom 23. Juli 2015, 13:58 Uhr
Das Attribut eventMap dient dazu, Ereignisse (bzw. Status), die ein Device unterstützt, auf
eine andere Schreibweise oder Übersetzung umzuleiten (zu mappen) oder mehrere gleichartige Werte auf einen einzelnen neuen Wert zusammenzufassen.
Syntax
Das eventMap Attribut wird in der folgenden Weise spezifiziert:
attr <device> eventMap /old1:new1/old2:new2/[old_n:new_n/]
wobei der Wert des Attributs eine Liste von Wertepaaren ist, bei der der alte Wert vom darauffolgenden neuen Werte durch einen Doppelpunkt getrennt wird. Die Wertepaare können im einfachsten Fall durch Leerzeichen voneinander getrennt sein, sofern die spezifizierten Wertepaare jedoch selbst Leerzeichen enthalten können, muss ein anderes Trennzeichen (Delimiter) wie z.B. "/" oder "," benutzt werden.
Es können auch mehrere "alte" Werte über reguläre Ausdrücke zusammengefasst auf einen einzelnen neuen Wert umgesetzt werden.
Einschränkungen
Werden mit eventMap Werte umdefiniert, müssen zumindest in manchen Situationen (z.B. devStateIcon) die "neuen" Werte verwendet werden.
Beispiele
Mit der Definition
attr meinDevice eventMap on:An off:Aus
wird on zu An und off zu Aus "umdefiniert".
Sollen beispielsweise alle "off-for-timer..." Ereignisse auf "hell" und alle "on-for-timer..." auf "dunkel" umgesetzt werden, kann das mit
attr eventMap off.*:hell on.*:dunkel
erreicht werden.
Links
- Ausführliche Beschreibung (mit Beispielen) zu eventMap, devStateIcon, setList und webCmd in diesem Forenthread