[comment]: # ({09f5b760-2be71f02})
# 11 Prototipus de gràfic

[comment]: # ({/09f5b760-2be71f02})

[comment]: # ({42eb93ed-4ce2099a})
### 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
[*Prototipus de gràfic*](/manual/web_interface/frontend_sections/dashboards/widgets/graph_prototype) 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 *Prototipus de gràfic*, consulteu el comportament dels paràmetres que es descriuen a les taules següents.
:::

[comment]: # ({/42eb93ed-4ce2099a})

[comment]: # ({30d7fc2f-83184d1c})
### Paràmetres

Els paràmetres següents s'admeten al giny *Prototip gràfic*.

|Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor|
|-----|-|------|-------------------|
|*Interval d'actualització*|<|0|rf_rate|0 - Sense actualització;<br>10 - 10 segons;<br>30 - 30 segons;<br>60 - *(per defecte)* 1 minut;<br>120 - 2 minuts;<br>600 - 10 minuts;<br>900 - 15 minuts.|
|*Font*|<|0|source_type|2 - *(per defecte)* Prototip de gràfic;<br>3 - Prototip de gràfic simple.|
|*Prototip de gràfic*|<|7|grafid.0|[Prototip de gràfic](/manual/api/reference/graphprototype/get) ID.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior) :<br>- *obligatori* si *Font* s'ha establert a "Prototip de gràfics"|
|*Prototip d'element*|<|5|itemid.0|[Prototip d'element](/manual/api/reference/itemprototype/get) ID.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior) :<br>- *obligatori* si *Font* s'ha establert a "Prototip de gràfic simple"|
|*Període de temps*|<|1|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 ` - estableix un [giny compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (amb el seu paràmetre *Referència* definit a "`ABCDE`") com a font de dades.<br><br> Per defecte: `DASHBOARD._timeperiod`<br><br>Com alternativa, podeu establir el període de temps només als paràmetres *Des de* i *Fins a*.|
|<|*Des de*|1|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) sintaxi temporal (`ara` , `now/d`, `now/w-1w`, etc.).<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si *El període de temps* no és pas definit<br>- *obligatori* si s'ha definit `time_period.to`.|
|^|*Fins a*|1|time_period.to|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`) , `now/d`, `now/w-1w`, etc.).<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si *El període de temps* no és pas definit<br>- *obligatori* si s'ha definit `time_period.from`.|
|*Mostra la llegenda*|<|0|mostra la llegenda|0 - Desactivat;<br>1 - *(per defecte)* Activat.|
|*Substitueix l'equip*|<|1|override_hostid.\_reference|`ABCDE._hostid` - estableix 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;<br>`DASHBOARD._hostid` - establiu el tauler [tria d'*Equip*](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) com la font de dades dels equips.<br><br>Aquest paràmetre no s'admet si es configura el giny en un [tauler de plantilla](/manual/api/reference/templatedashboard/object).|
|*Columnes*|<|0|columns|Els valors possibles oscil·len entre 1 i 24.<br><br> Per defecte: 2.|
|*Fileres*|<|0|rows|Els valors possibles oscil·len entre 1 i 16.<br><br> Per defecte: 1.|
|*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.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori*|

[comment]: # ({/30d7fc2f-83184d1c})

[comment]: # ({bc39c20a-df884afa})
### 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 *Prototip de gràfic*. Per obtindre més informació sobre la configuració d'un tauler, veieu [`dashboard.create`](/manual/api/reference/dashboard/create).

[comment]: # ({/bc39c20a-df884afa})

[comment]: # ({247e9c9f-826a8d29})
#### Configurar un giny de *Prototip de gràfic*

Configura un giny de *Prototip de gràfic* que ensenya una graella de 3 gràfics (3 columnes, 1 filera) creada des d'un prototip d'element (ID: "42316") per una descoberta de baix nivell.

[Petició](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "El meu tauler",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "graphprototype",
                        "name": "Prototip de gràfic",
                        "x": 0,
                        "y": 0,
                        "width": 16,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 0,
                                "name": "source_type",
                                "value": 3
                            },
                            {
                                "type": 5,
                                "name": "itemid",
                                "value": 42316
                            },
                            {
                                "type": 0,
                                "name": "columns",
                                "value": 3
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}
```

Resposta:

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

[comment]: # ({/247e9c9f-826a8d29})

[comment]: # ({e9d30322-46917953})
### 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-46917953})