[comment]: # aside:2

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

Za 'logikę biznesową' modułu odpowiadają akcje. Akcja zwykle składa się z [controller](#controller) i [action view](viewv#action-view). 

Moduł może: 

- Wywołać akcje, które są już zdefiniowane w interfejsie frontowym Zabbix.
- Zastąpić akcje domyślne akcjami niestandardowymi.
- Zdefiniować zupełnie nowe akcje.

Aby zastąpić domyślne zachowanie akcji jakimś niestandardowym zachowaniem, zdefiniuj akcję o tej samej nazwie w konfiguracji modułu. 
Kiedy akcja zostanie wywołana, zamiast domyślnej akcji Zabbix'a zostanie wykonana akcja modułu. 

Pliki akcji powinny być przechowywane w folderze *akcje*. Akcje muszą być określone w pliku [manifest.json](manifest).

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

[comment]: # ({aed2c24e-348a3343})
### Controller

Przepływ pracy kontrolera akcji:

1. Sprawdź, czy wszystkie parametry przekazane w żądaniu HTTP są poprawne:
- Wywołaj metodę *checkInput()* kontrolera;
- Użyj reguł walidacji zdefiniowanych w CNewValidator.php;
- Wywołaj metodę *validateInput()*.

2. Sprawdź uprawnienia użytkownika.

3. Przygotuj dane zgodnie z przekazanymi parametrami: jeśli *checkInput()* zwróci true, Zabbix wywoła metodę *doAction()* kontrolera.

4. Przygotuj tablicę **$data** dla widoku. Użyj *CControllerResponseData* oraz metody *setResponse()*, aby zapisać odpowiedź w tablicy **$data**.

Przykład:

````php
/**
 * Validate input parameters.
 *
 * @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;
}

/**
 * Check user permissions.
 *
 * @return bool
 */
protected function checkPermissions() {
    return $this->getUserType() >= USER_TYPE_ZABBIX_ADMIN;
}

/**
 * Execute action and generate response object.
 */
protected function do Action(): void {
    $data = [ 
        'hosts_count' => API::Host()->get([
            'countOutput' => true,
            'filter' => [
                'status' => $this->getInput('status')
            ]
        ]) 
    ];
    
    $this->setResponse(new CControllerResponseData($data));
}
````

::: notetip
Pełną listę dostępnych klas kontrolerów można zobaczyć w [kodzie źródłowym](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/ui/app/controllers?at=refs%2Fheads%2Frelease%2F7.4) Zabbixa.
:::

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