iobroker.javascript 9.2.1 → 9.2.3

package/docs/de/blockly.md

@@ -570,6 +570,13 @@ Im Gegensatz zu dem vorherigen Beispiel wird der Zustand von "Licht" in dem folg
 ```
 
 
+ 
+### State umschalten
+![Toggle state](img/system_toggle_en.png)
+
+Dieser Block ähnelt dem [Steuere-State-Block](#steuere-state), schaltet den Wert aber jeweils um — von `true` auf `false` und umgekehrt.
+
+
  
 ### Aktualisiere State
 ![Update state](img/system_update_en.png)
@@ -820,6 +827,42 @@ Typische Anwendung dieses Blocks:
  
 
 
+### Datenpunkt vorhanden
+
+Dieser Block liefert einen Boolean (`true` / `false`) und gibt zurück, ob der angegebene Datenpunkt aktuell überhaupt einen Wertdatensatz in der State-DB besitzt. Die OID wird über einen Value-Input geliefert — sie kann aus dem OID-Auswahlblock (`Objekt ID`), einer String-Variable oder jedem anderen Block kommen, der eine State-ID liefert.
+
+**Wozu das Ganze?** ioBroker speichert **Objekte** (Metadaten) und **States** (Werte) getrennt. Ein Adapter kann das *Objekt* eines Datenpunkts anlegen — die ID erscheint dann im OID-Auswahldialog —, ohne jemals einen *Wert* zu schreiben. In diesem Fall führt `getState(...)` zu einer Warnung im Log:
+
+```
+warn  getState "zigbee.0.187a3efffee9e4e8.load_power" not found (3)
+```
+
+Auch eine Prüfung wie `Wert von Objekt-ID … != null` löst diese Warnung aus, weil sie bereits *während* des `getState`-Aufrufs entsteht — also bevor der Vergleich überhaupt ausgewertet wird.
+
+Der Block **Datenpunkt vorhanden** verwendet intern `existsStateAsync(...)`. Diese Funktion prüft den Cache stillschweigend und schreibt nichts ins Log, falls der State fehlt. Das ist der saubere Weg, einen `getState`-Aufruf abzusichern, wenn ein Adapter Datenpunkte vorab anlegt, aber nicht sofort befüllt (z. B. Zigbee, Tuya).
+
+Typische Anwendung — einen Lese-Vorgang gegen fehlende State-Datensätze absichern:
+
+```
+wenn [Datenpunkt vorhanden [Objekt ID "zigbee.0.…load_power"]]
+    setze [leistung] auf [Wert von Objekt-ID "zigbee.0.…load_power"]
+    log [leistung]
+```
+
+Der erzeugte JavaScript-Code:
+
+```javascript
+if ((await existsStateAsync('zigbee.0.187a3efffee9e4e8.load_power'))) {
+    let leistung = getState('zigbee.0.187a3efffee9e4e8.load_power').val;
+    console.log(leistung);
+}
+```
+
+**Hinweis:** Mit der Adapter-Einstellung *„Beim Start nicht alle Zustände abonnieren"* lässt sich `existsState` nicht synchron auswerten. Der Block erzeugt deshalb die asynchrone Form (`await existsStateAsync(...)`), die in beiden Modi korrekt funktioniert.
+
+
+ 
+
 ## Aktionsblöcke
 
 ### Exec - Kommando
@@ -1224,6 +1267,10 @@ If you start value with "{" it will be interpreted as JSON string. Use double qu
 
 
  
+### An anderes Skript senden
+![An anderes Skript senden](img/sendto_otherscript_1_en.png)
+
+Mit diesem Block kannst du eine Nachricht an ein anderes Skript senden. Die Nachricht kann dort durch den Block [Ereignis – Nachricht empfangen](#trigger-on-script-event) verarbeitet werden.
 
 
  
@@ -1947,8 +1994,55 @@ Mit diesem Block können Sie Veranstaltungen per Dateiaktualisierung abbestellen
 
 **Wichtig**: Diese Funktionalität ist nur mit js-controller@4.1.x oder neuer verfügbar.
 
+### Trigger auf Skript-Ereignis
+![Trigger auf Skript-Ereignis](img/trigger_onScript_en.png)
+
+Mit diesem Block kannst du dich auf skriptübergreifende Ereignisse abonnieren und beim Empfang eine Aktion ausführen.
+
 ## Timeouts
 
+### Warten/Pause
+Mit diesem einfachen Block lässt sich die Ausführung von Blöcken pausieren.
+Achtung: Wird `pause` innerhalb einer Block-Kette verwendet, werden alle in diesem Skript darunter liegenden Blöcke ebenfalls verzögert:
+![Beispiel 1](img/wait1.png)
+Generierter Code:
+```
+console.log('"Independent" block'); // Wird nicht verzögert
+
+console.log('Before pause');
+await wait(5000);
+console.log('After pause');
+```
+
+Log-Ausgabe:
+```
+15:48:21.807	info	javascript.0 (7304) script.js.Skript_1: "Independent" block
+15:48:21.807	info	javascript.0 (7304) script.js.Skript_1: Before pause
+15:48:21.807	info	javascript.0 (7304) script.js.Skript_1: registered 0 subscriptions and 0 schedules
+15:48:26.810	info	javascript.0 (7304) script.js.Skript_1: After pause
+```
+
+![Beispiel 2](img/wait2.png)
+
+Generierter Code:
+```
+console.log('Before pause');
+await wait(5000);
+console.log('After pause');
+
+console.log('"Independent" block'); // Wird um 5 Sekunden verzögert
+```
+
+Ausgabe:
+
+```
+15:52:03.289	info	javascript.0 (7304) script.js.Skript_1: Before pause
+15:52:03.290	info	javascript.0 (7304) script.js.Skript_1: registered 0 subscriptions and 0 schedules
+15:52:08.296	info	javascript.0 (7304) script.js.Skript_1: After pause
+15:52:08.297	info	javascript.0 (7304) script.js.Skript_1: "Independent" block
+```
+
+
 ### Delayed execution
 ![Delayed execution](img/timeouts_timeout_en.png)
 
@@ -2333,25 +2427,592 @@ Inside these blocks variable "value" yet exist, but anyway to read their values
 
  
 
-## Functions
+## Funktionen
+
+### Funktion aus Blöcken erstellen (ohne Rückgabewert)
+![Funktion aus Blöcken erstellen ohne Rückgabewert](img/functions_function_en.png)
+
+Mit diesem Block kannst du wiederkehrende Block-Sequenzen zu einer Funktion zusammenfassen und diese Funktion anschließend an beliebigen Stellen im aktuellen Blockly-Skript verwenden.
+
+Hier ein Beispiel für eine Funktion, die nur die aktuelle Uhrzeit ins Log schreibt:
+
+![Funktion aus Blöcken erstellen ohne Rückgabewert](img/functions_function_2_en.png)
+
+```xml
+<xml xmlns="http://www.w3.org/1999/xhtml">
+  <block type="comment" id=";LE@QUg[hpGG!Ed6(?Hf" x="463" y="88">
+    <field name="COMMENT">Print current time</field>
+  </block>
+  <block type="procedures_defnoreturn" id="zz#oL]VPR)s}NMK9htHa" x="463" y="113">
+    <field name="NAME">printTime</field>
+    <comment pinned="false" h="80" w="160">Describe this function...</comment>
+    <statement name="STACK">
+      <block type="debug" id="ak(`[aJB-AH@Hvc;B,[D">
+        <field name="Severity">log</field>
+        <value name="TEXT">
+          <shadow type="text" id="aGuA=^(ge/)=lXes9f]?">
+            <field name="TEXT">test</field>
+          </shadow>
+          <block type="time_get" id="M}z9(p(melE7BbTGqczO">
+            <mutation format="false" language="false"></mutation>
+            <field name="OPTION">hh:mm:ss.sss</field>
+          </block>
+        </value>
+      </block>
+    </statement>
+  </block>
+</xml>
+```
+
+Nachdem die Funktion erstellt wurde, kann sie folgendermaßen verwendet werden:
+
+![Funktion aus Blöcken erstellen ohne Rückgabewert](img/functions_function_3_en.png)
+
+```xml
+<block xmlns="http://www.w3.org/1999/xhtml" type="timeouts_setinterval" id="hp;?}l3uStXhm+a2s!9t" x="62.99999999999943" y="112.99999999999994">
+  <field name="NAME">interval</field>
+  <field name="INTERVAL">1000</field>
+  <statement name="STATEMENT">
+    <block type="procedures_callnoreturn" id="(/)MPv+z_|516CuG%[XD">
+      <mutation name="printTime"></mutation>
+    </block>
+  </statement>
+</block>
+```
+
+Die neu erstellte Funktion erscheint im Block-Menü:
+
+![Funktion aus Blöcken erstellen ohne Rückgabewert](img/functions_function_4_en.png)
+
+Zusätzlich lassen sich über den Konfigurationsdialog Argumente für die Funktion festlegen. Im selben Dialog können auch die Namen der Argumente bearbeitet werden.
+
+![Funktion aus Blöcken erstellen ohne Rückgabewert](img/functions_function_1_en.png)
+
+Hier ein Beispiel für eine Funktion, die die Summe des ersten und des zweiten Arguments ausgibt:
+
+![Funktion aus Blöcken erstellen ohne Rückgabewert](img/functions_function_5_en.png)
+
+```xml
+<xml xmlns="http://www.w3.org/1999/xhtml">
+  <block type="comment" id=";LE@QUg[hpGG!Ed6(?Hf" x="463" y="88">
+    <field name="COMMENT">Print sum of a and b</field>
+  </block>
+  <block type="procedures_defnoreturn" id="zz#oL]VPR)s}NMK9htHa" x="463" y="113">
+    <mutation>
+      <arg name="a"></arg>
+      <arg name="b"></arg>
+    </mutation>
+    <field name="NAME">printSum</field>
+    <comment pinned="false" h="80" w="160">Describe this function...</comment>
+    <statement name="STACK">
+      <block type="debug" id="ak(`[aJB-AH@Hvc;B,[D">
+        <field name="Severity">log</field>
+        <value name="TEXT">
+          <shadow type="text" id="aGuA=^(ge/)=lXes9f]?">
+            <field name="TEXT">test</field>
+          </shadow>
+          <block type="math_arithmetic" id="qUGc!b+U]:yE!I+3I+Lp">
+            <field name="OP">ADD</field>
+            <value name="A">
+              <shadow type="math_number" id="OqjQ{@*pgO,~Xd(ef)9~">
+                <field name="NUM">1</field>
+              </shadow>
+              <block type="variables_get" id="]dC)!=A3{(5?9hJ:1gET">
+                <field name="VAR">a</field>
+              </block>
+            </value>
+            <value name="B">
+              <shadow type="math_number" id="aDp|:rn#.wve0]WKi(D[">
+                <field name="NUM">1</field>
+              </shadow>
+              <block type="variables_get" id="5];ao,?ce{;GJ;OOW~S4">
+                <field name="VAR">b</field>
+              </block>
+            </value>
+          </block>
+        </value>
+      </block>
+    </statement>
+  </block>
+</xml>
+```
+
+Die Argumente erscheinen im Variablen-Menü:
+
+![Funktion aus Blöcken erstellen ohne Rückgabewert](img/functions_function_6_en.png)
+
+Die Funktion lässt sich dann so verwenden:
+
+![Funktion aus Blöcken erstellen ohne Rückgabewert](img/functions_function_7_en.png)
+
+```xml
+<block xmlns="http://www.w3.org/1999/xhtml" type="procedures_callnoreturn" id="(-G|y+Y7AC]w2CTQGjYC" x="138" y="188">
+  <mutation name="printSum">
+    <arg name="a"></arg>
+    <arg name="b"></arg>
+  </mutation>
+  <value name="ARG0">
+    <block type="math_number" id="!.UT=[{Xkz-*wlPh)sYn">
+      <field name="NUM">5</field>
+    </block>
+  </value>
+  <value name="ARG1">
+    <block type="math_number" id="EMhKM9Cn#;DjMZ#Ko%EN">
+      <field name="NUM">6</field>
+    </block>
+  </value>
+</block>
+```
+
+### Funktion aus Blöcken erstellen (mit Rückgabewert)
+![Funktion aus Blöcken erstellen mit Rückgabewert](img/functions_function_ret_en.png)
+
+Dieser Block funktioniert wie der vorherige, kann aber zusätzlich ein Ergebnis zurückgeben, das anschließend in anderen Blöcken weiterverwendet werden kann.
+
+![Funktion aus Blöcken erstellen mit Rückgabewert](img/functions_function_ret_2_en.png)
+
+```xml
+<block xmlns="http://www.w3.org/1999/xhtml" type="procedures_defreturn" id="4)|}1YzV}e6YUvVV^sY{" x="413" y="138">
+  <mutation statements="false">
+    <arg name="a"></arg>
+    <arg name="b"></arg>
+  </mutation>
+  <field name="NAME">do something</field>
+  <comment pinned="false" h="80" w="160">Return sum of a and b</comment>
+  <value name="RETURN">
+    <block type="math_arithmetic" id="qUGc!b+U]:yE!I+3I+Lp">
+      <field name="OP">ADD</field>
+      <value name="A">
+        <shadow type="math_number" id="OqjQ{@*pgO,~Xd(ef)9~">
+          <field name="NUM">1</field>
+        </shadow>
+        <block type="variables_get" id="]dC)!=A3{(5?9hJ:1gET">
+          <field name="VAR">a</field>
+        </block>
+      </value>
+      <value name="B">
+        <shadow type="math_number" id="aDp|:rn#.wve0]WKi(D[">
+          <field name="NUM">1</field>
+        </shadow>
+        <block type="variables_get" id="5];ao,?ce{;GJ;OOW~S4">
+          <field name="VAR">b</field>
+        </block>
+      </value>
+    </block>
+  </value>
+</block>
+```
+
+Die Verwendung ist analog zu den anderen Funktionsblöcken:
+
+![Funktion aus Blöcken erstellen mit Rückgabewert](img/functions_function_ret_3_en.png)
+
+```xml
+<xml xmlns="http://www.w3.org/1999/xhtml">
+  <block type="debug" id="zgr7b0g)}uMe1ySGYL7X" x="163" y="137">
+    <field name="Severity">log</field>
+    <value name="TEXT">
+      <shadow type="text" id="q-]m1ptAzK4Rq20wWRBq">
+        <field name="TEXT">test</field>
+      </shadow>
+      <block type="procedures_callreturn" id="0RX?V1j|FZHK@*Lw3W-g">
+        <mutation name="sum">
+          <arg name="a"></arg>
+          <arg name="b"></arg>
+        </mutation>
+        <value name="ARG0">
+          <block type="math_number" id="Xd52^_Qp83=ah2RTWzSU">
+            <field name="NUM">5</field>
+          </block>
+        </value>
+        <value name="ARG1">
+          <block type="math_number" id="-M9A9EhrgJSRc*4(X^[;">
+            <field name="NUM">6</field>
+          </block>
+        </value>
+      </block>
+    </value>
+  </block>
+  <block type="procedures_defreturn" id="4)|}1YzV}e6YUvVV^sY{" x="413" y="138">
+    <mutation statements="false">
+      <arg name="a"></arg>
+      <arg name="b"></arg>
+    </mutation>
+    <field name="NAME">sum</field>
+    <comment pinned="false" h="80" w="160">Return sum of a and b</comment>
+    <value name="RETURN">
+      <block type="math_arithmetic" id="qUGc!b+U]:yE!I+3I+Lp">
+        <field name="OP">ADD</field>
+        <value name="A">
+          <shadow type="math_number" id="OqjQ{@*pgO,~Xd(ef)9~">
+            <field name="NUM">1</field>
+          </shadow>
+          <block type="variables_get" id="]dC)!=A3{(5?9hJ:1gET">
+            <field name="VAR">a</field>
+          </block>
+        </value>
+        <value name="B">
+          <shadow type="math_number" id="aDp|:rn#.wve0]WKi(D[">
+            <field name="NUM">1</field>
+          </shadow>
+          <block type="variables_get" id="5];ao,?ce{;GJ;OOW~S4">
+            <field name="VAR">b</field>
+          </block>
+        </value>
+      </block>
+    </value>
+  </block>
+</xml>
+```
 
-### Create function from blocks with no return value
+Für jede Funktion lässt sich ein Kommentar bzw. eine Beschreibung hinzufügen.
 
-### Create function from blocks with return value
+![Funktion aus Blöcken erstellen mit Rückgabewert](img/functions_function_ret_1_en.png)
+
+Im Funktionsblock kann zusätzlich ein spezielles Return-Element verwendet werden:
+
+![Funktion aus Blöcken erstellen mit Rückgabewert](img/functions_function_ret_4_en.png)
+
+![Funktion aus Blöcken erstellen mit Rückgabewert](img/functions_function_ret_5_en.png)
+
+```xml
+<xml xmlns="http://www.w3.org/1999/xhtml">
+  <block type="debug" id="zgr7b0g)}uMe1ySGYL7X" x="63" y="12">
+    <field name="Severity">log</field>
+    <value name="TEXT">
+      <shadow type="text" id="q-]m1ptAzK4Rq20wWRBq">
+        <field name="TEXT">test</field>
+      </shadow>
+      <block type="procedures_callreturn" id="0RX?V1j|FZHK@*Lw3W-g">
+        <mutation name="numberToDay">
+          <arg name="day"></arg>
+        </mutation>
+        <value name="ARG0">
+          <block type="math_number" id="Xd52^_Qp83=ah2RTWzSU">
+            <field name="NUM">5</field>
+          </block>
+        </value>
+      </block>
+    </value>
+  </block>
+  <block type="debug" id="@i@bdG^90dp,cJ#W*[nB" x="12" y="188">
+    <field name="Severity">log</field>
+    <value name="TEXT">
+      <shadow type="text" id="8:/`}T!:6Wz.d/;)jpHl">
+        <field name="TEXT">test</field>
+      </shadow>
+      <block type="procedures_callreturn" id="hvzS!O_Q=FlccQR@*%tk">
+        <mutation name="numberToDay">
+          <arg name="day"></arg>
+        </mutation>
+        <value name="ARG0">
+          <block type="time_get" id=":A,Ba,yrW_QgiX*cs9zh">
+            <mutation format="false" language="false"></mutation>
+            <field name="OPTION">wd</field>
+          </block>
+        </value>
+      </block>
+    </value>
+  </block>
+  <block type="procedures_defreturn" id="4)|}1YzV}e6YUvVV^sY{" x="588" y="163">
+    <mutation>
+      <arg name="day"></arg>
+    </mutation>
+    <field name="NAME">numberToDay</field>
+    <comment pinned="false" h="80" w="160">Return sum of a and b</comment>
+    <statement name="STACK">
+      <block type="procedures_ifreturn" id="/qJjm#cr-naS}joAL0eT">
+        <mutation value="1"></mutation>
+        <value name="CONDITION">
+          <block type="logic_compare" id="cbxuAYxF,ptMi.`E/nB.">
+            <field name="OP">EQ</field>
+            <value name="A">
+              <block type="variables_get" id="`mWQWp).?qDuD=)NX2dA">
+                <field name="VAR">day</field>
+              </block>
+            </value>
+            <value name="B">
+              <block type="math_number" id="s,20+9X6bB/2nL{v?g:/">
+                <field name="NUM">0</field>
+              </block>
+            </value>
+          </block>
+        </value>
+        <value name="VALUE">
+          <block type="text" id="iI)V7P`3YP]{-S-7HcO1">
+            <field name="TEXT">Sunday</field>
+          </block>
+        </value>
+        <next>
+          <block type="procedures_ifreturn" id="3=FBSCS{jzu[}2L5Spi[">
+            <mutation value="1"></mutation>
+            <value name="CONDITION">
+              <block type="logic_compare" id="V[;S84AH5cf93^5/[AN^">
+                <field name="OP">EQ</field>
+                <value name="A">
+                  <block type="variables_get" id=";ShgVu*+:nn9WSzbm[fA">
+                    <field name="VAR">day</field>
+                  </block>
+                </value>
+                <value name="B">
+                  <block type="math_number" id="jY?Wj8lC1-~SiIHa*I)0">
+                    <field name="NUM">1</field>
+                  </block>
+                </value>
+              </block>
+            </value>
+            <value name="VALUE">
+              <block type="text" id="=aVg_FatldZUUsS(8G`;">
+                <field name="TEXT">Monday</field>
+              </block>
+            </value>
+            <next>
+              <block type="procedures_ifreturn" id="(g_VE2e?U^J-nhk,bP|0">
+                <mutation value="1"></mutation>
+                <value name="CONDITION">
+                  <block type="logic_compare" id="M;B+SSw[Mc.iu;fUjvcV">
+                    <field name="OP">EQ</field>
+                    <value name="A">
+                      <block type="variables_get" id="yT{.UQ)qXY8-@2XzpxQo">
+                        <field name="VAR">day</field>
+                      </block>
+                    </value>
+                    <value name="B">
+                      <block type="math_number" id="Q-JC5_JZ=i{[+~:^|BpU">
+                        <field name="NUM">2</field>
+                      </block>
+                    </value>
+                  </block>
+                </value>
+                <value name="VALUE">
+                  <block type="text" id="9`665+j*i_?3BCZWODGt">
+                    <field name="TEXT">Tuesday</field>
+                  </block>
+                </value>
+                <next>
+                  <block type="procedures_ifreturn" id="{+9IT6E:N-a+Y.cFNMsw">
+                    <mutation value="1"></mutation>
+                    <value name="CONDITION">
+                      <block type="logic_compare" id="B}D{JSK|}=bk|-|D#/_h">
+                        <field name="OP">EQ</field>
+                        <value name="A">
+                          <block type="variables_get" id="s{Zxm|sBbEGA1#~Tv3EE">
+                            <field name="VAR">day</field>
+                          </block>
+                        </value>
+                        <value name="B">
+                          <block type="math_number" id="f!3KoyGu4bWpxdaJY`JI">
+                            <field name="NUM">3</field>
+                          </block>
+                        </value>
+                      </block>
+                    </value>
+                    <value name="VALUE">
+                      <block type="text" id="yS4pn;Fdg9JT[MjvPu,4">
+                        <field name="TEXT">Wednesday</field>
+                      </block>
+                    </value>
+                    <next>
+                      <block type="procedures_ifreturn" id="g*VMz;jyw4,@;Qb*/8TN">
+                        <mutation value="1"></mutation>
+                        <value name="CONDITION">
+                          <block type="logic_compare" id="(^azMqi{:`?S.tJ@y7-m">
+                            <field name="OP">EQ</field>
+                            <value name="A">
+                              <block type="variables_get" id="P*CAI!ug.Xl*BM2v/kpb">
+                                <field name="VAR">day</field>
+                              </block>
+                            </value>
+                            <value name="B">
+                              <block type="math_number" id="YN@VzF~X=BOcWm+P]c3i">
+                                <field name="NUM">4</field>
+                              </block>
+                            </value>
+                          </block>
+                        </value>
+                        <value name="VALUE">
+                          <block type="text" id="H`yzv!j_GjSw|@f7Gap8">
+                            <field name="TEXT">Thursday</field>
+                          </block>
+                        </value>
+                        <next>
+                          <block type="procedures_ifreturn" id=")htNPjBWw1J/gp-Y5#Kg">
+                            <mutation value="1"></mutation>
+                            <value name="CONDITION">
+                              <block type="logic_compare" id="nFZ;s`3ij0v|.wQqw`AB">
+                                <field name="OP">EQ</field>
+                                <value name="A">
+                                  <block type="variables_get" id="Q^3OKKD]aGa0/qxWf%*g">
+                                    <field name="VAR">day</field>
+                                  </block>
+                                </value>
+                                <value name="B">
+                                  <block type="math_number" id="#brnWNXj0_dx[JwHjgh0">
+                                    <field name="NUM">5</field>
+                                  </block>
+                                </value>
+                              </block>
+                            </value>
+                            <value name="VALUE">
+                              <block type="text" id="Y1-{3UJxFrpq{uJp6DkB">
+                                <field name="TEXT">Friday</field>
+                              </block>
+                            </value>
+                            <next>
+                              <block type="procedures_ifreturn" id="K2~CLXTJ5b=T+=/6%m=~">
+                                <mutation value="1"></mutation>
+                                <value name="CONDITION">
+                                  <block type="logic_compare" id="Cjh^D.y[m3YQn},sC1(0">
+                                    <field name="OP">EQ</field>
+                                    <value name="A">
+                                      <block type="variables_get" id="|uXT]6-.XcdAG-6HtffC">
+                                        <field name="VAR">day</field>
+                                      </block>
+                                    </value>
+                                    <value name="B">
+                                      <block type="math_number" id="N@!AqGy7OCz9:zhv@f?K">
+                                        <field name="NUM">6</field>
+                                      </block>
+                                    </value>
+                                  </block>
+                                </value>
+                                <value name="VALUE">
+                                  <block type="text" id="omKlSmgS{[5T:v{9(j}?">
+                                    <field name="TEXT">Saturday</field>
+                                  </block>
+                                </value>
+                                <next>
+                                  <block type="procedures_ifreturn" id=".XFx#9RZIGl!joSiMNyq">
+                                    <mutation value="1"></mutation>
+                                    <value name="CONDITION">
+                                      <block type="logic_compare" id="aqkbbBOzUTv/%JlX)V}S">
+                                        <field name="OP">EQ</field>
+                                        <value name="A">
+                                          <block type="variables_get" id="qrl+C-GvBF7QzLz8?@:u">
+                                            <field name="VAR">day</field>
+                                          </block>
+                                        </value>
+                                        <value name="B">
+                                          <block type="math_number" id="_[;I?)){=vm_jnSYHumL">
+                                            <field name="NUM">7</field>
+                                          </block>
+                                        </value>
+                                      </block>
+                                    </value>
+                                    <value name="VALUE">
+                                      <block type="text" id="MCTQyN!}ig#3~)B[r#q[">
+                                        <field name="TEXT">Sunday</field>
+                                      </block>
+                                    </value>
+                                  </block>
+                                </next>
+                              </block>
+                            </next>
+                          </block>
+                        </next>
+                      </block>
+                    </next>
+                  </block>
+                </next>
+              </block>
+            </next>
+          </block>
+        </next>
+      </block>
+    </statement>
+    <value name="RETURN">
+      <block type="text" id="revjgT`{%j^1mn*-SJ1a">
+        <field name="TEXT">Invalid day</field>
+      </block>
+    </value>
+  </block>
+</xml>
+```
+
+### Wert in Funktion zurückgeben
+![Wert in Funktion zurückgeben](img/functions_return_en.png)
+
+Siehe Verwendung dieses Blocks unter [Funktion aus Blöcken erstellen (mit Rückgabewert)](#funktion-aus-blöcken-erstellen-mit-rückgabewert).
+
+Dieser Block ist nur dort verwendbar und dient dazu, mitten in der Funktion einen Wert zurückzugeben.
+
+### Eigene Funktion erstellen (ohne Rückgabewert)
+![Eigene Funktion erstellen ohne Rückgabewert](img/functions_function_ex_en.png)
+
+Manchmal reichen die vorhandenen Blöcke nicht aus, um eine bestimmte Aufgabe zu lösen. Mit diesem Block kannst du einen eigenen Block als Funktion definieren, der Parameter entgegennimmt und beliebige Aktionen ausführt.
+Um eine solche Funktion zu schreiben, sind JavaScript-Kenntnisse nötig. Innerhalb der Funktion stehen alle Funktionen zur Verfügung, die auch im normalen JavaScript-Skript verfügbar sind.
+
+Um den Code zu schreiben, klickst du auf das `...` am Ende des Blocks, woraufhin sich der Editor-Dialog öffnet.
+
+![Eigene Funktion erstellen ohne Rückgabewert](img/functions_function_ex_1_en.png)
+
+Ansonsten ist die Verwendung dieses Blocks analog zu den Standard-Funktionsblöcken, etwa [Funktion aus Blöcken erstellen (mit Rückgabewert)](#funktion-aus-blöcken-erstellen-mit-rückgabewert) oder [Funktion aus Blöcken erstellen (ohne Rückgabewert)](#funktion-aus-blöcken-erstellen-ohne-rückgabewert).
+
+### Eigene Funktion erstellen (mit Rückgabewert)
+![Eigene Funktion erstellen mit Rückgabewert](img/functions_function_ex_ret_en.png)
+
+Dieser eigene Funktionsblock kann Werte zurückgeben. Um ein Ergebnis aus der Funktion zurückzugeben, schreibst du:
+
+```
+return 'dein Ergebnis';
+```
+
+Wie hier:
+
+![Eigene Funktion erstellen mit Rückgabewert](img/functions_function_ex_ret_1_en.png)
+
+```xml
+<xml xmlns="http://www.w3.org/1999/xhtml">
+  <block type="procedures_defcustomreturn" id="mG^pXm=MO7vPl!c^/.Px" x="163" y="63">
+    <mutation statements="false">
+      <arg name="a"></arg>
+      <arg name="b"></arg>
+    </mutation>
+    <field name="NAME">sum</field>
+    <field name="SCRIPT">cmV0dXJuIGEgKyBiOw==</field>
+    <comment pinned="false" h="80" w="160">Summarise a and b</comment>
+  </block>
+  <block type="debug" id="U6pI-lE0VS#G):ELrQ(0" x="163" y="138">
+    <field name="Severity">log</field>
+    <value name="TEXT">
+      <shadow type="text" id="PBg^5*vuC?Isr)]pqx/u">
+        <field name="TEXT">test</field>
+      </shadow>
+      <block type="procedures_callcustomreturn" id="XuhUUF65jRZGB#YE(GTC">
+        <mutation name="sum">
+          <arg name="a"></arg>
+          <arg name="b"></arg>
+        </mutation>
+        <value name="ARG0">
+          <block type="math_number" id="h_[^zH{ILtnHrsxY0j~z">
+            <field name="NUM">5</field>
+          </block>
+        </value>
+        <value name="ARG1">
+          <block type="math_number" id="iIoph|b.?suX;)R=d|),">
+            <field name="NUM">6</field>
+          </block>
+        </value>
+      </block>
+    </value>
+  </block>
+</xml>
+```
 
-### Return value in function 
+### Funktion aufrufen
+![Funktion aufrufen](img/functions_call_ex_en.png)
 
-### Create custom function with no return value
+![Funktion aufrufen](img/functions_call_ex_ret_en.png)
 
-### Create custom function with return value
+Für jede angelegte Funktion erscheint im Menü ein zusätzlicher Block mit dem Namen dieser Funktion.
 
-### Call function
+Du kannst ihn wie jeden anderen Block in deinen Skripten verwenden.
 
 ## AI Chat für Blockly
 
 Das AI-Chat-Panel ist jetzt auch für Blockly-Scripts verfügbar. Klicke auf den AI-Button (Zauberstab-Symbol) in der Toolbar, um das Chat-Panel neben dem Blockly-Editor zu öffnen.
 
-### Funktionen
+### Funktionsumfang
 
 - **Chat-Modus**: Stelle Fragen zu deinem Blockly-Script. Die KI sieht den generierten JavaScript-Code als Kontext.
 - **Code-Modus**: Beschreibe eine Automatisierungsaufgabe und die KI generiert Blockly-XML-Blöcke in einem Zwei-Schritt-Prozess (Plan, dann Blöcke).