[comment]: # ({c1a63b69-8203455f})
# 15 Text pla

[comment]: # ({/c1a63b69-8203455f})

[comment]: # ({554bc026-4f35bb7d})
### 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
[*Text pla*](/manual/web_interface/frontend_sections/dashboards/widgets/plain_text) 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 *Text pla*, consulteu el comportament dels paràmetres que es descriuen a les taules següents.
:::

[comment]: # ({/554bc026-4f35bb7d})

[comment]: # ({b0a4fe17-fc685d34})
### Paràmetres

S'admeten els paràmetres següents per al giny *Text pla*.

|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.|
|*Elements*|4|itemids|ID de l'[Element](/manual/api/reference/item/get) ID.<br><br>Veieu que per configurar elements múltiples, cal crear un objecte de camp de giny de tauler per cada element.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori*|
|*Ubicació d'elements*|0|estil|0 - *(per defecte)* Esquerra;<br>1 - A dalt.|
|*Veure línies*|0|show_lines|Rang vàlid, entre 1-100.<br><br>Per defecte: 25.|
|*Veure text com HTML*|0|show_as_html|0 - *(per defecte)* Desactivat;<br>1 - Activat.|
|*Activar la tria d'equips*|0|dinàmic|0 - *(per defecte)* Desactivat;<br>1 - Activat.|

[comment]: # ({/b0a4fe17-fc685d34})

[comment]: # ({25ce216d-08d24b15})
### 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 *Text pla*. Per obtindre més informació sobre la configuració d'un tauler, veieu [`dashboard.create`](/manual/api/reference/dashboard/create).

[comment]: # ({/25ce216d-08d24b15})

[comment]: # ({b5e6439d-753680ea})
#### Configurar un giny de *Text pla*

Configura un giny de *Text pla* que  ensenya la darrera informació dels elements "42269" i "42253".
A més, configura el nom dels elements per veure'ls damunt de les columnes, i només ensenyarà 15 línies de dades.

[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": "plaintext",
                        "name": "Plain text",
                        "x": 0,
                        "y": 0,
                        "width": 6,
                        "height": 3,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 4,
                                "name": "itemids",
                                "value": 42269
                            },
                            {
                                "type": 4,
                                "name": "itemids",
                                "value": 42253
                            },
                            {
                                "type": 0,
                                "name": "style",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "show_lines",
                                "value": 15
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}
```

Resposta:

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

[comment]: # ({/b5e6439d-753680ea})

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