MediaWiki-API-Ergebnis

{
    "batchcomplete": "",
    "continue": {
        "gapcontinue": "ReadingsGroup",
        "continue": "gapcontinue||"
    },
    "warnings": {
        "main": {
            "*": "Subscribe to the mediawiki-api-announce mailing list at <https://lists.wikimedia.org/postorius/lists/mediawiki-api-announce.lists.wikimedia.org/> for notice of API deprecations and breaking changes."
        },
        "revisions": {
            "*": "Because \"rvslots\" was not specified, a legacy format has been used for the output. This format is deprecated, and in the future the new format will always be used."
        }
    },
    "query": {
        "pages": {
            "4589": {
                "pageid": 4589,
                "ns": 0,
                "title": "Reading",
                "revisions": [
                    {
                        "contentformat": "text/x-wiki",
                        "contentmodel": "wikitext",
                        "*": "Readings sind i.d.R. modulabh\u00e4ngig und geben zusammen mit [[Attribut|Attributen]] und Internals den aktuellen Zustand des dahinter liegenden physischen oder virtuellen [[Ger\u00e4t|Ger\u00e4ts]] wieder.\n\n== Allgemeines ==\nReadings geben in FHEM wieder, welche Einstellungen oder Messwerte (allg. Ger\u00e4tedaten) am jeweiligen Ger\u00e4t vorliegen. So hat ein Temperatursensor ein Reading f\u00fcr die Temperatur, ein Lichtsensor hat ein Reading f\u00fcr die Helligkeit und ein Schalter ein Reading f\u00fcr An/Aus. Je nach Ger\u00e4tefamilie (zWave, FS20, Homematic,...) werden Readings in FHEM und Ger\u00e4tedaten m\u00f6glichst synchron gehalten. Zu Ausnahmen sp\u00e4ter mehr.\n\nReadings werden mit dem <code>define</code>-Befehl des jeweiligen [[Ger\u00e4t|Devices]] oder bei den ersten \u00dcbertragungen mit jenem angelegt und mit Werten gef\u00fcllt. \n\nBeim Herunterfahren von FHEM werden die bekannten Werte aller Readings entweder in das statefile oder die Konfigurationsdatenbank geschrieben. So k\u00f6nnen sie beim Start von FHEM wieder ausgelesen und in die entsprechenden Readings der Ger\u00e4te geschrieben werden. Damit entsteht ein wahrscheinlich halbwegs aktueller Zustand aller Ger\u00e4te, ohne dass beim Start von FHEM erst alle Ger\u00e4te abgefragt werden m\u00fcssen, was aber bei den meisten per Funk angesprochenen Ger\u00e4tefamilien wegen der 1%-Regel mitunter sehr lange dauern w\u00fcrde.\n\nAlle [[Ger\u00e4t|Ger\u00e4te]] haben Readings, deren Werte entweder vom Modulcode oder mit dem Befehl <code>setreading</code> ver\u00e4ndert werden k\u00f6nnen. Werden dabei moduleigene Readings gesetzt, k\u00f6nnen mitunter unerw\u00fcnschte Nebenwirkungen auftreten. Es k\u00f6nnen aber auch mit diesem Befehl neue Readings erzeugt werden, die bspw. zum Zwischenspeichern dienen sollen. So k\u00f6nnen Readings auch mit dem Kommando <code>deletereading</code> entfernt werden. Wobei hier durch das L\u00f6schen von modulinternen Readings sehr sicher Fehler in der Ausf\u00fchrung von FHEM auftreten werden. \n\n== Abgrenzung zu Attributen ==\nsiehe den entsprechenden Abschnitt bei [[Attribut#Abgrenzung zu Readings|Attribut]].\n\n== userReadings ==\nEinen Sonderfall eigener Readings stellen [[userReadings]] dar. Diese k\u00f6nnen insbesondere f\u00fcr Ger\u00e4te-interne Berechnungen genutzt werden, oder zur Erstellung von Readings mit Informationen aus verschiedenen Readings. Beispiel: Aus einzeln \u00fcbermittelten r, g und b-Werten einen rgb-Wert bilden, mit dem sich das devStateIcon einf\u00e4rben l\u00e4\u00dft. \u00c4hnlich wie bei notify und anderen Event-Handlern empfiehlt es sich, einen m\u00f6glichst engen Trigger zu definieren, damit nur bei \u00c4nderungen relevanter Ausgangswerte auch eine Neuberechnung des userreadings erfolgt.\n\n== Readings im STATE darstellen ==\nSollen andere als das Reading ''state'' in der Ger\u00e4te\u00fcbersicht angezeigt werden, erfolgt dies in der Regel \u00fcber das Attribut ''stateFormat''. N\u00e4heres hierzu ist im Artikel [[DeviceOverview anpassen]] zu finden.\n\n== Auf \u00c4nderungen reagieren ==\nUm auf \u00c4nderungen von Readings zu reagieren, verwenden Sie einen [[Eventhandler]], z.B. ein notify, um Trigger durch sich \u00e4ndernde Readings einzuschr\u00e4nken oder diese regelm\u00e4\u00dfig ohne \u00c4nderung zu erzeugen, verwenden Sie [[event-on-change-reading]] bzw. [[event-on-update-reading]] und [[event-min-interval]].\n\n== ReadingsGroup ==\n[[ReadingsGroup]] stellt eine M\u00f6glichkeit dar, neben Readings auch [[Attribut|Attribute] strukturiert darzustellen. \nMit Hilfe dieses [[Modul|Moduls]] k\u00f6nnen auch den End-Anwendern auf einfache Weise vielf\u00e4ltige Einstellm\u00f6glichkeiten zur Verf\u00fcgung gestellt werden.\n\n[[Kategorie:FHEM-Verwendung]]\n[[Kategorie:Glossary]]"
                    }
                ]
            },
            "4312": {
                "pageid": 4312,
                "ns": 0,
                "title": "ReadingsChange",
                "revisions": [
                    {
                        "contentformat": "text/x-wiki",
                        "contentmodel": "wikitext",
                        "*": "{{SEITENTITEL:readingsChange}}\n{{Infobox Modul\n|ModPurpose=Formatieren von Readings\n|ModType=h\n|ModCmdRef=readingsChange\n|ModTechName=33_readingsChange.pm\n|ModForumArea=Automatisierung\n|ModOwner=rudolfkoenig ({{Link2FU|8|Forum}} / [[Benutzer Diskussion:Rudolfkoenig|Wiki]])}} \n\nEventuell ist es n\u00f6tig, die Readings eines Ger\u00e4tes zu formatieren, Ihnen also Nachkommastellen abzuschneiden oder Textinhalte zu entfernen, hinzuf\u00fcgen oder umzustellen.\n\nHierzu dient das FHEM-[[:Kategorie:Hilfsmodul|Hilfsmodul]] [[readingsChange]]. Sobald ein Reading vom Device erzeugt wird, dass dem RegEX des Moduls entspricht, wird die Formatierung, z.B. von 27.2852 zu 27.3 vorgenommen.\n\n=== Definition ===\n\nDie Definition ist vom Modulautor in der Referenz beschrieben.\n\n== Besonderheiten ==\nReadingsChange ist abh\u00e4ngig von der Reihenfolge der Events und deren interner Verarbeitung. In dieser \"Nahrungskette\" steht es ziemlich weit hinten, mit dem Ergebnis, dass zum Beispiel Devices mit Attributen wie event-on-Change-reading fallweise nicht formatiert werden.\nDies erkl\u00e4rt dieser und sein folgender Forumseintrag: {{Link2Forum|Topic=65055|LinkText=readingsChange funktioniert nicht mehr}}\n\n\nHier spielt eine wichtige Rolle die Notify-Order, die man mit list .* NTFY_ORDER sich vor Augen f\u00fchren kann.\n== Beispiele ==\n\nEs soll das Reading \"battery\" f\u00fcr den Batteriestatus mehrerer HUE-Devices (Bewegungsmelder), welche einen numerischen Wert zwischen 0 und 100 liefern, in \"ok\" oder \"low\" \u00fcbersetzt werden. Die Schwelle von 30% f\u00fcr \"low\" ist an dieser Stelle nur beispielhaft.\n\n:<code>define rc_battState readingsChange HUEMotion. ^battery$ (\\d+) {$1 > 30 ? \"ok\" : \"low\"}</code>\nBeim Homematic-Z\u00e4hler HM-ES-TX-WM wird der \u00fcbermittelte Wert von ''powerIEC'' nicht als \"signed integer() (-2.147.4483.648 ... 2.147.483.647)\" sondern als \"unsigned integer() oder DWORD ( 0... 4294967295 )\" interpretiert und damit entsprechend falsch angezeigt. Sofern der Z\u00e4hler nur f\u00fcr den Bezug von Energie genutzt wird, tritt der Fehler nicht auf, um jedoch negative Leistungswerte (z.B. durch Einspeisung Balkonkraftwerk) richtig anzuzeigen, wird folgende Zeile nach Anpassung des Devicenamens helfen:\n\n<code>define rc_Zaehler_neg readingsChange HM_3BD456_IEC_01 powerIEC (\\d+) { $1 > 400000000 ? $1-4294967295 : $1}</code>\n\n== Links ==\n* Forenthema zur {{Link2Forum|Topic=60226|LinkText=Vorstellung des Moduls}}\n* [[Z-Wave-PHI_PST02-1A-T%C3%BCr-,_Bewegungs-,_Helligkeits-,_Temperatursensor#Temperaturkorrektur|Beispiel zu Temperaturoffset]]\n\n[[Kategorie:HOWTOS]]"
                    }
                ]
            }
        }
    }
}