[comment]: # ({d8592bb6-70237fe9})
# 12 Bresca
[comment]: # ({/d8592bb6-70237fe9})
[comment]: # ({19fe6913-24cd2015})
### Descripció
Aquests paràmetres i els possibles valors de propietat per als objectes de camp del giny del tauler de control respectius permeten configurar el giny
[*Bresca*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb) als mètodes `dashboard.create` i `dashboard.update`.
::: noteimportant
Les propietats dels `camps' del giny no es validen pas durant la creació o actualització d'un tauler.
Això permet als usuaris modificarels [ginys integrats](/manual/web_interface/frontend_sections/dashboards/widgets) i crear [ginys personalitzats](/devel/modules/tutorials/widget), però també afegeix el risc de creació o actualització incorrectes dels ginys.
Per garantir la creació o actualització correcta del giny *Bresca*, consulteu el comportament dels paràmetres que es descriuen a les taules següents.
:::
[comment]: # ({/19fe6913-24cd2015})
[comment]: # ({03089a26-7a40ed57})
### Paràmetres
Els paràmetres següents són compatibles amb el giny *Bresca*.
|Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor|
|-|--------|--|---------|---------------------------- -----|
|*Interval d'actualització*|<|0|rf_rate|0 - Sense actualització;
10 - 10 segons;
30 - 30 segons;
60 - *(per defecte)* 1 minut;
120 - 2 minuts;
600 - 10 minuts;
900 - 15 minuts.|
|*Grups d'equips*|<|2|groupids.0|ID del [Grup d'equips](/manual/api/reference/hostgroup/get).
Nota: per configurar diversos grups d'equips, creeu un giny de tauler objecte de camp per a cada grup d'equips amb un nombre incrementat al nom de la propietat.
Aquest paràmetre no s'admet si es configura el giny en un [tauler de plantilla](/manual/api/reference/templatedashboard/object).|
|<|*Grups d'equips (Giny)*|1|groupids.\_reference|En lloc de l'ID del [Grup d'equips](/manual/api/reference/hostgroup/get) ID:
`ABCDE._hostgroupids` - establiu un [giny compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (amb el seu paràmetre *Referència* establert a "`ABCDE`") com a font de dades per als grups d'equips.
Aquest paràmetre no és compatible si es configura el giny en un [tauler de plantilla](/manual/api/reference/templatedashboard/object).|
|*Equips*|<|3|hostids.0|[Equip](/manual/api/reference/host/get) ID.
Nota: per configurar diversos equips, creeu un objecte de camp de giny de tauler per a cada equip amb un nombre incrementat al nom de la propietat. Per a diversos equips, el paràmetre *Grups d'equips* no s'ha de configurar pas, o bé s'ha de configurar com a mínim amb un grup d'equips al qual pertanyen els equips configurats.
Aquest paràmetre no s'admet si es configura el giny en un [tauler de plantilla](/manual/api/reference/templatedashboard/object).|
|<|*Equips (Giny/Tauler)*|1|hostids.\_reference|En lloc d'ID d'[Equip](/manual/api/reference/host/get):
`DASHBOARD.hostids` - establiu la [Tria d'*Equip*](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) com a font de dades per als equips;
`ABCDE._hostids` - establiu un [giny compatible](/manual/web_interface/frontend_sections /dashboards/widgets#widget-compatibility) (amb el seu paràmetre *Referència* establert a "`ABCDE`") com a font de dades per als equips.
Aquest paràmetre no s'admet si es configura el giny a una [plantilla tauler de control](/manual/api/reference/templatedashboard/object).|
|*Etiquetes d'equips*|<|<|<|<|
|<|*Tipus d'avaluació*|0|evaltype_host|0 - *(per defecte)* I/O;
2 - O.
Aquest paràmetre no s'admet si es configura el giny en un [tauler de control de plantilla ](/manual/api/reference/templatedashboard/object).|
|^|*Nom de l'etiqueta*|1|host_tags.0.tag|Qualsevol valor de tipus cadena.
Nota: el nombre del nom de la propietat fa referència a l'ordre de l'etiqueta a la llista d'avaluació d'etiquetes.
[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):
- *obligatori* si es configura *etiquetes d'equips*
Aquest paràmetre no s'admet si es configura el giny en un [tauler de plantilla] (/manual/api/reference/templatedashboard/object).|
|^|*Operador*|0|host_tags.0.operator|0 - Conté;
1 - És igual;
2 - No conté;
3 - No és igual;
4 - Existeix;
5 - No existeix.
Nota: el nombre del nom de la propietat fa referència a l'ordre de l'etiqueta a la llista d'avaluació de l'etiqueta.
[Comportament del paràmetre](/manual/api/reference_commentary #parameter-behavior):
- *obligatori* si es configura *etiquetes d'equips*
Aquest paràmetre no s'admet si es configura el giny en un [tauler de plantilla](/manual/api/reference/templatedashboard/object).|
|^|*Valor de l'etiqueta*|1|host_tags.0.value|Qualsevol valor de cadena.
Nota: el nombre del nom de la propietat fa referència a l'ordre de l'etiqueta a la llista d'avaluació d'etiquetes.
[ Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):
- *obligatori* si es configura *etiquetes d'equips*
Aquest paràmetre no s'admet si es configura el giny en un [tauler de plantilla] (/manual/api/reference/templatedashboard/object).|
|*Patrons d'element*|<|1|items.0|[Item](/manual/api/reference/item/get) nom o patró.
Nota: per configurar diversos patrons d'element, creeu un tauler de control objecte camp de giny per a cada patró d'element amb un nombre incrementat al nom de la propietat.
[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):
- *obligatori*|
|*Etiquetes d'element*|<|<|<|<|
|<|*Tipus d'avaluació*|0|evaltype_item|0 - *(per defecte)* I/O;
2 - O.|
|^|*Nom de l'etiqueta*|1|item_tags.0.tag|Qualsevol valor de tipus cadena.
Nota: el nombre del nom de la propietat fa referència a l'ordre de l'etiqueta a la llista d'avaluació d'etiquetes.
[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):
- *obligatori* si s'està configurant *Etiquetes d'element*|
|^|*Operador*|0|item_tags.0.operator|0 - Conté;
1 - És igual;
2 - No conté;
3 - No és igual;
4 - Existeix;
5 - No existeix.
Nota: el nombre del nom de la propietat fa referència a l'ordre de l'etiqueta a la llista d'avaluació de l'etiqueta.
[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):
- *obligatori* si es configura *etiquetes d'element*|
|^|*Valor de l'etiqueta*|1|item_tags.0.value|Qualsevol valor de tipus cadena.
Nota: el nombre del nom de la propietat fa referència a l'ordre de l'etiqueta a la llista d'avaluació d'etiquetes.
[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):
- *obligatori* si s'està configurant *Etiquetes d'element*|
|*Mostra els equips en manteniment*|<|0|manteniment|0 - *(per defecte)* Desactivat;
1 - Activat.|
|*Vista*|<|0|show.0|1 - Etiqueta principal;
2 - Etiqueta secundària.
Nota: per configurar diversos valors, creeu un objecte de camp de giny de tauler per a cada valor amb un nombre incrementat al nom de la propietat.
Per defecte: 1, 2.|
|*Referència*|<|1|referència|Qualsevol valor de cadena que consta de 5 caràcters (p. ex., `ABCDE` o `JBPNL`). Aquest valor ha de ser únic dins del tauler de control al qual pertany el giny.
[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):
- *obligatori*|
[comment]: # ({/03089a26-7a40ed57})
[comment]: # ({57afca55-d25c8205})
#### Configuració avançada
Els següents paràmetres de configuració avançada són compatibles amb el giny *Bresca*.
::: noteclassic
El nombre del nom de propietat *Llindars* (p. ex. thresholds.0.color) fa referència al lloc del llindar en una llista, 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
(com ara `"thresholds.0.threshold":"5"` → `"thresholds.0.threshold":"1"`; `"thresholds.1.threshold":"1"` → `"thresholds.1.threshold": "5"`).
:::
|Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor|
|-----|-|------|-------------------|
|***Etiqueta principal***|<|<|<|
|*Tipus*|0|primary_label_type|0 - *(per defecte)* Text;
1 - Valor.|
|*Text*|1|primary_label|Qualsevol valor de cadena, incloses les macros.
Macros admeses: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, macros d'usuari.
Valor predeterminat: {HOST.NAME}
[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):
- *admès* si *Tipus* s'estableix a "Text"|
|*Nombre de decimals*|0|primary_label_decimal_places|Els valors possibles oscil·len entre 0 i 6.
Per defecte: 2.
[Comportament dels paràmetres](/manual/api/reference_commentary#parameter-behavior) :
- *admès* si *Tipus* s'estableix a "Valor"|
|*Mida* (tipus)|0|tipus_mida_etiqueta_primària|0 - *(per defecte)* Automàtic;
1 - Personalitzat.|
|*Size*|0|primary_label_size|Els valors possibles oscil·len entre 1 i 100.
Per defecte: 20.
[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):
- *admès* si *Mida* (tipus) és establert a "Personalitzat"|
|*Negreta*|0|primary_label_bold|0 - *(per defecte)* Desactivat;
1 - Activat.|
|*Color*|1|primary_label_color|Codi de color hexadecimal (per exemple, `FF0000`).
Per defecte: basat en el `tema` d'[Objecte de configuració](/manual/api/reference/settings/object#settings) i [Objecte d'usuari](/manual/api/reference/user/object#user):
`1F2C33` per a "tema blau" o "hc-light";
`EEEEEE` per a "fosc tema" o "hc-fosc".|
|*Unitats* (casella de selecció)|0|primary_label_units_show|0 - Desactivat;
1 - *(per defecte)* Activat.
[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior) :
- *admès* si *Tipus* s'estableix a "Valor"|
|*Unitats* (valor)|1|primary_label_units|Qualsevol valor de cadena.
`""` (buida)
[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior ):
- *admès* si *Tipus* s'estableix a "Valor" i *Unitats* (casella de selecció) s'estableix a "Activat"|
|*Posició*|0|primary_label_units_pos|0 - Abans del valor;
1 - *(per defecte)* Després del valor.
[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):
- *admès* si *Tipus* s'estableix a "Valor" i *Unitats* (casella de selecció) s'estableix a "Actiu"
Aquest paràmetre s'ignora si s'estableix a una de les següents [unitats de temps relatiu](/manual/config/items/item#configuration): unixtime, uptime, s.|
|***Etiqueta secundària***|<|<|<|
|*Tipus*|0|secondary_label_type|0 - Text;
1 - *(per defecte)* Valor.|
|*Text*|1|secondary_label|Qualsevol valor de cadena, incloses les macros.
Macros admeses: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, macros d'usuari.
Valor per defecte: {{ITEM.LASTVALUE}.fmtnum(2)}
[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):
- *admès* si *Tipus* és establert a "Text"|
|*Llocs decimals*|0|secondary_label_decimal_places|Els valors possibles oscil·len entre 0 i 6.
Per defecte: 2.
[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior) :
- *admès* si *Tipus* s'estableix a "Valor"|
|*Mida* (tipus)|0|secondary_label_size_type|0 - *(per defecte)* Automàtic;
1 - Personalitzat.|
|*Size*|0|secondary_label_size|Els valors possibles oscil·len entre 1 i 100.
Per defecte: 30.
[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):
- *admès* si *Mida* (tipus) és establerta a "Personalitzat"|
|*Negreta*|0|secondary_label_bold|0 - Desactivat;
1 - *(per defecte)* Activat.|
|*Color*|1|secondary_label_color|Codi de color hexadecimal (per exemple, `FF0000`).
Per defecte: basat en el `tema` d'[objecte de configuració](/manual/api/reference/settings/object#settings ) i [Objecte d'usuari](/manual/api/reference/user/object#user):
`1F2C33` per a "tema blau" o "hc-light";
`EEEEEE` per a "fosc tema" o "hc-fosc".|
|*Unitats* (casella de selecció)|0|secondary_label_units_show|0 - Desactivat;
1 - *(per defecte)* Activat.
[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior) :
- *admès* si *Tipus* s'estableix a "Valor"|
|*Unitats* (valor)|1|secondary_label_units|Qualsevol valor de cadena.
`""` (buida)
[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior ):
- *admès* si *Tipus* s'estableix a "Valor" i *Unitats* (casella de selecció) s'estableix a "Activat"|
|*Posició*|0|secondary_label_position|0 - Abans del valor;
1 - *(per defecte)* Després del valor.
[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):
- *admès* si *Tipus* s'estableix a "Valor" i *Unitats* (casella de selecció) s'estableix a "Actiu"
Aquest paràmetre s'ignora si s'estableix a una de les següents [unitats relacionades amb el temps](/manual/config/items/item#configuration): unixtime, uptime, s.|
|***Color de fons***|<|<|<|
|*Color de fons*|1|bg_color|Codi de color hexadecimal (p. ex., `FF0000`).
Per defecte: basat en el `tema` d'[Objecte de configuració](/manual/api/reference/settings/object# settings) i [Objecte d'usuari](/manual/api/reference/user/object#user):
`D9E7ED` per a "tema blau";
`3D5059` per a "tema fosc";
`AAD7E9` per a "hc-light";
`335463` per a "hc-dark".|
|***Llindars***|<|<|<|
|*Interpolació de colors*|0|interpolation|0 - Inhabilitat;
1 - *(per defecte)* Activat.|
|*Color*|1|thresholds.0.color|Codi de color hexadecimal (p. ex., `FF0000`).|
|*Llindar*|1|thresholds.0.threshold|Qualsevol valor numèric. Els [sufixos](/manual/apèndix/sufixos) (p. ex., "1d", "2w", "4K", "8G") són compatibles.|
[comment]: # ({/57afca55-d25c8205})
[comment]: # ({05e301d7-c6f49883})
### Exemples
Els exemples següents només tenen com a objectiu descriure la configuració dels objectes de camp del giny del tauler de control per al giny *Bresca*. Per obtindre més informació sobre la configuració d'un tauler, veieu [`dashboard.create`](/manual/api/reference/dashboard/create).
[comment]: # ({/05e301d7-c6f49883})
[comment]: # ({18033898-0cace4a6})
#### Configuració d'un giny *Bresca*
Configureu un giny *Bresca* que ensenyi l'ús dels processos del servidor Zabbix.
A més, canvieu l'etiqueta principal de les cel·les de bresca i ajusteu visualment el giny amb llindars.
[Petició](/manual/api#performing-requests):
```json
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": "30",
"auto_start": "1",
"pages": [
{
"widgets": [
{
"type": "honeycomb",
"name": "Honeycomb",
"x": "0",
"y": "0",
"width": "8",
"height": "5",
"view_mode": "0",
"fields": [
{
"type": 2,
"name": "groupids.0",
"value": 4
},
{
"type": 3,
"name": "hostids.0",
"value": 10084
},
{
"type": 1,
"name": "items.0",
"value": "Zabbix server: Utilization*"
},
{
"type": 1,
"name": "primary_label",
"value": "{ITEM.NAME}"
},
{
"type": 1,
"name": "thresholds.0.color",
"value": "0EC9AC"
},
{
"type": 1,
"name": "thresholds.0.threshold",
"value": "0"
},
{
"type": 1,
"name": "thresholds.1.color",
"value": "FFD54F"
},
{
"type": 1,
"name": "thresholds.1.threshold",
"value": "70"
},
{
"type": 1,
"name": "thresholds.2.color",
"value": "FF465C"
},
{
"type": 1,
"name": "thresholds.2.threshold",
"value": "90"
},
{
"type": 1,
"name": "reference",
"value": "KSTMQ"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}
```
Resposta:
```json
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}
```
[comment]: # ({/18033898-0cace4a6})
[comment]: # ({e9d30322-b52eec61})
### Veieu també
- [Camp de giny de tauler](/manual/api/reference/dashboard/object#dashboard-widget-field)
- [`dashboard.create`](/manual/api/reference/dashboard/create)
- [`dashboard.update`](/manual/api/reference/dashboard/update)
[comment]: # ({/e9d30322-b52eec61})