DOIF/Tipps zur leichteren Bedienung: Unterschied zwischen den Versionen

Aus FHEMWiki
(Die Seite wurde neu angelegt: „Kategorie:Hilfsmodul '''Anmerkung:''' Dieser Artikel wurde {{Link2Forum|Topic=45373|Message=371668|LinkText=aus dem Forum}} übernommen. Ich habe ein paar…“)
 
 
(16 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 2: Zeile 2:
'''Anmerkung:''' Dieser Artikel wurde {{Link2Forum|Topic=45373|Message=371668|LinkText=aus dem Forum}} übernommen.
'''Anmerkung:''' Dieser Artikel wurde {{Link2Forum|Topic=45373|Message=371668|LinkText=aus dem Forum}} übernommen.


Ich habe ein paar Hinweise gesammelt, die den Umgang mit dem DOIF erleichtern können. Nichts Neues, aber vielleicht hilft es dem Einen oder Anderen.
Hier sind ein paar Hinweise gesammelt, die den Umgang mit dem DOIF erleichtern können. Nichts Neues, aber vielleicht hilft es dem Einen oder Anderen.
Es gibt bestimmt noch Ergänzungen, die pflege ich hier im 1. Beitrag ein.


== Verwenden des DEF-Editors zum Erstellen und Bearbeiten des DOIF ==
== Verwenden des DEF-Editors zum Erstellen und Bearbeiten des DOIF ==
Zuerst eine minimale Definition in der Eingabezeile der WEB-Oberfläche erstellen
Zuerst eine minimale Definition in der Eingabezeile der WEB-Oberfläche erstellen
<pre>
<pre>
define <DOIF Name> DOIF ([<Name eines triggernden Gerätes>])
define <DOIF Name> DOIF ##
</pre>
</pre>
danach die Eingabetaste drücken, dann öffnet sich die Geräteübersicht (DeviceOverview), dort den DEF-Editor öffnen (auf DEF klicken) und die Definition weiter bearbeiten und strukturieren.
danach die Eingabetaste drücken, dann öffnet sich die Geräteübersicht (DeviceOverview), dort den DEF-Editor öffnen (auf DEF klicken) und die Definition weiter bearbeiten und strukturieren.
Zeile 30: Zeile 29:


== Größe des Editorfensters ändern ==
== Größe des Editorfensters ändern ==
Wem das Editorfenster zu zu groß oder zu klein ist, kann die Höhe optimieren mit
Wem das Editorfenster zu groß oder zu klein ist, kann die Höhe optimieren mit
<pre>
<pre>
attr WEB codemirrorParam { ..., "height":"auto" }
attr WEB codemirrorParam { ..., "height":"auto" }
Zeile 43: Zeile 42:
attr global language DE
attr global language DE
</pre>
</pre>
== Fehlende Geräte in "Probably associated with" anzeigen ==
Geräte, die im DOIF über einen regulären Ausdruck angesprochen werden, tauchen in der Liste von "Probably associated with" nicht auf.
Diese Geräte werden aufgeführt, wenn sie in der Definition des DOIF als Kommentar mit vollständigem Namen aufgezählt werden.
<pre>
(["^GERAET(1|2)$:"]) ## GERAET1 GERAET2
  (set ...)
</pre>
Seit Revision 18029 kann in [Gerät|Geräten] ein [Reading] <code>associatedWith</code> mit Gerätenamen angelegt werden, die zusätzlich in der Liste "Probably associated with" angezeigt werden <ref>{{Link2Forum|Topic=94434|Message=875564|LinkText=Forenthread}}</ref>.
setreading <name> associatedWith <Durch Komma oder Leerzeichen getrennte Liste von Gerätenamen>
==Import von Code Snippets==
Code Snippets können über '''[[Raw definition]]''' importiert werden, siehe [[DOIF/Import von Code Snippets]].
==DOIFtools das Modul zum DOIF==
Das Modul '''[[DOIFtools]]''' enthält Funktionen zur Unterstützung des Benutzers im Umgang mit DOIF:
* erstellen von readingsGroup Definitionen, zur Beschriftung von Frontendelementen.
* erstellen eines Debug-Logfiles, in dem mehrere DOIF und zugehörige Geräte geloggt werden.
* optionales DOIF-Listing bei jeder Status und Wait-Timer Aktualisierung im Debug-Logfile.
* Navigation zwischen den DOIF-Listings im Logfile, wenn es über DOIFtools geöffnet wird.
* erstellen von userReadings in DOIF-Geräten zur Anzeige des realen Datums bei Wochentag behafteten Timern.
* löschen von benutzerdefinierten Readings in DOIF-Definitionen über eine Mehrfachauswahl.
* erfassen statistischer Daten über Events.
* Begrenzung der Datenerfassungsdauer.
* erstellen eines Statistikreports.
* Liste aller DOIF-Definitionen in probably associated with.
* Zugriff auf DOIFtools aus jeder DOIF-Definition über die Liste in probably associated with.
* Zugriff aus DOIFtools auf vorhandene DOIFtoolsLog-Logdateien.
* einblenden des Event-Monitor in der Detailansicht.
* ermöglicht den Zugriff auf den Event Monitor in der Detailansicht von DOIF.
* prüfen der DOIF Definitionen mit Empfehlungen.
* erstellen eigener Shortcuts


== Weiterführende Links ==
== Weiterführende Links ==
[[DOIF/Tools und Fehlersuche|Tools und Fehlersuche]]
[[DOIF/Tools und Fehlersuche|Tools und Fehlersuche]]
[[Kategorie:Hilfsmodul]]
[[Kategorie:HOWTOS]]

Aktuelle Version vom 13. Februar 2019, 11:18 Uhr

Anmerkung: Dieser Artikel wurde aus dem Forum übernommen.

Hier sind ein paar Hinweise gesammelt, die den Umgang mit dem DOIF erleichtern können. Nichts Neues, aber vielleicht hilft es dem Einen oder Anderen.

Verwenden des DEF-Editors zum Erstellen und Bearbeiten des DOIF

Zuerst eine minimale Definition in der Eingabezeile der WEB-Oberfläche erstellen

define <DOIF Name> DOIF ##

danach die Eingabetaste drücken, dann öffnet sich die Geräteübersicht (DeviceOverview), dort den DEF-Editor öffnen (auf DEF klicken) und die Definition weiter bearbeiten und strukturieren.

Einschalten von Syntaxhervorhebung, Zeilenumbruch, Suchen und Ersetzen, Klammerprüfung uvm.

attr WEB JavaScripts codemirror/fhem_codemirror.js
attr WEB codemirrorParam { "lineWrapping":true }

Länge der Eingabezeile (Befehlszeile) ändern

Per Attribut die Länge der Eingabezeile ändern.

attr WEB mainInputLength 80

Eingabefeld für bestimmte Attribute vergrößern, z.B. für das Attribut "state", um bequem Berechnungen zu erstellen.

attr <DOIF Name> widgetOverride state:textField-long

Größe des Editorfensters ändern

Wem das Editorfenster zu groß oder zu klein ist, kann die Höhe optimieren mit

attr WEB codemirrorParam { ..., "height":"auto" }

Weitere einstellbare Parameter für codemirror siehe auch: Codemirror Bedienung und Einstellungen

Umschaltung auf deutsche Befehlsreferenz

Direkter Aufruf der deutschsprachigen Hilfe in der "Device specific help" und direkter Zugriff auf die deutschsprachige Befehlsreferenz im Hauptmenü.

attr global language DE

Fehlende Geräte in "Probably associated with" anzeigen

Geräte, die im DOIF über einen regulären Ausdruck angesprochen werden, tauchen in der Liste von "Probably associated with" nicht auf. Diese Geräte werden aufgeführt, wenn sie in der Definition des DOIF als Kommentar mit vollständigem Namen aufgezählt werden.

(["^GERAET(1|2)$:"]) ## GERAET1 GERAET2
   (set ...)

Seit Revision 18029 kann in [Gerät|Geräten] ein [Reading] associatedWith mit Gerätenamen angelegt werden, die zusätzlich in der Liste "Probably associated with" angezeigt werden [1].

setreading <name> associatedWith <Durch Komma oder Leerzeichen getrennte Liste von Gerätenamen>

Import von Code Snippets

Code Snippets können über Raw definition importiert werden, siehe DOIF/Import von Code Snippets.

DOIFtools das Modul zum DOIF

Das Modul DOIFtools enthält Funktionen zur Unterstützung des Benutzers im Umgang mit DOIF:

  • erstellen von readingsGroup Definitionen, zur Beschriftung von Frontendelementen.
  • erstellen eines Debug-Logfiles, in dem mehrere DOIF und zugehörige Geräte geloggt werden.
  • optionales DOIF-Listing bei jeder Status und Wait-Timer Aktualisierung im Debug-Logfile.
  • Navigation zwischen den DOIF-Listings im Logfile, wenn es über DOIFtools geöffnet wird.
  • erstellen von userReadings in DOIF-Geräten zur Anzeige des realen Datums bei Wochentag behafteten Timern.
  • löschen von benutzerdefinierten Readings in DOIF-Definitionen über eine Mehrfachauswahl.
  • erfassen statistischer Daten über Events.
  • Begrenzung der Datenerfassungsdauer.
  • erstellen eines Statistikreports.
  • Liste aller DOIF-Definitionen in probably associated with.
  • Zugriff auf DOIFtools aus jeder DOIF-Definition über die Liste in probably associated with.
  • Zugriff aus DOIFtools auf vorhandene DOIFtoolsLog-Logdateien.
  • einblenden des Event-Monitor in der Detailansicht.
  • ermöglicht den Zugriff auf den Event Monitor in der Detailansicht von DOIF.
  • prüfen der DOIF Definitionen mit Empfehlungen.
  • erstellen eigener Shortcuts

Weiterführende Links

Tools und Fehlersuche