[comment]: # aside:2

[comment]: # ({f589b4e2-e31d2e06})
# Accions

Les accions són responsables de la 'lògica de negoci' del mòdul. Una acció normalment consta d'un [controlador](#controller) i una [vista d'acció](views#action-view).

Un mòdul pot:

- Fer accions de crides que són definides a la interfície de Zabbix.
- Substituïr les accions predeterminades amb accions personalitzades.
- Definir accions totalment noves.

Per anul·lar un comportament d'acció predeterminat amb un comportament personalitzat, definiu una acció amb el mateix nom a la configuració del mòdul.
Quan es cridi l'acció, s'executarà l'acció del mòdul en lloc de l'acció Zabbix predeterminada.

Els fitxers d'acció s'han d'emmagatzemar a la carpeta *actions*. Les accions s'han d'especificar al [manifest.json](manifest).

[comment]: # ({/f589b4e2-e31d2e06})

[comment]: # ({17d83096-348a3343})
### Control·lador

Flux de treball del controlador d'acció:

1) Comproveu que tots els paràmetres passats en una petició HTTP siguin vàlids:
- Crideu al mètode *checkInput()* del controlador
- Empreu les regles de validació definides a CNewValidator.php
- Crideu al mètode *validateInput()*

2) Comproveu els permisos dels usuaris.

3) Prepareu les dades segons els paràmetres passats: si *checkInput()* retorna cert, Zabbix crida al mètode *doAction()* del controlador.

4) Prepareu la matriu **$data** per a la vista. Empreu el mètode *CControllerResponseData* i *setResponse()* per emmagatzemar la resposta a la matriu **$data**.

Exemple:

````php
/**
 * Validació dels paràmetres d'entrada.
 *
 * @return bool
 */
protected function checkInput(): bool {
    $ret = $this->validateInput([
        'status' => 'in '.implode(',', [HOST_STATUS_MONITORED, HOST_STATUS_NOT_MONITORED])
    ]);

    if (!$ret) {
        $this->setResponse(new CControllerResponseFatal());
    }

    return $ret;
}

/**
 * Comproveu els permisos dels usuaris.
 *
 * @return bool
 */
protected function checkPermissions() {
    return $this->getUserType() >= USER_TYPE_ZABBIX_ADMIN;
}

/**
 * Executar acció i generar objecte de resposta.
 */
protected function do Action(): void {
    $data = [ 
        'hosts_count' => API::Host()->get([
            'countOutput' => true,
            'filter' => [
                'status' => $this->getInput('status')
            ]
        ]) 
    ];
    
    $this->setResponse(new CControllerResponseData($data));
}
````

::: notetip
Podeu veure la llista completa de les classes de controlador disponibles al [codi font](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/ui/app/controllers?at=refs%2Fheads%2Frelease%2F6.4) de Zabbix.
:::

[comment]: # ({/17d83096-348a3343})