Fork me on GitHubAdapter JavaScript mit Blockly

Der javascript-Adapter dient dazu komfortabel Skripte zu erstellen, editieren und zu verwalten.

Der Adapter beherrscht javascript, coffeescript und die visuelle Oberfläche Blockly für javascript

Hier wird die Bedienung über Blockly behandelt.

Steckbrief

aktuelle Version version javascript
letzte Änderung 15.03.2016
Voraussetzungen
Entwickler bluefox, hobbyquaker
Stichworte JS, Scripte. Javascript, Blockly
Github icon_link Link
Platform  Javascript/Node.js
License  MIT

 

Konfiguration

Einstellungen Javascript Adapter
Einstellungsmenü Javascript Adapter

 

Die eigentliche Konfiguration besteht aus der Eingabe von zusätzlichen zu ladenden npm-Module (durch Komma getrennt), sowie der Geo-Koordinaten, die für diverse Berechnungen benutzt werden sollen. Um die Koordinaten zu erhalten, kann man z.B. google maps ziemlich weit aufzoomen und an der gewünschten Stelle anklicken. Die Koordinaten werden dann angezeigt.

Nach dem Speichern muss der Adapter noch über die rote Play-Taste aktiviert werden aktiviert werden.


 

Bedienung

Anlegen eines Scripts

Bei der Installation wird ein weiterer Reiter Scripte in der Admin-Oberfläche gezeigt, wenn man diesen nach der Installation über das Bleistift-Icon rechts oben aktiviert.

Hier werden die Skripte angelegt, indem auf das 5. Icon in der Symbolleiste (roter Kreis) geklickt wird.

iobroker_blockly_001

Ordner- und Dateiliste

Die Ordnerstruktur kann nach eigenem Wunsch angelegt werden. Der Speicherort hat keine Auswirkungen auf die Funktionalität des Skriptes. Neben der Baumstruktur gibt es eine Listenansicht (Umschalten über das 2. Icon). Ein Suchfeld erleichtert das Wiederfinden von Skripten.

Damit ein Skript läuft, muss es links in der Ordnerstruktur durch klick auf den roten Play-Knopf aktiviert werden. Zum Stoppen auf den grünen Pause-Knopf drücken. Für jedes Skript wird ein neues Objekt angelegt. Es trägt den Skriptnamen mit dem Zusatz _enabled und liegt im Ordner javascript.Instanz.ScriptEnabled. Das Objekt zeigt mit (true/false) an, ob das Skript läuft. Der Zustand kann auch gesetzt werden, um das Skript ein-/auszuschalten.

Skripte, die im Ordner global gespeichert wurden, sind globale Skripte. Eine Kopie dieser Skripte wird intern an jedes andere Skript angehängt. Somit lassen sich globale Funktionen auf mehrere Skripte anwenden.

 

Editor

Nach dem Anlegen öffnet sich rechts der Editor für Javascript.

Name

Hier kann man den Namen für das neue Skript vergeben, dieses wird beim Speichern in der Dateiliste gezeigt und kann hier jederzeit geändert werden.

Enginetyp

hier kann ausgewählt werden, ob mit der javascript oder der coffeescript engine oder mit Blockly gearbeitet werden soll.

Log

Rechts unten findet sich das Log-Fenster für die Ausgabe aller das markierte Skript betreffende Logs. Die Logs werden nach dem Abspeichern/Neustart des Skriptes angezeigt.


Das Editorfenster

Das Editorfenster besteht aus der Block-Sidebar links und der eigentlichen Arbeitsfläche

Block Sidebar

Hier befinden sich die Blöcke mit denen die Scripts erstellt werden, sie werden nach anklicken der Kategorie per Drag and Drop auf die Arbeitsfläche gezogen.

Zur Verfügung stehen folgende Kategorien:

System

iobroker_blockly_blocks_system

 

Aktionen

iobroker_blockly_blocks_aktionen

 

SendTo

iobroker_blockly_blocks_sendto

 

Datum und Zeit

iobroker_blockly_blocks_datum_zeit

 

Konvertierung

iobroker_blockly_blocks_konvertierung

 

Trigger

iobroker_blockly_blocks_trigger

 

Timeouts

iobroker_blockly_blocks_timeouts

 

Logik

iobroker_blockly_blocks_logik

 

Schleifen

iobroker_blockly_blocks_schleifen

 

Mathematik

iobroker_blockly_blocks_mathematik

 

Text

iobroker_blockly_blocks_text

 

Listen

iobroker_blockly_blocks_listen

 

Farbe

iobroker_blockly_blocks_farben

 

Variablen

iobroker_blockly_blocks_variablen

 

Funktionen

iobroker_blockly_blocks_funktionen

 

Anwenden der Blöcke

Die Blöcke werden zu einem Skript zusammengeschoben. Hier ein einfaches Beispiel:

iobroker_blockly_script_simple


Tipps

Backup

Um Skripte im Zweifel wiederherstellen zu können, sei die Sicherung per Copy & Paste empfohlen.

Test-Instanz

Es hat sich bewährt, zum Testen von neuen Skripten, eine weitere Javascript-Instanz anzulegen und das Skript in dieser Instanz zu starten. Hinter dem Skriptnamen lässt sich per Dropdown die gewünschtes Instanz einstellen. Sollte im Skript ein schwerwiegender Fehler sein, beendet sich nur diese zusätzliche Testinstanz, nicht die Produktivinstanz.

Instanz Javascript Adapter wählen
Instanz Javascript Adapter wählen