---
title: "Expresii / limbaj de scripting"
description: "Referința limbajului de scripting TapHome: contexte în smart rules, notificări, Modbus și Packet parser, rezultatul scriptului, tipuri de date, operatori și toate cele 104 funcții."
url: "https://taphome.com/ro/docs/script/"
language: ro
lastmod: 2026-11-06
generator: hugo
ai:
  topics: ["scripting-language","expressions","functions","data-types","smart-rules","parsing"]
  questions: ["Cum se scriu scripturi pe mai multe linii în TapHome?","Unde se poate folosi limbajul de scripting TapHome?","Cum se folosesc instrucțiunile IF/ELSE în expresiile TapHome?","Cum se parsează date JSON într-un script TapHome?","Care este diferența dintre funcțiile MIN și MINSTRICT?","Cum se lucrează cu data și ora în scripturile TapHome?","Cum se folosește funcția LINEAR pentru interpolarea valorilor?","Ce valoare returnează un script TapHome?","Ce poate returna scriptul de citire al unui dispozitiv?"]
---

# Expresii / limbaj de scripting

Ultima actualizare: 2026-11-06

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

TapHome are un singur limbaj de scripting pentru smart rules, notificări și integrările dispozitivelor. Sintaxa și funcțiile sunt aceleași peste tot; doar variabilele, constantele și funcțiile disponibile depind de locul în care rulează scriptul. Aplicația pentru Android, Windows și macOS evidențiază sintaxa în editorul de scripturi; aplicația pentru iOS afișează scriptul fără evidențiere.

## Unde se folosesc scripturile

Același limbaj de scripting rulează în smart rules, în notificări și în integrările Modbus și Packet parser:

| Context | Ce face scriptul | Specific contextului |
|---|---|---|
| Smart rule **Ecuație** | O singură expresie peste valorile dispozitivelor. `TRUE` execută acțiunile pentru adevărat, `FALSE` acțiunile pentru fals. | `LastState`, `TriggerName` |
| Smart rule **Formulă** | Calculează o valoare care se scrie în fiecare dispozitiv de ieșire. | `LastState`, `TriggerName` |
| Smart rule **Script** | Citește valorile dispozitivelor și atribuie valori noi; fiecare atribuire devine o acțiune a dispozitivului. | Variabile de citire/scriere, `TriggerName` |
| Condiția de limitare **Formulă** | Decide dacă smart rule poate rula. | `TRUE` permite rularea regulii |
| Titlul și mesajul **notificării** | Compune textul notificării. | Trebuie să returneze text; constantele notificării |
| **Scriptul de citire al modulului** Modbus | Interoghează modulul, de regulă pentru a semnala erori ale dispozitivelor. | Funcțiile `MODBUS*` |
| **Scripturile de citire și scriere ale dispozitivului** Modbus | Convertesc registrele în valoarea dispozitivului și valoarea cerută înapoi în registre. | Rezultatul citirii devine valoarea dispozitivului |
| **Scriptul de inițializare** Modbus | Rulează o singură dată după conectarea modulului. | De regulă `MODBUSWNE` |
| **Scripturile de citire și scriere** Packet parser | Trimit o cerere sau o comandă prin HTTP, FTP, TCP, UDP sau MQTT; la HTTP și FTP prelucrează și răspunsul. | `SENDHTTPREQUEST`, `SENDDATA`, `MQTTPUBLISH` |
| **Scriptul listener** Packet parser | Tratează fiecare pachet TCP sau UDP primit și fiecare mesaj MQTT. | `RECEIVEDMSG` |
| **Atribute și acțiuni de service** (Modbus, Packet parser) | Rânduri de diagnostic și butoane cu parametri în aplicație. | Parametrii acțiunii după abrevierea lor |

`SLEEP` este respins în smart rules și în notificări (excepția este condiția de limitare Formulă). `ADDERROR`, `ADDWARNING` și `ADDINFO` funcționează doar în scripturile dispozitivelor. Ce transmite fiecare smart rule scriptului său se găsește pe pagina [Scripturi în smart rules și notificări](https://taphome.com/ro/docs/script/smart-rules/); integrările au paginile lor proprii, [Funcții Modbus](https://taphome.com/ro/docs/script/modbus/) și [Funcții Packet parser](https://taphome.com/ro/docs/script/packet-parser/).

## Rezultatul scriptului

Un script este o listă de instrucțiuni. Valoarea ultimei instrucțiuni evaluate este rezultatul scriptului. [`RETURN`](https://taphome.com/ro/docs/script/basics/#return) încheie scriptul mai devreme cu valoarea dată.

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

Rezultatul scriptului de citire al unui dispozitiv trebuie să corespundă valorii dispozitivului, altfel scriptul eșuează cu `Return value 'X' does not match required return type constraint`:

| Valoarea dispozitivului | Rezultat permis |
|---|---|
| Starea întrerupătorului, contact reed | `TRUE` sau `FALSE` (se acceptă și numere), `NaN`, `Null` |
| Starea comutatorului cu mai multe valori | Număr (un număr întreg selectează starea; o valoare zecimală nu este respinsă), `NaN`, `Null` |
| Orice altă valoare | Număr, `NaN`, `Null` |

`NaN` înseamnă „valoarea este necunoscută", `Null` înseamnă „nu există nicio valoare". Cum se comportă cele două în expresii este descris în [Null și NaN](https://taphome.com/ro/docs/script/data-types/#null-and-nan).

## Pagini de referință

### Bazele limbajului

- [Sintaxă și controlul fluxului](https://taphome.com/ro/docs/script/basics/) — Instrucțiuni, comentarii, literali, `IF`, `SWITCH`, buclele `WHILE` și `DO`, `RETURN`
- [Tipuri de date](https://taphome.com/ro/docs/script/data-types/) — Numere, text, tipuri structurate și enumerări, colecții, `.Type`, promovarea tipurilor, `Null` și `NaN`
- [Variabile și constante](https://taphome.com/ro/docs/script/variables/) — Variabilele dispozitivelor, valorile grupurilor, variabilele modulului, `VAR` și declarațiile cu tip, proprietăți, constantele contextului
- [Operatori](https://taphome.com/ro/docs/script/operators/) — Lista operatorilor, precedența, evaluarea prin scurtcircuitare, echivalentele din Excel

### Smart rules și diagnostic

- [Smart rules și notificări](https://taphome.com/ro/docs/script/smart-rules/) — Ecuație, Formulă, Script, condiția de limitare Formulă și notificările
- [Logică și diagnostic](https://taphome.com/ro/docs/script/logic-and-diagnostics/) — `ISNULL`, `ISNAN`, `EQUALS`, `SLEEP`, `ADDERROR`, `ADDWARNING`, `ADDINFO`, `DEBOUNCE`
- [Erori](https://taphome.com/ro/docs/script/errors/) — Mesajele de eroare la parsare și la rulare și cum se remediază

### Numere și timp

- [Statistici și Value info](https://taphome.com/ro/docs/script/value-info/) — Statisticile unui dispozitiv, Value info cu momentul ultimei modificări, valoarea anterioară și valorile perioadelor încheiate
- [Funcții matematice](https://taphome.com/ro/docs/script/mathematical-functions/) — `MIN`, `MAX`, `AVG` (omit valorile necunoscute, variantele `…STRICT` nu), `ABS`, `SIGN`, `SQRT`, `POWER`, `MOD`, `LOG`, `LN`, `DEWPOINT`
- [Rotunjire și numere aleatoare](https://taphome.com/ro/docs/script/rounding-and-random/) — `ROUND`, `CEIL`, `FLOOR`, `RAND`, `RANDINT`
- [Interpolare și praguri](https://taphome.com/ro/docs/script/interpolation-and-thresholds/) — `LINEAR` transpune o valoare dintr-un interval în altul (de exemplu o curbă de reglare a intensității), `HYSTERESIS`
- [Data și ora](https://taphome.com/ro/docs/script/date-and-time/) — `NOW`, `DATETIME`, `DATETIMEADD`, `TIMESPAN`, `LOCALTIMEZONE`

### Text, colecții și culori

- [Text și colecții](https://taphome.com/ro/docs/script/text-string-and-byte-array/) — `LENGTH`, `GETAT`, `SETAT`, `APPEND`, `INSERT`, `REMOVEAT`, `COPY`, `INDEXOF`, `REPLACE`, `SPLIT`, `COMPARE`, `BYTECOLLECTION`, `UINT16COLLECTION`, `BOOLCOLLECTION`
- [Sortare](https://taphome.com/ro/docs/script/sorting/) — `ORDER`, `ORDERINDEX` și variantele lor descrescătoare și stricte
- [Conversii de tipuri de date](https://taphome.com/ro/docs/script/data-type-conversions/) — `TOSTRING`, `TODOUBLE`, `TOBYTES`, `ENCODE`, `DECODE`
- [Culori](https://taphome.com/ro/docs/script/colours/) — `HSVTORGB`, `RGBTOHSV`
- [Funcții de parsare](https://taphome.com/ro/docs/script/parsing-functions/) — `PARSETEXT`, `PARSEJSON` (citește o valoare din JSON după calea ei), `PARSEXML`

### Date binare și securitate

- [Operații pe biți](https://taphome.com/ro/docs/script/bit-operations/) — `GETBIT`, `GETBITS`, `SETBIT`, `SETBITS`, `GETBYTE`, `SETBYTE`, `TOBCD`, `FROMBCD`
- [Date binare](https://taphome.com/ro/docs/script/binary-data/) — `PACKVALUE`, `UNPACKVALUE`
- [Criptare și hash-uri](https://taphome.com/ro/docs/script/encryption-and-hashes/) — `AESENCRYPT`, `AESDECRYPT`, `HASH`, `HMAC`, `RANDBYTES`
- [Codificări de octeți și sume de control](https://taphome.com/ro/docs/script/byte-encodings/) — `TOBASE64`, `FROMBASE64`, `TOHEX`, `FROMHEX`, `CRC16`, `CRC32`

### Integrări de dispozitive

- [Funcții Modbus](https://taphome.com/ro/docs/script/modbus/) — Tipuri de registre, `MODBUSR`, `MODBUSW`, `MODBUSWNE`, `MODBUSRBLOCK`, `MODBUSWBLOCK`, `MODBUSWBLOCKNE`
- [Scripturi Modbus](https://taphome.com/ro/docs/script/modbus-scripts/) — Ce scripturi au un modul și un dispozitiv Modbus, când rulează, prefetch și memorarea în cache
- [Tipuri de date Modbus](https://taphome.com/ro/docs/script/modbus-data-types/) — Tipurile de date ale funcțiilor Modbus, variantele ordinii octeților, tipuri pe 64 de biți, text
- [Funcții Packet parser](https://taphome.com/ro/docs/script/packet-parser/) — `HTTPREQUEST`, `SENDHTTPREQUEST`, `SENDDATA`, `MQTTPUBLISH`, `FTPDOWNLOAD`, `FTPUPLOAD`, `COMPLETESERVICEATTRIBUTE`, `COMPLETESERVICEACTION`
- [Scripturi listener](https://taphome.com/ro/docs/script/listener-scripts/) — Scriptul listener al unui modul Packet parser, `RECEIVEDMSG` și `RECEIVEDBYTES`

### Exemple și referințe

- [Exemple](https://taphome.com/ro/docs/script/examples/) — Scripturi complete din șabloane reale de dispozitive
- [Cerințe de versiune](https://taphome.com/ro/docs/script/version-requirements/) — Versiunea Core de care are nevoie fiecare funcție
- [Funcții A–Z](https://taphome.com/ro/docs/script/functions-a-z/) — Fiecare funcție cu o propoziție și un link

