[comment]: # ({d220a982-0158bee8})
# 12 Valor do item
[comment]: # ({/d220a982-0158bee8})
[comment]: # ({f0bf3b77-90997d6a})
### Descrição
Esses parâmetros e os possíveis valores de propriedade para os respectivos objetos de campo de widget de painel permitem configurar o widget [*Item value*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/item_value) nos métodos `dashboard.create` e `dashboard.update` .
::: noteimportant
As propriedades do campo Widget `fields` não são validadas
durante a criação ou atualização de um dashboard.
Isso permite que os usuários configurem widgets integrados[built-in widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) e criem widgets personalizados [custom widgets](/manual/modules#developing-modules), mas também introduz o risco de criar ou atualizar widgets de forma incorreta.
Para garantir a criação ou atualização bem-sucedida do widget *Valor do item*, consulte os requisitos dos parâmetros descritos nas tabelas abaixo.
:::
[comment]: # ({/f0bf3b77-90997d6a})
[comment]: # ({7ebf36a4-c637d90d})
### Parâmetros
Os seguintes parâmetros são suportados para o widget *Valor do Item*.
|Parâmetro|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|nome|valor|
|-----|-|-----|-------------------|
|*Intervalo de Atualização*|0|rf_rate|0 - Sem atualização;
10 - 10 segundos;
30 - 30 segundos;
60 - *(padrão)* 1 minuto;
120 - 2 minutos;
600 - 10 minutos;
900 - 15 minutos.|
|***Item***
(obrigatório)|4|itemid|[Item](/manual/api/reference/item/get) ID.|
|*Show*|0|Show|1 - Descrição;
2 - Valor;
3 - Tempo;
4 - Indicador de mudança.
Padrão: 1, 2, 3, 4 (todos habilitados).
Note: Para configurar múltiplos valores, crie um objeto de campo de widget de painel para cada valor.|
|*Item Dinâmico*|0|dynamic|0 - *(padrão)* Desativado;
1 - Habilitado.|
|*Configuração avançada*|0|adv_conf|0 - *(padrão)* Desativado;
1 - Habilitado.|
[comment]: # ({/7ebf36a4-c637d90d})
[comment]: # ({6c4a776f-db4b24d9})
#### Configuração avançada
Os seguintes parâmetros são suportados se a *Configuração avançada* estiver definida como "Habilitada".
|Parâmetro|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|nome|valor|
|-|--------|--|--------|-------------------------------|
|*Cor de fundo*|<|1|bg_color|Código de cor hexadecimal (por exemplo, `FF0000`).
Padrão: `""` (vazio).|
[comment]: # ({/6c4a776f-db4b24d9})
[comment]: # ({afead1c7-078914fc})
##### Descrição
Os seguintes parâmetros são suportados se a *Configuração Avançada* estiver definida como "Habilitada", e *Mostrar* estiver definido como "Description".
|Parâmetro|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|nome|valor|
|-----|-|-----|-------------------|
|*Description*|1|description|Qualquer valor de string, incluindo macros.
Macros suportados: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, Macros de usuário.
Padrão: {ITEM.NAME}.|
|*Posição Horizontal*|0|desc_h_pos|0 - Esquerda;
1 - *(padrão* Center;
2 - Direita.
Dois ou mais elementos (Description, Valor, Tempo) não podem compartilhar a mesma *Posição Horizontal* e *Posição Vertical*.|
|*Posição Vertical|0|desc_v_pos|0 - Superior;
1 - Meio;
2 - *(Padrão)* Inferior.
Dois ou mais elementos (Description, Valor, Tempo) não podem compartilhar a mesma *Posição Horizontal* e *Posição Vertical*.|
|*Tamanho*|0|desc_size|Valores válidos variam de 1-100.
Padrão: 15.|
|*Negrito*|0|desc_bold|0 - *(padrão)* Desativado;
1 - Habilitado.|
|*Cor*|1|desc_color|Código de cor hexadecimal (Por exemplo, `FF0000`).
Padrão: `""` (vazio).|
[comment]: # ({/afead1c7-078914fc})
[comment]: # ({1c933529-ef72e1ef})
##### Valor
Os seguintes parâmetros são suportados se a *Configuração Avançada* estiver definida como "Habilitada", e *Mostrar* estiver definido como "Valor".
|Parâmetro|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|nome|valor|
|-|--------|--|--------|-------------------------------|
|*Casas Decimais*|<|<|<|<|
|<|*Casas Decimais*|0|decimal_places|Valores válidos variam de 1-10.
Padrão: 2.|
|^|*Tamanho*|0|decimal_size|Valores válidos variam de 1-100.
Padrão: 35.|
|*Posição*|<|<|<|<|
|<|*Posição Horizontal*|0|value_h_pos|0 - Esquerda;
1 - *(padrão)* Centro;
2 - Direita.
Dois ou mais elementos (Descrição, Valor, Tempo) não podem compartilhar a mesma *Posição horizontal* e *Posição vertical*.|
|^|*Posição Vertical*|0|value_v_pos|0 - Superior;
1 - *(padrão)* Meio;
2 - Inferior.
Dois ou mais elementos (Descrição, Valor, Tempo) não podem compartilhar a mesma *Posição horizontal* e *Posição vertical*.|
|^|*Tamanho*|0|value_size|Valores válidos variam de 1-100.
Padrão: 45.|
|^|*Negrito*|0|value_bold|0 - Desativado;
1 - *(padrão)* Habilitado.|
|^|*Cor*|1|value_color|Código de cor hexadecimal (Por exemplo, `FF0000`).
Padrão: `""` (vazio).|
|*Unidades*|<|<|<|<|
|<|*Unidades* (checkbox)|0|units_show|0 - Desativado;
1 - *(padrão)* Habilitado.|
|^|*Unidades* (valor)|1|units|Qualquer valor de string.|
|^|*Posição*|0|units_pos|0 - Antes do valor;
1 - Acima do valor;
2 - *(padrão)* Após o valor;
3 - Abaixo do valor.|
|^|*Tamanho*|0|units_size|Valores válidos variam de 1-100.
Padrão: 35.|
|^|*Negrito*|0|units_bold|0 - Desativado;
1 - *(padrão)* Habilitado.|
|^|*Cor*|1|units_color|Código de cor hexadecimal (Por exemplo, `FF0000`).
Padrão: `""` (vazio).|
[comment]: # ({/1c933529-ef72e1ef})
[comment]: # ({2562b521-1504e2d4})
##### Tempo
Os seguintes parâmetros são suportados se a *Configuração avançada* estiver definida como "Ativada" e *Mostrar* estiver definido como "Tempo".
|Parâmetro|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|nome|valor|
|-----|-|-----|-------------------|
|*Posição Horizontal*|0|time_h_pos|0 - Esquerda;
1 - *(padrão)* Centro;
2 - Direita.
Dois ou mais elementos (Descrição, Valor, Tempo) não podem compartilhar a mesma *Posição horizontal* e *Posição vertical*.|
|*Posição Vertical*|0|time_v_pos|0 - *(padrão)* Dois ou mais elementos (Descrição, Valor, Tempo) não podem compartilhar a mesma *Posição horizontal* e *Posição vertical*|
|*Tamanho*|0|time_size|Valores válidos variam de 1-100.
Padrão: 15.|
|*Negrito*|0|time_bold|0 - *(padrão)* Desativado;
1 - Habilitado.|
|*Cor*|1|time_color|Código de cor hexadecimal (Por exemplo, `FF0000`).
Padrão: `""` (vazio).|
[comment]: # ({/2562b521-1504e2d4})
[comment]: # ({effbeabd-071114d8})
Indicador de mudança
Os seguintes parâmetros são suportados se a *Configuração avançada* estiver definida como "Ativada" e *Mostrar* estiver definido como "Indicador de Mudança".
|Parâmetro|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|nome|valor|
|-----|-|-----|-------------------|
|*Cor da seta de aumento ↑*|1|up_color|Código de cor hexadecimal (Por exemplo, `FF0000`).
Padrão: `""` (vazio).|
|*Cor da seta de redução ↓*|1|down_color|Código de cor hexadecimal (Por exemplo, `FF0000`).
Padrão: `""` (vazio).|
|*Change indicator ↕ color*|1|updown_color|Código de cor hexadecimal (Por exemplo, `FF0000`).
Padrão: `""` (empty).|
[comment]: # ({/effbeabd-071114d8})
[comment]: # ({fd9ac7eb-2dce34b2})
### Exemplos
Os seguintes exemplos têm como objetivo descrever apenas a configuração dos objetos de campo do widget de *Valor do item* para o painel de controle.
Para mais informações sobre como configurar um dashboard, consulte [`dashboard.create`](/manual/api/reference/dashboard/create).
[comment]: # ({/fd9ac7eb-2dce34b2})
[comment]: # ({ac4bca74-98b4043e})
#### Configuranda um widget de *Valor do item*
Configure um widget de *Valor do item* que exiba o valor do item para o item "42266" (Disponibilidade do agente Zabbix). Além disso, ajuste visualmente o widget com várias opções avançadas.
Solicitação:
```json
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "item",
"name": "Item value",
"x": 0,
"y": 0,
"width": 4,
"height": 3,
"view_mode": 0,
"fields": [
{
"type": 4,
"name": "itemid",
"value": 42266
},
{
"type": 0,
"name": "show",
"value": 1
},
{
"type": 0,
"name": "show",
"value": 2
},
{
"type": 0,
"name": "show",
"value": 3
},
{
"type": 0,
"name": "adv_conf",
"value": 1
},
{
"type": 1,
"name": "bg_color",
"value": "D1C4E9"
},
{
"type": 1,
"name": "description",
"value": "Agent status"
},
{
"type": 0,
"name": "desc_h_pos",
"value": 0
},
{
"type": 0,
"name": "desc_v_pos",
"value": 0
},
{
"type": 0,
"name": "desc_bold",
"value": 1
},
{
"type": 1,
"name": "desc_color",
"value": "F06291"
},
{
"type": 0,
"name": "value_h_pos",
"value": 0
},
{
"type": 0,
"name": "value_size",
"value": 25
},
{
"type": 1,
"name": "value_color",
"value": "FFFF00"
},
{
"type": 0,
"name": "units_show",
"value": 0
},
{
"type": 0,
"name": "time_h_pos",
"value": 2
},
{
"type": 0,
"name": "time_v_pos",
"value": 2
},
{
"type": 0,
"name": "time_size",
"value": 10
},
{
"type": 0,
"name": "time_bold",
"value": 1
},
{
"type": 1,
"name": "time_color",
"value": "9FA8DA"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}
```
Resposta:
```json
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}
```
[comment]: # ({/ac4bca74-98b4043e})
[comment]: # ({e9d30322-0dc1c2d5})
### Consulte também
- [Dashboard widget field](/manual/api/reference/dashboard/object#dashboard-widget-field)
- [`dashboard.create`](/manual/api/reference/dashboard/create)
- [`dashboard.update`](/manual/api/reference/dashboard/update)
[comment]: # ({/e9d30322-0dc1c2d5})