[comment]: # ({65c03452-e03ef403})
# 15 Cartão de item

[comment]: # ({/65c03452-e03ef403})

[comment]: # ({50641221-cb7939c5})
### Descrição

Esses parâmetros e os possíveis valores de propriedade para os respectivos objetos de campo do widget de dashboard permitem configurar o widget [*Item card*](/manual/web_interface/frontend_sections/dashboards/widgets/item_card) nos métodos `dashboard.create` e `dashboard.update`.

::: noteimportant
As propriedades `fields` do widget não são validadas durante a criação ou atualização de um dashboard.
Isso permite que os usuários modifiquem [widgets internos](/manual/web_interface/frontend_sections/dashboards/widgets) e criem [widgets personalizados](/devel/modules/tutorials/widget), mas também introduz o risco de criar ou atualizar widgets incorretamente.
Para garantir a criação ou atualização bem-sucedida do widget *Item card*, consulte o comportamento do parâmetro descrito nas tabelas abaixo.
:::

[comment]: # ({/50641221-cb7939c5})

[comment]: # ({8318f93b-b004895d})
### Parâmetros

Os seguintes parâmetros são suportados para o widget *Item card*.

|Parâmetro|<|[tipo](/manual/api/reference/dashboard/object#dashboard-widget-field)|nome|valor|
|-|--------|--|--------|-------------------------------|
|*Intervalo de atualização*|<|0|rf_rate|0 - Sem atualização;<br>10 - 10 segundos;<br>30 - 30 segundos;<br>60 - *(padrão)* 1 minuto;<br>120 - 2 minutos;<br>600 - 10 minutos;<br>900 - 15 minutos.|
|*Item*|<|4|itemid.0|ID do [Item](/manual/api/reference/item/get).<br><br>[Comportamento do parâmetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obrigatório* se *Item (Widget)* não estiver definido|
|<|*Item (Widget)*|1|itemid.\_reference|Em vez do ID do [Item](/manual/api/reference/item/get):<br>`ABCDE._itemid` - defina um [widget compatível](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (com seu parâmetro *Referência* definido como "`ABCDE`") como a fonte de dados para o item.<br><br>[Comportamento do parâmetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obrigatório* se *Item* não estiver definido|
|*Mostrar*|<|0|sections.0|0 - Descrição;<br>1 - Texto de erro;<br>2 - Métricas;<br>3 - Últimos dados;<br>4 - Tipo de informação;<br>5 - Triggers;<br>6 - Interface do host;<br>7 - Tipo;<br>8 - Inventário do host;<br>9 - Tags.<br><br>Nota: O número no nome da propriedade faz referência à ordem da seção na lista de seções. Para configurar várias seções, crie um objeto de campo de widget de dashboard para cada seção com um número incrementado no nome da propriedade.|
|*Substituir host*|<|1|override_hostid.\_reference|`ABCDE._hostid` - defina um [widget compatível](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (com seu parâmetro *Referência* definido como "`ABCDE`") como a fonte de dados para hosts;<br>`DASHBOARD._hostid` - defina o [seletor de host](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) do dashboard como a fonte de dados para hosts.<br><br>Padrão: `""` (vazio)<br><br>Este parâmetro não é suportado se o widget estiver sendo configurado em um [dashboard de template](/manual/api/reference/templatedashboard/object).|

[comment]: # ({/8318f93b-b004895d})

[comment]: # ({6fb91e67-7444d2e3})
#### Sparkline

Os seguintes parâmetros são suportados se *Mostrar* estiver definido como "Últimos dados".

|Parâmetro|<|[tipo](/manual/api/reference/dashboard/object#dashboard-widget-field)|nome|valor|
|-|--------|--|--------|-------------------------------|
|*Largura*|<|0|sparkline.width|Os valores possíveis variam de 0 a 10.<br><br>Padrão: 1.|
|*Preenchimento*|<|0|sparkline.fill|Os valores possíveis variam de 0 a 10.<br><br>Padrão: 3.|
|*Cor*|<|1|sparkline.color|Código de cor hexadecimal (por exemplo, `FF0000`).<br><br>Padrão: `42A5F5`.|
|*Período de tempo*|<|1|sparkline.time_period.\_reference|`DASHBOARD._timeperiod` - define o [seletor de período de tempo](/manual/web_interface/time_period_selector) do dashboard como fonte de dados;<br>`ABCDE._timeperiod` - define um [widget compatível](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (com seu parâmetro `reference` igual a `ABCDE`) como fonte de dados.<br><br>Padrão: `""` (vazio)<br><br>Alternativamente, você pode definir o período de tempo apenas nos parâmetros *De* e *Até*.|
|<|*De*|1|sparkline.time_period.from|String de tempo válida em sintaxe absoluta (`YYYY-MM-DD hh:mm:ss`) ou [relativa](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.).<br><br>Padrão: now-1h.<br><br>[Comportamento do parâmetro](/manual/api/reference_commentary#parameter-behavior):<br>- *suportado* se *Período de tempo* não estiver definido<br>- *obrigatório* se `sparkline.time_period.to` estiver definido|
|^|*Até*|1|sparkline.time_period.from|String de tempo válida em sintaxe absoluta (`YYYY-MM-DD hh:mm:ss`) ou [relativa](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.).<br><br>Padrão: now.<br><br>[Comportamento do parâmetro](/manual/api/reference_commentary#parameter-behavior):<br>- *suportado* se *Período de tempo* não estiver definido<br>- *obrigatório* se `time_period.to` estiver definido|
|*Dados de histórico*|<|0|sparkline.history|0 - *(padrão)* Automático;<br>1 - Histórico;<br>2 - Tendências.|

[comment]: # ({/6fb91e67-7444d2e3})

[comment]: # ({7148225f-f146ed91})
### Exemplos

Os exemplos a seguir têm como objetivo descrever apenas a configuração dos objetos de campo do widget do painel para o widget *Item card*.
Para obter mais informações sobre como configurar um painel, consulte [`dashboard.create`](/manual/api/reference/dashboard/create).

[comment]: # ({/7148225f-f146ed91})

[comment]: # ({a1691adf-3e0437fc})
#### Configurando um widget *Item card*

Configure um widget *Item card* que exibe estas seções: "Descrição", "Últimos dados", "Triggers" e "Tags".

[Requisição](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "itemcard",
                        "name": "Item card",
                        "x": 0,
                        "y": 0,
                        "width": 14,
                        "height": 7,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 4,
                                "name": "itemid.0",
                                "value": 42257
                            },
                            {
                                "type": 0,
                                "name": "sections.0",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "sections.1",
                                "value": 3
                            },
                            {
                                "type": 0,
                                "name": "sections.2",
                                "value": 5
                            },
                            {
                                "type": 0,
                                "name": "sections.3",
                                "value": 9
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}
```

Resposta:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "dashboardids": [
            "3"
        ]
    },
    "id": 1
}
```

[comment]: # ({/a1691adf-3e0437fc})

[comment]: # ({e9d30322-25bd508b})
### Veja também

-   [Campo de widget do dashboard](/manual/api/reference/dashboard/object#dashboard-widget-field)
-   [`dashboard.create`](/manual/api/reference/dashboard/create)
-   [`dashboard.update`](/manual/api/reference/dashboard/update)

[comment]: # ({/e9d30322-25bd508b})