en-us	### Item preprocessing  The item preprocessing object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |type|integer|The preprocessing option type.<br><br>Possible values:<br>1 - Custom multiplier;<br>2 - Right trim;<br>3 - Left trim;<br>4 - Trim;<br>5 - Regular expression;<br>6 - Boolean to decimal;<br>7 - Octal to decimal;<br>8 - Hexadecimal to decimal;<br>9 - Simple change;<br>10 - Change per second;<br>11 - XML XPath;<br>12 - JSONPath;<br>13 - In range;<br>14 - Matches regular expression;<br>15 - Does not match regular expression;<br>16 - Check for error in JSON;<br>17 - Check for error in XML;<br>18 - Check for error using regular expression;<br>19 - Discard unchanged;<br>20 - Discard unchanged with heartbeat;<br>21 - JavaScript;<br>22 - Prometheus pattern;<br>23 - Prometheus to JSON;<br>24 - CSV to JSON;<br>25 - Replace;<br>26 - Check unsupported;<br>27 - XML to JSON;<br>28 - SNMP walk value;<br>29 - SNMP walk to JSON;<br>30 - SNMP get value.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |params|string|Additional parameters used by preprocessing option.<br>Multiple parameters are separated by the newline (\\n) character.<br><br>If `type` is set to "Check unsupported", the parameters follow a `<scope>[\n<pattern>]` syntax, where *pattern* is a regular expression, and *scope* is one of:<br>-1 - match any error;<br>\ 0 - check if error message matches *pattern*;<br>\ 1 - check if error message does not match *pattern*.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "Custom multiplier" (1), "Right trim" (2), "Left trim" (3), "Trim" (4), "Regular expression" (5), "XML XPath" (11), "JSONPath" (12), "In range" (13), "Matches regular expression" (14), "Does not match regular expression" (15), "Check for error in JSON" (16), "Check for error in XML" (17), "Check for error using regular expression" (18), "Discard unchanged with heartbeat" (20), "JavaScript" (21), "Prometheus pattern" (22), "Prometheus to JSON" (23), "CSV to JSON" (24), "Replace" (25), Check unsupported (26), "SNMP walk value" (28), "SNMP walk to JSON" (29), or "SNMP get value" (30)| |error\_handler|integer|Action type used in case of preprocessing step failure.<br><br>Possible values:<br>0 - Error message is set by Zabbix server;<br>1 - Discard value;<br>2 - Set custom value;<br>3 - Set custom error message.<br><br>Possible values if `type` is set to "Check unsupported":<br>1 - Discard value;<br>2 - Set custom value;<br>3 - Set custom error message.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "Custom multiplier" (1), "Regular expression" (5), "Boolean to decimal" (6), "Octal to decimal" (7), "Hexadecimal to decimal" (8), "Simple change" (9), "Change per second" (10), "XML XPath" (11), "JSONPath" (12), "In range" (13), "Matches regular expression" (14), "Does not match regular expression" (15), "Check for error in JSON" (16), "Check for error in XML" (17), "Check for error using regular expression" (18), "Prometheus pattern" (22), "Prometheus to JSON" (23), "CSV to JSON" (24), "Check unsupported" (26), "XML to JSON" (27), "SNMP walk value" (28), "SNMP walk to JSON" (29), or "SNMP get value" (30)| |error\_handler\_params|string|Error handler parameters.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `error_handler` is set to "Set custom value" or "Set custom error message"|  The following parameters and error handlers are supported for each preprocessing type.  |Preprocessing type|Name|Parameter 1|Parameter 2|Parameter 3|Supported error handlers| |------------------|----|-----------|-----------|-----------|------------------------| |1|Custom multiplier|number^1,\ 6^|<|<|0, 1, 2, 3| |2|Right trim|list of characters^2^|<|<|<| |3|Left trim|list of characters^2^|<|<|<| |4|Trim|list of characters^2^|<|<|<| |5|Regular expression|pattern^3^|output^2^|<|0, 1, 2, 3| |6|Boolean to decimal|<|<|<|0, 1, 2, 3| |7|Octal to decimal|<|<|<|0, 1, 2, 3| |8|Hexadecimal to decimal|<|<|<|0, 1, 2, 3| |9|Simple change|<|<|<|0, 1, 2, 3| |10|Change per second|<|<|<|0, 1, 2, 3| |11|XML XPath|path^4^|<|<|0, 1, 2, 3| |12|JSONPath|path^4^|<|<|0, 1, 2, 3| |13|In range|min^1,\ 6^|max^1,\ 6^|<|0, 1, 2, 3| |14|Matches regular expression|pattern^3^|<|<|0, 1, 2, 3| |15|Does not match regular expression|pattern^3^|<|<|0, 1, 2, 3| |16|Check for error in JSON|path^4^|<|<|0, 1, 2, 3| |17|Check for error in XML|path^4^|<|<|0, 1, 2, 3| |18|Check for error using regular expression|pattern^3^|output^2^|<|0, 1, 2, 3| |19|Discard unchanged|<|<|<|<| |20|Discard unchanged with heartbeat|seconds^5,\ 6^|<|<|<| |21|JavaScript|script^2^|<|<|<| |22|Prometheus pattern|pattern^6,\ 7^|`value`, `label`, `function`|output^8,\ 9^|0, 1, 2, 3| |23|Prometheus to JSON|pattern^6,\ 7^|<|<|0, 1, 2, 3| |24|CSV to JSON|character^2^|character^2^|0,1|0, 1, 2, 3| |25|Replace|search string^2^|replacement^2^|<|<| |26|Check unsupported|scope^1^|pattern^3,\ 6^|<|1, 2, 3| |27|XML to JSON|<|<|<|0, 1, 2, 3| |28|SNMP walk value|OID^2^|Format:<br>0 - Unchanged<br>1 - UTF-8 from Hex-STRING<br>2 - MAC from Hex-STRING<br>3 - Integer from BITS|<|0, 1, 2, 3| |29|SNMP walk to JSON^10^|Field name^2^|OID prefix^2^|Format:<br>0 - Unchanged<br>1 - UTF-8 from Hex-STRING<br>2 - MAC from Hex-STRING<br>3 - Integer from BITS|0, 1, 2, 3| |30|SNMP get value|Format:<br>1 - UTF-8 from Hex-STRING<br>2 - MAC from Hex-STRING<br>3 - Integer from BITS|<|<|0, 1, 2, 3|  ^1^ integer or floating-point number\ ^2^ string\ ^3^ regular expression\ ^4^ JSONPath or XML XPath\ ^5^ positive integer (with support of time suffixes, e.g. 30s, 1m, 2h, 1d)\ ^6^ user macro\ ^7^ Prometheus pattern following the syntax: `<metric name>{<label name>="<label value>", ...} == <value>`. Each Prometheus pattern component (metric, label name, label value and metric value) can be user macro.\ ^8^ Prometheus output following the syntax: `<label name>` (can be a user macro) if `label` is selected as the second parameter.\ ^9^ One of the aggregation functions: `sum`, `min`, `max`, `avg`, `count` if `function` is selected as the second parameter.\ ^10^ Supports multiple "Field name,OID prefix,Format records" records delimited by a new line character.
ca	### Preprocessament de l'element  L'objecte té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |type|integer|El tipus d'opció de preprocessament.<br><br>Valors possibles:<br>1 - Multiplicador personalitzat;<br>2 - Retalla a la dreta;< br>3 - Retalla a l'esquerra;<br>4 - Retalla;<br>5 - Coincidència d'expressió regular;<br>6 - Booleà a decimal;<br>7 - Octal a decimal;<br>8 - Hexadecimal a decimal;<br> 9 - Canvi únic;<br>10 - Canvi per segon;<br>11 - XML XPath;<br>12 - JSONPath;<br>13 - Dins l'interval;<br>14 - Coincideix amb l'expressió regular;<br>15 - No coincideix amb l'expressió regular;<br>16 - Comprova si hi ha errors en JSON;<br>17 - Comprova si hi ha errors en XML;<br>18 - Comprova si hi ha errors mitjançant una expressió regular;<br>19 - Descartar sense canvis;<br>20 - Descartar sense canvis amb un heartbeat;<br>21 - JavaScript;<br>22 - Patró de Prometheus;<br>23 - Prometheus a JSON;<br>24 - CSV a JSON;<br> 25 - Substituïu;<br> >26 - No s'admet la verificació;<br>27 - XML a JSON;<br>28 - Valor SNMP walk;<br>29 - SNMP walk a JSON;<br>30 - Valor SNMP get.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |params|string|Paràmetres addicionals emprats per l'opció de preprocessament.<br>Diversos paràmetres són separats pel caràcter de nova línia (\\n).<br><br>Si `type` és "Validar no suportats", els paràmetres segueixen una sintaxi de `<scope>[\n<pattern>]`, on *pattern* és una expressió regular, i *scope* és una d'aquestes:<br>-1 - verifica davant qualsevol error;<br>\ 0 - verificar  si el missatge d'error coincideix amb *pattern*;<br>\ 1 - verificar si el missatge d'error no coincideix amb *pattern*.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `type` s'ha establert a "Multiplicador personalitzat" (1), "Retall dret" (2), "Retall esquerre" (3), "Retall" (4), "Expressió regular" (5), "XML XPath" (11), "JSONPath" (12), "Dins l'intèrval" (13), "Coincideix amb l'expressió regular" (14), "No coincideix amb l'expressió regular" (15), "Validar per error al JSON" (16), "Validar per error al XML" (17), "Validar per error emprant una expressió regular" (18), "Descartar els no canviants amb heartbeat" (20), "JavaScript" (21), "Patró Prometheus" (22), "Prometheus a JSON" (23), "CSV a JSON" (24), "Substituïr" (25), Validar no suportats (26), "Valor SNMP walk" (28), "SNMP walk a JSON" (29), or "Valor SNMP get" (30)| |error\_handler|integer|Tipus d'acció que s'empra quan falla el pas de preprocessament.<br><br>Valors possibles:<br>0 - Zabbix defineix el missatge d'error del missatge;< br>1 - Elimina el valor;<br>2 - Estableix un valor personalitzat;<br>3 - Estableix un missatge d'error personalitzat.<br><br>Valors possibles si `type` és "Validar no suportat":<br>1 - Descartar el valor;<br>2 - Establir valor personalitzat;<br>3 - Establir missatge d'error personalitzat.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `type` és "Multiplicador personalitzat" (1), "Coincidència d'expressió regular" (5), "Booleà a decimal" (6), "Octal a decimal" (7), "Hexadecimal a decimal" (8), "Canvi simple" (9), "Canvi per segon" (10), "XML XPath" (11), "JSONPath" (12), "En rang" (13), "Coincideix amb expressió regular" (14), "No coincideix amb expressió regular" (15), "Verificar errors a JSON" (16), "Verificar errors a  XML" (17), "Verificar errors emprant una expressió regular" (18), "Patró Prometheus" (22), "Prometheus a JSON" (23), "CSV a JSON" (24), "Verificació no admesa" (26), "XML a JSON" (27), "Valor SNMP walk" (28), or "SNMP walk a JSON" (29), o "Valor SNMP get" (30)| |error\_handler\_params|string|Paràmetres del gestor d'errors.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `error_handler` és "Establir valor personalitzat" o "Establir missatge d'error personalitzat"|  Els següents paràmetres i gestors d'errors són compatibles per a cada tipus de preprocessament.  |Tipus de preprocessament|Nom|Paràmetre 1|Paràmetre 2|Paràmetre 3|Gestors d'errors admesos| |------------------|----|------------|-----------|-- ---------|---------| |1|Multiplicador personalitzat|nombre^1,\6^|<|<|0, 1, 2, 3| |2|Retalla a la dreta|llista de caràcters^2^|<|<|<| |3|Retalla a l'esquerra|llista de caràcters^2^|<|<|<| |4|Retalla|llista de caràcters^2^|<|<|<| |5|Expressió regular|patró^3^|sortida^2^|<|0, 1, 2, 3| |6|Booleà a decimal|<|<|<|0, 1, 2, 3| |7|Octal a decimal|<|<|<|0, 1, 2, 3| |8|Hexadecimal a decimal|<|<|<|0, 1, 2, 3| |9|Canvi únic|<|<|<|0, 1, 2, 3| |10|Canvi per segon|<|<|<|0, 1, 2, 3| |11|XML XPath|camí^4^|<|<|0, 1, 2, 3| |12|JSONPath|camí^4^|<|<|0, 1, 2, 3| |13|Dins de l'interval|min^1,\ 6^|max^1,\ 6^|<|0, 1, 2, 3| |14|Coincideix amb l'expressió regular|patró^3^|<|<|0, 1, 2, 3| |15|No coincideix amb l'expressió regular|patró^3^|<|<|0, 1, 2, 3| |16|Comprova l'error a JSON|camí^4^|<|<|0, 1, 2, 3| |17|Comprova l'error en XML|camí^4^|<|<|0, 1, 2, 3| |18|Comprova si hi ha errors emprant l'expressió regular|patró^3^|sortida^2^|<|0, 1, 2, 3| |19|Descarta el que no ha canviat|<|<|<|<| |20|Descarta el no canviat amb un heartbeat|segons^5,\ 6^|<|<|<| |21|JavaScript|script^2^|<|<|<| |22|Patró de Prometheus|patró^6,\7^|`valor`, `etiqueta`, `funció`|sortida^8,\9^|0, 1, 2, 3| |23|Prometheus a JSON|patró^6,\7^|<|<|0, 1, 2, 3| |24|CSV a JSON|char^2^|char^2^|0,1|0, 1, 2, 3| |25|Substitueix|cadena de cerca^2^|substitueix^2^|<|<| |26|La verificació no és compatible|<|<|<|1, 2, 3| |27|XML a JSON|<|<|<|0, 1, 2, 3| |28|Valor SNMP walk|OID^2^|Format:<br>0 - No canviat<br>1 - UTF-8 de Hex-STRING<br>2 - MAC de Hex-STRING<br>3 - Enter de BITS|<|0, 1, 2, 3| |29|SNMP walk a JSON^10^|Field name^2^|OID prefix^2^|Format:<br>0 - No canviat<br>1 - UTF-8 de Hex-STRING<br>2 - MAC de Hex-STRING<br>3 - Enter de BITS|0, 1, 2, 3| |30|Valor SNMP get|Format:<br>1 - UTF-8 de Hex-STRING<br>2 - MAC de Hex-STRING<br>3 - Integer de BITS|<|<|0, 1, 2, 3|  ^1^ nombre enter o coma flotant\ ^2^ cadena\ ^3^ expressió regular\ ^4^ JSONPath o XML XPath\ ^5^ enter positiu (amb suport per a sufixos de temps, per exemple, 30s, 1m, 2h, 1d)\ ^6^ macro d'usuari\ ^7^ El model de Prometheus segueix la sintaxi: `<nom mètric>{<nom de l'etiqueta>="<valor de l'etiqueta>", ...} == <valor>`. Cada component del patró de Prometheus (mètrica, nom d'etiqueta, valor d'etiqueta i valor de mètrica) pot ser una macro d'usuari. ^8^ Prometheus mostra la següent sintaxi: `<nom de l'etiqueta>` (pot ser una macro d'usuari) si `etiqueta` està seleccionada com a segon paràmetre.\ ^9^ Una de les funcions agregades: `sum`, `min`, `max`, `avg`, `count` si `function` està seleccionat com a segon paràmetre. ^10^ Admet diversos "Nom de camp,prefix OID,Registre de format" registres separtas per un caràcter de nova línia.

en-us	# itemprototype.create
ca	# itemprototype.create

en-us	# itemprototype.delete
ca	# itemprototype.delete

en-us	# itemprototype.get
ca	# itemprototype.get

en-us	# Item prototype object  The following objects are directly related to the `itemprototype` API.
ca	# Objecte prototip d'elements  Els següents objectes són relacionats amb l'API `itemprototype`.

en-us	### Item prototype preprocessing  The item prototype preprocessing object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |type|integer|The preprocessing option type.<br><br>Possible values:<br>1 - Custom multiplier;<br>2 - Right trim;<br>3 - Left trim;<br>4 - Trim;<br>5 - Regular expression;<br>6 - Boolean to decimal;<br>7 - Octal to decimal;<br>8 - Hexadecimal to decimal;<br>9 - Simple change;<br>10 - Change per second;<br>11 - XML XPath;<br>12 - JSONPath;<br>13 - In range;<br>14 - Matches regular expression;<br>15 - Does not match regular expression;<br>16 - Check for error in JSON;<br>17 - Check for error in XML;<br>18 - Check for error using regular expression;<br>19 - Discard unchanged;<br>20 - Discard unchanged with heartbeat;<br>21 - JavaScript;<br>22 - Prometheus pattern;<br>23 - Prometheus to JSON;<br>24 - CSV to JSON;<br>25 - Replace;<br>26 - Check unsupported;<br>27 - XML to JSON;<br>28 - SNMP walk value;<br>29 - SNMP walk to JSON;<br>30 - SNMP get value.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |params|string|Additional parameters used by preprocessing option.<br>Multiple parameters are separated by the newline (\\n) character.<br><br>If `type` is set to "Check unsupported", the parameters follow a `<scope>[\n<pattern>]` syntax, where *pattern* is a regular expression, and *scope* is one of:<br>-1 - match any error;<br>\ 0 - check if error message matches *pattern*;<br>\ 1 - check if error message does not match *pattern*.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "Custom multiplier" (1), "Right trim" (2), "Left trim" (3), "Trim" (4), "Regular expression" (5), "XML XPath" (11), "JSONPath" (12), "In range" (13), "Matches regular expression" (14), "Does not match regular expression" (15), "Check for error in JSON" (16), "Check for error in XML" (17), "Check for error using regular expression" (18), "Discard unchanged with heartbeat" (20), "JavaScript" (21), "Prometheus pattern" (22), "Prometheus to JSON" (23), "CSV to JSON" (24), "Replace" (25), "Check unsupported" (26), "SNMP walk value" (28), "SNMP walk to JSON" (29), or "SNMP get value" (30)| |error\_handler|integer|Action type used in case of preprocessing step failure.<br><br>Possible values:<br>0 - Error message is set by Zabbix server;<br>1 - Discard value;<br>2 - Set custom value;<br>3 - Set custom error message.<br><br>Possible values if `type` is set to "Check unsupported":<br>1 - Discard value;<br>2 - Set custom value;<br>3 - Set custom error message.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "Custom multiplier" (1), "Regular expression" (5), "Boolean to decimal" (6), "Octal to decimal" (7), "Hexadecimal to decimal" (8), "Simple change" (9), "Change per second" (10), "XML XPath" (11), "JSONPath" (12), "In range" (13), "Matches regular expression" (14), "Does not match regular expression" (15), "Check for error in JSON" (16), "Check for error in XML" (17), "Check for error using regular expression" (18), "Prometheus pattern" (22), "Prometheus to JSON" (23), "CSV to JSON" (24), "Check unsupported" (26), "XML to JSON" (27), "SNMP walk value" (28), "SNMP walk to JSON" (29), or "SNMP get value" (30)| |error\_handler\_params|string|Error handler parameters.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `error_handler` is set to "Set custom value" or "Set custom error message"|  The following parameters and error handlers are supported for each preprocessing type.  |Preprocessing type|Name|Parameter 1|Parameter 2|Parameter 3|Supported error handlers| |------------------|----|-----------|-----------|-----------|------------------------| |1|Custom multiplier|number^1,\ 6^|<|<|0, 1, 2, 3| |2|Right trim|list of characters^2^|<|<|<| |3|Left trim|list of characters^2^|<|<|<| |4|Trim|list of characters^2^|<|<|<| |5|Regular expression|pattern^3^|output^2^|<|0, 1, 2, 3| |6|Boolean to decimal|<|<|<|0, 1, 2, 3| |7|Octal to decimal|<|<|<|0, 1, 2, 3| |8|Hexadecimal to decimal|<|<|<|0, 1, 2, 3| |9|Simple change|<|<|<|0, 1, 2, 3| |10|Change per second|<|<|<|0, 1, 2, 3| |11|XML XPath|path^4^|<|<|0, 1, 2, 3| |12|JSONPath|path^4^|<|<|0, 1, 2, 3| |13|In range|min^1,\ 6^|max^1,\ 6^|<|0, 1, 2, 3| |14|Matches regular expression|pattern^3^|<|<|0, 1, 2, 3| |15|Does not match regular expression|pattern^3^|<|<|0, 1, 2, 3| |16|Check for error in JSON|path^4^|<|<|0, 1, 2, 3| |17|Check for error in XML|path^4^|<|<|0, 1, 2, 3| |18|Check for error using regular expression|pattern^3^|output^2^|<|0, 1, 2, 3| |19|Discard unchanged|<|<|<|<| |20|Discard unchanged with heartbeat|seconds^5,\ 6^|<|<|<| |21|JavaScript|script^2^|<|<|<| |22|Prometheus pattern|pattern^6,\ 7^|`value`, `label`, `function`|output^8,\ 9^|0, 1, 2, 3| |23|Prometheus to JSON|pattern^6,\ 7^|<|<|0, 1, 2, 3| |24|CSV to JSON|character^2^|character^2^|0,1|0, 1, 2, 3| |25|Replace|search string^2^|replacement^2^|<|<| |26|Check unsupported|scope^1^|pattern^3,\ 6^|<|1, 2, 3| |27|XML to JSON|<|<|<|0, 1, 2, 3| |28|SNMP walk value|OID^2^|Format:<br>0 - Unchanged<br>1 - UTF-8 from Hex-STRING<br>2 - MAC from Hex-STRING<br>3 - Integer from BITS|<|0, 1, 2, 3| |29|SNMP walk to JSON^10^|Field name^2^|OID prefix^2^|Format:<br>0 - Unchanged<br>1 - UTF-8 from Hex-STRING<br>2 - MAC from Hex-STRING<br>3 - Integer from BITS|0, 1, 2, 3| |30|SNMP get value|Format:<br>1 - UTF-8 from Hex-STRING<br>2 - MAC from Hex-STRING<br>3 - Integer from BITS|<|<|0, 1, 2, 3|  ^1^ integer or floating-point number\ ^2^ string\ ^3^ regular expression\ ^4^ JSONPath or XML XPath\ ^5^ positive integer (with support of time suffixes, e.g. 30s, 1m, 2h, 1d)\ ^6^ user macro, LLD macro\ ^7^ Prometheus pattern following the syntax: `<metric name>{<label name>="<label value>", ...} == <value>`. Each Prometheus pattern component (metric, label name, label value and metric value) can be user macro or LLD macro.\ ^8^ Prometheus output following the syntax: `<label name>` (can be a user macro or an LLD macro) if `label` is selected as the second parameter.\ ^9^ One of the aggregation functions: `sum`, `min`, `max`, `avg`, `count` if `function` is selected as the second parameter.\ ^10^ Supports multiple "Field name,OID prefix,Format records" records delimited by a new line character.
ca	### Preprocessament del prototip d'element  L'objecte té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |type|integer|El tipus d'opció de preprocessament.<br><br>Valors possibles:<br>1 - Multiplicador personalitzat;<br>2 - Elimina els espais finals;<br> 3 - Eliminació d'espais inicials;<br>4 - Eliminació d'espais finals i posteriors;<br>5 - Coincidència d'expressió regular;<br>6 - Booleà a decimal;<br>7 - Octal a decimal;<br>8 - Hexadecimal a decimal;<br>9 - Canvi únic;<br>10 - Canvi per segon;<br>11 - XML ​​​​XPath;<br>12 - JSONPath;<br>13 - Dins l'interval;<br>14 - Coincideix amb l'expressió regular;<br>15 - No coincideix amb l'expressió regular;<br>16 - Comprova si hi ha un error a JSON;<br>17 - Comprova si hi ha un error a XML;<br>18 - Troba un error emprant una expressió regular;<br>19 - Esborra sense modificacions;<br>20 - Esborra sense modificacions amb heartbeat;<br>21 - JavaScript;< 22 - Patró de Prometheus;<br>23 - Prometheus a JSON;<br> 24 - CSV a JSON; <br>25 - Substitueix;<br>26 - Comprova si hi ha valors no admesos;<br>27 - XML ​​​​a JSON;<28> - Valor SNMP walk;<29> - SNMP walk a JSON;<br>30 - Valor SNMP get.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |params|string|Paràmetres addicionals emprats per l'opció de preprocessament.<br>Múltiples paràmetres són separats pel caràcter de nova línia (\\n).<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `tipus` s'estableix a "Multiplicador personalitzat" (1), "Retall dret" (2), "Retall esquerre" (3), "Retall" (4), "Expressió regular coincident" (5), "XML XPath" (11), "JSONPath" (12), "En l'abast" (13), "Coincideix amb l'expressió regular" (14), "No coincideix amb l'expressió regular" (15), " Comprovar si hi ha errors en JSON" (16), "Comprovar si hi ha errors en XML" (17), "Comprovar si hi ha errors mitjançant l'expressió regular" (18), "Descartar sense canvis amb heartbeat" (20), "JavaScript" (21), "Patró de Prometheus" (22), "Prometheus a JSON" (23), "CSV a JSON" (24), "Substitueix" (25), "Valor de caminada SNMP" (28) o "Patró SNMP a JSON" ( 29)| |error\_handler|integer|Tipus d'acció emprat en cas d'error de la passa de preprocessament.<br><br>Valors possibles:<br>0 - El servidor Zabbix ha establert el missatge d'error;<br>1 - Descarta el valor;<br> 2 - Establiu un valor personalitzat;<br>3 - Estableix un missatge d'error personalitzat.<br><br>Valors possibles si `type` s'estableix com a "Comprova no compatible":<br>1 - Descarta el valor;<br>2 - Estableix valor personalitzat;<br>3 - Establiu un missatge d'error personalitzat.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `type` s'estableix en "Multiplicador personalitzat" (1), "Concordança d'expressions regulars" (5), "Booleà a decimal" (6), "Octal a decimal" (7), "Hexadecimal a decimal" (8), "Canvi simple" (9) ), "Canvi per segon" (10), "XML XPath" (11), "JSONPath" (12), "En l'abast" (13), "Coincideix amb l'expressió regular" (14), "No coincideix amb l'expressió regular" (15), "Comprova si hi ha errors en JSON" (16), "Comprova si hi ha errors en XML" (17), "Comprova si hi ha errors mitjançant l'expressió regular" (18), "Patró Prometheus" (22), "Prometheus a JSON " (23), "CSV a JSON" (24), "Comprova que no s'admet" (26), "XML a JSON" (27), "Valor d'SNMP walk" (28),  "SNMP walk a JSON" (29) o "valor SNMP get" (30)| |error\_handler\_params|string|Paràmetres del gestor d'errors.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `error_handler` està establert en "Estableix un valor personalitzat" o "Estableix un missatge d'error personalitzat"|  Els següents paràmetres i gestors d'errors són compatibles per a cada tipus de preprocessament.  |Tipus de preprocessament|Nom|Paràmetre 1|Paràmetre 2|Paràmetre 3|Gestors d'errors admesos| |-------------------|----|-----------|------------|- ----------|----------| |1|Multiplicador personalitzat|nombre^1,\6^|<|<|0, 1, 2, 3| |2|Eliminació d'espais finals|llista de caràcters^2^|<|<|<| |3|Eliminació dels espais inicials|llista de caràcters^2^|<|<|<| |4|Eliminació dels espais inicials i finals|llista de caràcters^2^|<|<|<| |5|Concordança d'expressió regular|patró^3^|sortida^2^|<|0, 1, 2, 3| |6|Booleà a decimal|<|<|<|0, 1, 2, 3| |7|Octal a decimal|<|<|<|0, 1, 2, 3| |8|Hexadecimal a decimal|<|<|<|0, 1, 2, 3| |9|Canvi únic|<|<|<|0, 1, 2, 3| |10|Canvi per segon|<|<|<|0, 1, 2, 3| |11|XML XPath|camí^4^|<|<|0, 1, 2, 3| |12|JSONPath|camí^4^|<|<|0, 1, 2, 3| |13|Dins de l'interval|min^1,\ 6^|max^1,\ 6^|<|0, 1, 2, 3| |14|Coincideix amb l'expressió regular|patró^3^|<|<|0, 1, 2, 3| |15|No coincideix amb l'expressió regular^3^|<|<|0, 1, 2, 3| |16|Cerca un error a JSON|camí^4^|<|<|0, 1, 2, 3| |17|Cerca un error a XML|camí^4^|<|<|0, 1, 2, 3| |18|Cerca un error emprant una expressió regular|patró^3^|sortida^2^|<|0, 1, 2, 3| |19|Esborra sense modificacions|<|<|<|<| |20|Esborra sense canvis amb el heratbeat|segons^5,\ 6^|<|<|<| |21|JavaScript|script^2^|<|<|<| |22|Patró de Prometheus|patró^6,\7^|`valor`, `etiqueta`, `funció`|sortida^8,\9^|0, 1, 2, 3| |23|Prometheus a JSON|patró^6,\7^|<|<|0, 1, 2, 3| |24|CSV a JSON|char^2^|char^2^|0,1|0, 1, 2, 3| |25|Substitueix|cadena de cerca^2^|substitueix^2^|<|<| |26|Comprova si hi ha valors no admesos|<|<|<|1, 2, 3| |27|XML a JSON|<|<|<|0, 1, 2, 3| |28|Valor SNMP walk|OID^2^|Format:<br>0 - Sense canvis<br>1 - UTF-8 de Hex-STRING<br>2 - MAC de Hex-STRING<br>3 - Enter de BITS|<|0, 1, 2, 3| |29|SNMP walk a JSON^10^|Field name^2^|OID prefix^2^|Format:<br>0 - Sense canvis<br>1 - UTF-8 de Hex-STRING<br>2 - MAC de Hex-STRING<br>3 - Enter de BITS|0, 1, 2, 3| |30|SNMP get value|Format:<br>1 - UTF-8 de Hex-STRING<br>2 - MAC de Hex-STRING<br>3 - Enter de BITS|<|<|0, 1, 2, 3|  ^1^ nombre enter o coma flotant\ ^2^ cadena\ ^3^ expressió regular\ ^4^ JSONPath o XML XPath\ ^5^ enter positiu (amb suport per a sufixos de temps, per exemple, 30s, 1m, 2h, 1d)\ ^6^ macro d'usuari, macro LLD\ ^7^ Patró Prometheus següent sintaxi: `<nom mètric>{<nom de l'etiqueta>="<valor de l'etiqueta>", ...} == <valor>`. Cada component del patró de Prometheus (mètrica, nom d'etiqueta, valor d'etiqueta i valor de mètrica) pot ésser una macro d'usuari o una macro LLD.\ ^8^ Prometheus dóna la següent sintaxi: `<nom de l'etiqueta>` (pot ésser una macro d'usuari o una macro LLD) si `label` és seleccionada com a segon paràmetre.\ ^9^ Una de les funcions d'agregació: `sum`, `min`, `max`, `avg`, `count` si `function` és seleccionada com a segon paràmetre. ^10^ Admet diversos registrs "Field name,OID prefix,Format records" separats per un caràcter de nova línia.

en-us	### Item prototypes  Item prototypes that can be created based on systemd service discovery include, for example:  -   Item name: `{#UNIT.DESCRIPTION} active state info`; item key:     `systemd.unit.info["{#UNIT.NAME}"]` -   Item name: `{#UNIT.DESCRIPTION} load state info`; item key:     `systemd.unit.info["{#UNIT.NAME}",LoadState]`
ca	### Prototipus d'elements  Els prototips d'elements que es poden crear basant-se en la descoberta de serveis de systemd inclouen, per exemple:  - Nom de l'element: `{#UNIT.DESCRIPTION} active stat info`; Clau d'element: `systemd.unit.info["{#UNIT.NAME}"]` - Nom de l'element: `{#UNIT.DESCRIPTION} active stat info`; Clau d'element: `systemd.unit.info["{#UNIT.NAME}",LoadState]`

en-us	#### Item prototypes  The following screenshot illustrates how we can use these macros in item prototypes:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/item_prototype_snmp.png)  You can create as many item prototypes as needed:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/item_prototypes_snmp.png){width="600"}
ca	#### Prototips d'elements  La següent captura de pantalla il·lustra com podem emprar aquestes macros en prototips d'elements:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/item_prototype_snmp.png)  Podeu crear tants prototips d'article com us calgui:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/item_prototypes_snmp.png){width="600"}

en-us	### Item prototype tag  The item prototype tag object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |tag|string|Item prototype tag name.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value|string|Item prototype tag value.|
ca	### Etiqueta de prototip d'element  L'objecte d'etiqueta de prototip d'element té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |tag|string|Nom de l'etiqueta de prototip d'element.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |value|string|Valor de l'etiqueta del prototip d'element.|

en-us	### Item prototype  The item prototype object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |itemid|ID|ID of the item prototype.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |delay|string|Update interval of the item prototype.<br><br>Accepts seconds or time unit with suffix (e.g., 30s, 1m, 2h, 1d) and, optionally, one or more [custom intervals](/manual/config/items/item/custom_intervals), all separated by semicolons. Custom intervals can be a mix of flexible and scheduling intervals.<br><br>Accepts user macros and LLD macros. If used, the value must be a single macro. Multiple macros or macros mixed with text are not supported. Flexible intervals may be written as two macros separated by a forward slash (e.g., `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).<br><br>Example:<br>`1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}`<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "Zabbix agent" (0), "Simple check" (3), "Zabbix internal" (5), "External check" (10), "Database monitor" (11), "IPMI agent" (12), "SSH agent" (13), "TELNET agent" (14), "Calculated" (15), "JMX agent" (16), "HTTP agent" (19), "SNMP agent" (20), "Script" (21), "Browser" (22), or if `type` is set to "Zabbix agent (active)" (7) and `key_` does not contain "mqtt.get"| |hostid|ID|ID of the host that the item prototype belongs to.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *constant*<br>- *required* for create operations| |interfaceid|ID|ID of the item prototype's host interface.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if item prototype belongs to host and `type` is set to "Zabbix agent", "IPMI agent", "JMX agent", "SNMP trap", or "SNMP agent"<br>- *supported* if item prototype belongs to host and `type` is set to "Simple check", "External check", "SSH agent", "TELNET agent", or "HTTP agent"| |key\_|string|Item prototype key.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations<br>- *read-only* for inherited objects| |name|string|Name of the item prototype.<br>Supports user macros.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations<br>- *read-only* for inherited objects| |type|integer|Type of the item prototype.<br><br>Possible values:<br>0 - Zabbix agent;<br>2 - Zabbix trapper;<br>3 - Simple check;<br>5 - Zabbix internal;<br>7 - Zabbix agent (active);<br>10 - External check;<br>11 - Database monitor;<br>12 - IPMI agent;<br>13 - SSH agent;<br>14 - TELNET agent;<br>15 - Calculated;<br>16 - JMX agent;<br>17 - SNMP trap;<br>18 - Dependent item;<br>19 - HTTP agent;<br>20 - SNMP agent;<br>21 - Script;<br>22 - Browser.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations<br>- *read-only* for inherited objects| |url|string|URL string.<br>Supports LLD macros, user macros, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects| |value\_type|integer|Type of information of the item prototype.<br><br>Possible values:<br>0 - numeric float;<br>1 - character;<br>2 - log;<br>3 - numeric unsigned;<br>4 - text;<br>5 - binary.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations<br>- *read-only* for inherited objects| |allow\_traps|integer|Allow to populate value similarly to the trapper item.<br><br>0 - *(default)* Do not allow to accept incoming data;<br>1 - Allow to accept incoming data.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"| |authtype|integer|Authentication method.<br><br>Possible values if `type` is set to "SSH agent":<br>0 - *(default)* password;<br>1 - public key.<br><br>Possible values if `type` is set to "HTTP agent":<br>0 - *(default)* none;<br>1 - basic;<br>2 - NTLM;<br>3 - Kerberos.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "SSH agent" or "HTTP agent"<br>- *read-only* for inherited objects (if `type` is set to "HTTP agent")| |description|string|Description of the item prototype.| |follow\_redirects|integer|Follow response redirects while polling data.<br><br>Possible values:<br>0 - Do not follow redirects;<br>1 - *(default)* Follow redirects.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects| |headers|array|Array of [headers](#http-header) that will be sent when performing an HTTP request.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects| |history|string|A time unit of how long the history data should be stored.<br>Also accepts user macro and LLD macro.<br><br>Default: 31d.| |http\_proxy|string|HTTP(S) proxy connection string.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects| |ipmi\_sensor|string|IPMI sensor.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "IPMI agent" and `key_` is not set to "ipmi.get"<br>- *supported* if `type` is set to "IPMI agent"<br>- *read-only* for inherited objects| |jmx\_endpoint|string|JMX agent custom connection string.<br><br>Default: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "JMX agent"| |logtimefmt|string|Format of the time in log entries.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `value_type` is set to "log"<br>- *read-only* for inherited objects| |master\_itemid|ID|ID of the master item.<br>Recursion up to 3 dependent items and item prototypes and maximum count of dependent items and item prototypes equal to 29999 are allowed.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "Dependent item"<br>- *read-only* for inherited objects| |output\_format|integer|Should the response be converted to JSON.<br><br>Possible values:<br>0 - *(default)* Store raw;<br>1 - Convert to JSON.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects| |params|string|Additional parameters depending on the type of the item prototype:<br>- executed script for SSH agent and TELNET agent item prototypes;<br>- SQL query for database monitor item prototypes;<br>- formula for calculated item prototypes;<br>- the script for script and browser item prototypes.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "Database monitor", "SSH agent", "TELNET agent", "Calculated", "Script", or "Browser"<br>- *read-only* for inherited objects (if `type` is set to "Script" or "Browser")| |parameters|object/array|Additional parameters if `type` is set to "Script" or "Browser". Array of objects with `name` and `value` properties, where `name` must be unique.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "Script" or "Browser"<br>- *read-only* for inherited objects| |password|string|Password for authentication.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "JMX agent" and `username` is set<br>- *supported* if `type` is set to "Simple check", "SSH agent", "TELNET agent", "Database monitor", or "HTTP agent"<br>- *read-only* for inherited objects (if `type` is set to "HTTP agent")| |post\_type|integer|Type of post data body stored in `posts` property.<br><br>Possible values:<br>0 - *(default)* Raw data.<br>2 - JSON data.<br>3 - XML data.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects| |posts|string|HTTP(S) request body data.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "HTTP agent" and `post_type` is set to "JSON data" or "XML data"<br>- *supported* if `type` is set to "HTTP agent" and `post_type` is set to "Raw data"<br>- *read-only* for inherited objects| |privatekey|string|Name of the private key file.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "SSH agent" and `authtype` is set to "public key"| |publickey|string|Name of the public key file.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "SSH agent" and `authtype` is set to "public key"| |query\_fields|array|Array of [query fields](#http-query-field) that will be sent when performing an HTTP request.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects| |request\_method|integer|Type of request method.<br><br>Possible values:<br>0 - *(default)* GET;<br>1 - POST;<br>2 - PUT;<br>3 - HEAD.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects| |retrieve\_mode|integer|What part of response should be stored.<br><br>Possible values if `request_method` is set to "GET", "POST", or "PUT":<br>0 - *(default)* Body;<br>1 - Headers;<br>2 - Both body and headers will be stored.<br><br>Possible values if `request_method` is set to "HEAD":<br>1 - Headers.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects| |snmp\_oid|string|SNMP OID.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "SNMP agent"<br>- *read-only* for inherited objects| |ssl\_cert\_file|string|Public SSL Key file path.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects| |ssl\_key\_file|string|Private SSL Key file path.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects| |ssl\_key\_password|string|Password for SSL Key file.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects| |status|integer|Status of the item prototype.<br><br>Possible values:<br>0 - *(default)* enabled item prototype;<br>1 - disabled item prototype;<br>3 - unsupported item prototype.| |status\_codes|string|Ranges of required HTTP status codes, separated by commas.<br>Also supports user macros or LLD macros as part of comma separated list.<br><br>Example: 200,200-{$M},{$M},200-400<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects| |templateid|ID|ID of the parent template item prototype.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |timeout|string|Item data polling request timeout.<br>Accepts seconds or time unit with suffix (e.g., 30s, 1m). Also accepts user macros and LLD macros.<br><br>Possible values range: 1-600s.<br><br>Default: "" - use proxy/global settings.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "Zabbix agent" (0), "Simple check" (3) and `key_` does not start with "`vmware.`" and "`icmpping`", "Zabbix agent (active)" (7), "External check" (10), "Database monitor" (11), "SSH agent" (13), "TELNET agent" (14), "HTTP agent" (19), "SNMP agent" (20) and `snmp_oid` starts with "`walk[`" or "`get[`", "Script" (21), "Browser" (22)<br>- *read-only* for inherited objects| |trapper\_hosts|string|Allowed hosts.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "Zabbix trapper", or if `type` is set to "HTTP agent" and `allow_traps` is set to "Allow to accept incoming data"| |trends|string|A time unit of how long the trends data should be stored.<br>Also accepts user macro and LLD macro.<br><br>Default: 365d.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `value_type` is set to "numeric float" or "numeric unsigned"| |units|string|Value units.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `value_type` is set to "numeric float" or "numeric unsigned"<br>- *read-only* for inherited objects| |username|string|Username for authentication.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "SSH agent" or "TELNET agent", or if `type` is set to "JMX agent" and `password` is set<br>- *supported* if `type` is set to "Simple check", "Database monitor", or "HTTP agent"<br>- *read-only* for inherited objects (if `type` is set to "HTTP agent")| |uuid|string|Universal unique identifier, used for linking imported item prototypes to already existing ones. Auto-generated, if not given.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if the item prototype belongs to a template| |valuemapid|ID|ID of the associated value map.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `value_type` is set to "numeric float", "character", or "numeric unsigned"<br>- *read-only* for inherited objects| |verify\_host|integer|Whether to validate that the host name for the connection matches the one in the host's certificate.<br><br>Possible values:<br>0 - *(default)* Do not validate;<br>1 - Validate.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects| |verify\_peer|integer|Whether to validate that the host's certificate is authentic.<br><br>Possible values:<br>0 - *(default)* Do not validate;<br>1 - Validate.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects| |discover|integer|Item prototype discovery status.<br><br>Possible values:<br>0 - *(default)* new items will be discovered;<br>1 - new items will not be discovered and existing items will be marked as lost.|
ca	### Prototip d'element  L'objecte té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |itemid|ID|ID del prototip d'element.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*<br>- *obligatori* per operacions d'actualització| |delay|string|Interval d'actualització del prototip d'element. Accepta segons o una unitat de temps amb sufix (30s, 1m, 2h, 1d).<br>Opcionalment, un o més [intervals personalitzats](/manual/config/items/item/custom_intervals) es poden especificar com a intervals flexibles o com una programació.<br>Múltiples intervals estan separats per un punt i coma.<br>Es poden emprar macros d'usuari. Una sola macro hauria d'omplir tot el camp. No s'admeten pas diverses macros en un camp o macros barrejades amb text.<br>Els intervals flexibles es poden escriure com a dues macros separades per una barra inclinada (p. ex., `{$FLEX_INTERVAL}/ {$FLEX_PERIOD}`).<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `type` és "Agent Zabbix" (0), "Verificació simple" (3), "Zabbix intern" (5), "Verificació externa" (10), "Monitoratge de base de dades" (11), "Agent IPMI" (12), "Agent SSH" (13), "Agent TELNET" (14), "Calculat" (15), "Agent JMX" (16), "Agent HTTP" (19), "Agent SNMP" (20), "Script" (21), "Navegador" (22),o si `type` és "Agent Zabbix (actiu)" (7) i `key_` no conté "mqtt.get"| |hostid|ID|ID de l'equip o de la plantilla a la qual pertany el prototip d'element.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *constant*<br>- *obligatori* per operacions de creació| |interfaceid|string|Identificador d'interfície equip del prototip d'element.<<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si el prototip d'element pertany a l'equip i `type` és "Agent Zabbix", "Agent IPMI", "Agent JMX", Traça SNMP" o "Agent SNMP"<br>- *admès* si el prototip d'element pertany a l'equip i `type` és "Verificació senzilla", "Verificació externa", "Agent SSH", "Agent Telnet" o "Agent HTTP"| |key\_|string|Clau del prototip d'element.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació<br>- *només lectura* per objectes heretats| |name|string|Nom del prototip de l'element.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació<br>- *només lectura* per objectes heretats| |type|integer|Tipus de prototip d'element<br><br>Valors possibles:<br>0 - Agent Zabbix;<br>2 - Trapper Zabbix;<br>3 - Verificació simple;<br>5 - Zabbix intern;<br>7 - Agent Zabbix (actiu);<br>9 - Element web;<br>10 - Verificació externa;<br>11 - Monitor de base de dades; <br>12 - IPMI Agent;<br>13 - Agent SSH;<br>14 - Agent Telnet;<br>15 - Calculat;<br>16 - Agent JMX;<br>17 - Trampa SNMP;<br> 18 - Element dependent;< br>19 - Agent HTTP;<br>20 - Agent SNMP;<br>21 - Script;<br>22 - Navegador.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació<br>- *només lectura* per objectes heretats| |url|string|cadena d'URL, necessària només per al tipus de prototip d'element d'agent HTTP. Admet macros d'usuari, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats| |value\_type|integer|Tipus d'informació del prototip d'element.<br><br>Valors possibles:<br>0 - nombre flotant;<br>1 - caràcter ;<br >2 - diari;<br>3 - digital sense signar;<br>4 - text;<br>5 - binari.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació<br>- *només lectura* per objectes heretats| |allow\_traps|integer|camp de prototip d'element d'agent HTTP. També permet l'ampliació de valors com en el tipus d'element trapper.<br><br>0 - *(per defecte)* No permet acceptar dades entrants.<br>1 - Permet acceptar dades entrants.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"| |authtype|integer|Només s'empren per elements d'agent SSH prototip o elements d'agent HTTP.<br><br>Valors possibles per al mètode d'autenticació de l'agent SSH:<br>0 - mot de pas *(per defecte)*;<br>1 - clau pública.<br><br> Valors possibles si `type` és "Agent HTTP":<br>0 - *(per defecte)* cap;<br>1 - Bàsic;<br>2 - NTLM;<br>3 - Kerberos.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent SSH" o "Agent HTTP"<br>- *només lectura* per objectes heretats (si `type` és "Agent HTTP")| |description|string|Descripció del prototip d'element.| |follow\_redirects|integer|Prototip de camp d'element d'agent HTTP. Seguiu les redireccions de respostes mentre aegiu dades.<br><br>0 - No seguir les redireccions.<br>1 - *(per defecte)* Seguir les redireccions.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats| |headers|object|Objecte amb capçaleres de petició HTTP(S), on el nom de la capçalera s'empra com a clau i el valor de la capçalera com a valor.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats| |history|string|Unitat de temps que indica quant de temps s'han d'emmagatzemar les dades de l'històric. També admet macros d'usuari.<br><br>Per defecte: 31d.| |http\_proxy|string|Cadena de connexió del proxy HTTP(S).<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats| |ipmi\_sensor|string|sensor IPMI.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats| |jmx\_endpoint|string|Cadena de connexió de l'agent JMX personalitzada.<br><br>Per defecte:service:jmx:rmi:///jndi/rmi://{HOST.CONN} :{HOST.PORT} /jmxrmi<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent JMX"| |logtimefmt|string|Format d'hora a les entrades de registre.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `value_type` és "log"<br>- *només lectura* per objectes heretats| |master\_itemid|ID|ID de l'element principal.<br>Es permet la recursivitat fins a 3 elements dependents i el nombre màxim d'elements i prototips d'elements dependents de 29999.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Element dependent"<br>- *només lectura* per objectes heretats| |output\_format|integer|Si cal convertir la resposta a JSON.<br><br>Possible values:<br>0 - *(per defecte)* Emmagatzema en brut.<br>1 - Converteix a JSON.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats| |params|string|Paràmetres addicionals en funció del tipus de prototip d'element:<br>- script executat per a prototips d'elements SSH i Telnet;<br>- Consulta SQL per a dades de prototips d'elements de supervisió bàsica;<br>- fórmula per a prototips d'elements calculats.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Monitoratge de base de dades", "Agent SSH, "Agent TELNET", "Calculat", "Script" o "Navegador"<br>- *només lectura* per objectes heretats (si `type` és "Script" o "Navegador")| |parameters|array|Paràmetres addicionals si `type` és "Script" o "Navegador". Matriu d'objectes amb propietats `name` i `value`, on el nom ha d'ésser únic.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Script"<br>- *només lectura* per objectes heretats| |password|string|Mot de pas per a l'autenticació.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `type` és "Agent JMX" i `username` s'ha definit<br>- *admès* si `type` és "Verificació simple", "Agent SSH", "Agent TELNET", "Monitoratge de base de dades" o "Agent HTTP"<br>- *només lectura* per objectes heretats (si `type` és "Agent HTTP")| |post\_type|integer|Tipus de cos de dades publicades a la propietat `posts`.<br><br>Valors possibles:<br>0 - *(per defecte)* Dades en brut.<br>2 - Dades JSON.<br>3 - Dades XML.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats| |posts|string|HTTP(S) demana dades del cos.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `type` és "Agent HTTP" i `post_type` és "Dades JSON" o "Dades XML"<br>- *admès* si `type` és "Agent HTTP" i `post_type` és "Dades en brut"<br>- *només lectura* per objectes heretats| |privatekey|string|Nom del fitxer de clau privada.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `type` és "Agent SSH" i `auth_type` és "clau pública"| |publickey|string|Nom del fitxer de clau pública.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `type` és "Agent SSH" i `auth_type` és "clau pública"| |query\_fields|array|Taula de [camps de consulta](#http-query-field) que s'enviarà quan es faci una petició HTTP.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats| |request\_method|integer|Tipus de mètode de petició.<br><br>0 - *(per defecte)* GET<br>1 - POST<br>2 - PUT<br>3 - HEAD<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats| |retrieve\_mode|integer|Quina part de la resposta s'ha d'emmagatzemar.<br><br>Valors possibles si `request_method` és "GET", "POST" o "PUT":<br>0 - *(per defecte)* Cos;<br>1 - Capçaleres.<br>2 - S'emmagatzemaran el cos i les capçaleres.< br><br>Valors possibles si `request_method` és "HEAD":<br>1 - Capçaleres.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats| |snmp\_oid|string|SNMP OID.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `type` és "Agent SNMP"<br>- *només lectura* per objectes heretats| |ssl\_cert\_file|string|Camí al fitxer de clau SSL pública.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats| |ssl\_key\_file|string|Camí al fitxer de clau SSL privada<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats.| |ssl\_key\_password|string|Mot de pas per al fitxer de clau SSL.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats| |status|integer|Estat del prototip d'element.<br><br>Valors possibles:<br>0 - prototip d'element habilitat *(per defecte)*;<br>1 - prototip d'element desactivat;< br>2 - prototip d'element no compatible.| |status\_codes|string|Intervals de codis d'estat HTTP obligatoris separats per comes.<br>També admet macros d'usuari com a part d'una llista separada per comes.<br><br>Exemple: 200.200-{$M},{$M},200-400<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats| |templateid|ID|(ID del prototip d'element de plantilla principal.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*| |timeout|string|Temps d'espera de la consulta de dades d'element.<br>Admet segons o unitat de temps amb sufixe (ocm ara 30s, 1m). També admet macros d'usuari i macros LLD.<br><br>Rang de possibles valors: 1-600s.<br><br>Valor per defecte: "" - emprar configuració global de proxy.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent Zabbix" (0), "Comprovació simple" (3) i `key_` no comença amb "`vmware.`" i "`icmpping`", "Agent Zabbix (actiu)" (7), "Verificació externa" (10), "Monitor de Base de dades" (11), "Agent SSH" (13), "Agent TELNET" (14), "Agent HTTP" (19), "Agent SNMP" (20) i `snmp_oid` comença amb "`walk[`" o "`get[`", "Script" (21), "Navegador" (22)<br>- *només lectura* per objectes heretats| |trapper\_hosts|string|Equips permesos.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Zabbix trapper" o si `type` és "Agent HTTP" i `allow_traps` és "Permetre acceptar dades d'entrada"| |trends|string|Unitat de temps de quant de temps s'han d'emmagatzemar les dades de tendències.<br>També admet macros d'usuari.<br><br>Per defecte: 365d.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `value_type` és "numèric flotant" o "numèric sense signe"| |units|string|Unitats de valor.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `value_type` és "numèric flotant" o "numèric sense signe"<br>- *només lectura* per objectes heretats| |username|string|Nom d'usuari per a l'autenticació.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `type` és "Agent SSH" o "Agent TELNET", o si `type` és "Agent JMX" i `password` s'ha definit<br>- *admès* si `type` és "Verficació simple", "Monitoratge de base de dades" o "Agent HTTP"<br>- *només lectura* per objectes heretats (si `type` és "Agent HTTP")| |uuid|string|Identificador únic universal, que s'empra per enllaçar un prototip d'element importat amb prototips d'element ja existents. S'empra només per a prototips d'elements de model. Es genera automàticament, si no es proporciona.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si el prototip d'element pertany a una plantilla| |valuemapid|ID|ID del mapa de valors associats.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `value_type` és "numèric flotant", "caràcter" o "numèric sense signe"<br>- *només lectura* per objectes heretats| |verify\_host|integer|CValida que el nom d'equip a l'URL sigui al camp *Nom comú* o *Nom alternatiu del subjecte* del certificat d'equip.<br><br>Valors possibles:<br>0 - *(per defecte)* No valideu. <br>1 - Valida.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats| |verify\_peer|integer|Valideu si el certificat d'equip és autèntic.<br><br>Valors possibles:<br>0 - *(per defecte)* No validar.<br>1 - Validar.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats| |discover|integer|Estat de descobriment del prototip d'element.<br><br>Valors possibles:<br>0 - *(per defecte)* es descobriran nous elements;<br>1 - no es descobriran elements nous i els elements existents es marcaran com a perduts.|

en-us	# Item prototype  This class is designed to work with item prototypes.  Object references:  -   [Item prototype](/manual/api/reference/itemprototype/object#item_prototype) -   [Item prototype tag](/manual/api/reference/itemprototype/object#item_prototype_tag) -   [Item prototype preprocessing](/manual/api/reference/itemprototype/object#item_prototype_preprocessing)  Available methods:  -   [itemprototype.create](/manual/api/reference/itemprototype/create) - create new item prototypes -   [itemprototype.delete](/manual/api/reference/itemprototype/delete) - delete item prototypes -   [itemprototype.get](/manual/api/reference/itemprototype/get) - retrieve item prototypes -   [itemprototype.update](/manual/api/reference/itemprototype/update) - update item prototypes
ca	# Prototipus d'element  Aquesta classe és dissenyada per treballar amb prototipus d'elements.  Referències d'objectes:  -   [Prototip d'element](/manual/api/reference/itemprototype/object#item_prototype) -   [Etiqueta de prototip d'element](/manual/api/reference/itemprototype/object#item_prototype_tag) -   [Preprocessament de prototip d'element](/manual/api/reference/itemprototype/object#item_prototype_preprocessing)  Mètodes disponibles:  -   [itemprototype.create](/manual/api/reference/itemprototype/create) - crear nous prototipus d'elements -   [itemprototype.delete](/manual/api/reference/itemprototype/delete) - esborrar prototips d'elements -   [itemprototype.get](/manual/api/reference/itemprototype/get) - recuperar prototipus d'elements -   [itemprototype.update](/manual/api/reference/itemprototype/update) - actualitzar prototipus d'elements

en-us	# itemprototype.update
ca	# itemprototype.update

en-us	##### Item prototype  You may want to create an item prototype like this:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/lld_item_prototype_prom.png){width="600"}  with preprocessing options:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/lld_item_prototype_prom_b.png)
ca	##### Prototip d'element  És possible que vulgueu crear un prototip d'element com aquest:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/lld_item_prototype_prom.png){width="600"}  amb opcions de preprocessament:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/lld_item_prototype_prom_b.png)

en-us	#### item prototype  [ZBXNEXT-7726](https://support.zabbix.com/browse/ZBXNEXT-7726) The `params` property is now *required* for preprocessing steps of the type "Check for not supported value".\ [ZBXNEXT-7578](https://support.zabbix.com/browse/ZBXNEXT-7578) `itemprototype.get`, `itemprototype.create`, `itemprototype.update`: The properties `headers` and `query_fields` changed from name-indexed object to array of objects with separate `name` and `value` properties.\
ca	#### item prototype  [ZBXNEXT-7726](https://support.zabbix.com/browse/ZBXNEXT-7726) La propietat `params` ara és *obligatòria* per passes de preprocessament de tipus "Validació per valor no admès".\  [ZBXNEXT-7578](https://support.zabbix.com/browse/ZBXNEXT-7578) `itemprototype.get`, `itemprototype.create`, `itemprototype.update`: Les propietats `headers` i `query_fields` han canviat d'objectes de nom indexat a taula d'objectes amb les propietats `name` i `value` separades.\

en-us	#### item prototype  [ZBXNEXT-9150](https://support.zabbix.com/browse/ZBXNEXT-9150) Added new item prototype `type` (22 - Browser).\ [ZBXNEXT-8645](https://support.zabbix.com/browse/ZBXNEXT-8645) Added new [item prototype preprocessing](/manual/api/reference/itemprototype/object#item-prototype-preprocessing) type "SNMP get value" (30).\ [ZBXNEXT-8645](https://support.zabbix.com/browse/ZBXNEXT-8645) Property `timeout` is now also supported if item `type` is set to "SNMP agent" (20) and `snmp_oid` starts with "`get[`".\ [ZBXNEXT-1096](https://support.zabbix.com/browse/ZBXNEXT-1096) Property `timeout` is now supported if item `type` is set to "Zabbix agent" (0), "Simple check" (3) and `key_` does not start with "`vmware.`" and "`icmpping`", "Zabbix agent (active)" (7), "External check" (10), "Database monitor" (11), "SSH agent" (13), "TELNET agent" (14), "SNMP agent" (20) and `snmp_oid` starts with "`walk[`".\ [ZBXNEXT-7726](https://support.zabbix.com/browse/ZBXNEXT-7726) Added *scope* and *pattern* components to parameters for steps of the type "Check for not supported value".\ [ZBXNEXT-7578](https://support.zabbix.com/browse/ZBXNEXT-7578) It is now possible to store more data for the `query_fields` property, have repeated `header` and `query_fields` entries.
ca	#### prototip d'element  [ZBXNEXT-9150](https://support.zabbix.com/browse/ZBXNEXT-9150) Afegida la nova regla LLD `type` (22 - Navegador).\ [ZBXNEXT-8645](https://support.zabbix.com/browse/ZBXNEXT-8645) S'ha afegit un nou tipus de [preprocessament d'element prototip](/manual/api/reference/itemprototype/object#item-prototype-preprocessing): "recollir valor SNMP" (30).\ [ZBXNEXT-8645](https://support.zabbix.com/browse/ZBXNEXT-8645) La propietat `timeout` s'admet ara si l'element `type` s'estableix a "agent SNMP" (20) i `snmp_oid` comença amb "`get[`".\ [ZBXNEXT-1096](https://support.zabbix.com/browse/ZBXNEXT-1096) La propietat `timeout` s'admet ara si l'element `type` s'estableix a "agent Zabbix" (0), "Validació simple" (3) i `key_` no comença pas amb "`vmware.`" i "`icmpping`", "agent Zabbix (actiu)" (7), "Validació externa" (10), "monitor de base de dades" (11), "agent SSH" (13), "agent TELNET" (14), "agent SNMP" (20) i `snmp_oid` comença amb "`walk[`".\ [ZBXNEXT-7726](https://support.zabbix.com/browse/ZBXNEXT-7726) Afegits els components *àmbit* i *patró* als paràmetres per les passes de tipus "Validació per valor no admès".\ [ZBXNEXT-7578](https://support.zabbix.com/browse/ZBXNEXT-7578) Ara es pot emmagatzemar més informació per la propietat `query_fields`, tindre entrades repetides `header` i `query_fields`.

en-us	## Items
ca	## Elements

en-us	## Items
ca	## Elements

en-us	## Items
ca	## Elements

en-us	#### Items  Define items to monitor.  [Item API](/manual/api/reference/item)
ca	#### Elements  Defineix els elements a monitorar.  [API Element](/manual/api/reference/item)

en-us	#### Items / item prototypes  In an [item](/manual/config/items/item) or an [item prototype](/manual/discovery/low_level_discovery/item_prototypes) configuration, user macros can be used in the following fields:  |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Item name|<|yes| |Item key parameters|<|yes| |Update interval|<|no| |Custom intervals|<|no| |Timeout (available for [supported](/manual/web_interface/frontend_sections/administration/general#timeouts) item types)|<|no| |Store up to (for history and trends)|<|no| |Description|<|yes| |*Calculated item*|<|<| | |Formula|yes| |*Database monitor*|<|<| | |Username|yes| |^|Password|yes| |^|SQL query|yes| |*HTTP agent*|<|<| | |URL^[3](supported_by_location_user#footnotes)^|yes| |^|Query fields|yes| |^|Request body|yes| |^|Headers (names and values)|yes| |^|Required status codes|yes| |^|HTTP proxy|yes| |^|HTTP authentication username|yes| |^|HTTP authentication password|yes| |^|SSl certificate file|yes| |^|SSl key file|yes| |^|SSl key password|yes| |^|Allowed hosts|yes| |*JMX agent*|<|<| | |JMX endpoint|yes| |*Script item*|<|<| | |Parameter names and values|yes| |*Browser item*|<|<| | |Parameter names and values|yes| |*SNMP agent*|<|<| | |SNMP OID|yes| |*SSH agent*|<|<| | |Username|yes| |^|Public key file|yes| |^|Private key file|yes| |^|Password|yes| |^|Script|yes| |*TELNET agent*|<|<| | |Username|yes| |^|Password|yes| |^|Script|yes| |*Zabbix trapper*|<|<| | |Allowed hosts|yes| |*Tags*^[2](supported_by_location_user#footnotes)^|<|<| | |Tag names|yes| |^|Tag values|yes| |*Preprocessing steps*|<|<| | |Parameters (including custom scripts)|yes| | |Custom error-handling parameters (*Set value to* and *Set error to* fields)|yes|
ca	#### Elements / prototips d'elements  En una configuració d'[element](/manual/config/items/item) o [prototips d'elements](/manual/discovery/low_level_discovery/item_prototypes), les macros d'usuari es poden emprar als camps següents:  |Ubicació|<|Múltiples macros/barreja amb text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Paràmetres de clau d'element|<|sí| |Intèrval d'actualització|<|no| |Intèrvals personalitzats|<|no| |Període d'emmagatzematge de l'històric|<|no| |Període d'emmagatzematge de les tendències|<|no| |Descripció|<|sí| |*element calculat*|<|<| | |Fórmula|sí| |*Monitoratge de base de dades*|<|<| | |Nom d'usuari|sí| |^|Mot de pas|sí| |^|Petició SQL|sí| |*Agent HTTP*|<|<| | |URL^[3](supported_by_location_user#footnotes)^|sí| |^|Camps de petició|sí| |^|Temps d'espera|no| |^|Cos de la petició|sí| |^|Capçalera (noms i valors)|sí| |^|Codis d'estat demanats|sí| |^|Proxy HTTP|sí| |^|Nom d'usuari d'autenticació HTTP|sí| |^|Mot de pas d'autenticació HTTP|sí| |^|Arxiu de certificat SSL|sí| |^|Arxiu de clau SSL|sí| |^|Mot de pas de la clau SSL|sí| |^|Equips autoritzats|sí| |*Agent JMX*|<|<| | |Punt d'acabament JMX|sí| |*Element Script*|<|<| | |Noms i valors dels paràmetres|sí| |*Element navegador*|<|<| | |Paràmetres nom i valors|sí| |*Agent SNMP*|<|<| | |OID SNMP|sí| |*Agent SSH*|<|<| | |Nom d'usuari|sí| |^|Arxiu de clau pública|sí| |^|Arxiu de clau privada|sí| |^|Paraula de pas|sí| |^|Script|sí| |*Agent TELNET*|<|<| | |Nom d'usuari|sí| |^|Mot de pas|sí| |^|Script|sí| |*Trap Zabbix*|<|<| | |Equips autoritzats|sí| |*Etiquetes*^[2](supported_by_location_user#footnotes)^|<|<| | |Noms d'etiquetes|sí| |^|Valors d'etiquetes|sí| |*Passes de preprocessament*|<|<| | |Paràmetres (inclosos els scripts personalitzats)|sí| | |Paràmetres personalitzats de gestió d'errors (camps *Estableix el valor a* i *Estableix error a*)|sí|

en-us	 ### Items  |Macro|Supported in|Description| |--|--------|--------| |{ITEM.DESCRIPTION}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts)<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget|*Description of the Nth item in the trigger expression that caused a notification.*<br><br>This macro may be used with a numeric index e.g. {ITEM.DESCRIPTION[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.DESCRIPTION.ORIG}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts)<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget|*Description (with macros unresolved) of the Nth item in the trigger expression that caused a notification.*<br><br>This macro may be used with a numeric index e.g. {ITEM.DESCRIPTION.ORIG[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.ID}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Script-type and Browser-type item, item prototype and discovery rule parameter names and values<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, query fields, request body, headers, proxy, SSL certificate file, SSL key file<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts)<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget|*Numeric ID of the Nth item in the trigger expression that caused a notification.*<br><br>This macro may be used with a numeric index e.g. {ITEM.ID[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.KEY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Script-type and Browser-type item, item prototype and discovery rule parameter names and values<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, query fields, request body, headers, proxy, SSL certificate file, SSL key file<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts)<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget|*Key of the Nth item in the trigger expression that caused a notification.*<br><br>This macro may be used with a numeric index e.g. {ITEM.KEY[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{TRIGGER.KEY}` is deprecated.<br><br>[Macro functions](/manual/config/macros/macro_functions) are not supported for this macro if it is used as a placeholder in the first parameter of a [history function](/manual/appendix/functions/history), for example, `last(/{HOST.HOST}/{ITEM.KEY})`.| |{ITEM.KEY.ORIG}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Script-type and Browser-type item, item prototype and discovery rule parameter names and values<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, Query fields, Request body, Headers, Proxy, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts)<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget|*Original key (with macros not expanded) of the Nth item in the trigger expression that caused a notification ^[4](supported_by_location#footnotes)^.*<br><br>This macro may be used with a numeric index e.g. {ITEM.KEY.ORIG[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LASTVALUE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, event names, operational data and descriptions<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Trigger URLs<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts)<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget|*The latest value of the Nth item in the trigger expression that caused a notification.*<br><br>It will resolve to \*UNKNOWN\* in the frontend if the latest history value has been collected more than the *Max history display period* time ago (set in the [Administration→General](/manual/web_interface/frontend_sections/administration/general#gui) menu section).<br><br>When used in the problem name, the macro will not resolve to the latest item value when viewing problem events; instead, it will keep the item value from the time when the problem happened.<br><br>When used in notifications, in some cases the macro might not resolve to the latest item value at the moment the trigger fired. For example, if an item quickly receives two values, "A" and "B", and the trigger fires for "A", notifications might show "B" as the latest value due to a slight processing delay - the latest item value changed between the time the trigger fired and when the notification was created. To avoid this, you can use the {ITEM.VALUE} macro, which resolves to the value at the moment the trigger fires, ensuring the correct value is used in the notification.<br><br>It is alias to `last(/{HOST.HOST}/{ITEM.KEY})`.<br><br>The resolved value for text/log items is truncated to 20 characters by the frontend in the following locations:<br>- Operational data;<br>- Trigger description;<br>- Trigger URLs;<br>- Trigger URL labels;<br>- Description of the item value widget.<br><br>To resolve to a full value, you may use [macro functions](/manual/config/macros/macro_functions), as no values are truncated by the server. For example: `{{ITEM.LASTVALUE}.regsub("(.*)", \1)}`<br><br>This macro may be used with a numeric index e.g. {ITEM.LASTVALUE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. item in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LOG.AGE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, operational data and descriptions<br>→ Trigger URLs<br>→ Event tags and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts)<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget|*Age of the log item event*, with precision down to a second.<br><br>This macro may be used with a numeric index e.g. {ITEM.LOG.AGE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LOG.DATE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, operational data and descriptions<br>→ Trigger URLs<br>→ Event tags and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts)<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget|*Date of the log item event.*<br><br>This macro may be used with a numeric index e.g. {ITEM.LOG.DATE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LOG.EVENTID}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, operational data and descriptions<br>→ Trigger URLs<br>→ Event tags and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts)<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget|*ID of the event in the event log.*<br>For Windows event log monitoring only.<br><br>This macro may be used with a numeric index e.g. {ITEM.LOG.EVENTID[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LOG.NSEVERITY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, operational data and descriptions<br>→ Trigger URLs<br>→ Event tags and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts)<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget|*Numeric severity of the event in the event log.*<br>For Windows event log monitoring only.<br><br>This macro may be used with a numeric index e.g. {ITEM.LOG.NSEVERITY[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LOG.SEVERITY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, operational data and descriptions<br>→ Trigger URLs<br>→ Event tags and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts)<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget|*Verbal severity of the event in the event log.*<br>For Windows event log monitoring only.<br><br>This macro may be used with a numeric index e.g. {ITEM.LOG.SEVERITY[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LOG.SOURCE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, operational data and descriptions<br>→ Trigger URLs<br>→ Event tags and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts)<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget|*Source of the event in the event log.*<br>For Windows event log monitoring only.<br><br>This macro may be used with a numeric index e.g. {ITEM.LOG.SOURCE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LOG.TIME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, operational data and descriptions<br>→ Trigger URLs<br>→ Event tags and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts)<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget|*Time of the log item event.*<br><br>This macro may be used with a numeric index e.g. {ITEM.LOG.TIME[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts)<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget|*Name of the item* with all macros resolved.<br><br>This macro may be used with a numeric index e.g. {ITEM.NAME[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.NAME.ORIG}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts)<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget|This macro is used to resolve to the *original name (i.e. without macros resolved) of the item*.<br><br>This macro may be used with a numeric index e.g. {ITEM.NAME.ORIG[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.STATE}|→ Item-based internal notifications<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget|*The latest state of the Nth item in the trigger expression that caused a notification.* Possible values: **Not supported** and **Normal**.<br><br>This macro may be used with a numeric index e.g. {ITEM.STATE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.STATE.ERROR}|→ Item-based internal notifications|*Error message with details why an item became unsupported.* <br> <br> If an item goes into the unsupported state and then immediately gets supported again the error field can be empty.| |{ITEM.VALUE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, event names, operational data and descriptions<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Trigger URLs<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts)<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget|Resolved to either:<br>1) the historical (at-the-time-of-event) value of the Nth item in the trigger expression, if used in the context of trigger status change, for example, when displaying events or sending notifications.<br>2) the latest value of the Nth item in the trigger expression, if used without the context of trigger status change, for example, when displaying a list of triggers in a pop-up selection window. In this case works the same as {ITEM.LASTVALUE}<br>In the first case it will resolve to \*UNKNOWN\* if the history value has already been deleted or has never been stored.<br>In the second case, and in the frontend only, it will resolve to \*UNKNOWN\* if the latest history value has been collected more than the *Max history display period* time ago (set in the [Administration→General](/manual/web_interface/frontend_sections/administration/general#gui) menu section).<br><br>The resolved value for text/log items is truncated to 20 characters by the frontend in the following locations:<br>- Operational data;<br>- Trigger description;<br>- Trigger URLs;<br>- Trigger URL labels;<br>- Description of the item value widget.<br>To resolve to a full value, you may use [macro functions](/manual/config/macros/macro_functions), as no values are truncated by the server. For example: `{{ITEM.VALUE}.regsub("(.*)", \1)}`<br><br>This macro may be used with a numeric index e.g. {ITEM.VALUE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. item in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.VALUETYPE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts)<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget|*Value type of the Nth item in the trigger expression that caused a notification.* Possible values: 0 - numeric float, 1 - character, 2 - log, 3 - numeric unsigned, 4 - text.<br><br>This macro may be used with a numeric index e.g. {ITEM.VALUETYPE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).|
ca	### Elements  |Macro|Admesa a|Descripció| |--|------|------| |{ITEM.DESCRIPTION}|→ Notificacions i ordres basades en triggers<br>→ Notificacions i ordres d'actualització de problemes<br>→ Notificacions internes<br>→ Acció manual d'esdeveniments [scripts](/manual/web_interface/frontend_sections/administration/scripts )<br>→ Paràmetre *Descripció* al [*Valor de l'element*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) i el giny [*Calibre*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Paràmetre de *Text* d'etiqueta Primària/Secundària al giny [*Rusc*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)|*Descripció de l'element enèssim del trigger que va provocar una notificació.*<br><br>Aquesta macro es pot emprar amb un índex numèric, p. {ITEM.DESCRIPTION[<1-9>](supported_by_location#indexed_macros)} per apuntar al primer, segon, tercer, etc. equip en un trigger actiu. Veieu [macros indexades](supported_by_location#indexed_macros).| |{ITEM.DESCRIPTION.ORIG}|→ Notificacions i ordres basades en triggers<br>→ Notificacions i ordres d'actualització de problemes<br>→ Notificacions internes<br>→ Acció manual d'esdeveniments [scripts](/manual/web_interface/frontend_sections/administration /scripts)<br>→ Paràmetre *Descripció* al [*Valor de l'element*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) i el giny [*Calibre*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Paràmetre de *Text* d'etiqueta Primària/Secundària al giny [*Rusc*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)|*Descripció (amb macros no resoltes) de l'element enèssim del trigger que va provocar una notificació.*<br><br>Aquesta macro es pot emprar amb un índex numèric, p. {ITEM.DESCRIPTION.ORIG[<1-9>](supported_by_location#indexed_macros)} per apuntar al primer, segon, tercer, etc. equip en un trigger. Veieu [macros indexades](supported_by_location#indexed_macros).| |{ITEM.ID}|→ Notificacions i ordres basades en triggers<br>→ Notificacions i ordres d'actualització de problemes<br>→ Notificacions internes<br>→ Element de tipus d'script, prototip d'element i noms i valors dels paràmetres de la regla de descoberta^[6] (supported_by_location#footnotes)^<br>→ Element de tipus d'agent HTTP, prototip d'element i camps de regla de descoberta:<br>URL, camps de consulta, cos de la sol·licitud, capçaleres, proxy, fitxer de certificat SSL, fitxer de clau SSL<br>→ Esdeveniment manual action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Paràmetre *Descripció* al [*Valor de l'element*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) i el giny [*Calibre*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Paràmetre de *Text* d'etiqueta Primària/Secundària al giny [*Rusc*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)|*ID numèric de l'element enèssim al trigger que va provocar una notificació.*<br><br>Això La macro es pot emprar amb un índex numèric, p. {ITEM.ID[<1-9>](supported_by_location#indexed_macros)} per apuntar al primer, segon, tercer, etc. equip en un trigger. Veieu [macros indexades](supported_by_location#indexed_macros).| |{ITEM.KEY}|→ Notificacions i ordres basades en triggers<br>→ Notificacions i ordres d'actualització de problemes<br>→ Notificacions internes<br>→ Element de tipus d'script, prototip d'element i noms i valors dels paràmetres de la regla de descoberta^[6] (supported_by_location#footnotes)^<br>→ Element de tipus d'agent HTTP, prototip d'element i camps de regla de descoberta:<br>URL, camps de consulta, cos de la sol·licitud, capçaleres, proxy, fitxer de certificat SSL, fitxer de clau SSL<br>→ Esdeveniment manual acció [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Paràmetre *Descripció* al [*Valor de l'element*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) i el giny [*Calibre*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Paràmetre de *Text* d'etiqueta Primària/Secundària al giny [*Rusc*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)|*Clau de l'element enèssim al trigger que va provocar una notificació.*<br><br>Aquesta macro es pot emprar amb un índex numèric, p. {ITEM.KEY[<1-9>](supported_by_location#indexed_macros)} per apuntar al primer, segon, tercer, etc. equip en un trigger. Veieu [macros indexades](supported_by_location#indexed_macros).<br><br>`{TRIGGER.KEY}` és obsolet.| |{ITEM.KEY.ORIG}|→ Notificacions i ordres basades en triggers<br>→ Notificacions i ordres d'actualització de problemes<br>→ Notificacions internes<br>→ Element de tipus d'script, prototip d'element i noms i valors dels paràmetres de la regla de descoberta^[ 6](supported_by_location#footnotes)^<br>→ Element de tipus d'agent HTTP, prototip d'element i camps de regla de descoberta:<br>URL, camps de consulta, cos de la sol·licitud, capçaleres, proxy, fitxer de certificat SSL, fitxer de clau SSL, amfitrions permesos. ^[6](supported_by_location#footnotes)^<br>→ Acció d'esdeveniment manual [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Paràmetre *Descripció* al [*Valor de l'element*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) i el giny [*Calibre*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Paràmetre de *Text* d'etiqueta Primària/Secundària al giny [*Rusc*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)|*Clau original (amb macros no ampliades) de l'element N del trigger que va provocar una notificació ^[4](supported_by_location#footnotes)^.*<br><br>Aquesta macro es pot emprar amb un índex numèric, p. {ITEM.KEY.ORIG[<1-9>](supported_by_location#indexed_macros)} per apuntar al primer, segon, tercer, etc. equip en un trigger. Veieu [macros indexades](supported_by_location#indexed_macros).| |{ITEM.LASTVALUE}|→ Notificacions i comandes basades en triggers<br>→ Notificacions i comandes d'actualització de problemes<br>→ Noms de trigger, noms d'esdeveniments, dades operatives i descripcions<br>→ [Noms i valors de les etiquetes](/manual /config/tagging#macro_support)<br>→ URL de trigger<br>→ Acció manual d'esdeveniments [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Descripció del giny del valor de l'element|*El valor més recent de l'element enèssim del trigger que va provocar una notificació.*<br><br>Es resoldrà com a \*DESCONEGUT\* a la interfície si el darrer valor que s'ha recollit de l'historial és més gran  més que el *Període màxim de visualització de l'historial* (establert a la secció de menú [Administració→General](/manual/web_interface/frontend_sections/administration/general#gui)).<br><br>Tingueu en compte que, quan s'empra al nom del problema, no es resoldrà amb el darrer valor de l'element quan es visualitzin esdeveniments problemàtics; en lloc d'això, mantindrà el valor de l'element des del moment en què es produeixi el problema.<br><br>Quan s'empra a les notificacions, en alguns casos és possible que la macro no es resolgui amb el valor de l'element més recent en el moment en què s'ha activat el trigger. Per exemple, si un element rep de cop dos valors, "A" i "B", i el trigger s'activa per a "A", les notificacions poden mostrar "B" com a valor més recent a causa d'un lleuger endarreriment en el processament; el valor de l'element més recent ha canviat entre el moment en què es va activar el trigger i quan es va crear la notificació. Per evitar-ho, podeu emprar la macro {ITEM.VALUE}, que resol el valor en el moment en què s'activa el trigger, assegurant-vos que s'empra el valor correcte a la notificació.<br><br>És àlies fins a `last(/{HOST.HOST}/{ITEM.KEY})`.<br><br>El valor resolt per als elements de text/registre es trunca a 20 caràcters per la interfície a les ubicacions següents:<br>- Dades operatives;<br>- Descripció del trigger;<br>- URL de trigger;<br>- Descripció del giny de valor de l'element.<br>Per resoldre un valor complet, podeu emprar [funcions de macro](/manual/config/macros/macro_functions#seeing-full-item-values). El servidor no trunca cap valor.<br><br>El valor de la macro [personalització](/manual/config/macros/macro_functions) és compatible amb aquesta macro; des de amb Zabbix 3.2.0.<br><br>Aquesta macro es pot emprar amb un índex numèric, p. {ITEM.LASTVALUE[<1-9>](supported_by_location#indexed_macros)} per apuntar al primer, segon, tercer, etc. element d'un trigger. Veieu [macros indexades](supported_by_location#indexed_macros).| |{ITEM.LOG.AGE}|→ Notificacions i ordres basades en triggers<br>→ Notificacions i ordres d'actualització de problemes<br>→ Noms, dades operatives i descripcions del trigger<br>→ URL del trigger<br>→ Valors i etiquetes d'esdeveniments <br>→ Acció d'esdeveniment manual [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Paràmetre *Descripció* al [*Valor de l'element*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) i el giny [*Calibre*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Paràmetre de *Text* d'etiqueta Primària/Secundària al giny [*Rusc*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)|*Edat de l'esdeveniment de l'element de registre*, amb precisió fins a un segon.<br ><br>Aquesta macro es pot emprar amb un índex numèric, p. {ITEM.LOG.AGE[<1-9>](supported_by_location#indexed_macros)} per apuntar al primer, segon, tercer, etc. equip en un trigger. Veieu [macros indexades](supported_by_location#indexed_macros).| |{ITEM.LOG.DATE}|→ Notificacions i ordres basades en triggers<br>→ Notificacions i ordres d'actualització de problemes<br>→ Nom del trigger, dades operatives i descripcions<br>→ URL del trigger<br>→ Etiquetes i valors d'esdeveniments <br>→ Acció d'esdeveniment manual [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Paràmetre *Descripció* al [*Valor de l'element*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) i el giny [*Calibre*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Paràmetre de *Text* d'etiqueta Primària/Secundària al giny [*Rusc*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)|*Data de l'esdeveniment de l'element de registre.*<br><br>Aquesta macro pot s'emprarà amb un índex numèric, p. {ITEM.LOG.DATE[<1-9>](supported_by_location#indexed_macros)} per apuntar al primer, segon, tercer, etc. equip en un trigger. Veieu [macros indexades](supported_by_location#indexed_macros).| |{ITEM.LOG.EVENTID}|→ Notificacions i ordres basades en triggers<br>→ Notificacions i ordres d'actualització de problemes<br>→ Nom del trigger, dades operatives i descripcions<br>→ URL del trigger<br>→ Etiquetes i valors d'esdeveniments <br>→ Acció manual d'esdeveniments [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Descripció del giny de valor d'element|*ID de l'esdeveniment al registre d'esdeveniments.*<br>Per al registre d'esdeveniments de Windows només monitoratge.<br><br>Aquesta macro es pot emprar amb un índex numèric, p. ex. {ITEM.LOG.EVENTID[<1-9>](supported_by_location#indexed_macros)} per apuntar al primer, segon, tercer, etc. equip en un trigger. Veieu [macros indexades](supported_by_location#indexed_macros).| |{ITEM.LOG.NSEVERITY}|→ Notificacions i ordres basades en triggers<br>→ Notificacions i ordres d'actualització de problemes<br>→ Nom del trigger, dades operatives i descripcions<br>→ URL d'activació<br>→ Etiquetes i valors d'esdeveniment <br>→ Acció manual d'esdeveniments [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Paràmetre *Descripció* al [*Valor de l'element*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) i el giny [*Calibre*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Paràmetre de *Text* d'etiqueta Primària/Secundària al giny [*Rusc*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)|*Gravetat numèrica de l'esdeveniment al registre d'esdeveniments.*<br>Per a l'esdeveniment de Windows només monitoratge del registre.<br><br>Aquesta macro es pot emprar amb un índex numèric, p. ex. {ITEM.LOG.NSEVERITY[<1-9>](supported_by_location#indexed_macros)} per apuntar al primer, segon, tercer, etc. equip en un trigger. Veieu [macros indexades](supported_by_location#indexed_macros).| |{ITEM.LOG.SEVERITY}|→ Notificacions i ordres basades en triggers<br>→ Notificacions i ordres d'actualització de problemes<br>→ Nom del trigger, dades operatives i descripcions<br>→ URL del trigger<br>→ Etiquetes i valors d'esdeveniments <br>→ Acció manual d'esdeveniments [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Paràmetre *Descripció* al [*Valor de l'element*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) i el giny [*Calibre*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Paràmetre de *Text* d'etiqueta Primària/Secundària al giny [*Rusc*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)|*Gravetat verbal de l'esdeveniment al registre d'esdeveniments.*<br>Per a l'esdeveniment de Windows només monitoratge del registre.<br><br>Aquesta macro es pot emprar amb un índex numèric, p. ex. {ITEM.LOG.SEVERITY[<1-9>](supported_by_location#indexed_macros)} per apuntar al primer, segon, tercer, etc. equip en un trigger. Veieu [macros indexades](supported_by_location#indexed_macros).| |{ITEM.LOG.SOURCE}|→ Notificacions i ordres basades en triggers<br>→ Notificacions i ordres d'actualització de problemes<br>→ Nom del trigger, dades operatives i descripcions<br>→ URL del trigger<br>→ Etiquetes i valors d'esdeveniments <br>→ Acció manual d'esdeveniments [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Descripció del giny de valor d'element|*Font de l'esdeveniment al registre d'esdeveniments.*<br>Per al registre d'esdeveniments de Windows només monitoratge.<br><br>Aquesta macro es pot emprar amb un índex numèric, p. ex. {ITEM.LOG.SOURCE[<1-9>](supported_by_location#indexed_macros)} per apuntar al primer, segon, tercer, etc. equip en un trigger. Veieu [macros indexades](supported_by_location#indexed_macros).| |{ITEM.LOG.TIME}|→ Notificacions i ordres basades en triggers<br>→ Notificacions i ordres d'actualització de problemes<br>→ Noms, dades operatives i descripcions del trigger<br>→ URL del trigger<br>→ Valors i etiquetes d'esdeveniments <br>→ Acció d'esdeveniment manual [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Paràmetre *Descripció* al [*Valor de l'element*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) i el giny [*Calibre*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Paràmetre de *Text* d'etiqueta Primària/Secundària al giny [*Rusc*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)|*Hora de l'esdeveniment de l'element de registre.*<br><br>Aquesta macro pot s'emprarà amb un índex numèric, p. {ITEM.LOG.TIME[<1-9>](supported_by_location#indexed_macros)} per apuntar al primer, segon, tercer, etc. equip en un trigger. Veieu [macros indexades](supported_by_location#indexed_macros).| |{ITEM.NAME}|→ Notificació basada en triggers i ordres<br>→ Notificacions i ordres d'actualització de problemes<br>→ Notificacions internes<br>→ Acció manual d'esdeveniments [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Paràmetre *Descripció* al [*Valor de l'element*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) i el giny [*Calibre*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Paràmetre de *Text* d'etiqueta Primària/Secundària al giny [*Rusc*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)| *Nom de l'element N del trigger que va provocar una notificació.*<br><br>Aquesta macro es pot emprar amb un índex numèric, p. {ITEM.NAME[<1-9>](supported_by_location#indexed_macros)} per apuntar al primer, segon, tercer, etc. equip en un trigger. Veieu [macros indexades](supported_by_location#indexed_macros).| |{ITEM.NAME.ORIG}|→ Notificacions i ordres basades en triggers<br>→ Notificacions i ordres d'actualització de problemes<br>→ Notificacions internes<br>→ Acció manual d'esdeveniments [scripts](/manual/web_interface/frontend_sections/administration /scripts)<br>→ Descripció del giny de valor d'element|Aquesta macro és obsoleta des de Zabbix 6.0. Solia resoldre el *nom original (és a dir, sense les macros resoltes) de l'element* a les versions Zabbix anteriors a la 6.0 quan les macros d'usuari i les macros de posició eren admeses al nom de l'element.<br><br>Aquesta macro es pot emprar amb un índex numèric, p. {ITEM.NAME.ORIG[<1-9>](supported_by_location#indexed_macros)} per apuntar al primer, segon, tercer, etc. equip en un trigger. Veieu [macros indexades](supported_by_location#indexed_macros).| |{ITEM.STATE}|→ Notificacions internes basades en elements<br>→ Paràmetre *Descripció* al [*Valor de l'element*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) i el giny [*Calibre*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Paràmetre de *Text* d'etiqueta Primària/Secundària al giny [*Rusc*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)|*El darrer estat de l'element N del trigger que ha provocat una notificació.* Valors possibles: **No s'admet** i **Normal**.<br><br>Aquesta macro es pot emprar amb un índex numèric, p. ex. {ITEM.STATE[<1-9>](supported_by_location#indexed_macros)} per apuntar al primer, segon, tercer, etc. equip en un trigger. Veieu [macros indexades](supported_by_location#indexed_macros).| |{ITEM.STATE.ERROR}|→ Notificacions internes basades en elements|*Missatge d'error amb detalls per què un element no s'admet.* <br> <br> Si un element passa a l'estat incompatible i immediatament torna a ésser compatible, el camp d'error pot ésser buit.| |{ITEM.VALUE}|→ Notificacions i ordres basades en triggers<br>→ Notificacions i ordres d'actualització de problemes<br>→ Nom del trigger, noms d'esdeveniments, dades operatives i descripcions<br>→ [Noms i valors de l'etiqueta](/manual /config/tagging#macro_support)<br>→ URL d'activació<br>→ Acció manual d'esdeveniments [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Paràmetre *Descripció* al [*Valor de l'element*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) i el giny [*Calibre*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Paràmetre de *Text* d'etiqueta Primària/Secundària al giny [*Rusc*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)|Resolt a:< br>1) el valor històric (en el moment de l'esdeveniment) de l'element N del trigger, si s'empra en el context del canvi d'estat del trigger, per exemple, quan es mostren esdeveniments o s'envien notificacions.<br> 2) el valor més recent de l'element N del trigger, si s'empra sense el context del canvi d'estat del trigger, per exemple, quan es mostra una llista de triggers en una finestra de selecció emergent. En aquest cas, funciona igual que {ITEM.LASTVALUE}<br>En el primer cas, es resoldrà a \*DESCONEGUT\* si el valor de l'historial ja s'ha esborrat o no s'ha emmagatzemat mai.<br>En el segon cas, i només a la interfície, es resoldrà en \*DESCONEGUT\* si el darrer valor de l'historial s'ha recopilat més que el *Període màxim de visualització de l'historial* (establert a [Administració→General](/manual/web_interface/frontend_sections). /administration/general#gui)).<br><br>El valor resolt per als elements de text/registre es trunca a 20 caràcters per la interfície a les ubicacions següents:<br>- Dades operatives;<br>- Descripció de trigger;<br>- URL del trigger;<br>- Etiquetes de la URL del Trigger ;<br>- Paràmetre *Descripció* al [*Valor de l'element*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) i el giny [*Calibre*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Paràmetre de *Text* d'etiqueta Primària/Secundària al giny [*Rusc*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration).<br>Per resoldre un valor complet, podeu emprar [funcions de macro](/manual/config/macros/macro_functions#seeing-full -valors-elements), doncs el servidor no trunca cap valor. Per exemple: `{{ITEM.VALUE}.regsub("(.*)", \1)}`<br><br>Aquest La macro es pot emprar amb un índex numèric, p. {ITEM.VALUE[<1-9>](supported_by_location#indexed_macros)} per apuntar al primer, segon, tercer, etc. element d'un trigger. Veieu [macros indexades](supported_by_location#indexed_macros).| |{ITEM.VALUETYPE}|→ Notificacions i ordres basades en triggers<br>→ Notificacions i ordres d'actualització de problemes<br>→ Notificacions internes<br>→ Acció manual d'esdeveniments [scripts](/manual/web_interface/frontend_sections/administration/scripts )<br>→ Paràmetre *Descripció* al [*Valor de l'element*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) i el giny [*Calibre*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Paràmetre de *Text* d'etiqueta Primària/Secundària al giny [*Rusc*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)|*Tipus de valor de l'element enèssim al trigger que va provocar una notificació.* Valors possibles: 0 - flotant numèric, 1 - caràcter, 2 - registre, 3 - numèric sense signe, 4 - text.<br><br>Aquesta macro es pot emprar amb un índex numèric, p. ex. {ITEM.VALUETYPE[<1-9>](supported_by_location#indexed_macros)} per apuntar al primer, segon, tercer, etc. equip en un trigger. Veieu [macros indexades](supported_by_location#indexed_macros).|

en-us	#### Items  To configure querying of internal stats on another Zabbix instance, you may use two items:  -   `zabbix[stats,<ip>,<port>]` internal item - for direct remote     queries of Zabbix server/proxy. <ip> and <port> are used     to identify the target instance. -   `zabbix.stats[<ip>,<port>]` agent item - for agent-based remote     queries of Zabbix server/proxy. <ip> and <port> are used     to identify the target instance.  See also: [Internal items](/manual/config/items/itemtypes/internal), [Zabbix agent items](/manual/config/items/itemtypes/zabbix_agent)  The following diagram illustrates the use of either item depending on the context.  ![](../../../../assets/en/manual/appendix/items/ext_stats.png)  -   ![](../../../../assets/en/manual/appendix/items/green.png) - Server     → external Zabbix instance (`zabbix[stats,<ip>,<port>]`) -   ![](../../../../assets/en/manual/appendix/items/pink.png) - Server →     proxy → external Zabbix instance (`zabbix[stats,<ip>,<port>]`) -   ![](../../../../assets/en/manual/appendix/items/blue.png) - Server →     agent → external Zabbix instance (`zabbix.stats[<ip>,<port>]`) -   ![](../../../../assets/en/manual/appendix/items/red.png) - Server →     proxy → agent → external Zabbix instance     (`zabbix.stats[<ip>,<port>]`)  To make sure that the target instance allows querying it by the external instance, list the address of the external instance in the 'StatsAllowedIP' parameter on the target instance.
ca	#### Elements  Per configurar la consulta de les estadístiques internes sobre una altra instància Zabbix, podeu emprar dos elements:  - L'element intern `zabbix[stats,<ip>,<port>]` - per les peticions directes a distància del servidor/proxy Zabbix. <ip> i <port> són emprades per indentificar la instància destí. - L'element agent `zabbix.stats[<ip>,<port>]` - per les peticions basades en l'agent del servidor/proxy Zabbix. <ip> i<port> són emprades per identificar la instància destí.  Veieu també: [Elements interns](/manual/config/items/itemtypes/internal), [Elements d'agent Zabbix](/manual/config/items/itemtypes/zabbix_agent)  L'sequema següent mostra l'ús d'un o altre element en funció del context.  ![](../../../../assets/en/manual/appendix/items/ext_stats.png)  - ![](../../../../assets/en/manual/appendix/items/green.png) - Servidor → instància Zabbix externa (`zabbix[stats,<ip>,<port>]`) - ![](../../../../assets/en/manual/appendix/items/pink.png) - Servidor → proxy → instància Zabbix externa (`zabbix[stats,<ip>,<port>]`) - ![](../../../../assets/en/manual/appendix/items/blue.png) - Servidor → agent → instància Zabbix externa (`zabbix.stats[<ip>,<port>]`) - ![](../../../../assets/en/manual/appendix/items/red.png) - Servidor → proxy → agent → instància Zabbix externa (`zabbix.stats[<ip>,<port>]`)  Per assegurar-vos que la instància destí permet ésser consultada per la instància externa, especifiqueu l'adreça externa al paràmetre 'StatsAllowedIP' de la instància destí.

en-us	### Item tag  The item tag object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |tag|string|Item tag name.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value|string|Item tag value.|
ca	### Etiqueta d'element  L'objecte d'etiqueta d'element té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |tag|string|Nom de l'etiqueta de l'element.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |value|string|Valor de l'etiqueta de l'element.|

en-us	# Item  This class is designed to work with items.  Object references:  -   [Item](/manual/api/reference/item/object#item) -   [Item tag](/manual/api/reference/item/object#item_tag) -   [Item preprocessing](/manual/api/reference/item/object#item_preprocessing)  Available methods:  -   [item.create](/manual/api/reference/item/create) - create new items -   [item.delete](/manual/api/reference/item/delete) - delete items -   [item.get](/manual/api/reference/item/get) - retrieve items -   [item.update](/manual/api/reference/item/update) - update items
ca	# Element  Aquesta classe és dissenyada per treballar amb elements.  Referències d'objectes:\  -   [Element](/manual/api/reference/item/object#item) -   [Etiqueta d'element](/manual/api/reference/item/object#item_tag) -   [Preprocessament d'element](/manual/api/reference/item/object#item_preprocessing)  Available methods:\  -   [item.create](/manual/api/reference/item/create) - crear nous elements -   [item.delete](/manual/api/reference/item/delete) - esborrar elements -   [item.get](/manual/api/reference/item/get) - recuperar elements -   [item.update](/manual/api/reference/item/update) - actualitzar elements

en-us	#### Item timeout configuration changes  Upon upgrade, [global timeouts](/manual/web_interface/frontend_sections/administration/general#timeouts) for all supported item types will be set based on the [`Timeout`](/manual/appendix/config/zabbix_server#timeout) parameter value from the server configuration file. If a proxy is configured, then, by default, it will use the server's global timeout settings.  When using an upgraded server (version 7.0.0 or newer) with an older proxy or agent, the proxy or agent will work as before:  - the proxy will use the [`Timeout`](/manual/appendix/config/zabbix_proxy#timeout) parameter from the proxy configuration file; - the agent will use the [`Timeout`](/manual/appendix/config/zabbix_agentd#timeout) parameter from the agent configuration file.  The timeout parameters have been removed from the configuration files of [Modbus](/manual/appendix/config/zabbix_agent2_plugins/modbus_plugin) and [MQTT](/manual/appendix/config/zabbix_agent2_plugins/mqtt_plugin) plugins. The request execution timeouts can now be set using the [item configuration](/manual/config/items/item#configuration) form.
ca	#### Canvis en la configuració del temps d'espera de l'element  Després de l'actualització, els [temps d'espera global](/manual/web_interface/frontend_sections/administration/general#timeouts) per a tots els tipus d'elements admesos s'establiran en funció del valor del paràmetre [`Timeout`](/manual/appendix/config/zabbix_server#timeout) del fitxer de configuració del servidor. Si es configura un proxy, de manera predeterminada, emprarà la configuració del temps d'espera global del servidor.  Quan empreu un servidor actualitzat (versió 7.0.0 o posterior) amb un proxy o agent anterior, el proxy o agent funcionarà com abans:  - el proxy emprarà el paràmetre [`Timeout`](/manual/appendix/config/zabbix_proxy#timeout) del fitxer de configuració del servidor intermediari; - l'agent emprarà el paràmetre [`Timeout`](/manual/appendix/config/zabbix_agentd#timeout) del fitxer de configuració de l'agent.  Els paràmetres de temps d'espera s'han tret dels fitxers de configuració dels connectors [Modbus](/manual/appendix/config/zabbix_agent2_plugins/modbus_plugin) i [MQTT](/manual/appendix/config/zabbix_agent2_plugins/mqtt_plugin). Els temps d'espera d'execució de la petició ara es poden establir mitjançant el formulari [configuració de l'element](/manual/config/items/item#configuration).

en-us	##### Item  To begin with, you may want to set up an item that monitors a log file, for example:      log[/var/log/syslog]  ![](../../../../assets/en/manual/config/event_correlation/correlation_item.png)  With the item set up, wait a minute for the configuration changes to be picked up and then go to [Latest data](/manual/web_interface/frontend_sections/monitoring/latest_data) to make sure that the item has started collecting data.
ca	##### Element  Per començar, voleu poder configurar un element que monitora un arxiu de registre, per exemple:      log[/var/log/syslog]  ![](../../../../assets/en/manual/config/event_correlation/correlation_item.png)  Una vegada l'element és configurat, espereu un minut que les modificacions de configuració siguin recuperades, i accediu a les [Darreres dades](/manual/web_interface/frontend_sections/monitoring/latest_data) per assegurar-vos que l'element comença a recollir dades.

en-us	#### Item, trigger, graph prototypes  Item prototypes must be created as **dependent** item prototypes, using macros from the discovery rule.  Dependent items will obtain their values from the `walk[]` master item. Thus it will not be necessary for each discovered item to query  the SNMP device independently.  Trigger and graph prototypes may also be created also by using macros from the discovery rule.
ca	#### Prototips d'elements, triggers, gràfics  Els prototips d'elements s'han de crear com a prototips d'elements **dependents**, emprant macros de la regla de descoberta.  Els elements dependents obtindran els seus valors de l'element principal `walk[]`. Per tant, no caldrà que cada element descobert consulti el dispositiu SNMP de manera independent.  També es poden crear prototips de trigger i gràfic emprant macros de la regla de descoberta.

en-us	# item.update
ca	# item.update

en-us	#### Item value preprocessing  Data preprocessing is performed in the following steps:  -   The item value is passed to the preprocessing manager using a UNIX socket-based IPC mechanism. -   If the item has neither preprocessing nor dependent items, its value is either added to the history cache or sent to the LLD manager. Otherwise:     -   A preprocessing task is created and added to the queue and preprocessing workers are notified about the new task.     -   At this point the data flow stops until there is at least one unoccupied (i.e., not executing any tasks) preprocessing worker.     -   When a preprocessing worker is available, it takes the next task from the queue.     -   After the preprocessing is done (both failed and successful execution of preprocessing steps), the preprocessed value is added to the finished task queue and the manager is notified about a new finished task.     -   The preprocessing manager converts the result to desired format (defined by item value type) and either adds it to the history cache or sends to the LLD manager.     -   If there are dependent items for the processed item, then dependent items are added to the preprocessing queue with the preprocessed master item value. Dependent items are enqueued bypassing the normal value preprocessing requests, but only for master items with the value set and not in a NOT SUPPORTED state.  ![](../../../assets/en/diagrams/value_preprocessing.png){width="600"}  Note that in the diagram the master item preprocessing is slightly simplified by skipping the preprocessing caching.
ca	#### Preprocessament del valor de l'article  El preprocessament de les dades es realitza en els passos següents:  - El valor de l'element es passa al gestor de preprocessament mitjançant un mecanisme IPC basat en sòcols UNIX. - Si l'element no té elements de preprocessament ni dependents, el seu valor s'afegeix a la memòria cau de l'historial o s'envia al gestor de LLD. D'una altra manera:      - Es crea una tasca de preprocessament i s'afegeix a la cua i els treballadors de preprocessament reben una notificació sobre la nova tasca.      - En aquest punt, el flux de dades s'atura fins que hi hagi almenys un treballador de preprocessament desocupat (és a dir, no executant cap tasca).      - Quan un treballador de preprocessament és disponible, pren la següent tasca de la cua.      - Un cop finalitzat el preprocessament (tant amb l'execució fallida com amb l'èxit dels passos de preprocessament), el valor preprocessat s'afegeix a la cua de tasques acabades i el gestor rep una notificació sobre una nova tasca acabada.      - El gestor de preprocessament converteix el resultat al format desitjat (definit pel tipus de valor d'element) i l'afegeix a la memòria cau de l'historial o l'envia al gestor de LLD.      - Si hi ha elements dependents per a l'element processat, els elements dependents s'afegeixen a la cua de preprocessament amb el valor de l'element principal preprocessat. Els elements dependents es posen a la cua sense passar per alt les sol·licituds de preprocessament del valor normal, però només per als elements mestres amb el valor establert i no en un estat NO SUPORTAT.  ![](../../../assets/en/diagrams/value_preprocessing.png){width="600"}  Tingueu en compte que al diagrama el preprocessament de l'element principal es simplifica lleugerament si omet la memòria cau del preprocessament.

en-us	##### Item value preprocessing  The **Preprocessing** tab allows to define [transformation rules](/manual/config/items/preprocessing) for the received values.
ca	##### Preprocessament del valor de l'element  La pestanya **Preprocessament** permet definir [regles de transformació](/manual/config/items/preprocessing) per als valors rebuts.

en-us	#### Item value processing  To visualize the data flow from data source to the Zabbix database, we can use the following simplified diagram:  ![](../../../../../assets/en/manual/appendix/items/overall_pic.png)  The diagram above shows only processes, objects and actions related to item value processing in a **simplified** form. The diagram does not show conditional direction changes, error handling or loops. The local data cache of the preprocessing manager is not shown either because it doesn't affect the data flow directly. The aim of this diagram is to show processes involved in the item value processing and the way they interact.  -   Data gathering starts with raw data from a data source. At this     point, the data contains only ID, timestamp and value (can be multiple     values as well). -   No matter what type of data gatherer is used, the idea is the same     for active or passive checks, for trapper items, etc., as it only     changes the data format and the communication starter (either data     gatherer is waiting for a connection and data, or data gatherer     initiates the communication and requests the data). The raw data is     validated, the item configuration is retrieved from the configuration cache     (data is enriched with the configuration data). -   A socket-based IPC mechanism is used to pass data from data gatherers     to the preprocessing manager. At this point the data gatherer continues to     gather data without waiting for the response from preprocessing     manager. -   Data preprocessing is performed. This includes the execution of     preprocessing steps and dependent item processing.  ::: noteclassic An item can change its state to NOT SUPPORTED while preprocessing is performed  if any of preprocessing steps fail. :::  -   The history data from the local data cache of the preprocessing manager is being     flushed into the history cache. -   At this point the data flow stops until the next synchronization of     history cache (when the history syncer process performs data     synchronization). -   The synchronization process starts with data normalization before storing data     in Zabbix database. The data normalization performs conversions to the     desired item type (type defined in item configuration), including     truncation of textual data based on predefined sizes allowed for     those types (HISTORY\_STR\_VALUE\_LEN for string,     HISTORY\_TEXT\_VALUE\_LEN for text and HISTORY\_LOG\_VALUE\_LEN for     log values). The data is being sent to the Zabbix database after     the normalization is done.  ::: noteclassic An item can change its state to NOT SUPPORTED if data normalization fails  (for example, when a textual value cannot be converted to number). :::  -   The gathered data is being processed - triggers are checked, the item     configuration is updated if item becomes NOT SUPPORTED, etc. -   This is considered the end of data flow from the point of view of     item value processing.
ca	#### Processament del valor de l'element  Per visualitzar el flux de dades de la font de dades a la base de dades Zabbix, podem emprar el següent diagrama simplificat:  ![](../../../../../assets/en/manual/appendix/items/overall_pic.png)  El diagrama anterior només mostra els processos, objectes i accions relacionades amb el processament del valor de l'element en una forma **simplificada**. El diagrama no mostra canvis de direcció condicionals, tractament d'errors ni bucles. Tampoc es mostra la memòria cau de dades locals del gestor de preprocessament perquè no afecta directament el flux de dades. L'objectiu d'aquest diagrama és mostrar els processos implicats en el processament del valor dels elements i com interactuen.  - La recollida de dades comença amb dades en brut d'una font de dades. En aquest moment, les dades només contenen ID, marca de temps i valor (també poden ser diversos valors) - Independentment del tipus de col·lector de dades emprat, la idea és la mateixa per a controls actius o passius, per a elements trapper, etc., ja que només canvia el format de les dades i l'inici de la comunicació (o el col·lector de dades és esperant una connexió i dades, o el recollidor de dades inicia la comunicació i demana les dades). Les dades en brut es validen, la configuració de l'element es recupera de la memòria cau de configuració (les dades s'enriqueixen amb dades de configuració). - El mecanisme IPC basat en socket s'empra per passar dades dels col·lectors de dades al gestor de preprocessament. En aquest punt, el recopilador de dades continua recopilant dades sense esperar la resposta del gestor de preprocessament. - Es fa un pretractament de dades. Això inclou fer passes de preprocessament i processar elements dependents.  :::noteclassic L'element pot canviar d'estat a NO SOPORTAT durant el preprocessament si alguna de les passes de preprocessament falla. :::  - Les dades de l'historial de la memòria cau de dades local del gestor de preprocessament s'envien a la memòria cau de l'historial. - En aquest punt, el flux de dades s'atura fins a la següent sincronització de la memòria cau de l'historial (quan el procés de sincronització de l'historial realitza la sincronització de dades). - El procés de sincronització comença amb la normalització de dades emmagatzemant dades a la base de dades Zabbix. La normalització de dades realitza conversions al tipus d'element esperat (tipus definit a la configuració de l'element), inclòs el truncament de les dades textuals segons les mides predefinides permeses per a aquests tipus (HISTORY\_STR\_VALUE\_LEN per a la cadena, HISTORY\_TEXT\_VALUE\_LEN per a text i HISTORY\_LOG\_VALUE\_LEN per als valors de registre). Les dades s'envien a la base de dades Zabbix després de la normalització.  :::noteclassic L'element pot canviar d'estat a NO SOPORTAT si la normalització de dades falla (per exemple, quan el valor del text no es pot convertir a nombre). :::  - S'estan processant les dades recollides: es comproven els triggers, s'actualitza la configuració de l'element si l'element no és compatible, etc. - Es considera el final del flux de dades des del punt de vista del processament del valor de l'element.

en-us	Item values remain in value cache either until:  -   the item is deleted (cached values are deleted after the next configuration sync); -   the item value is outside the time or count range specified in the trigger/calculated item expression     (cached value is removed when a new value is received); -   the time or count range specified in the trigger/calculated item expression is changed     so that less data is required for calculation (unnecessary cached values are removed after 24 hours).  ::: notetip Value cache status can be observed by using the server [runtime control](/manual/concepts/server#runtime-control) option `diaginfo` (or `diaginfo=valuecache`) and inspecting the section for value cache diagnostic information. This can be useful for determining misconfigured triggers or calculated items. :::
ca	Els valors dels elements romanen a la memòria cau de valors fins que:  - s'esborra l'element (els valors de la memòria cau s'esborren després de la següent sincronització de configuració); - el valor de l'element és fora de l'interval de temps o de recompte especificat a l'expressió de l'element trigger/calculat (el valor en memòria cau s'esborra quan es rep un valor nou); - es canvia l'interval de temps o recompte especificat a l'expressió de l'element trigger/calculat de manera que calen menys dades per al càlcul (els valors innecessaris a la memòria cau s'esborren després de 24 hores).  ::: nota L'estat de la memòria cau de valors es pot veure mitjançant l'opció del servidor [control d'execució](/manual/concepts/server#runtime-control) `diaginfo` (o `diaginfo=valuecache`) i inspeccionant la secció per obtindre informació de diagnòstic de la memòria cau de valors. Això pot ser útil per determinar triggers mal configurats o elements calculats. :::

en-us	#### Item values  The following information is exported for a collected item value:  |Field|<|<|Type|Description| |-|-|---------|---------|---------------------------| |*host*|<|<|object|Host name of the item host.| | |host|<|string|Host name.| |^|name|<|string|Visible host name.| |*groups*|<|<|array|List of host groups of the item host; there should be at least one element in array.| | |\-|<|string|Host group name.| |*item_tags*|<|<|array|List of item tags (can be empty).| | |\-|<|object|<| |^| |*tag*|string|Tag name.| |^|^|*value*|string|Tag value (can be empty).| |*itemid*|<|<|number|Item ID.| |*name*|<|<|string|Visible item name.| |*clock*|<|<|number|Number of seconds since Epoch to the moment when value was collected (integer part).| |*ns*|<|<|number|Number of nanoseconds to be added to `clock` to get a precise value collection time.| |*timestamp*<br>(*Log* only)|<|<|number|0 if not available.| |*source*<br>(*Log* only)|<|<|string|Empty string if not available.| |*severity*<br>(*Log* only)|<|<|number|0 if not available.| |*eventid*<br>(*Log* only)|<|<|number|0 if not available.| |*value*|<|<|number (for numeric items) or<br>string (for text items)|Collected item value.| |*type*|<|<|number|Collected value type:<br>0 - numeric float, 1 - character, 2 - log, 3 - numeric unsigned, 4 - text, 5 - binary|
ca	#### Valors d'element  S'exporta la informació següent per al valor d'un element recollit:  |Camp|<|Tipus|Descripció| |-|----------|----------|----------------------------- | |*host*|<|object|Nom d'equip de l'equip de l'element.| | |host|string|Nom de l'equip.| |^|nom|string|Nom visible de l'equip.| |*groups*|<|array|Llista de grups d'equips de l'element equip; hi ha d'haver almenys un element a la matriu.| | |\-|string|Nom del grup d'equips.| |*item_tags*|<|<|array|Llista d'etiquetes d'elements (pot ésser buida).| | |\-|<|objecte|<| |^| |*tag*|string|Nom d'etiqueta.| |^|^|*value*|string|Valor d'etiqueta (pot ésser buit).| |*itemid*|<|number|ID de l'element.| |*name*|<|string|Nom de l'element visible.| |*clock*|<|number|Nombre de segons des de l'Època fins que es va recopilar el valor (part entera).| |*ns*|<|number|Nombre de nanosegons que cal afegir a `clock` per obtindre un temps de recollida de valors precís.| |*timestamp*<br>(només *Journal*)|<|number|0 si no és pas disponible.| |*source*<br>(només *Journal*)|<|string|Cadena buida si no és pas disponible.| |*severity*<br>(només *Journal*)|<|number|0 si no és pas disponible.| |*eventid*<br>(només *Journal*)|<|number|0 si no és pas disponible.| |*value*|<|number (per a elements numèrics) o<br>string (per a elements de text)|Valor de l'element recollit.| |*types*|<|number|Tipus de valor recollit:<br>0 - nombre flotant, 1 - caràcter, 2 - registre, 3 - numèric sense signe, 4 - text, 5 - binari|

en-us	##### Item value  The following parameters are supported if *Data* is set to "Item value".  ::: noteclassic The first number in the *Thresholds* property name (e.g. columnsthresholds.0.color.0) references the column for which thresholds are configured, while the second number references threshold place in a list, sorted in ascending order. However, if thresholds are configured in a different order, the values will be sorted in ascending order after updating widget configuration in Zabbix frontend (e.g. `"threshold.0.threshold":"5"` → `"threshold.0.threshold":"1"`; `"threshold.1.threshold":"1"` → `"threshold.1.threshold": "5"`). :::  |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Item*|<|1 |columns.0.item|Valid item name.<br><br>When configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object), only items configured on the template should be set.| |*Display*|<|0|columns.0.display|1 - *(default)* As is;<br>2 - Bar;<br>3 - Indicators.| |*Min*|<|1|columns.0.min|Any numeric value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Display* is set to "Bar" or "Indicators"| |*Max*|<|1|columns.0.max|Any numeric value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Display* is set to "Bar" or "Indicators"| |*Decimal places*|<|0|columns.0.decimal_places|Possible values range from 0-10.<br><br>Default: 2.| |*Thresholds*|<|<|<|<| |<|*Color*|1|columnsthresholds.0.color.0|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |^|*Threshold*|1|columnsthresholds.0.threshold.0|Any string value.| |*Aggregation function*|<|0|columns.0.aggregate_function|0 - *(default)* not used;<br>1 - min;<br>2 - max;<br>3 - avg;<br>4 - count;<br>5 - sum;<br>6 - first;<br>7 - last.| |*Time period*|<|1|columns.0.time_period.\_reference|`DASHBOARD._timeperiod` - set the [*Time period* selector](/manual/web_interface/time_period_selector) as the data source;<br>`ABCDE._timeperiod` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its `reference` parameter equal to `ABCDE`) as the data source.<br><br>Default: `DASHBOARD._timeperiod`<br><br>Alternatively, you can set the time period only in the *From* and *To* parameters.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Aggregation function* is set to "min", "max", "avg", "count", "sum", "first", "last"| |<|*From*|1|columns.0.time_period.from|Valid time string in absolute (`YYYY-MM-DD hh:mm:ss`) or [relative](/manual/web_interface/time_period_selector) time syntax (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time period* is not set and *Aggregation function* is set to "min", "max", "avg", "count", "sum", "first", "last"| |^|*To*|1|columns.0.time_period.to|Valid time string in absolute (`YYYY-MM-DD hh:mm:ss`) or [relative](/manual/web_interface/time_period_selector) time syntax (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time period* is not set and *Aggregation function* is set to "min", "max", "avg", "count", "sum", "first", "last"| |*History data*|<|0|columns.0.history|0 - *(default)* Auto;<br>1 - History;<br>2 - Trends.| |*Reference*|<|1|reference|Any string value consisting of 5 characters (e.g., `ABCDE` or `JBPNL`). This value must be unique within the dashboard to which the widget belongs.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
ca	##### Valor de l'element  Els paràmetres següents són compatibles si *Data* s'estableix en "Valor de l'element".  ::: noteclassic El primer nombre del nom de propietat *Llindars* (p. ex. columnsthresholds.color.0.0) fa referència a la columna per a la qual es configuren els llindars, mentre que el segon nombre fa referència al lloc llindar en una llista, ordenada en ordre ascendent. Tanmateix, si els llindars es configuren en un ordre diferent, els valors s'ordenaran en ordre ascendent després d'actualitzar la configuració del giny a la interfície de Zabbix (p.ex., `"threshold.threshold.0":"5"` → `"threshold.threshold.0":"1"`; `"threshold.threshold.1":"1"` → `"threshold.threshold.1": "5"`). :::  |Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-|--------|--|---------|---------------------------- -----| |*Element*|<|1 |columns.item.0|Nom d'element vàlid.<br><br>Quan es configura el giny a un [tauler de plantilla](/manual/api/reference/templatedashboard/object), només es poden establir els elements configurats a la plantilla.| |*Visualització*|<|0|columns.display.0|1 - *(per defecte)* Tal com és;<br>2 - Barra;<br>3 - Indicadors.| |*Min*|<|1|columns.min.0|Qualsevol valor numèric.<br><br>[Comportament del paràmetre behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* if *Visualització* s'estableix a "Barra" o "Indicadors"| |*Max*|<|1|columns.max.0|Qualsevol valor numèric.<br><br>[Comportament del paràmetre behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* if *Visualització* s'estableix a "Barra" o "Indicadors"| |*Llocs decimals*|<|0|columns.decimal_places.0|Els valors vàlids oscil·len entre 0 i 10.<br><br>Per defecte: 2.| |*Llindars*|<|<|<|<| |<|*Color*|1|columnsthresholds.color.0.0|Codi de color hexadecimal (per exemple, `FF0000`).<br><br>Per defecte: `""` (buit).| |^|*Llindar*|1|columnsthresholds.threshold.0.0|Qualsevol valor de cadena.| |*Funció d'agregació*|<|0|columns.aggregate_function.0|0 - *(per defecte)* cap;<br>1 - mín;<br>2 - màxim;<br>3 - mitjana;<br>4 - recompte;<br>5 - suma;<br>6 - primer;<br>7 - darrer.| |*Període de temps*|<|1|columns.0.time_period._reference|`DASHBOARD._timeperiod` - estableix la [tria de *Període de temps*](/manual/web_interface/time_period_selector) com a font de dades.<br>` ABCDE._timeperiod`: defineix un giny compatible (*Navegador de l'equip* amb el seu paràmetre `reference` igual a `ABCDE`) com a font de dades.<br><br>Per defecte: `DASHBOARD._timeperiod`<br><br> Alternativament, només podeu establir el període de temps als paràmetres *Des de* i *Fins a*.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si la *Funció d'agregació* s'estableix a "min", "max", "mitjana", "recompte", "suma", "primer", "darrer" | |<|*Des de*|1|columns.0.time_period.from|Cadena de temps vàlida en la sintaxi de temps absoluta (`AAAA-MM-DD hh:mm:ss`) o [relativa](/manual/web_interface/time_period_selector) (`ara`, `ara/d`, `ara/w-1w`, etc.).<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si no s'estableix *Període de temps* i la *Funció d'agregació* s'estableix a "min", "max", "mitjana", "recompte", "suma", "primer", "darrer"| |^|*Fins a*|1|columns.0.time_period.to|Cadena de temps vàlida en sintaxi de temps absoluta (`AAAA-MM-DD hh:mm:ss`) o [relativa](/manual/web_interface/time_period_selector) (`ara`, `ara/d`, `ara/w-1w`, etc.).<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si no s'estableix *Període de temps* i la *Funció d'agregació* s'estableix en "min", "max", "mitjana", "recompte", "suma", "primer", "darrer"| |*Dades de l'historial*|<|0|columns.history.0|1 - *(per defecte)* Automàtic;<br>2 - Historial;<br>3 - Tendències.|

en-us	#### item  [ZBXNEXT-7726](https://support.zabbix.com/browse/ZBXNEXT-7726) The `params` property is now *required* for preprocessing steps of the type "Check for not supported value".\ [ZBXNEXT-7578](https://support.zabbix.com/browse/ZBXNEXT-7578) `item.get`, `item.create`, `item.update`: The properties `headers` and `query_fields` changed from name-indexed object to array of objects with separate `name` and `value` properties.\
ca	#### element  [ZBXNEXT-7726](https://support.zabbix.com/browse/ZBXNEXT-7726) La propietat `params` ara és *obligatòria* per passes de preprocessament de tipus "Validació per valor no admès".\ [ZBXNEXT-7578](https://support.zabbix.com/browse/ZBXNEXT-7578) `item.get`, `item.create`, `item.update`: Les propietats `headers` i `query_fields` han canviat d'objectes de nom indexat a taula d'objectes amb les propietats `name` i `value` separades.\

en-us	#### item  [ZBXNEXT-9150](https://support.zabbix.com/browse/ZBXNEXT-9150) Added new item `type` (22 - Browser).\ [ZBXNEXT-7460](https://support.zabbix.com/browse/ZBXNEXT-7460) Added new read-only property `name_resolved`.\ [ZBXNEXT-8645](https://support.zabbix.com/browse/ZBXNEXT-8645) Added new [item preprocessing](/manual/api/reference/item/object#item-preprocessing) type "SNMP get value" (30).\ [ZBXNEXT-8645](https://support.zabbix.com/browse/ZBXNEXT-8645) Property `timeout` is now also supported if item `type` is set to "SNMP agent" (20) and `snmp_oid` starts with "`get[`".\ [ZBXNEXT-1096](https://support.zabbix.com/browse/ZBXNEXT-1096) Property `timeout` is now supported if item `type` is set to "Zabbix agent" (0), "Simple check" (3) and `key_` does not start with "`vmware.`" and "`icmpping`", "Zabbix agent (active)" (7), "External check" (10), "Database monitor" (11), "SSH agent" (13), "TELNET agent" (14), "SNMP agent" (20) and `snmp_oid` starts with "`walk[`".\ [ZBXNEXT-7726](https://support.zabbix.com/browse/ZBXNEXT-7726) Added *scope* and *pattern* components to parameters for steps of the type "Check for not supported value".\ [ZBXNEXT-7578](https://support.zabbix.com/browse/ZBXNEXT-7578) It is now possible to store more data for the `query_fields` property, have repeated `header` and `query_fields` entries.\ [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) `item.get`: Method now also supports `status`, `ts_disable` and `disable_source` properties if `selectItemDiscovery` parameter is used.
ca	#### element  [ZBXNEXT-9150](https://support.zabbix.com/browse/ZBXNEXT-9150) Afegida la nova regla LLD `type` (22 - Navegador).\ [ZBXNEXT-7460](https://support.zabbix.com/browse/ZBXNEXT-7460) S'ha afegit una nova propietat de només lectura `name_resolved`.\ [ZBXNEXT-8645](https://support.zabbix.com/browse/ZBXNEXT-8645) S'ha afegit un nou tipus de [preprocessament d'element](/manual/api/reference/item/object#item-preprocessing): "collir valor SNMP" (30).\ [ZBXNEXT-8645](https://support.zabbix.com/browse/ZBXNEXT-8645) La propietat `timeout` ara s'admet si l'element `type` s'estableix a "agent SNMP" (20) i `snmp_oid` comença amb "`get[`".\ [ZBXNEXT-1096](https://support.zabbix.com/browse/ZBXNEXT-1096) La propietat `timeout` ara s'admet si l'element `type` s'estableix a "agent Zabbix" (0), "Validació simple" (3) i `key_` no comença amb "`vmware.`" i "`icmpping`", "agent de Zabbix (actiu)" (7), "Validació externa" (10), "Monitor de base de dades" (11), "agent SSH" (13), "agent TELNET" (14), "agent SNMP" (20) i`snmp_oid` comença amb "`walk[`".\ [ZBXNEXT-7726](https://support.zabbix.com/browse/ZBXNEXT-7726) Afegits els components *àmbit* i *patró* als paràmetres de les passes de tipus "Validació per valors no admesos".\ [ZBXNEXT-7578](https://support.zabbix.com/browse/ZBXNEXT-7578) Ara és possible emmagatzemar més informació per la propietat `query_fields`, tindre entrades repetides `header` i `query_fields`.\ [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) `item.get`: El mètode ara admet les propietats `status`, `ts_disable` i `disable_source` si s'empra el paràmetre `selectItemDiscovery`.

en-us	It is possible to zoom in and out the map by using the plus and minus buttons in the widget's upper left corner or by using the mouse scroll wheel or touchpad. To set the current view as default, right-click anywhere on the map and select *Set this view as default*. This setting will override *Initial view* widget parameter for the current user. To undo this action, right-click anywhere on the map again and select *Reset to initial view*.  When *Initial view* or *Default view* is set, you can return to this view at any time by pressing on the home icon on the left.  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/geomap_widget3.png)
ca	És possible ampliar i allunyar el mapa emprant els botons més i menys a la cantonada superior esquerra del giny o emprant la roda del ratolí o el touchpad. Per establir la vista actual com a predeterminada, feu clic amb el botó dret a qualsevol lloc del mapa i seleccioneu *Establir aquesta vista com a predeterminada*. Aquesta configuració anul·larà la configuració del giny *Vista inicial* per a l'usuari actual. Per desfer aquesta acció, torneu a fer clic amb el botó dret a qualsevol lloc del mapa i trieu *Restablir a la vista inicial*.  Quan s'estableix *Visualització inicial* o *Visualització per defecte*, podeu tornar a aquesta vista en qualsevol moment tocant la icona d'inici a l'esquerra.  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/geomap_widget3.png)

en-us	##### Java gateway  If you obtained Zabbix from the source repository or an archive, then the necessary dependencies are already included in the source tree.  If you obtained Zabbix from your distribution's package, then the necessary dependencies are already provided by the packaging system.  In both cases above, the software is ready to be used and no additional downloads are necessary.  If, however, you wish to provide your versions of these dependencies (for instance, if you are preparing a package for some Linux distribution), below is the list of library versions that Java gateway is known to work with. Zabbix may work with other versions of these libraries, too.  The following table lists JAR files that are currently bundled with Java gateway in the original code:  |Library|Mandatory status|Minimum version|Comments| |--|-|-|------| |[android-json](https://mvnrepository.com/artifact/com.vaadin.external.google/android-json)|Yes|4.3r1|JSON (JavaScript Object Notation) is a lightweight data-interchange format. This is the org.json compatible Android implementation extracted from the Android SDK.| |[logback-classic](https://mvnrepository.com/artifact/ch.qos.logback/logback-classic)|^|1.2.9| | |[logback-core](https://mvnrepository.com/artifact/ch.qos.logback/logback-core)|^|1.2.9| | |[slf4j-api](https://mvnrepository.com/artifact/org.slf4j/slf4j-api)|^|1.7.32| |  Java gateway can be built using either Oracle Java or open-source OpenJDK (version 1.6 or newer). Packages provided by Zabbix are compiled using OpenJDK. The table below provides information about OpenJDK versions used for building Zabbix packages by distribution:  |Distribution|OpenJDK version| |------------|---------------| |RHEL 8|1.8.0| |RHEL 7|1.8.0| |SLES 15|11.0.4| |Debian 10|11.0.8| |Ubuntu 20.04|11.0.8| |Ubuntu 18.04|11.0.8|
ca	##### Passerel·la Java  Si heu obtingut Zabbix del repositori font o d'un arxiu, les dependències necessàries ja s'inclouen a la font.  Si teniu Zabbix del paquet de la vostra distribució, el sistema de paquets ja proporciona les dependències necessàries.  En els dos casos anteriors, el programari és llest per usar-lo i no cal descarregar-lo.  Tanmateix, si voleu proporcionar les vostres versions d'aquestes dependències (per exemple, si sou preparant un paquet per a determinades distribucions de Linux), a continuació es mostra el llistat de versions de biblioteca amb les quals se sap que la passarel·la de Java pot funcionar. Zabbix també pot treballar amb altres versions d'aquestes biblioteques.  La taula següent llista els fitxers JAR que s'envien actualment amb Java Gateway al codi original:  |Biblioteca|Obligatori|Comentaris| |--|-|-------| |[android-json](https://mvnrepository.com/artifact/com.vaadin.external.google/android-json)|Sí|Versió 4.3r1 o superior.<br>JSON (JavaScript Object Notation) és un format intercanvi de dades lleuger. Aquesta és la implementació d'Android compatible amb org.json extreta de l'SDK d'Android.| |[logback-classic](https://mvnrepository.com/artifact/ch.qos.logback/logback-classic)|^|Versió 1.2.9 o superior.| |[logback-core](https://mvnrepository.com/artifact/ch.qos.logback/logback-core)|^|Versió 1.2.9 o superior.| |[slf4j-api](https://mvnrepository.com/artifact/org.slf4j/slf4j-api)|^|Versió 1.7.32 o superior.|  La passarel·la de Java es pot crear amb Oracle Java o OpenJDK de codi obert (versió 1.6 o posterior). Els paquets proporcionats per Zabbix es compilen mitjançant OpenJDK. La taula següent proporciona informació sobre les versions d'OpenJDK emprades per crear paquets Zabbix per distribució:  |Distribució|Versió OpenJDK| |-----------|---------------| |RHEL 8|1.8.0| |RHEL 7|1.8.0| |SLES 15|11.0.4| |Debian 10|11.0.8| |Ubuntu 20.04|11.0.8| |Ubuntu 18.04|11.0.8|

en-us	### Java gateway installation  It is required to install [Java gateway](/manual/concepts/java) only if you want to monitor JMX applications. Java gateway is lightweight and does not require a database.  Once the required repository is added, you can install Zabbix Java gateway by running:      apt install zabbix-java-gateway  Proceed to [setup](/manual/concepts/java/from_debian_ubuntu) for more details on configuring and running Java gateway.
ca	###Instal·lació de la passarel·la Java  Cal instal·lar la [passarel·la de Java](/manual/concepts/java) només si voleu monitorar les aplicacions JMX. La passarel·la de Java és lleugera i no li cal una base de dades.  Un cop afegit el dipòsit necessari, podeu instal·lar Zabbix Java Gateway executant:       # apt install zabbix-java-gateway  Aneu a [configuració](/manual/concepts/java/from_debian_ubuntu) per obtindre detalls sobre la configuració i l'execució de la passarel·la Java.

en-us	### Java gateway installation  It is required to install [Java gateway](/manual/concepts/java) only if you want to monitor JMX applications. Java gateway is lightweight and does not require a database.  Once the required repository is added, you can install Zabbix Java gateway by running:      dnf install zabbix-java-gateway  Proceed to [setup](/manual/concepts/java/from_rhel) for more details on configuring and running Java gateway.
ca	###Instal·lació de la passarel·la Java  Cal instal·lar la [passarel·la de Java](/manual/concepts/java) només si voleu monitorar les aplicacions JMX. La passarel·la de Java és lleugera i no li cal una base de dades.  Un cop afegit el dipòsit necessari, podeu instal·lar Zabbix Java Gateway executant:       dnf install zabbix-java-gateway  Aneu a [configuració](/manual/concepts/java/from_rhel) per obtindre detalls sobre la configuració i l'execució de la passarel·la Java.

en-us	##### JavaGatewayPort  The port that Zabbix Java gateway listens on.  Default: `10052`<br> Range: 1024-32767
ca	##### JavaGatewayPort  El port on escolta la passarel·la Zabbix Java.  Per defecte: `10052`<br> Rang: 1024-32767

en-us	##### JavaGatewayPort The port that Zabbix Java gateway listens on.  Default: `10052`<br> Range: 1024-32767
ca	##### JavaGatewayPort El port on escolta la passarel·la Zabbix Java.  Per defecte: `10052`<br> Rang: 1024-32767

en-us	##### JavaGateway  The IP address (or hostname) of Zabbix Java gateway. Only required if Java pollers are started.
ca	##### JavaGateway  Adreça IP (o nom d'equip) de la passarel·la Java de Zabbix. Només cal si s'inicien els sondeigs de Java.

en-us	##### JavaGateway The IP address (or hostname) of Zabbix Java gateway. Only required if Java pollers are started.
ca	##### JavaGateway  Adreça IP (o nom d'equip) de la passarel·la Java de Zabbix. Només cal si s'inicien els sondeigs de Java.

en-us	### JavaScript  A JavaScript class can be used to add dynamic behavior and interactivity to the widget configuration view. For example, you can initialize a color picker, defined in the [*CWidgetFormView*](#cwidgetformview) class.  The JavaScript class should be loaded with the form, therefore it should be referenced in the [*CWidgetFormView*](#cwidgetformview) class by using the methods *includeJsFile()* and *addJavaScript()*.  In the example below, a singleton class instance is immediately created and stored under the *window.my_custom_widget_form* name. Thus, opening the form for the second time will re-create the instance.  The JavaScript class should be located in the *views* directory.  **views/widget.edit.js.php example**  ```php <?php  use Modules\MyCustomWidget\Widget;  ?>  window.my_custom_widget_form = new class {      init({color_palette}) {         colorPalette.setThemeColors(color_palette);          for (const colorpicker of jQuery('.<?= ZBX_STYLE_COLOR_PICKER ?> input')) {             jQuery(colorpicker).colorpicker();         }          const overlay = overlays_stack.getById('widget_properties');          for (const event of ['overlay.reload', 'overlay.close']) {             overlay.$dialogue[0].addEventListener(event, () => { jQuery.colorpicker('hide'); });         }     } }; ```
ca	### JavaScript  Es pot emprar una classe JavaScript per afegir comportament dinàmic i interactivitat a la vista de configuració del giny. Per exemple, podeu inicialitzar un selector de color, definit a la classe [*CWidgetFormView*](#cwidgetformview).  La classe JavaScript s'ha de carregar amb el formulari; per tant, s'ha de fer referència a la classe [*CWidgetFormView*](#cwidgetformview) emprant els mètodes *includeJsFile()* i *addJavaScript()*.  A l'exemple següent, es crea immediatament una instància de classe singleton i s'emmagatzema sota el nom *window.my_custom_widget_form*. Així, en obrir el formulari per segon cop es tornarà a crear la instància.  La classe JavaScript s'ha d'ubicar al directori *views*.  **views/widget.edit.js.php exemple**  ```php <?php  use Modules\MyCustomWidget\Widget;  ?>  window.my_custom_widget_form = new class {      init({color_palette}) {         colorPalette.setThemeColors(color_palette);          for (const colorpicker of jQuery('.<?= ZBX_STYLE_COLOR_PICKER ?> input')) {             jQuery(colorpicker).colorpicker();         }          const overlay = overlays_stack.getById('widget_properties');          for (const event of ['overlay.reload', 'overlay.close']) {             overlay.$dialogue[0].addEventListener(event, () => { jQuery.colorpicker('hide'); });         }     } }; ```

en-us	 ##### JavaScript {#javascript}  Enter JavaScript code in the block that appears when clicking in the parameter field or on the pencil icon.  Comments:  -   The available JavaScript length depends on the [database used](/manual/config/items/item#custom-script-limit);<br> -   For more information, see: [Javascript preprocessing](/manual/config/items/preprocessing/javascript).
ca	 ##### JavaScript {#javascript}  Introdueix el codi JavaScript al bloc que apareix en fer clic al camp de paràmetres o a la icona del llapis.  Comentaris:  - La llargària disponible de JavaScript depèn de la [base de dades emprada](/manual/config/items/item#custom-script-limit);<br> - Per obtindre més informació, veieu: [Preprocessament de Javascript](/manual/config/items/preprocessing/javascript).

en-us	### JavaScript preprocessing  JavaScript preprocessing is done by invoking JavaScript function with a single parameter 'value' and user-provided function body. The preprocessing step result is the value returned by this function, for example, to perform Fahrenheit to Celsius conversion, enter:      return (value - 32)  * 5 / 9  in JavaScript preprocessing parameters, which will be wrapped into a JavaScript function by server:  ```javascript function (value) {    return (value - 32) * 5 / 9 } ```  The input parameter 'value' is always passed as a string. The return value is automatically coerced to string via ToString() method (if it fails, then the error is returned as string value), with a few exceptions:  -   returning undefined value will result in an error; -   returning null value will cause the input value to be discarded,     much like 'Discard value' preprocessing on 'Custom on fail' action.  Errors can be returned by throwing values/objects (normally either strings or Error objects).  For example:  ```javascript if (value == 0)     throw "Zero input value" return 1/value ```  Each script has a 10-second execution timeout (depending on the script, it might take longer for the timeout to trigger); exceeding it will return error. A 512-megabyte heap limit is enforced.  The JavaScript preprocessing step bytecode is cached and reused when the step is applied next time. Any changes to the item's preprocessing steps will cause the cached script to be reset and recompiled later.  Consecutive runtime failures (3 in a row) will cause the engine to be reinitialized to mitigate the possibility of one script breaking the execution environment for the next scripts (this action is logged with DebugLevel 4 and higher).  JavaScript preprocessing is implemented with [Duktape](https://duktape.org/) JavaScript engine.  See also: [Additional JavaScript objects and global functions](/manual/config/items/preprocessing/javascript/javascript_objects)
ca	#### Preprocessament de JavaScript  El preprocessament de JavaScript es realitza invocant la funció JavaScript amb un únic paràmetre 'valor' i un cos de funció subministrat per l'usuari. El resultat de la passa de preprocessament és el valor que retorna aquesta funció, per exemple, per fer una conversió de Fahrenheit a Celsius, l'usuari introduiria:      return (value - 32) * 5 / 9  als paràmetres de preprocessament de JavaScript, que s'embolcallen en una funció JavaScript per servidor:  ```javascript function (value) {    return (value - 32) * 5 / 9 } ```  El paràmetre d'entrada 'valor' sempre es passa com a cadena. El valor de retorn es converteix automàticament a una cadena mitjançant el mètode ToString() (si falla, l'error es retorna com a valor de cadena), amb algunes excepcions:  - retornar un valor no definit donarà lloc a un error - retornar un valor nul farà que el valor d'entrada s'esborri, de la mateixa manera que el preprocessament 'Esborra el valor' a l'acció 'Personalitzar en cas d'error'.  Els errors es poden retornar iniciant valors/objectes (normalment cadenes o objectes d'error).  Per exemple:  ``` javascript if (value == 0)     throw "Zero input value" return 1/value ```  Cada script té un temps d'espera d'execució de 10 segons (depenent de l'script, el temps d'espera pot trigar més a activar-se); superar-lo retornarà un error. S'aplica un límit d'emmagatzematge dinàmic de 512 Mo.  El bytecode de la passa de preprocessament de JavaScript s'emmagatzema a la memòria cau i es reutilitza la propera vegada que s'aplica el pas. Qualsevol canvi als passos de preprocessament de l'element farà que l'script desat a la memòria cau es restableixi i es torni a compilar posteriorment.  Els errors d'execució consecutius (3 de seguits) faran que el motor es restableixi per esmorteir la possibilitat que un script trenqui l'entorn d'execució per als scripts posteriors (aquesta acció es registra amb DebugLevel a 4 i posteriors).  El preprocessament de JavaScript s'implementa amb el motor JavaScript de Duktape (<https://duktape.org/>).  Veieu també: [Objectes JavaScript addicionals i funcions globals](/manual/config/items/preprocessing/javascript/javascript_objects)

en-us	### JavaScript  The JavaScript class is responsible for determining widget behavior, such as updating widget data, resizing the widget, displaying widget elements, etc.  All JavaScript operations use and/or extend the base JavaScript class of all dashboard widgets - *CWidget*. The *CWidget* class contains a set of methods with the default implementation for widget behavior. Depending on widget complexity, these methods can be utilized as is or extended.  The *CWidget* class contains the following methods:  -   Methods that define widget lifecycle: *onInitialize()*, *onStart()*, *onActivate()*, *onDeactivate()*, *onDestroy()*, *onEdit()*. -   Methods that handle updating and displaying widget data: *promiseUpdate()*, *getUpdateRequestData()*, *processUpdateResponse(response)*, *processUpdateErrorResponse(error)*, *setContents(response)*. -   Methods that modify widget appearance: *onResize()*, *hasPadding()*.  The JavaScript class should be located in the *assets/js* directory and specified in the [*assets*](/devel/modules/file_structure/manifest#assets) (*assets/js*) parameter in the *manifest.json* file.
ca	### JavaScript  La classe JavaScript s'encarrega de determinar el comportament del giny, com ara actualitzar les dades del giny, canviar la mida del giny, mostrar elements del giny, etc.  Totes les operacions de JavaScript empren i/o amplien la classe bàsica de JavaScript de tots els ginys del tauler - *CWidget*. La classe *CWidget* conté un conjunt de mètodes amb la implementació predeterminada per al comportament del giny. Depenent de la complexitat del giny, aquests mètodes es poden utilitzar tal qual o ampliar.  La classe *CWidget* conté els mètodes següents:  - Mètodes que defineixen el cicle de vida del giny: *onInitialize()*, *onStart()*, *onActivate()*, *onDeactivate()*, *onDestroy()*, *onEdit()*. - Mètodes que gestionen l'actualització i la visualització de dades del giny: *promiseUpdate()*, *getUpdateRequestData()*, *processUpdateResponse(response)*, *processUpdateErrorResponse(error)*, *setContents(response)*. - Mètodes que modifiquen l'aparença del giny: *onResize()*, *hasPadding()*.  La classe JavaScript s'ha d'ubicar al directori *assets/js* i s'ha d'especificar al paràmetre [*assets*](/devel/modules/file_structure/manifest#assets) (*assets/js*) al dossier *manifest.json*.

en-us	#### Jira webhook (custom)  ![](../../../../../../assets/en/manual/config/notifications/media/media_webhook_jira.png){width="600"}  This script will create a JIRA issue and return some info on the created issue.  ``` {.java} try {     Zabbix.log(4, '[ Jira webhook ] Started with params: ' + value);      var result = {             'tags': {                 'endpoint': 'jira'             }         },         params = JSON.parse(value),         req = new HttpRequest(),         fields = {},         resp;      if (params.HTTPProxy) {         req.setProxy(params.HTTPProxy);     }      req.addHeader('Content-Type: application/json');     req.addHeader('Authorization: Basic ' + params.authentication);      fields.summary = params.summary;     fields.description = params.description;     fields.project = {key: params.project_key};     fields.issuetype = {id: params.issue_id};      resp = req.post('https://jira.example.com/rest/api/2/issue/',         JSON.stringify({"fields": fields})     );      if (req.getStatus() != 201) {         throw 'Response code: ' + req.getStatus();     }      resp = JSON.parse(resp);     result.tags.issue_id = resp.id;     result.tags.issue_key = resp.key;      return JSON.stringify(result); } catch (error) {     Zabbix.log(4, '[ Jira webhook ] Issue creation failed json : ' + JSON.stringify({"fields": fields}));     Zabbix.log(3, '[ Jira webhook ] issue creation failed : ' + error);      throw 'Failed with error: ' + error; } ```
ca	#### Jira webhook (personalitzat)  ![](../../../../../../assets/en/manual/config/notifications/media/media_webhook_jira.png){width="600"}  Aquest script crearà un problema JIRA i retornarà la informació del problema creat.  ``` {.java} try {     Zabbix.log(4, '[ Jira webhook ] Started with params: ' + value);      var result = {             'tags': {                 'endpoint': 'jira'             }         },         params = JSON.parse(value),         req = new HttpRequest(),         fields = {},         resp;      if (params.HTTPProxy) {         req.setProxy(params.HTTPProxy);     }      req.addHeader('Content-Type: application/json');     req.addHeader('Authorization: Basic ' + params.authentication);      fields.summary = params.summary;     fields.description = params.description;     fields.project = {key: params.project_key};     fields.issuetype = {id: params.issue_id};      resp = req.post('https://jira.example.com/rest/api/2/issue/',         JSON.stringify({"fields": fields})     );      if (req.getStatus() != 201) {         throw 'Response code: ' + req.getStatus();     }      resp = JSON.parse(resp);     result.tags.issue_id = resp.id;     result.tags.issue_key = resp.key;      return JSON.stringify(result); } catch (error) {     Zabbix.log(4, '[ Jira webhook ] Issue creation failed json : ' + JSON.stringify({"fields": fields}));     Zabbix.log(3, '[ Jira webhook ] issue creation failed : ' + error);      throw 'Failed with error: ' + error; } ```

en-us	 #### JIT user provisioning  Previously provisioned users were limited only to the media created during provisioning without the flexibility of editing such properties as working hours or severities.  Now more flexibility is available for provisioned users in Zabbix:  -    provisioned [user media](/manual/web_interface/user_profile#user-profile) can be disabled/enabled; -    provisioned user [media fields](/manual/config/notifications/media#user-media) such as *When active*, *Use if severity* and *Enabled* can be manually edited; -    additional user media can be added (for example, additional email addresses) for provisioned users manually; -    manually added user media can be deleted (provisioned user media cannot).  Additionally, when configuring user media mapping for provisioning such fields as *When active*, *Use if severity* and *Enabled* are now available. Note that changes to user media type mapping form will take effect only for new media created during provisioning.
ca	 #### Provisió d'usuaris JIT  Els usuaris aprovisionats anteriorment es limitaven només als suports creats durant l'aprovisionament sense la flexibilitat d'editar propietats com ara les hores de treball o la gravetat.  Ara hi ha més flexibilitat disponible per als usuaris subministrats a Zabbix:  - es pot habilitar/desactivar els [suports d'usuari] (/manual/web_interface/user_profile#user-profile) subministrats; - L'usuari subministrat [camps multimèdia](/manual/config/notifications/media#user-media) com ara *Quan és actiu*, *Emprar si la gravetat* i *Activat* es poden editar manualment; - Es poden afegir suports d'usuari addicionals (per exemple, adreces de correu electrònic addicionals) per als usuaris subministrats manualment; - Els suports d'usuari afegits manualment es poden suprimir (els mitjans d'usuari subministrats no poden).  A més, quan es configura el mapa de mitjans d'usuari per subministrar camps com ara *Quan és actiu*, *Emprar si la gravetat* i *Activat* ara són disponibles. Tingueu en compte que els canvis al formulari d'assignació de tipus de suport d'usuari només tindran efecte per als suports nous creats durant l'aprovisionament.

en-us	#### JMX item keys in more detail
ca	#### Claus de l'element JMX detallats

en-us	#### JMX monitoring  See [JMX monitoring](/manual/config/items/itemtypes/jmx_monitoring) page for more details.
ca	#### Monitoratge JMX  Veieu la pàgina [Supervisió JMX](/manual/config/items/itemtypes/jmx_monitoring) per tindre més detalls.

en-us	#### JMX monitoring  See [JMX monitoring](/manual/config/items/itemtypes/jmx_monitoring) page for more details.
ca	#### Monitoratge JMX  Veieu la pàgina [Supervisió JMX](/manual/config/items/itemtypes/jmx_monitoring) per tindre més detalls.

en-us	#### JMX monitoring  See [JMX monitoring](/manual/config/items/itemtypes/jmx_monitoring) page for more details.
ca	#### Monitoratge JMX  Veieu la pàgina [Supervisió JMX](/manual/config/items/itemtypes/jmx_monitoring) per tindre més detalls.

en-us	 ```json {   "books": [     {       "category": "reference",       "author": "Nigel Rees",       "title": "Sayings of the Century",       "price": 8.95,       "id": 1     },     {       "category": "fiction",       "author": "Evelyn Waugh",       "title": "Sword of Honour",       "price": 12.99,       "id": 2     },     {       "category": "fiction",       "author": "Herman Melville",       "title": "Moby Dick",       "isbn": "0-553-21311-3",       "price": 8.99,       "id": 3     },     {       "category": "fiction",       "author": "J. R. R. Tolkien",       "title": "The Lord of the Rings",       "isbn": "0-395-19395-8",       "price": 22.99,       "id": 4     }   ],   "services": {     "delivery": {       "servicegroup": 1000,       "description": "Next day delivery in local town",       "active": true,       "price": 5     },     "bookbinding": {       "servicegroup": 1001,       "description": "Printing and assembling book in A5 format",       "active": true,       "price": 154.99     },     "restoration": {       "servicegroup": 1002,       "description": "Various restoration methods",       "active": false,       "methods": [         {           "description": "Chemical cleaning",           "price": 46         },         {           "description": "Pressing pages damaged by moisture",           "price": 24.5         },         {           "description": "Rebinding torn book",           "price": 99.49         }       ]     }   },   "filters": {     "price": 10,     "category": "fiction",     "no filters": "no \"filters\""   },   "closed message": "Store is closed",   "tags": [     "a",     "b",     "c",     "d",     "e"   ] } ```  |JSONPath|Type|Result| |---|-|------| |`$.filters.price`|definite|10| |`$.filters.category`|definite|fiction| |`$.filters['no filters']`|definite|no "filters"| |`$.filters`|definite|{<br>"price": 10,<br>"category": "fiction",<br>"no filters": "no \\"filters\\""<br>}| |`$.books[1].title`|definite|Sword of Honour| |`$.books[-1].author`|definite|J. R. R. Tolkien| |`$.books.length()`|definite|4| |`$.tags[:]`|indefinite|\["a", "b", "c", "d", "e" \]| |`$.tags[2:]`|indefinite|\["c", "d", "e" \]| |`$.tags[:3]`|indefinite|\["a", "b", "c"\]| |`$.tags[1:4]`|indefinite|\["b", "c", "d"\]| |`$.tags[-2:]`|indefinite|\["d", "e"\]| |`$.tags[:-3]`|indefinite|\["a", "b"\]| |`$.tags[:-3].length()`|definite|2| |`$.books[0, 2].title`|indefinite|\["Moby Dick", "Sayings of the Century"\]| |`$.books[1]['author', "title"]`|indefinite|\["Sword of Honour", "Evelyn Waugh"\]| |`$..id`|indefinite|\[1, 2, 3, 4\]| |`$.services..price`|indefinite|\[154.99, 5, 46, 24.5, 99.49\]| |`$.books[?(@.id == 4 - 0.4 * 5)].title`|indefinite|\["Sword of Honour"\]<br><br>Note: This query shows that arithmetical operations can be used in queries; it can be simplified to `$.books[?(@.id == 2)].title`| |`$.books[?(@.id == 2 \|\| @.id == 4)].title`|indefinite|\["Sword of Honour", "The Lord of the Rings"\]| |`$.books[?(!(@.id == 2))].title`|indefinite|\["Sayings of the Century", "Moby Dick", "The Lord of the Rings"\]| |`$.books[?(@.id != 2)].title`|indefinite|\["Sayings of the Century", "Moby Dick", "The Lord of the Rings"\]| |`$.books[?(@.title =~ " of ")].title`|indefinite|\["Sayings of the Century", "Sword of Honour", "The Lord of the Rings"\]| |`$.books[?(@.price > 12.99)].title`|indefinite|\["The Lord of the Rings"\]| |`$.books[?(@.author > "Herman Melville")].title`|indefinite|\["Sayings of the Century", "The Lord of the Rings"\]| |`$.books[?(@.price > $.filters.price)].title`|indefinite|\["Sword of Honour", "The Lord of the Rings"\]| |`$.books[?(@.category == $.filters.category)].title`|indefinite|\["Sword of Honour","Moby Dick","The Lord of the Rings"\]| |`$.books[?(@.category == "fiction" && @.price < 10)].title`|indefinite|\["Moby Dick"\]| |`$..[?(@.id)]`|indefinite|\[<br>{<br>"price": 8.95,<br>"id": 1,<br>"category": "reference",<br>"author": "Nigel Rees",<br>"title": "Sayings of the Century"<br>},<br>{<br>"price": 12.99,<br>"id": 2,<br>"category": "fiction",<br>"author": "Evelyn Waugh",<br>"title": "Sword of Honour"<br>},<br>{<br>"price": 8.99,<br>"id": 3,<br>"category": "fiction",<br>"author": "Herman Melville",<br>"title": "Moby Dick",<br>"isbn": "0-553-21311-3"<br>},<br>{<br>"price": 22.99,<br>"id": 4,<br>"category": "fiction",<br>"author": "J. R. R. Tolkien",<br>"title": "The Lord of the Rings",<br>"isbn": "0-395-19395-8"<br>}<br>\]| |`$.services..[?(@.price > 50)].description`|indefinite|\["Printing and assembling book in A5 format", "Rebinding torn book"\]| |`$..id.length()`|definite|4| |`$.books[?(@.id == 2)].title.first()`|definite|Sword of Honour| |`$..tags.first().length()`|definite|5<br><br>Note: `$..tags` is an indefinite path, so it returns an array of matched elements, i.e., `[["a", "b", "c", "d", "e" ]]`; `first()` returns the first element, i.e., `["a", "b", "c", "d", "e"]`; `length()` calculates the length of the element, i.e.,`5`.| |`$.books[*].price.min()`|definite|8.95| |`$..price.max()`|definite|154.99| |`$.books[?(@.category == "fiction")].price.avg()`|definite|14.99| |`$.books[?(@.category == $.filters.xyz)].title`|indefinite|Note: A query without match returns NULL for definite and indefinite paths.| |`$.services[?(@.active=="true")].servicegroup`|indefinite|\[1001,1000\]<br><br>Note: Text constants must be used in boolean value comparisons.| |`$.services[?(@.active=="false")].servicegroup`|indefinite|\[1002\]<br><br>Note: Text constants must be used in boolean value comparisons.| |`$.services[?(@.servicegroup=="1002")]~.first()`|definite|restoration|
ca	```json {   "books": [     {       "category": "reference",       "author": "Nigel Rees",       "title": "Sayings of the Century",       "price": 8.95,       "id": 1     },     {       "category": "fiction",       "author": "Evelyn Waugh",       "title": "Sword of Honour",       "price": 12.99,       "id": 2     },     {       "category": "fiction",       "author": "Herman Melville",       "title": "Moby Dick",       "isbn": "0-553-21311-3",       "price": 8.99,       "id": 3     },     {       "category": "fiction",       "author": "J. R. R. Tolkien",       "title": "The Lord of the Rings",       "isbn": "0-395-19395-8",       "price": 22.99,       "id": 4     }   ],   "services": {     "delivery": {       "servicegroup": 1000,       "description": "Next day delivery in local town",       "active": true,       "price": 5     },     "bookbinding": {       "servicegroup": 1001,       "description": "Printing and assembling book in A5 format",       "active": true,       "price": 154.99     },     "restoration": {       "servicegroup": 1002,       "description": "Various restoration methods",       "active": false,       "methods": [         {           "description": "Chemical cleaning",           "price": 46         },         {           "description": "Pressing pages damaged by moisture",           "price": 24.5         },         {           "description": "Rebinding torn book",           "price": 99.49         }       ]     }   },   "filters": {     "price": 10,     "category": "fiction",     "no filters": "no \"filters\""   },   "closed message": "Store is closed",   "tags": [     "a",     "b",     "c",     "d",     "e"   ] } ```  |JSONPath|Tipus|Resultat| |--|--|------|------| |`$.filters.price`|definit|10| |`$.filters.category`|definit|ficció| |`$.filters['no filters']`|definit|no "filters"| |`$.filters`|definit|{<br>"price": 10,<br>"category": "ficció",<br>"no filters": "no \\"filters\\""<br>}| |`$.books[1].title`|definit|Sword of Honour| |`$.books[-1].author`|definit|J. R. R. Tolkien| |`$.books.length()`|definit|4| |`$.tags[:]`|indefinit|\["a", "b", "c", "d", "e" \]| |`$.tags[2:]`|indefinit|\["c", "d", "e" \]| |`$.tags[:3]`|indefinit|\["a", "b", "c"\]| |`$.tags[1:4]`|indefinit|\["b", "c", "d"\]| |`$.tags[-2:]`|indefinit|\["d", "e"\]| |`$.tags[:-3]`|indefinit|\["a", "b"\]| |`$.tags[:-3].length()`|definit|2| |`$.books[0, 2].title`|indefinit|\["Moby Dick", "Sayings of the Century"\]| |`$.books[1]['author', "title"]`|indefinit|\["Sword of Honour", "Evelyn Waugh"\]| |`$..id`|indefinit|\[1, 2, 3, 4\]| |`$.services..price`|indefinit|\[5, 154.99, 46, 24.5, 99.49\]| |`$.books[?(@.id == 4 - 0.4 * 5)].title`|indefinit|\["Sword of Honour"\]<br><br>Nota: Aquesta cerca ensenya que les operacions aritmètiques es poden emprar a les consultes. Evidentment, aquesta consulta es pot simplificar com a `$.books[?(@.id == 2)].title`| |`$.books[?(@.id == 2 \|\| @.id == 4)].title`|indefinit|\["Sword of Honour", "The Lord of the Rings"\]| |`$.books[?(!(@.id == 2))].title`|indefinit|\["Sayings of the Century", "Moby Dick", "The Lord of the Rings"\]| |`$.books[?(@.id != 2)].title`|indefinit|\["Sayings of the Century", "Moby Dick", "The Lord of the Rings"\]| |`$.books[?(@.title =~ " of ")].title`|indefinit|\["Sayings of the Century", "Sword of Honour", "The Lord of the Rings"\]| |`$.books[?(@.price > 12.99)].title`|indefinit|\["The Lord of the Rings"\]| |`$.books[?(@.author > "Herman Melville")].title`|indefinit|\["Sayings of the Century", "The Lord of the Rings"\]| |`$.books[?(@.price > $.filters.price)].title`|indefinit|\["Sword of Honour", "The Lord of the Rings"\]| |`$.books[?(@.category == $.filters.category)].title`|indefinit|\["Sword of Honour","Moby Dick","The Lord of the Rings"\]| |`$.books[?(@.category == "ficció" && @.price < 10)].title`|indefinit|\["Moby Dick"\]| |`$..[?(@.id)]`|indefinit|\[<br>{<br>"category": "reference",<br>"author": "Nigel Rees",<br>"title": "Sayings of the Century",<br>"price": 8.95,<br>"id": 1<br>},<br>{<br>"category": "ficció",<br>"author": "Evelyn Waugh",<br>"title": "Sword of Honour",<br>"price": 12.99,<br>"id": 2<br>},<br>{<br>"category": "ficció",<br>"author": "Herman Melville",<br>"title": "Moby Dick",<br>"isbn": "0-553-21311-3",<br>"price": 8.99,<br>"id": 3<br>},<br>{<br>"category": "ficció",<br>"author": "J. R. R. Tolkien",<br>"title": "The Lord of the Rings",<br>"isbn": "0-395-19395-8",<br>"price": 22.99,<br>"id": 4<br>}<br>\]| |`$.services..[?(@.price > 50)].description`|indefinit|'\["Printing and assembling book in A5 format", "Rebinding torn book"\]| |`$..id.length()`|definit|4| |`$.books[?(@.id == 2)].title.first()`|definit|Sword of Honour| |`$..tags.first().length()`|definit|5<br><br>Nota: `$..etiquetes` és un camí indefinit, pel que retornarà una matriu d'elements trobats, com ara `[["a", "b", "c", "d", "e" ]]`; `first()` retorna el primer element, com ara  `["a", "b", "c", "d", "e" ]`;  `length()` calcula la seva allargada - 5.| |`$.books[*].price.min()`|definit|8.95| |`$..price.max()`|definit|154.99| |`$.books[?(@.category == "ficció")].price.avg()`|definit|14.99| |`$.books[?(@.category == $.filters.xyz)].title`|indefinit|<br><br>Nota: Una consulta sense trobar res retornarà NULL per camins definits i indefinits.| |`$.services[?(@.active=="true")].servicegroup`|indefinit|\[1001,1000\]<br><br>Nota: Les constants de text s'han d'emprar a les comparacions de valors booleans.| |`$.services[?(@.active=="false")].servicegroup`|indefinit|\[1002\]<br><br>Nota: Les constants de text s'han d'emprar a les comparacions de valors booleans.| |`$.services[?(@.servicegroup=="1002")]~.first()`|definit|restauració|

en-us	#### JSON format  The JSON export format contains the following objects:  -   Root object for Zabbix JSON export -   Export version  ```json {     "zabbix_export": {         "version": "7.0"     } } ```  Other objects are dependent on exported objects.
ca	#### Format JSON  El format d'exportació JSON conté els objectes següents:  - Node arrel per exportació Zabbix JSON. - Versió d'exportació.   ```json {     "zabbix_export": {         "version": "7.0"     } } ```  Altres nodes són dependents d'objectes exportats.

en-us	##### JSON Path {#jsonpath}  Extract value or fragment from JSON data using [JSONPath functionality](/manual/config/items/preprocessing/jsonpath_functionality).  If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected.
ca	##### Camí JSON {#jsonpath}  Extraeu el valor o fragment de les dades JSON mitjançant [funcionalitat JSONPath](/manual/config/items/preprocessing/jsonpath_functionality).  Si marqueu la casella de selecció *Personalitzar en cas d'error*, és possible especificar opcions personalitzades de gestió d'errors: per descartar el valor, establir un valor especificat o establir un missatge d'error especificat. En el cas d'una passa de preprocessament fallida, l'element no serà compatible si es tria l'opció per descartar el valor o establir un valor especificat.

en-us	 ##### jsonpath(value,path,<default>) {#jsonpath}  Return the JSONPath result.<br> Supported value types: *String*, *Text*, *Log*.  Parameters:   -   **value** - the value to check;<br> -   **path** - the path (must be quoted);<br> -   **default** - the optional fallback value if the JSONPath query returns no data. Note that on other errors failure is returned (e.g. "unsupported construct").  Example:      jsonpath(last(/host/proc.get[zabbix_agentd,,,summary]),"$..size")
ca	 ##### jsonpath(valor,camí,<predeterminat>) {#jsonpath}  Retorna el resultat JSONPath.<br> Tipus de valors admesos: *Cadena*, *Text*, *Registre*.  Paràmetres:   - **valor** - el valor que cal comprovar;<br> - **camí** - el camí (s'ha de citar entre cometes);<br> - **per defecte** - el valor alternatiu opcional si la consulta JSONPath no retorna cap dada. Tingueu en compte que en altres errors es retorna un error (per exemple, "construcció no compatible").  Exemple:      jsonpath(last(/host/proc.get[zabbix_agentd,,,summary]),"$..size")

en-us	#### JSON protocol for passive agent checks  A JSON-based protocol for [passive agent checks](/manual/appendix/items/activepassive#passive-checks) has been implemented.   For compatibility with older agents, a failover to the old plaintext protocol has been added. If the agent returns "ZBX_NOTSUPPORTED", Zabbix will cache the interface as old protocol and retry the check by sending only the plaintext item key.  [Zabbix get](/manual/concepts/get) can now be run with a new option `-P --protocol <value>` where "value" is either:   -   auto - connect using JSON protocol, fall back and retry with plaintext protocol (default);  -   json - connect using JSON protocol key;  -   plaintext - connect using plaintext protocol where just the item key is sent.
ca	#### Protocol JSON per a comprovacions d'agents passius  S'ha implementat un protocol basat en JSON per a [comprovacions d'agent passiu](/manual/appendix/items/activepassive#passive-checks).   Per a la compatibilitat amb agents antics, s'ha afegit una migració per error al protocol antic de text sense format. Si l'agent torna "ZBX_NOTSUPPORTED", Zabbix emmagatzemarà la interfície com a protocol antic i tornarà a provar la comprovació enviant només la clau de l'element de text sense format.  [Zabbix get](/manual/concepts/get) ara es pot executar amb una nova opció `-P --protocol <valor>` on "valor" és:   - automàtic - connecta mitjançant el protocol JSON, feu retrocedir i torneu-ho a provar amb el protocol de text pla (per defecte);  - json - connecta mitjançant la clau de protocol JSON;  - text pla - connecta mitjançant el protocol de text pla on només s'envia la clau de l'element.

en-us	#### Keeping history  You can set for how many days history will be kept:  -   in the item properties [form](/manual/config/items/item) -   when mass-updating items -   when [setting     up](/manual/web_interface/frontend_sections/administration/housekeeping)     housekeeper tasks  Any older data will be removed by the housekeeper.  The general strong advice is to keep history for the smallest possible number of days and that way not to overload the database with lots of historical values.  Instead of keeping a long history, you can keep longer data of trends. For example, you could keep history for 14 days and trends for 5 years.  You can get a good idea of how much space is required by history versus trends data by referring to the [database sizing page](/manual/installation/requirements#database_size).  While keeping shorter history, you will still be able to review older data in graphs, as graphs will use trend values for displaying older data.  ::: noteimportant If history is set to '0', the item will update only dependent items and inventory. No trigger functions will be evaluated because trigger evaluation is based on history data only. :::   ::: notetip As an alternative way to preserve history consider to use [history export](/manual/extensions/loadablemodules#providing_history_export_callbacks) functionality of loadable modules. :::
ca	#### Conservar l'històric  Podeu definir durant quant de temps s'ha de conservar l'històric:  -   al formulari de propietats de l'[element](/manual/config/items/item) -   quan s'actualitzen elements de forma massiva -   quan es fa la [configuració](/manual/web_interface/frontend_sections/administration/general#housekeeper) de les tasques de neteja  Totes les dades més antigues s'esborraran per la neteja.  El consell general és conservar l'històric durant el mínim de dies possibles i no sobrecarregar la basse de dades amb nombrosos valors històrics.  En lloc de conservar un històric llarg, podeu configurar dates més llargues a les tendències. Per exemple, podeu conservar l'històric de 14 dies i les tendències durant 5 anys.  Podeu tindre una bona ideia de l'espai que cal per les dades d'històric segons l'informe de les dades de tendències, veient la [pàgina de dimensionament de la base de dades](/manual/installation/requirements#database_size).  Conservant l'històric més curt, podeu veure les dades més antigues als gràfics, doncs els gràfics empren els valors de tendències per mostrar les dades més antigues.  ::: noteimportant Si l'històric es defineix a '0', l'element actualitzarà només elements dependents i inventari. Cap funció de trigger s'avaluarà, doncs l'avaluació del trigger es basa només en les dades d'històric. :::   ::: notetip Una altra manera de preservar l'històric ésemprar la funcionalitat [exportar l'històric](/manual/config/items/loadablemodules#providing_history_export_callbacks) dels mòduls carregables. :::

en-us	#### Keeping trends  Trends is a built-in historical data reduction mechanism which stores minimum, maximum, average and the total number of values per every hour for numeric data types.  You can set for how many days trends will be kept:  -   in the item properties [form](/manual/config/items/item) -   when mass-updating items -   when setting up Housekeeper tasks  Trends usually can be kept for much longer than history. Any older data will be removed by the housekeeper.  Zabbix server accumulates trend data in runtime in the trend cache, as the data flows in. Server flushes **previous hour** trends of every item into the database (where frontend can find them) in these situations:  -   server receives the first current hour value of the item -   5 or less minutes of the current hour left and still no current hour     values of the item -   server stops  To see trends on a graph you need to wait at least to the beginning of the next hour (if item is updated frequently) and at most to the end of the next hour (if item is updated rarely), which is 2 hours maximum.  When server flushes trend cache and there are already trends in the database for this hour (for example, server has been restarted mid-hour), server needs to use update statements instead of simple inserts. Therefore on a bigger installation if restart is needed it is desirable to stop server in the end of one hour and start in the beginning of the next hour to avoid trend data overlap.  History tables do not participate in trend generation in any way.  ::: noteimportant If trends are set to '0', Zabbix server does not calculate or store trends at all. :::  ::: noteclassic The trends are calculated and stored with the same data type as the original values. As a result the average value calculations of unsigned data type values are rounded and the less the value interval is the less precise the result will be. For example if item has values 0 and 1, the average value will be 0, not 0.5.  Also restarting server might result in the precision loss of unsigned data type average value calculations for the current hour. :::
ca	#### Desar les tendències  Les tendències són un mecanisme de reducció de dades de l'històric integrat que emmagatzema valors horaris mínims, màxims, mitjans i totals per a tipus de dades numèriques.  Podeu definir durant quants dies es mantindran les tendències:  - al [formulari](/manual/config/items/item) de les propietats de l'element - quan s'actualitzen elements a comptagotes - en configurar tasques de neteja  Les tendències normalment es poden mantindre molt més temps que l'històric. Totes les dades més antigues s'esborraran amb la neteja.  El servidor Zabbix acumula dades de tendències en temps d'execució a la memòria cau de tendències a mesura que arriben les dades. El servidor aboca les tendències de l'**hora anterior** de cada element a la base de dades (on la interfície les pot trobar) en aquestes situacions:  - el servidor rep el primer valor de temps actual de l'element - Queden 5 minuts o menys de l'hora actual i encara no hi ha valor de temps actual per a l'element - el servidor s'atura  Per veure les tendències en un gràfic, hauríeu d'esperar almenys fins a l'inici de l'hora següent (si l'element s'actualitza amb freqüència) i com a màxim fins al final de l'hora següent (si l'element s'actualitza amb poca freqüència); és a dir, 2 hores com a màxim.  Quan el servidor esborra la memòria cau de tendències i ja hi ha tendències a la base de dades per a aquesta hora (per exemple, el servidor s'ha reiniciat fa mitja hora), el servidor hauria d'emprar declaracions d'actualització en lloc d'insercions simples. Per tant, en una instal·lació més gran, si es requereix un reinici, és desitjable aturar el servidor després d'una hora i començar al principi de l'hora següent per evitar la superposició de dades de tendència.  Les taules històriques no participen de cap manera en la generació de tendències.  ::: noteimportant Si les tendències s'estableixen a "0", el servidor Zabbix no calcula ni emmagatzema tendències en absolut. :::  :::noteclassic Les tendències es calculen i s'emmagatzemen amb el mateix tipus de dades que els valors originals. Com a resultat, els càlculs de valors mitjans dels valors de tipus de dades sense signar s'arrodoneixen i com més petit sigui el rang de valors, menys precís serà el resultat. Per exemple, si l'element té els valors 0 i 1, el valor mitjà serà 0 i no 0,5.  Reiniciar el servidor també pot provocar que els càlculs del valor mitjà dels tipus de dades sense signar per a l'hora actual siguin inexactes. :::

en-us	##### kernel.maxfiles {#kernel.maxfiles}  <br> The maximum number of opened files supported by OS.<br> Return value: *Integer*.<br> [Supported platforms](#supported-platforms): Linux, FreeBSD, MacOS X, OpenBSD, NetBSD.
ca	##### kernel.maxfiles {#kernel.maxfiles}  <br> El nombre màxim de fitxers oberts compatibles amb el sistema operatiu.<br> Valor de retorn: *Enter*.<br> [Plataformes admeses](#plataformes-admeses): Linux, FreeBSD, MacOS X, OpenBSD, NetBSD.

en-us	##### kernel.maxproc {#kernel.maxproc}  <br> The maximum number of processes supported by OS.<br> Return value: *Integer*.<br> [Supported platforms](#supported-platforms): Linux 2.6 and later, FreeBSD, Solaris, MacOS X, OpenBSD, NetBSD.
ca	##### kernel.maxproc {#kernel.maxproc}  <br> El nombre màxim de processos compatibles amb el sistema operatiu.<br> Valor de retorn: *Enter*.<br> [Plataformes admeses](#plataformes-admeses): Linux 2.6 i posteriors, FreeBSD, Solaris, MacOS X, OpenBSD, NetBSD.

en-us	##### kernel.openfiles {#kernel.openfiles}  <br> The number of currently open file descriptors.<br> Return value: *Integer*.<br> [Supported platforms](#supported-platforms): Linux (the item may work on other UNIX-like platforms).
ca	##### kernel.openfiles {#kernel.openfiles}  <br> Nombre de descriptors de fitxers oberts actualment.<br> Valor de retorn: *Enter*.<br> [Plataformes admeses](#supported-platforms): Linux (l'element pot funcionar en altres plataformes semblants a UNIX).

en-us	##### Key file authentication  To use key based authentication for SSH items, certain changes to the server configuration are required.  Open the Zabbix server configuration file ([*zabbix\_server.conf*](/manual/appendix/config/zabbix_server)) as `root` and look for the following line:  ```ini # SSHKeyLocation= ```  Uncomment it and set the full path to the folder where the public and private keys will be located:  ```ini SSHKeyLocation=/home/zabbix/.ssh ```  Save the file and restart Zabbix server afterwards.  The path */home/zabbix* here is the home directory for the *zabbix* user account, and *.ssh* is a directory where by default public and private keys will be generated by an [ssh-keygen](http://en.wikipedia.org/wiki/Ssh-keygen) command inside the home directory.  Usually installation packages of Zabbix server from different OS distributions create the *zabbix* user account with a home directory elsewhere, for example, */var/lib/zabbix* (as for system accounts).  Before generating the keys, you could reallocate the home directory to */home/zabbix*, so that it corresponds with the `SSHKeyLocation` Zabbix server configuration parameter mentioned above.  ::: noteclassic The following steps can be skipped if *zabbix* account has been added manually according to the [installation section](/manual/installation/install#create_user_account). In such a case the home directory for the *zabbix* account is most likely already */home/zabbix*. :::  To change the home directory of the *zabbix* user account, all working processes which are using it have to be stopped:  ```bash service zabbix-agent stop service zabbix-server stop ```  To change the home directory location with an attempt to move it (if it exists) the following command should be executed:  ```bash usermod -m -d /home/zabbix zabbix ```  It is also possible that a home directory did not exist in the old location, so it should be created at the new location. A safe attempt to do that is:  ```bash test -d /home/zabbix || mkdir /home/zabbix ```  To be sure that all is secure, additional commands could be executed to set permissions to the home directory:  ```bash chown zabbix:zabbix /home/zabbix chmod 700 /home/zabbix ```  Previously stopped processes can now be started again:  ```bash service zabbix-agent start service zabbix-server start ```  Now, the steps to generate the public and private keys can be performed with the following commands (for better readability, command prompts are commented out):  ```bash sudo -u zabbix ssh-keygen -t rsa # Generating public/private rsa key pair. # Enter file in which to save the key (/home/zabbix/.ssh/id_rsa): /home/zabbix/.ssh/id_rsa # Enter passphrase (empty for no passphrase): <Leave empty> # Enter same passphrase again:  <Leave empty> # Your identification has been saved in /home/zabbix/.ssh/id_rsa. # Your public key has been saved in /home/zabbix/.ssh/id_rsa.pub. # The key fingerprint is: # 90:af:e4:c7:e3:f0:2e:5a:8d:ab:48:a2:0c:92:30:b9 zabbix@it0 # The key's randomart image is: # +--[ RSA 2048]----+ # |                 | # |       .         | # |      o          | # | .     o         | # |+     . S        | # |.+   o =         | # |E .   * =        | # |=o . ..* .       | # |... oo.o+        | # +-----------------+ ```  ::: noteclassic The public and private keys (*id\_rsa.pub* and *id\_rsa*) have been generated by default in the */home/zabbix/.ssh* directory, which corresponds to the Zabbix server `SSHKeyLocation` configuration parameter. :::  ::: noteimportant Key types other than "rsa" may be supported by the ssh-keygen tool and SSH servers but they may not be supported by libssh2 used by Zabbix. :::
ca	##### Autenticació d'arxiu de clau  Per emprar una autenticació basada en clau per elements SSH, s'han de fer alguns canvis a la configuració del servidor.  Obriu l'arxiu de configuració del servidor Zabbix ([zabbix\_server.conf](/manual/appendix/config/zabbix_server)) com a `root`, i cerqueu la línia següent:  ```ini # SSHKeyLocation= ```  Traieu-li el comentari i poseu-hi la ruta sencera cap a la carpeta on hi haurà les claus públiques i privades:  ```ini SSHKeyLocation=/home/zabbix/.ssh ```  Deseu l'arxiu i reinicieu el zabbix\_server.  */home/zabbix* aquest és el directori arrel de l'usuari *zabbix*, i *.ssh* és el directori on s'hi generen per defecte les claus públiques i privades amb la comanda [ssh-keygen](http://en.wikipedia.org/wiki/Ssh-keygen) dins del directori de l'usuari.  Generalment, els paquets d'instal·lació del zabbix-server de diferents distribucions de Sistema Operatiu creen el compte d'usuari *zabbix* amb un directori arrel en un lloc no gaire habitual (com per a comptes del sistema; per exemple, */var/lib/zabbix*).  Abans de generar les claus, estaria bé moure el directori base de l'usuari a un lloc més intuïtiu. Aquest hauria de correspondre amb el paràmetre de configuració *SSHKeyLocation* del servidor Zabbix, tal com s'ha dit més amunt.  ::: noteclassic Les passes poden saltar-se si el compte *zabbix* s'ha afegit manualment d'acord amb la [secció d'instal·lació](/manual/installation/install#create_user_account), doncs en aquest cas el directori base sigui a */home/zabbix*. :::  Per canviar aquest paràmetre del compte d'usuari *zabbix*, tots els processos que sigui emprant s'han d'aturar:  ```bash service zabbix-agent stop service zabbix-server stop ```  Per canviar el directori base movent-lo, la comanda hauria d'ésser:  ```bash usermod -m -d /home/zabbix zabbix ```  És possible que el directori base no existeixi al lloc antic, pel que s'hauria de crear a la nova ubicació. Una manera de fer-ho és:  ```bash test -d /home/zabbix || mkdir /home/zabbix ```  Per assegurar-vos que és segur, exxecuteu comandes addicionals per establir els permisos al directori base:  ```bash chown zabbix:zabbix /home/zabbix chmod 700 /home/zabbix ```  Com hem aturat els processos abans, ara els hauríem d'engegar:  ```bash service zabbix-agent start service zabbix-server start ```  Ara, les passes per generar les claus públiques i privades es poden fer amb aquesta comand:  ```bash # sudo -u zabbix ssh-keygen -t rsa Generating public/private rsa key pair. Enter file in which to save the key (/home/zabbix/.ssh/id_rsa):  # <enter the created directory '/home/zabbix/.ssh'> Enter passphrase (empty for no passphrase):  Enter same passphrase again:  Your identification has been saved in /home/zabbix/.ssh/id_rsa. Your public key has been saved in /home/zabbix/.ssh/id_rsa.pub. The key fingerprint is: 90:af:e4:c7:e3:f0:2e:5a:8d:ab:48:a2:0c:92:30:b9 zabbix@it0 The key's randomart image is: +--[ RSA 2048]----+ |                 | |       .         | |      o          | | .     o         | |+     . S        | |.+   o =         | |E .   * =        | |=o . ..* .       | |... oo.o+        | +-----------------+ ```  :::noteclassic Nota: les claus públiques i privades (*id\_rsa.pub* i *id\_rsa* respectivament) s'han generat per defecte al directori */home/zabbix/.ssh*, que correspon al paràmetre de configuració *SSHKeyLocation* del servidor Zabbix. :::  ::: noteimportant Els tipus de claus diferents d'"rsa" es poden admetre per l'eina ssh-keygen i els servidors SSH però no seran suportades per libssh2, que és la que empra el Zabbix. :::

en-us	#### Key name  The key name itself has a limited range of allowed characters, which just follow each other. Allowed characters are:      0-9a-zA-Z_-.  Which means:  -   all numbers; -   all lowercase letters; -   all uppercase letters; -   underscore; -   dash; -   dot.  ![](../../../../../assets/en/manual/config/key_name.png)
ca	#### Nom de la clau  El nom de la clau té una limitació de caràcters permesos, que es segueixen els uns als altres. Els caràcters permesos són:      0-9a-zA-Z_-.  Que vol dir:  -   tots les nombres ; -   totes les lletres minúscules; -   totes les lletres majúscules; -   guió baix; -   guió; -   punt.  ![](../../../../../assets/en/manual/config/key_name.png)

en-us	#### Key parameters  An item key can have multiple parameters that are comma separated.  ![](../../../../../assets/en/manual/config/key_parameters.png)  Each key parameter can be either a quoted string, an unquoted string or an array.  ![](../../../../../assets/en/manual/config/item_parameter.png)  The parameter can also be left empty, thus using the default value. In that case, the appropriate number of commas must be added if any further parameters are specified. For example, item key **icmpping\[,,200,,500\]** would specify that the interval between individual pings is 200 milliseconds, timeout - 500 milliseconds, and all other parameters are left at their defaults.  It is possible to include macros in the parameters. Those can be [user macros](/manual/appendix/macros/supported_by_location_user#items-item-prototypes) or some of the built-in macros. To see what particular built-in macros are supported in item key parameters, search the page [Supported macros](/manual/appendix/macros/supported_by_location) for "item key parameters".
ca	#### Paràmetres de les claus  Una clau d'element pot tindre diversos paràmetres, separats per comes.  ![](../../../../../assets/en/manual/config/key_parameters.png)  Cada paràmetre de clau pot ésser una cadena entre cometes, una cadena sense cometes o una taula.  ![](../../../../../assets/en/manual/config/item_parameter.png)  El paràmetre es pot deixar buit, emprant el valor per defecte. En aquest cas, el nombre adequat de comes s'ha d'ajustar si s'especifiquen altres paràmetres. Per exemple, la clau d'element **icmpping\[,,200,,500\]** especifica que l'interval entre pings individuals és de 200 mil·lisegons, amb un timeout de 500 mil·lisegons, i tots els altres paràmetres es deixen amb els seus valors per defecte.  És possible incloure macros als paràmetres. Aquestes poden ser [macros d'usuari](/manual/appendix/macros/supported_by_location_user#items-item-prototypes) o algunes de les macros integrades. Per veure quines macros integrades concretes s'admeten als paràmetres clau de l'element, cerqueu "paràmetres clau de l'element" a la pàgina de [macros admeses](/manual/appendix/macros/supported_by_location).

en-us	#### Kiosk mode  The kiosk mode in supported frontend pages can be activated using URL parameters. For example, in dashboards:  -   `/zabbix.php?action=dashboard.view&kiosk=1` - activate kiosk mode -   `/zabbix.php?action=dashboard.view&kiosk=0` - activate normal mode
ca	#### Mode quiosc  El mode quiosc a les pàgines d'interfície compatibles es pot activar mitjançant els paràmetres d'URL. Per exemple, als taulers de control:  - `/zabbix.php?action=dashboard.view&kiosk=1` - activa el mode kiosque - `/zabbix.php?action=dashboard.view&kiosk=0` - activa el mode normal

en-us	#### Known issues  See [known issues](/manual/installation/known_issues#graphs) for graphs.
ca	#### Problemes coneguts  Veieu els [problemes coneguts](/manual/installation/known_issues#graphs) dels gràfics.

en-us	#### Known issues  To improve performance, you can convert the field types from *nclob* to *nvarchar2*, see [known issues](/manual/installation/known_issues#slow-configuration-sync-with-oracle).
ca	#### Problemes coneguts  Per millorar el rendiment, podeu convertir els tipus d'arxius de *nclob* a *nvarchar2*, veieu els [problemes coneguts](/manual/installation/known_issues#slow-configuration-sync-with-oracle).

en-us	 ##### kurtosis(/host/key,(sec|#num)<:time shift>) {#kurtosis}  The "tailedness" of the probability distribution in collected values within the defined evaluation period. See also: [Kurtosis](https://en.wikipedia.org/wiki/Kurtosis).<br> Supported value types: *Float*, *Integer*.<br> Supported [foreach function](/manual/appendix/functions/aggregate/foreach): *last_foreach*.  Parameters: see [common parameters](#common-parameters).  Example:      kurtosis(/host/key,1h) #kurtosis for the last hour until now
ca	 ##### kurtosis(/host/key,(sec|#num)<:time shift>) {#kurtosis}  La "cua" de la distribució de probabilitat en els valors recollits dins del període d'avaluació definit. Veieu també: [Kurtosis](https://en.wikipedia.org/wiki/Kurtosis).<br> Tipus de valors admesos: *Flotant*, *Enter*.<br> Admet les [funcions foreach](/manual/appendix/functions/aggregate/foreach): *last_foreach*.  Paràmetres: veieu [paràmetres comuns](#common-parameters).  Exemple:       kurtosis(/host/key,1h) #kurtosis durant la darrera hora

en-us	##### Large file support  Zabbix has large file support for SNMP trapper files. The maximum file size that Zabbix can read is 2\^63 (8 EiB). Note that the filesystem may impose a lower limit on the file size.
ca	##### Suport d'arxius grossos  Zabbix admet fitxers grossos per a fitxers trapper SNMP. El límit de mida màxim que pot llegir Zabbix és 2\^63 (8 EiB). Tingueu en compte que el sistema de fitxers pot imposar un límit inferior a la mida del fitxer.

en-us	 ##### last(/host/key,<#num<:time shift>>) {#last}  The most recent value.<br> Supported value types: *Float*, *Integer*, *String*, *Text*, *Log*.  Parameters:   -   See [common parameters](#common-parameters);<br> -   **#num** (optional) - the Nth most recent value.  Comments:  -   Take note that a hash-tagged time period (#N) works differently here than with many other functions. For example: `last()` is always equal to `last(#1)`; `last(#3)` - the third most recent value (*not* three latest values); -   Zabbix does not guarantee the exact order of values if more than two values exist within one second in history; -   See also [first()](#first).  Example:      last(/host/key) #retrieve the last value     last(/host/key,#2) #retrieve the previous value     last(/host/key,#1) <> last(/host/key,#2) #the last and previous values differ
ca	 ##### last(/host/key,<#num<:time shift>>) {#last}  El valor més recent.<br> Tipus de valors admesos: *Flotant*, *Enter*, *Cadena*, *Text*, *Log*.  Paràmetres:  - Veieu [paràmetres comuns](#common-parameters);<br> - **#num** (opcional) - el valor enèssim més recent.  Comentaris:  - Tingueu en compte que un període de temps etiquetat amb hash (#N) funciona de manera diferent aquí que amb moltes altres funcions. Per exemple: `last()` sempre és igual a `last(#1)`; `last(#3)` - el tercer valor més recent (*no* els tres valors més recents); - Zabbix no garanteix l'ordre exacte dels valors si existeixen més de dos valors en un segon a l'històric; - Veieu també [first()](#first).  Exemple:       last(/host/key) #recupera el darrer valor      last(/host/key, #2) #recupera el valor anterior      last(/host/key,#1) <> last(/host/key,#2) #el darrer valor i l'anterior difereixen

en-us	#### Latest data filter  In *Monitoring* → [*Latest data*](/manual/web_interface/frontend_sections/monitoring/latest_data), the subfilter and data are no longer displayed by default if the filter is not set.  If upgrading from previous Zabbix versions, see also: [Upgrade notes for 7.0.0](/manual/installation/upgrade_notes_700#latest-data-filter).
ca	#### Filtre de dades més recents  A *Monitoratge* → [*Dades recents*](/manual/web_interface/frontend_sections/monitoring/latest_data), el subfiltre i les dades ja no es mostren de manera predeterminada si el filtre no és configurat.  Si actualitzeu des de versions anteriors de Zabbix, consulteu també: [Notes d'actualització per a 7.0.0](/manual/installation/upgrade_notes_700#latest-data-filter).

en-us	#### Latest data filter  In *Monitoring* → [*Latest data*](/manual/web_interface/frontend_sections/monitoring/latest_data), the subfilter and data are no longer displayed by default if the filter is not set. Note, however, that previously [saved filters](/manual/web_interface/frontend_sections/monitoring/latest_data#saving-filter) that were set using only the subfilter remain unaffected. In such cases, the subfilter will remain visible, and data will be displayed even without the main filter being set.
ca	#### Filtre de dades més recent  A *Monitoratge* → [*Darreres dades*](/manual/web_interface/frontend_sections/monitoring/latest_data), el subfiltre i les dades ja no es mostren de manera predeterminada si el filtre no està configurat. Tingueu en compte, però, que anteriorment [els filtres desats](/manual/web_interface/frontend_sections/monitoring/latest_data#saving-filter) que s'havien establert només amb el subfiltre no es veuen afectats. En aquests casos, el subfiltre romandrà visible i les dades es mostraran fins i tot sense establir el filtre principal.

en-us	 #### LDAP server configuration  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/users/auth_ldap_server.png)  LDAP server configuration parameters:  |Parameter|Description| |--|--------| |*Name*|Name of the LDAP server in Zabbix configuration.| |*Host*|Hostname, IP or URI of the LDAP server. Examples: ldap.example.com, 127.0.0.1, ldap://ldap.example.com<br>For secure LDAP server, use *ldaps* protocol and hostname. Example: ldaps://ldap.example.com<br>With OpenLDAP 2.x.x and later, a full LDAP URI of the form ldap://hostname:port or ldaps://hostname:port may be used.| |*Port*|Port of the LDAP server. Default is 389.<br>For secure LDAP connection port number is normally 636.<br>Not used when using full LDAP URIs.| |*Base DN*|Base path to user accounts in LDAP server:<br>ou=Users,ou=system (for OpenLDAP),<br>DC=company,DC=com (for Microsoft Active Directory)<br> uid=%{user},dc=example,dc=com (for direct user binding, see a note below)| |*Search attribute*|LDAP account attribute used for search:<br>uid (for OpenLDAP),<br>sAMAccountName (for Microsoft Active Directory)| |*Bind DN*|LDAP account for binding and searching over the LDAP server, examples:<br>uid=ldap\_search,ou=system (for OpenLDAP),<br>CN=ldap\_search,OU=user\_group,DC=company,DC=com (for Microsoft Active Directory)<br>Anonymous binding is also supported. Note that anonymous binding potentially opens up domain configuration to unauthorized users (information about users, computers, servers, groups, services, etc.). For security reasons, disable anonymous binds on LDAP hosts and use authenticated access instead.| |*Bind password*|LDAP password of the account for binding and searching over the LDAP server.| |*Description*|Description of the LDAP server.| |*Configure JIT provisioning*|Mark this checkbox to show options related to JIT provisioning.| |*Group configuration*|Select the group configuration method:<br>**memberOf** - by searching users and their group membership attribute<br>**groupOfNames** - by searching groups through the member attribute<br>Note that memberOf is preferable as it is faster; use groupOfNames if your LDAP server does not support `memberOf` or group filtering is required.| |*Group name attribute*|Specify the attribute to get the group name from all objects in the `memberOf` attribute (see the *User group membership attribute* field)<br>The group name is necessary for user group mapping.| |*User group membership attribute*|Specify the attribute that contains information about the groups that the user belongs to (e.g. `memberOf`).<br>For example, the memberOf attribute may hold information like this: `memberOf=cn=zabbix-admin,ou=Groups,dc=example,dc=com`<br>This field is available only for the memberOf method.| |*User name attribute*|Specify the attribute that contains the user's first name.| |*User last name attribute*|Specify the attribute that contains the user's last name.| |*User group mapping*|Map an LDAP user group pattern to Zabbix user group and user role.<br>This is required to determine what user group/role the provisioned user will get in Zabbix.<br>Click on *Add* to add a mapping.<br>The *LDAP group pattern* field supports wildcards. The group name must match an existing group.<br>If an LDAP user matches several Zabbix user groups, the user becomes a member of all of them.<br>If a user matches several Zabbix user roles, the user will get the one with the highest permission level among them.| |*Media type mapping*|Map the user's LDAP media attributes (e.g. email) to Zabbix user media for sending notifications.| |*Advanced configuration*|Click on the *Advanced configuration* label to display advanced configuration options (see below).| |*StartTLS*|Mark the checkbox to use the StartTLS operation when connecting to LDAP server. The connection will fall if the server doesn't support StartTLS.<br>StartTLS cannot be used with servers that use the *ldaps* protocol.| |*Search filter*|Define a custom string when authenticating a user in LDAP. The following placeholders are supported:<br>`%{attr}` - search attribute name (uid, sAMAccountName)<br>`%{user}` - user username value to authenticate<br>For example, to carry out a case-sensitive search within the case-insensitive LDAP or Microsoft Active Directory environment, the string can be defined as follows:<br>`(%{attr}:caseExactMatch:=%{user})`.<br>If the filter is not customized, LDAP will use the default: `(%{attr}=%{user})`.|  ::: noteclassic To configure an LDAP server for **direct user binding**, append an attribute uid=%{user} to the *Base DN* parameter (for example,*uid=%{user},dc=example,dc=com*) and leave *BindDN* and *Bind password* parameters empty. When authenticating, a placeholder %{user} will be replaced by the username entered during login. :::  The following fields are specific to "groupOfNames" as the *Group configuration* method:  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/users/auth_ldap_server2.png)  |Parameter|Description| |--|--------| |*Group base DN*|Base path to the groups in LDAP server.| |*Group name attribute*|Specify the attribute to get the group name in the specified base path to groups.<br>The group name is necessary for user group mapping.| |*Group member attribute*|Specify the attribute that contains information about the members of the group in LDAP (e.g. `member`).| |*Reference attribute*|Specify the reference attribute for the group filter (see the *Group filter* field).<br>Then use `%{ref}` in the group filter to get values for the attribute specified here.| |*Group filter*|Specify the filter to retrieve the group that the user is member of.<br>For example, `(member=uid=%{ref},ou=Users,dc=example,dc=com)` will match "User1" if the member attribute of the group is `uid=User1,ou=Users,dc=example,dc=com` and will return the group that "User1" is a member of.|  ::: notewarning In case of trouble with certificates, to make a secure LDAP connection (ldaps) work  you may need to add a `TLS_REQCERT allow` line to the /etc/openldap/ldap.conf configuration file. It may decrease the security of connection to the LDAP catalog. :::  ::: notetip It is recommended to create a separate LDAP account (*Bind DN*) to perform binding and  searching over the LDAP server with minimal privileges in the LDAP instead of using real  user accounts (used for logging in the Zabbix frontend).\ Such an approach provides more security and does not require changing the *Bind password*  when the user changes his own password in the LDAP server.\ In the table above it's the *ldap\_search* account name. :::
ca	 #### Configuració del servidor LDAP  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/users/auth_ldap_server.png)  Paràmetres de configuració del servidor LDAP:  |Paràmetre|Descripció| |--|---------| |*Nom*|Nom del servidor LDAP a la configuració de Zabbix.| |*Host*|Nom d'equip, URI o IP del servidor LDAP. Exemples: ldap.exemple.cat, 127.0.0.1, ldap://ldap.exemple.cat<br>Per al servidor LDAP segur, empreu el protocol *ldaps* i el nom d'equip. Exemple: ldaps://ldap.exemple.cat<br>Amb OpenLDAP 2.x.x i posteriors, es pot emprar l'URI LDAP de la forma ldap://nom_equip:port o ldaps://nom_equip:port.| |*Port*|Port del servidor LDAP. El valor predeterminat és 389.<br>Per a una connexió segura LDAP, el nombre de port normalment és 636.<br>No s'utilitza quan s'empren URI LDAP complets.| |*DN base*|Camí base als comptes d'usuari al servidor LDAP:<br>ou=Usuaris,ou=sistema (per a OpenLDAP),<br>DC=empresa,DC=com (per a Microsoft Active Directory)<br> uid =%{usuari},dc=exemple,dc=com (per a l'enllaç directe d'usuari, veieu una nota a continuació)| |*Atribut de cerca*|Atribut del compte LDAP emprat per a la cerca:<br>uid (per a OpenLDAP),<br>sAMAccountName (per a Microsoft Active Directory)| |*Bind DN*|Compte LDAP per vincular i cercar al servidor LDAP, exemples:<br>uid=ldap\_search,ou=system (per a OpenLDAP),<br>CN=ldap\_search,OU=usuari\_grup ,DC=company,DC=com (per a Microsoft Active Directory)<br>També s'admet l'enllaç anònim. Tingueu en compte que l'enllaç anònim pot obrir la configuració del domini a usuaris no autoritzats (informació sobre usuaris, ordinadors, servidors, grups, serveis, etc.). Per motius de seguretat, desactiveu els enllaços anònims als equips LDAP i empreu l'accés autenticat.| |*Mot de pas d'enllaç*|Mot de pas LDAP del compte per vincular i cercar al servidor LDAP.| |*Descripció*|Descripció del servidor LDAP.| |*Configura el subministrament JIT*|Marqueu aquesta casella de selecció per mostrar les opcions relacionades amb el subministrament JIT.| |*Configuració del grup*|Trieu el mètode de configuració del grup:<br>**memberOf** - cercant usuaris i el seu atribut de pertinença al grup<br>**groupOfNames** - cercant grups mitjançant l'atribut membre<br>Tingueu en compte que memberOf és preferible ja que és més ràpid; empreu groupOfNames si el vostre servidor LDAP no admet `memberOf` o si cal filtrar el grup.| |*Atribut del nom del grup*|Especifiqueu l'atribut per obtenir el nom del grup de tots els objectes de l'atribut `memberOf` (veieu el camp *Atribut de pertinença al grup d'usuaris*)<br>El nom del grup és necessari per al mapeig del grup d'usuaris.| |*Atribut de pertinença al grup d'usuaris*|Especifiqueu l'atribut que conté informació sobre els grups als quals pertany l'usuari (per exemple, `memberOf`).<br>Per exemple, l'atribut memberOf pot contenir informació com aquesta: `memberOf=cn=zabbix -admin,ou=Groups,dc=example,dc=com`<br>Aquest camp només està disponible per al mètode memberOf.| |*Atribut del nom d'usuari*|Especifiqueu l'atribut que conté el nom de l'usuari.| |*Atribut del cognom de l'usuari*|Especifiqueu l'atribut que conté el cognom de l'usuari.| |*Mapatge de grups d'usuaris*|Mapeja un patró de grup d'usuaris LDAP al grup d'usuaris de Zabbix i al rol d'usuari.<br>Això és necessari per determinar quin grup/rol d'usuaris obtindrà l'usuari subministrat a Zabbix.<br>Feu clic a *Afegir* per afegir una assignació.<br>El camp *Patró de grup LDAP* admet comodins. El nom del grup ha de coincidir amb un grup existent.<br>Si un usuari LDAP coincideix amb diversos grups d'usuaris de Zabbix, l'usuari esdevé membre de tots ells.<br>Si un usuari coincideix amb diversos rols d'usuari de Zabbix, l'usuari obtindrà el nivell de permís més alt entre ells.| |*Mapa de tipus de suport*|Mapeja els atributs de suport LDAP de l'usuari (per exemple, correu electrònic) als mitjans d'usuari de Zabbix per enviar notificacions.| |*Configuració avançada*|Marqueu aquesta casella de selecció per veure les opcions de configuració avançades (veieu més avall).| |*StartTLS*|Marqueu la casella de selecció per emprar l'operació StartTLS quan us connecteu al servidor LDAP. La connexió caurà si el servidor no admet StartTLS.<br>StartTLS no es pot emprar amb servidors que empren el protocol *ldaps*.| |*Filtre de cerca*|Definiu una cadena personalitzada en autenticar l'usuari a LDAP. S'admeten els següents marcadors de posició:<br>`%{attr}` - nom de l'atribut de cerca (uid, sAMAccountName)<br>`%{user}` - valor del nom d'usuari de l'usuari per autenticar.<br>Per exemple, per fer una cerca sensible a majúscules a l'entorn LDAP o Microsoft Active Directory, la cadena es pot definir així:<br>`(%{attr}:caseExactMatch:=%{usuari})`.<br>Si s'omet, LDAP emprarà el filtre per defecte: `(%{attr}=%{usuari})`.|  ::: noteclassic Per configurar un servidor LDAP per a **enllaç directe d'usuari**, afegiu un atribut uid=%{user} al paràmetre *Base DN* (per exemple,*uid=%{user},dc=example,dc=com*) i deixeu els paràmetres *BindDN* i *Bind password* buits. Quan s'autentiqui, un marcador de posició %{user} serà substituït pel nom d'usuari introduït durant la sessió. :::  Els camps següents són específics de "groupOfNames" com a mètode *Configuració del grup*:  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/users/auth_ldap_server2.png)  |Paràmetre|Descripció| |--|---------| |*DN base del grup*|Camí base als grups al servidor LDAP.| |*Atribut del nom del grup*|Especifiqueu l'atribut per obtenir el nom del grup a la ruta base especificada als grups.<br>El nom del grup és necessari per a l'assignació de grups d'usuaris.| |*Atribut del membre del grup*|Especifiqueu l'atribut que conté informació sobre els membres del grup a LDAP (per exemple, `membre`).| |*Atribut de referència*|Especifiqueu l'atribut de referència per al filtre de grup (veieu el camp *Filtre de grup*).<br>A continuació, empreu `%{ref}` al filtre de grup per obtenir valors per a l'atribut especificat aquí.| |*Filtre de grup*|Especifiqueu el filtre per recuperar el grup del qual és membre l'usuari.<br>Per exemple, `(member=uid=%{ref},ou=Users,dc=example,dc=com)` coincidirà amb "Usuari1" si l'atribut de membre del grup és `uid=Usuari1,ou=Usuaris,dc=example,dc=com` i retornarà el grup del qual "Usuari1" és membre.|  ::: notewarning En cas de problemes amb els certificats, perquè funcioni una connexió LDAP segura (ldaps), potser haureu d'afegir una línia `TLS_REQCERT allow` al fitxer de configuració /etc/openldap/ldap.conf. Pot disminuir la seguretat de la connexió al catàleg LDAP. :::  ::: notetip Es recomana crear un compte LDAP independent (*Bind DN*) per realitzar l'enllaç i la cerca al servidor LDAP amb privilegis mínims al LDAP en comptes d'emprar comptes d'usuari reals (emprats per iniciar sessió a la interfície Zabbix).\ Aquest enfocament proporciona més seguretat i no requereix canviar el *mot de pas d'enllaç* quan l'usuari canvia el seva propi mot de pas al servidor LDAP.\ A la taula de dalt hi ha el nom del compte *ldap\_search*. :::

en-us	##### Left trim {#ltrim}  Remove specified characters from the beginning of the value.
ca	##### Retallar esquerra {#ltrim}  Esborra els caràcters especificats al principi del valor.

en-us	 ##### left(value,count) {#left}  Return the leftmost characters of the value.<br> Supported value types: *String*, *Text*, *Log*.  Parameter:   -   **value** - the value to check;<br> -   **count** - the number of characters to return.  For example, you may return 'Zab' from 'Zabbix' by specifying 3 leftmost characters to return. See also [right()](#right).  Example:      left(last(/host/key),3) #return three leftmost characters
ca	 ##### left(value,count) {#left}  Retorna els caràcters més a l'esquerra del valor.<br> Tipus de valors admesos: *Cadena*, *Text*, *Log*.  Paràmetre:  - **valor** - valor que cal comprovar;<br> - **recompte** - nombre de caràcters a retornar.  Per exemple, podeu tornar 'Zab' de 'Zabbix' especificant 3 caràcters més a l'esquerra per retornar. Veieu també [right()](#right).  Exemple:      left(last(/host/key),3) #retorna els tres caràcters de més a l'esquerra

en-us	#### Legend  The following parameters are supported for configuring *Legend*.  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Show legend*|0|legend|0 - Disabled;<br>1 - *(default)* Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show legend* is set to "Enabled"| |*Display min/avg/max*|0|legend_statistic|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show legend* is set to "Enabled"| |*Show aggregation function*|0|legend_aggregation|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show legend* is set to "Enabled"| |*Rows*|0|legend_lines_mode|0 - *(default)* Fixed;<br>1 - Variable.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show legend* is set to "Enabled"| |*Number of rows/*<br>*Maximum number of rows*|0|legend_lines|Possible values range from 1-10.<br><br>Default: 1.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show legend* is set to "Enabled"| |*Number of columns*|0|legend_columns|Possible values range from 1-4.<br><br>Default: 4.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show legend* is set to "Enabled", and *Display min/avg/max* is set to "Disabled"|
ca	#### Llegenda  Els paràmetres següents són compatibles per configurar la *Llegenda*.  |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|------|-------------------| |*Veure la llegenda*|0|legend|0 - Desactivat;<br>1 - *(per defecte)* Habilitat.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):< br>- *admès* si *Veure la llegenda* és establert a "Habilitat"| |*Veure min/avg/max*|0|legend_statistic|0 - *(per defecte)* Desactivat;<br>1 - Activat.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter- comportament):<br>- *admès* si *Veure la llegenda* és establert a "Habilitat"| |*Veure la funció d'agregació*|0|legend_aggregation|0 - *(per defecte)* Desactivat;<br>1 - Activat.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior): <br>- *admès* si *Veure la llegenda* és establert a "Habilitat"| |*Fileres*|0|legend_lines_mode|0 - *(per defecte)* Corregit;<br>1 - Variable.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br >- *admès* si *Veure la llegenda* és establert a "Activat"| |*Nombre de fileres/*<br>*Nombre màxim de fileres*|0|legend_lines|Els valors possibles oscil·len entre 1 i 10.<br><br>Per defecte: 1.<br><br>[Comportament del paràmetre]( /manual/api/reference_commentary#parameter-behavior):<br>- *admès* si *Veure la llegenda* és establert a "Habilitat"| |*Nombre de columnes*|0|legend_columns|Els valors possibles oscil·len entre 1 i 4.<br><br>Per defecte: 4.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior ):<br>- *admès* si *Veure la llegenda* és establert a "Activat" i *Veure min/avg/màx* és establert a "Desactivat"|

en-us	#### Legend  The following parameters are supported for configuring *Legend*.  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Show legend*|0|legend|0 - Disabled;<br>1 - *(default)* Enabled.| |*Show value*|0|legend_value|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show legend* is set to "Enabled"| |*Show aggregation function*|0|legend_aggregation|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show legend* is set to "Enabled"| |*Rows*|0|legend_lines_mode|0 - *(default)* Fixed;<br>1 - Variable.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show legend* is set to "Enabled"| |*Number of rows/*<br>*Maximum number of rows*|0|legend_lines|Possible values range from 1-10.<br><br>Default: 1.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show legend* is set to "Enabled"| |*Number of columns*|0|legend_columns|Possible values range from 1-4.<br><br>Default: 4.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show legend* is set to "Enabled", and *Show value* is set to "Disabled"|
ca	#### Llegenda  Els paràmetres següents són compatibles per configurar *Llegenda*.  |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|------|-------------------| |*Veure la llegenda*|0|legend|0 - Desactivat;<br>1 - *(per defecte)* Activat.| |*Veure el valor*|0|legend_value|0 - *(per defecte)* Desactivat;<br>1 - Activat.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):< br>- *admès* si *Veure la llegenda* és establert a "Habilitat"| |*Veure la funció d'agregació*|0|legend_aggregation|0 - *(per defecte)* Desactivat;<br>1 - Activat.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior): <br>- *admès* si *Veure la llegenda* és establert a "Habilitat"| |*Fileres*|0|legend_lines_mode|0 - *(per defecte)* Corregit;<br>1 - Variable.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br >- *admesa* si *Veure la llegenda* és establert a "Activat"| |*Nombre de fileres/*<br>*Nombre màxim de fileres*|0|legend_lines|Els valors possibles oscil·len entre 1 i 10.<br><br>Per defecte: 1.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si *Veure la llegenda* és establert a "Habilitat"| |*Nombre de columnes*|0|legend_columns|Els valors possibles oscil·len entre 1 i 4.<br><br>Per defecte: 4.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si *Veure la llegenda* és establert a "Activat" i *Veure el valor* és establert a "Desactivat"|

en-us	#### Legend  The **Legend** tab allows to customize the graph legend:  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/graph_legend.png){width="600"}  |   |   | |--|--------| |*Show legend*|Unmark this checkbox to hide the legend on the graph (marked by default).| |*Display min/avg/max*|Mark this checkbox to display the minimum, average, and maximum values of the item in the legend.| |*Show aggregation function*|Mark this checkbox to show the aggregation function in the legend.| |*Rows*|Select the display mode for legend rows:<br>**Fixed** - the number of rows displayed is determined by the *Number of rows* parameter value;<br>**Variable** - the number of rows displayed is determined by the amount of configured items while not exceeding the *Maximum number of rows* parameter value.| |*Number of rows/*<br>*Maximum number of rows*|If *Rows* is set to "Fixed", set the number of legend rows to be displayed (1-10).<br>If *Rows* is set to "Variable", set the maximum number of legend rows to be displayed (1-10).| |*Number of columns*|Set the number of legend columns to be displayed (1-4).<br>This parameter is available if *Display min/avg/max* is unmarked.|
ca	#### Llegenda  La pestanya **Llegenda** permet personalitzar la llegenda del gràfic:  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/graph_legend.png){width="600"}  |   |   | |--|---------| |*Mostra la llegenda*|Desmarqueu aquesta casella per ocultar la llegenda al gràfic (marcada per defecte).| |*Mostra min/mig/max*|Marqueu aquesta casella de selecció per mostrar els valors mínims, mitjos i màxims de l'element a la llegenda.| |*Mostra la funció d'agregació*|Marqueu aquesta casella de selecció per mostrar la funció d'agregació a la llegenda.| |*Fileres*|Trieu el mode de visualització de les files de llegenda:<br>**Fixes** - el nombre de files que es mostren ve determinat pel valor del paràmetre *Nombre de fileres*;<br>**Variable** - el nombre de files que es mostren es determina per la quantitat d'elements configurats sense superar el valor del paràmetre *Nombre màxim de files*.| |*Nombre de fileres/*<br>*Nombre màxim de fileres*|Si *Fileres* s'estableix en "Fixes", definiu el nombre de fileres de llegenda que es veuran (1-10).<br>Si *Fileres* és establert a "Variable", estableix el nombre màxim de fileres de llegenda que es veuran (1-10).| |*Nombre de columnes*|Defineix el nombre de columnes de llegenda que es veuran (1-4).<br>Aquest paràmetre és disponible si *Mostra mín/mig/màx* no és pas marcat.|

en-us	#### Legend  The **Legend** tab allows to customize the pie chart legend:  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/pie_legend.png){width="600"}  |   |   | |--|--------| |*Show legend*|Unmark this checkbox to hide the legend on the pie chart (marked by default).| |*Show value*|Mark this checkbox to show the value of the item in the legend.| |*Show aggregation function*|Mark this checkbox to show the aggregation function in the legend.| |*Rows*|Select the display mode for legend rows:<br>**Fixed** - the number of rows displayed is determined by the *Number of rows* parameter value;<br>**Variable** - the number of rows displayed is determined by the amount of configured items while not exceeding the *Maximum number of rows* parameter value.| |*Number of rows/*<br>*Maximum number of rows*|If *Rows* is set to "Fixed", set the number of legend rows to be displayed (1-10).<br>If *Rows* is set to "Variable", set the maximum number of legend rows to be displayed (1-10).| |*Number of columns*|Set the number of legend columns to be displayed (1-4).<br>This parameter is available if *Show value* is unmarked.|
ca	#### Llegenda  La pestanya **Llegenda** permet personalitzar la llegenda del gràfic circular:  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/pie_legend.png){width="600"}  |   |   | |--|---------| |*Mostra la llegenda*|Desmarca aquesta casella per ocultar la llegenda al gràfic circular (marcat per defecte).| |*Mostra el valor*|Marqueu aquesta casella de selecció per mostrar el valor de l'element a la llegenda.| |*Mostra la funció d'agregació*|Marqueu aquesta casella de selecció per mostrar la funció d'agregació a la llegenda.| |*Files*|Seleccioneu el mode de visualització de les files de llegenda:<br>**Fixat**: el nombre de files que es mostren ve determinat pel valor del paràmetre *Nombre de files*;<br>**Variable**: el nombre de files que es mostren es determina per la quantitat d'elements configurats sense superar el valor del paràmetre *Nombre màxim de files*.| |*Nombre de files/*<br>*Nombre màxim de files*|Si *Files* s'estableix en "Fixat", definiu el nombre de files de llegenda que es mostraran (1-10).<br>Si *Files* està establert a "Variable", estableix el nombre màxim de files de llegenda que es mostraran (1-10).| |*Nombre de columnes*|Defineix el nombre de columnes de llegenda que es mostraran (1-4).<br>Aquest paràmetre està disponible si *Mostra el valor* no està marcat.|

en-us	 ##### length(value) {#length}  The length of value in characters.<br> Supported value types: *String*, *Text*, *Log*.  Parameter:   -   **value** - the value to check.  Examples:      length(last(/host/key)) #the length of the latest value     length(last(/host/key,#3)) #the length of the third most recent value     length(last(/host/key,#1:now-1d)) #the length of the most recent value one day ago
ca	 ##### length(value) {#length}  Longitud del valor en caràcters.<br> Tipus de valors admesos: *Cadena*, *Text*, *Log*.  Paràmetre:  - **valor** - valor que cal comprovar.  Exemples:       length(last(/host/key)) #longitud del darrer valor      length(last(/host/key,#3)) #longitud del tercer valor més recent      length(last(/host/key,#1:now-1d)) #durada del valor més recent fa un dia

en-us	#### Library in a non-standard location  Zabbix allows you to specify a library located in a non-standard location. In the example below, Zabbix will run `curl-config` from the specified non-standard location and use its output to determine the correct libcurl to use.      $ ./configure --enable-server --with-mysql --with-libcurl=/usr/local/bin/curl-config  This will work if it is the only libcurl installed in the system, but might not if there is another libcurl installed in a standard location (by the package manager, for example). Such is the case when you need a newer version of the library for Zabbix and the older one for other applications.  Therefore, specifying a component in a non-standard location will not always work when the same component also exists in a standard location.  For example, if you use a newer libcurl installed in `/usr/local` with the libcurl package still installed, Zabbix might pick up the wrong one and compilation will fail:      usr/bin/ld: ../../src/libs/zbxhttp/libzbxhttp.a(http.o): in function 'zbx_http_convert_to_utf8':     /tmp/zabbix-master/src/libs/zbxhttp/http.c:957: undefined reference to 'curl_easy_header'     collect2: error: ld returned 1 exit status  Here, the function `curl_easy_header()` is not available in the older `/usr/lib/x86_64-linux-gnu/libcurl.so`, but is available in the newer `/usr/local/lib/libcurl.so`.  The problem lies with the order of linker flags, and one solution is to specify the full path to the library in an LDFLAGS variable:      $ LDFLAGS="-Wl,--no-as-needed /usr/local/lib/libcurl.so" ./configure --enable-server --with-mysql --with-libcurl=/usr/local/bin/curl-config  Note the `-Wl,--no-as-needed` option which might be needed on some systems (see also: default linking options on [Debian-based](https://wiki.debian.org/ToolChain/DSOLinking) systems).
ca	#### Biblioteca en una ubicació no estàndard  Zabbix us permet especificar una biblioteca ubicada a un lloc no estàndard. A l'exemple següent, Zabbix executarà `curl-config` des de la ubicació no estàndard especificada i emprarà la seva sortida per determinar el libcurl correcte a emprar.      $ ./configure --enable-server --with-mysql --with-libcurl=/usr/local/bin/curl-config  Això funcionarà si és l'únic libcurl instal·lat al sistema, però potser no pas si hi ha un altre libcurl instal·lat en una ubicació estàndard (pel gestor de paquets, per exemple). Aquest és el cas quan us cal una versió més nova de la biblioteca per a Zabbix i la més antiga per a altres aplicacions.  Per tant, especificar un component en una ubicació no estàndard no sempre funcionarà quan el mateix component també existeix en una ubicació estàndard.  Per exemple, si empreu un libcurl més nou instal·lat a `/usr/local` amb el paquet libcurl encara instal·lat, Zabbix podria agafar l'equivocat i la compilació fallarà:      usr/bin/ld: ../../src/libs/zbxhttp/libzbxhttp.a(http.o): a la funció 'zbx_http_convert_to_utf8':     /tmp/zabbix-master/src/libs/zbxhttp/http.c:957: referència indefinida a 'curl_easy_header'     collect2: error: ld returned 1 exit status  Aquí, la funció `curl_easy_header()` no és disponible a l'antiga `/usr/lib/x86_64-linux-gnu/libcurl.so`, però sí que ho és a la nova `/usr/local/lib/libcurl.so` .  El problema rau en l'ordre dels indicadors d'enllaç i una solució és especificar el camí complet a la biblioteca en una variable LDFLAGS:      $ LDFLAGS="-Wl,--no-as-needed /usr/local/lib/libcurl.so" ./configure --enable-server --with-mysql --with-libcurl=/usr/local/bin /curl-config  Tingueu en compte l'opció `-Wl,--no-as-needed` que pot caldre en alguns sistemes (vegeu també: opcions d'enllaç predeterminades a sistemes [basats en Debian](https://wiki.debian.org/ToolChain/DSOLinking)).

en-us	##### Lifecycle methods  The widget lifecycle methods are invoked by the dashboard, and at different stages of the widget's lifecycle during its existence within the dashboard.
ca	##### Mètodes de cicle de vida  Els mètodes de cicle de vida del giny són cridats pel tauler de control i en diferents etapes del cicle de vida del giny durant la seva existència dins del tauler.

en-us	##### Limitations  -   Only same host (template) dependencies are allowed -   An item prototype can depend on another item prototype or regular     item from the same host -   Maximum count of dependent items for one master item is limited to     29999 (regardless of the number of dependency levels) -   Maximum 3 dependency levels allowed -   Dependent item on a host with master item from template will not be     exported to XML
ca	##### Limitacions  - Només es permeten dependències del mateix equip (model). - Un prototip d'element pot dependre d'un altre prototip d'element o d'un element estàndard del mateix equip - El nombre màxim d'elements dependents per a un element principal és limitat a 29999 (independentment del nombre de nivells de dependència) - Màxim 3 nivells de dependència permesos - L'element dependent de l'equip amb l'element del model principal no s'exportarà com a XML