[comment]: # ({38b63d3a-e5b69436})
# 1 Registre d'accions

[comment]: # ({/38b63d3a-e5b69436})

[comment]: # ({099dbeb6-7950f8a2})
### 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
[*Registre d'accions*](/manual/web_interface/frontend_sections/dashboards/widgets/action_log) 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 *Registre d'accions*, consulteu el comportament dels paràmetres que es descriuen a les taules següents.
:::

[comment]: # ({/099dbeb6-7950f8a2})

[comment]: # ({351a02b1-74bdffdc})
### Paràmetres

Els paràmetres següents són compatibles amb el giny *Registre d'accions*.

|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.|
|*Destinataris*|<|11|identificacions d'usuari|[Usuari](/manual/api/reference/user/get) ID.<br><br>Nota: per configurar diversos usuaris, creeu un objecte de camp de giny de tauler per a cada usuari.|
|*Accions*|<|12|actionids|[Acció](/manual/api/reference/action/get) ID.<br><br>Nota: per configurar diverses accions, creeu un objecte de camp de giny del tauler de control per a cada acció.|
|*Tipus de suport*|<|13|mediatypeids|[Tipus de suport](/manual/api/reference/mediatype/get) ID.<br><br>Nota: per configurar diversos tipus de suport, creeu un objecte de camp de giny de tauler per a cada tipus de suport.|
|*Estat*|<|0|estats|0 - En curs;<br>1 - Enviat/Executat;<br>2 - Ha fallat.<br><br>Nota: per configurar diversos valors, creeu un objecte de camp de giny de tauler per a cada valor.|
|*Cadena de cerca*|<|1|missatge|Qualsevol valor de cadena.|
|*Període de temps*|<|1|time_period.\_reference|`DASHBOARD._timeperiod` - establiu la [tria de *Període de temps*](/manual/web_interface/time_period_selector) com a origen de dades;<br>`ABCDE._timeperiod` - definiu un [giny compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (amb el seu paràmetre de *Referència* establert a "`ABCDE`") com a orígen de dades.<br><br>Per defecte: `DASHBOARD._timeperiod`<br><br>Alternativament, 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 sintaxi absoluta (`YYYY-MM-DD hh:mm:ss`) o [relativa](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Comportament de la propietat](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si *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 sintaxi absoluta (`YYYY-MM-DD hh:mm:ss`) o [relativa](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.).<br><br>Comportament de la propietat](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si *Període de temps* no és pas definit<br>- *obligatori* si s'ha definit `time_period.from`.|
|*Ordenar les entrades per*|<|0|sort_triggers|3 - Temps (creixent);<br>4 - *(per defecte)* Temps (decreixent);<br>5 - Tipus (ascendent);<br>6 - Tipus ( descendent);<br>7 - Estat (creixent);<br>8 - Estat (decreixent);<br>11 - Destinatari (ascendent);<br>12 - Destinatari (descendent).|
|*Mostra les línies*|<|0|mostra_línies|Els valors vàlids van d'1 a 100.<br><br>Per defecte: 25.|

[comment]: # ({/351a02b1-74bdffdc})

[comment]: # ({211d52e5-2dd9270a})
### 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 *Registre d'accions*. Per obtindre més informació sobre la configuració d'un tauler, veieu [`dashboard.create`](/manual/api/reference/dashboard/create).

[comment]: # ({/211d52e5-2dd9270a})

[comment]: # ({93e6111e-bf9fdcfc})
#### Configurar un giny de *registre d'acció*

Configureu un giny de *Registre d'acció* que ensenyi 10 entrades dels detalls d'operacions d'acció, ordenats per data (en ordre ascendent).
A més, ensenya detalls només per aquelles operacions que han provat d'enviar correu-e a l'usuari "1", però ha fallat.

[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": "actionlog",
                        "name": "Action log",
                        "x": 0,
                        "y": 0,
                        "width": 12,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 0,
                                "name": "show_lines",
                                "value": 10
                            },
                            {
                                "type": 0,
                                "name": "sort_triggers",
                                "value": 3
                            },
                            {
                                "type": 11,
                                "name": "userids.0",
                                "value": 1
                            },
                            {
                                "type": 13,
                                "name": "mediatypeids.0",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "statuses.0",
                                "value": 2
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}
```

Resposta:

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

[comment]: # ({/93e6111e-bf9fdcfc})

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