Skip to content

Commit

Permalink
Merge pull request #682 from onkelandy/docu
Browse files Browse the repository at this point in the history
Docu Update for log_text and log_level
  • Loading branch information
Morg42 authored Oct 16, 2024
2 parents f8a5aa2 + d85b459 commit f1eeeb5
Showing 1 changed file with 12 additions and 6 deletions.
18 changes: 12 additions & 6 deletions doc/user/source/referenz/items/standard_attribute/log_change.rst
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,14 @@ ERROR, CRITICAL). Die Angabe kann durch den Namen oder den Integer Wert des Logl

**Beispiel:** ``log_level: WARNING``

eval-Ausduck in log_level
--------------------------

Ab **SmarthomeNG v1.10.1** ist es möglich, das Loglevel variabel mittels Eval-Ausdruck festzulegen. Es wird dadurch
vor dem Schreiben eines jeden Logging-Eintrags neu evaluiert.

**Beispiel:** ``log_level: '{10 if value == 5 else "WARNING" if value == 1 else "INFO"}'``


Attribut *log_text*
===================
Expand Down Expand Up @@ -109,14 +117,13 @@ Unterstützt werden folgende Variablen/Platzhalter:
eval-Ausdrücke in log_text
--------------------------

Zusätzlich zu den Variaben, können in den Log Text auch eval Ausdrücke eingeschlossen werden. Der Syntax dazu ist
folgender: ``{eval(<Ausdruck>)}``. Dabei muss sicher gestellt sein, dass der Ausdruck ein String ist. Wenn man
zum Beispiel nur Zahlen addiert ``3+5``, muss dieser Ausdruck in **doppelte** Anführungszeichen (``"``) gesetzt werden:
``{eval("3+5")}``.
Zusätzlich zu den Variaben, können in den Log Text auch eval Ausdrücke eingeschlossen werden. Diese sind in
geschwungene Klammern zu setzen.

Es können auch mehrere eval-Ausdrücke in einen Log Text eingebunden und mit Variablen konfiguriert werden.

**Beispiel:** ``log_text: Ergebnis={eval("1+4")} für item {id}``
**Beispiel:** ``log_text: Ergebnis={1+value} für item {id}``
**Beispiel:** ``log_text: Ergebnis={"Eins" if value == 1 else "Zwei" if value == 2 else 1+value} für item {id}``


Attribut *log_mapping*
Expand Down Expand Up @@ -219,4 +226,3 @@ itemvalue

``itemvalue`` Der absolute oder relative Pfad zu einem Item, dessen Wert ausgelesen werden soll.
Dies kann beispielsweise dazu genutzt werden, die Lognachricht zur Laufzeit anzupassen.

0 comments on commit f1eeeb5

Please sign in to comment.