---
title: "Izrazi / Skriptni jezik"
description: "Referencija skriptnog jezika TapHome: konteksti u smart rules, obavijestima, Modbus i Packet parser, rezultat skripte, tipovi podataka, operatori i sve 104 funkcije."
url: "https://taphome.com/hr/docs/script/"
language: hr
lastmod: 2026-11-06
generator: hugo
ai:
  topics: ["scripting-language","expressions","functions","data-types","smart-rules","parsing"]
  questions: ["Kako napisati višeredne skripte u sustavu TapHome?","Gdje se može koristiti skriptni jezik TapHome?","Kako koristiti naredbe IF/ELSE u izrazima TapHome?","Kako raščlaniti JSON podatke u skripti TapHome?","Koja je razlika između funkcija MIN i MINSTRICT?","Kako raditi s datumom i vremenom u skriptama TapHome?","Kako koristiti funkciju LINEAR za interpolaciju vrijednosti?","Koju vrijednost vraća skripta TapHome?","Što smije vratiti skripta za čitanje uređaja?"]
---

# Izrazi / Skriptni jezik

Posljednje ažuriranje: 2026-11-06

![TapHome Icon](https://taphome.com/documentation/script/script-icon.png)

TapHome ima jedan skriptni jezik za smart rules, obavijesti i integracije uređaja. Sintaksa i funkcije svugdje su iste; samo dostupne varijable, konstante i funkcije ovise o tome gdje se skripta izvršava. Aplikacija za Android, Windows i macOS u uređivaču skripti ističe sintaksu; aplikacija za iOS prikazuje skriptu bez isticanja.

## Gdje se skripte koriste

Isti skriptni jezik izvršava se u smart rules, obavijestima i u integracijama Modbus i Packet parser:

| Kontekst | Što skripta radi | Specifično za kontekst |
|---|---|---|
| Smart rule **Jednadžba** | Jedan izraz nad vrijednostima uređaja. `TRUE` pokreće radnje za istinu, `FALSE` radnje za laž. | `LastState`, `TriggerName` |
| Smart rule **Formula** | Izračunava vrijednost koja se upisuje u svaki izlazni uređaj. | `LastState`, `TriggerName` |
| Smart rule **Skripta** | Čita vrijednosti uređaja i dodjeljuje nove; svaka dodjela postaje radnja na uređaju. | Varijable za čitanje i pisanje, `TriggerName` |
| Ograničavajući uvjet **Formula** | Odlučuje smije li se smart rule izvršiti. | `TRUE` dopušta izvršavanje smart rule |
| **Naslov i tekst obavijesti** | Sastavlja tekst obavijesti. | Mora vratiti tekst; konstante obavijesti |
| Modbus **skripta za čitanje modula** | Ispituje modul, obično radi prijave pogrešaka uređaja. | Funkcije `MODBUS*` |
| Modbus **skripte za čitanje i pisanje uređaja** | Pretvara registre u vrijednost uređaja i traženu vrijednost natrag u registre. | Rezultat skripte za čitanje postaje vrijednost uređaja |
| Modbus **inicijalizacijska skripta** | Izvršava se jednom nakon spajanja modula. | Obično `MODBUSWNE` |
| Packet parser **skripte za čitanje i pisanje** | Šalje zahtjev ili naredbu preko HTTP, FTP, TCP, UDP ili MQTT; kod HTTP i FTP obrađuje i odgovor. | `SENDHTTPREQUEST`, `SENDDATA`, `MQTTPUBLISH` |
| Packet parser **listener skripta** | Obrađuje svaki dolazni TCP ili UDP paket i svaku MQTT poruku. | `RECEIVEDMSG` |
| **Servisni atributi i radnje** (Modbus, Packet parser) | Dijagnostički retci i gumbi s parametrima u aplikaciji. | Parametri radnje prema njihovoj kratici |

`SLEEP` se u smart rules i obavijestima odbija (iznimka je ograničavajući uvjet Formula). `ADDERROR`, `ADDWARNING` i `ADDINFO` rade samo u skriptama uređaja. Što pojedini smart rules prosljeđuju svojoj skripti, opisuje stranica [Skripte u smart rules i obavijestima](https://taphome.com/hr/docs/script/smart-rules/); integracije imaju vlastite stranice, [Funkcije Modbus](https://taphome.com/hr/docs/script/modbus/) i [Funkcije Packet parsera](https://taphome.com/hr/docs/script/packet-parser/).

## Rezultat skripte

Skripta je popis naredbi. Vrijednost posljednje izračunate naredbe rezultat je skripte. [`RETURN`](https://taphome.com/hr/docs/script/basics/#return) prijevremeno završava skriptu zadanom vrijednošću.

```taphome
VAR a := 1;
VAR b := 2;
a + b;
# Result: 3
```

Rezultat skripte za čitanje uređaja mora odgovarati vrijednosti uređaja, inače skripta završava pogreškom `Return value 'X' does not match required return type constraint`:

| Vrijednost uređaja | Dopušteni rezultat |
|---|---|
| Stanje sklopke, magnetski kontakt | `TRUE` ili `FALSE` (prihvaćaju se i brojevi), `NaN`, `Null` |
| Stanje prekidača s više vrijednosti | Broj (cijeli broj odabire stanje; decimalna vrijednost se ne odbija), `NaN`, `Null` |
| Bilo koja druga vrijednost | Broj, `NaN`, `Null` |

`NaN` znači „vrijednost je nepoznata”, `Null` znači „vrijednost ne postoji”. Kako se oba ponašaju u izrazima, opisano je u odjeljku [Null i NaN](https://taphome.com/hr/docs/script/data-types/#null-and-nan).

## Referentne stranice

### Osnove jezika

- [Sintaksa i tijek izvršavanja](https://taphome.com/hr/docs/script/basics/) — Naredbe, komentari, literali, `IF`, `SWITCH`, petlje `WHILE` i `DO`, `RETURN`
- [Tipovi podataka](https://taphome.com/hr/docs/script/data-types/) — Brojevi, tekst, strukturirani i enum tipovi, zbirke, `.Type`, proširenje tipa, `Null` i `NaN`
- [Varijable i konstante](https://taphome.com/hr/docs/script/variables/) — Varijable uređaja, vrijednosti skupina, varijable modula, `VAR` i deklaracije s tipom, svojstva, konstante konteksta
- [Operatori](https://taphome.com/hr/docs/script/operators/) — Popis operatora, prioritet, skraćeno izračunavanje, ekvivalenti u Excelu

### Smart rules i dijagnostika

- [Smart rules i obavijesti](https://taphome.com/hr/docs/script/smart-rules/) — Jednadžba, Formula, Skripta, ograničavajući uvjet Formula i obavijesti
- [Logika i dijagnostika](https://taphome.com/hr/docs/script/logic-and-diagnostics/) — `ISNULL`, `ISNAN`, `EQUALS`, `SLEEP`, `ADDERROR`, `ADDWARNING`, `ADDINFO`, `DEBOUNCE`
- [Pogreške](https://taphome.com/hr/docs/script/errors/) — Poruke o pogreškama pri raščlambi i izvršavanju te kako ih ukloniti

### Brojevi i vrijeme

- [Statistika i Info vrijednosti](https://taphome.com/hr/docs/script/value-info/) — Statistike uređaja, Info vrijednosti s vremenom posljednje promjene, prethodnom vrijednošću i vrijednostima završenih razdoblja
- [Matematičke funkcije](https://taphome.com/hr/docs/script/mathematical-functions/) — `MIN`, `MAX`, `AVG` (preskaču nepoznate vrijednosti, varijante `…STRICT` ne), `ABS`, `SIGN`, `SQRT`, `POWER`, `MOD`, `LOG`, `LN`, `DEWPOINT`
- [Zaokruživanje i slučajni brojevi](https://taphome.com/hr/docs/script/rounding-and-random/) — `ROUND`, `CEIL`, `FLOOR`, `RAND`, `RANDINT`
- [Interpolacija i pragovi](https://taphome.com/hr/docs/script/interpolation-and-thresholds/) — `LINEAR` preslikava vrijednost iz jednog raspona u drugi (na primjer krivulju prigušivanja), `HYSTERESIS`
- [Datum i vrijeme](https://taphome.com/hr/docs/script/date-and-time/) — `NOW`, `DATETIME`, `DATETIMEADD`, `TIMESPAN`, `LOCALTIMEZONE`

### Tekst, zbirke i boje

- [Tekst i zbirke](https://taphome.com/hr/docs/script/text-string-and-byte-array/) — `LENGTH`, `GETAT`, `SETAT`, `APPEND`, `INSERT`, `REMOVEAT`, `COPY`, `INDEXOF`, `REPLACE`, `SPLIT`, `COMPARE`, `BYTECOLLECTION`, `UINT16COLLECTION`, `BOOLCOLLECTION`
- [Sortiranje](https://taphome.com/hr/docs/script/sorting/) — `ORDER`, `ORDERINDEX` i njihove silazne i stroge varijante
- [Pretvorbe tipova podataka](https://taphome.com/hr/docs/script/data-type-conversions/) — `TOSTRING`, `TODOUBLE`, `TOBYTES`, `ENCODE`, `DECODE`
- [Boje](https://taphome.com/hr/docs/script/colours/) — `HSVTORGB`, `RGBTOHSV`
- [Funkcije za raščlambu](https://taphome.com/hr/docs/script/parsing-functions/) — `PARSETEXT`, `PARSEJSON` (čita vrijednost iz JSON-a prema njezinoj putanji), `PARSEXML`

### Binarni podaci i sigurnost

- [Operacije s bitovima](https://taphome.com/hr/docs/script/bit-operations/) — `GETBIT`, `GETBITS`, `SETBIT`, `SETBITS`, `GETBYTE`, `SETBYTE`, `TOBCD`, `FROMBCD`
- [Binarni podaci](https://taphome.com/hr/docs/script/binary-data/) — `PACKVALUE`, `UNPACKVALUE`
- [Šifriranje i hashevi](https://taphome.com/hr/docs/script/encryption-and-hashes/) — `AESENCRYPT`, `AESDECRYPT`, `HASH`, `HMAC`, `RANDBYTES`
- [Kodiranje bajtova i kontrolni zbrojevi](https://taphome.com/hr/docs/script/byte-encodings/) — `TOBASE64`, `FROMBASE64`, `TOHEX`, `FROMHEX`, `CRC16`, `CRC32`

### Integracije uređaja

- [Funkcije Modbus](https://taphome.com/hr/docs/script/modbus/) — Tipovi registara, `MODBUSR`, `MODBUSW`, `MODBUSWNE`, `MODBUSRBLOCK`, `MODBUSWBLOCK`, `MODBUSWBLOCKNE`
- [Skripte Modbus](https://taphome.com/hr/docs/script/modbus-scripts/) — Koje skripte imaju Modbus modul i uređaj, kada se izvršavaju, prefetch i predmemoriranje
- [Tipovi podataka Modbus](https://taphome.com/hr/docs/script/modbus-data-types/) — Tipovi podataka funkcija Modbus, varijante redoslijeda bajtova, 64-bitni tipovi, tekst
- [Funkcije Packet parsera](https://taphome.com/hr/docs/script/packet-parser/) — `HTTPREQUEST`, `SENDHTTPREQUEST`, `SENDDATA`, `MQTTPUBLISH`, `FTPDOWNLOAD`, `FTPUPLOAD`, `COMPLETESERVICEATTRIBUTE`, `COMPLETESERVICEACTION`
- [Listener skripte](https://taphome.com/hr/docs/script/listener-scripts/) — Listener skripta modula Packet parser, `RECEIVEDMSG` i `RECEIVEDBYTES`

### Primjeri i referenca

- [Primjeri](https://taphome.com/hr/docs/script/examples/) — Cjelovite skripte iz stvarnih predložaka uređaja
- [Zahtjevi za verziju](https://taphome.com/hr/docs/script/version-requirements/) — Build jedinice Core koji treba svaka funkcija
- [Funkcije od A do Ž](https://taphome.com/hr/docs/script/functions-a-z/) — Svaka funkcija s jednom rečenicom i poveznicom

