Autocreate: Unterschied zwischen den Versionen

Aus FHEMWiki
(Erste Version der Seite)
 
K (→‎Attribute: -> ignoreTypes benötigt umschließende (..) bei mehreren per | verknüpften Ausdrücken, damit bei allen allen Ausdrücken (und nicht nur 1.) ab Beginn geprüft wird)
 
(4 dazwischenliegende Versionen von einem anderen Benutzer werden nicht angezeigt)
Zeile 2: Zeile 2:


{{Infobox Modul
{{Infobox Modul
|ModPurpose=Sinn und Zweck dieses Moduls (ein Satz)
|ModPurpose=Aktivierung des automatischen Anlegens von neuen Geräten
|ModType=h
|ModType=h
|ModCmdRef=autocreate
|ModCmdRef=autocreate
|ModForumArea=Automatisierung
|ModForumArea=Automatisierung
|ModTechName=98_autocreate.pm
|ModTechName=98_autocreate.pm
|ModOwner=rudolfkoenig
|ModOwner=rudolfkoenig ({{Link2FU|8|Forum}} / [[Benutzer Diskussion:Rudolfkoenig|Wiki]])
}}
}}


Zeile 14: Zeile 14:
== Attribute ==
== Attribute ==
Die vollständige Liste der unterstützten Attribute ist in der Dokumentation (siehe Infobox) enthalten. Detailliertere Informationen für ausgewählte Attribute sind in den folgenden Abschnitten verfügbar.
Die vollständige Liste der unterstützten Attribute ist in der Dokumentation (siehe Infobox) enthalten. Detailliertere Informationen für ausgewählte Attribute sind in den folgenden Abschnitten verfügbar.
;autosave
:Sofern dieses Attribut auf den Wert "1" gesetzt ist
::<code>attr ''autocreate'' autosave 1</code>
:(das ist auch der Standardwert, wenn das Attribut nicht gesetzt ist), wird nach dem automatischen Anlegen eines Gerätes die [[Konfiguration]] automatisch abgespeichert (also implizit ein ''save'' Befehl ausgeführt).
:Das neu (08/2015, siehe dazu auch diesen {{Link2Forum|Topic=39985|Message=325097|LinkText=Forenbeitrag}}) eingeführte ''global'' Attribut ''autosave'' erfüllt den gleichen Zweck. Derzeit kann das globale Attribut noch durch das ''autocreate'' Attribut überschrieben werden, das lokale Attribut sollte aber nicht mehr benutzt werden und könnte in einer späteren Version entfallen.


;ignoreTypes
;ignoreTypes
{{Randnotiz|RNTyp=y|RNText=In {{Link2Forum|Topic=46872|LinkText=diesem Forenthread}} wird etwas genauer dargestellt, auf was sich die spezifizierten ''ignoreTypes'' beziehen. Eigentlich ist der Name dieses Attributs irreführend, da es um den Präfix des generierten Gerätenamens geht und nicht um den TYPE/Modulnamen.}}
:Spezifikation von Geräten, die von der automatischen Generierung ausgenommen werden sollen:
:Spezifikation von Geräten, die von der automatischen Generierung ausgenommen werden sollen:
::<code>attr ''autocreate'' ignoreTypes ''TYPE=...''</code>
::<code>attr ''autocreate'' ignoreTypes ''(NamePrefix.*''[|''NamePrefix2.*''|...])</code>
:Reguläre Ausdrücke sind in der Spezifikation erlaubt.
:Reguläre Ausdrücke sind in der Spezifikation erlaubt, mit der Spezifikation von <code>(CUL_WS.*|FS20.*)</code> würden keine neuen Geräte mehr angelegt, deren generierter Name mit ''CUL_WS'' oder mit ''FS20'' beginnt. Viele Module generieren Gerätenamen, die mit dem Modulnamen (also z.B. ''FS20'') beginnen, im Einzelfall kann aber eine andere Vorgehensweise implementiert sein. Dann muss das Muster der erzeugten Namen identifiziert und der reguläre Ausdruck entsprechend angepasst werden.

Aktuelle Version vom 14. September 2020, 16:35 Uhr


autocreate
Zweck / Funktion
Aktivierung des automatischen Anlegens von neuen Geräten
Allgemein
Typ Hilfsmodul
Details
Dokumentation EN / DE
Support (Forum) Automatisierung
Modulname 98_autocreate.pm
Ersteller rudolfkoenig (Forum / Wiki)
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!


Bei aktiviertem autocreate werden neue Geräte von Fhem automatisch angelegt, sobald eine entsprechende Nachricht (Funktelegramm) empfangen wird. Geräte, die abgefragt werden (Polling), wie z.B. EMEM/EMWZ, werden nicht automatisch angelegt.

Attribute

Die vollständige Liste der unterstützten Attribute ist in der Dokumentation (siehe Infobox) enthalten. Detailliertere Informationen für ausgewählte Attribute sind in den folgenden Abschnitten verfügbar.

autosave
Sofern dieses Attribut auf den Wert "1" gesetzt ist
attr autocreate autosave 1
(das ist auch der Standardwert, wenn das Attribut nicht gesetzt ist), wird nach dem automatischen Anlegen eines Gerätes die Konfiguration automatisch abgespeichert (also implizit ein save Befehl ausgeführt).
Das neu (08/2015, siehe dazu auch diesen Forenbeitrag) eingeführte global Attribut autosave erfüllt den gleichen Zweck. Derzeit kann das globale Attribut noch durch das autocreate Attribut überschrieben werden, das lokale Attribut sollte aber nicht mehr benutzt werden und könnte in einer späteren Version entfallen.
ignoreTypes
Emblem-question-yellow.svgIn diesem Forenthread wird etwas genauer dargestellt, auf was sich die spezifizierten ignoreTypes beziehen. Eigentlich ist der Name dieses Attributs irreführend, da es um den Präfix des generierten Gerätenamens geht und nicht um den TYPE/Modulnamen.
Spezifikation von Geräten, die von der automatischen Generierung ausgenommen werden sollen:
attr autocreate ignoreTypes (NamePrefix.*[|NamePrefix2.*|...])
Reguläre Ausdrücke sind in der Spezifikation erlaubt, mit der Spezifikation von (CUL_WS.*|FS20.*) würden keine neuen Geräte mehr angelegt, deren generierter Name mit CUL_WS oder mit FS20 beginnt. Viele Module generieren Gerätenamen, die mit dem Modulnamen (also z.B. FS20) beginnen, im Einzelfall kann aber eine andere Vorgehensweise implementiert sein. Dann muss das Muster der erzeugten Namen identifiziert und der reguläre Ausdruck entsprechend angepasst werden.