Režim Kód: jeden skript pro celý konfigurátor — Příručka gull system

Režim Kód (doplněk Logika) v gull system: skript v JavaScriptu, vstupy a return, nastavení jednotek, co skript nesmí, limity a hlášení.

Režim Kód: jeden skript pro celý konfigurátor

S doplňkem Logika nahradí vzorce jeden skript v JavaScriptu: čte vstupy, vrátí hodnoty parametrů. Hodí se, když má výpočet smyčky, pole nebo víc kroků, než se vejde do vzorce.

Zapnout

V kroku 3 na liště ve skupině Vyhodnocení klikněte na Kód a potvrďte Změnit. Vzorce zůstanou uložené, jen se nepoužívají; zpět se přepnete stejně.

Tvar skriptu

• Vstup čtete jako `vstupy["Délka"]` (alias `inputs`).
• Skript musí končit `return { "název parametru": hodnota, … }` — klíče jsou názvy zachycených parametrů z kroku 1. Panel Parametry vedle editoru ukazuje každý cíl s jeho klíčem a náhledem hodnoty.
• Příklad z editoru: `const d = vstupy["Délka"]; return { "Délka": d, "Otvor": d > 2000 };`
• K dispozici je `Math` a `console.log`, `console.warn`, `console.error`; jejich výstup se zobrazí pod editorem.

Nastavení

• Řádek: Délky v - Hodnoty: mm, cm, m - Význam: v jakých jednotkách skript počítá; do modelu se převedou
• Řádek: Úhly v - Hodnoty: °, rad - Význam: totéž pro úhly
• Řádek: Desetinné číslo ve vstupech - Hodnoty: „1.25 i 1,25“, „1.25“, „1,25“ - Význam: jak se čte hodnota, která přijde z formuláře nebo Excelu — ne jak píšete kód
• Řádek: Načíst ze souboru - Hodnoty: .js nebo .txt - Význam: jednorázově zkopíruje obsah souboru; na soubor se dál neodkazuje

Co skript nesmí

• `Date` a `Math.random()` jsou odmítnuté: „pravidlo musí dát pokaždé stejný výsledek“. Datum do objednávky dodá uzel Hodnota ve workflow.
• Žádný přístup k souborům ani k síti.
• Tabulky z Knihovny zatím nevidí — objekt `tabulky` je prázdný.
• V kódu je desetinná tečka: „v JavaScriptu není čárka desetinná — napište 1234.5, ne 1234,5“.

Limity a hlášení

Skript smí běžet 2 s, vytvořit pole do 10 milionů položek a zanořit se jen do určité hloubky; překročení zastaví objednávku s hlášením „nekonečný cyklus?“. Skript, který vrátí názvy, jaké žádný parametr nemá, dostane varování ještě v editoru.

Potlačení ve skriptu platí po staru: `true` nebo nenulové číslo = potlačit, opačně než u vzorců. Texty `"S"` (potlačit) a `"U"` (aktivní) platí v obou režimech stejně — používejte je, ať nemusíte přemýšlet, kde jste.

Náhled v režimu Kód nepíše do modelu, na rozdíl od vzorců. Výsledek skriptu uvidíte až při objednávce nebo v panelu Parametry.