[comment]: # aside:2

[comment]: # ({f589b4e2-e31d2e06})
# Действия

Действия отвечают за 'бизнес-логику' модуля. Действие обычно состоит из [controller](#контроллер) и [action view](views#представление-действия).

Модуль может:

- Вызвать действия, которые уже определены в веб-интерфейсе Zabbix.
- Переопределить действия по умолчанию настраиваемыми действиями.
- Определить совершенно новые действия.

Чтобы переопределить поведение действия по умолчанию некоторым пользовательским поведением, определите действие с тем же именем в конфигурации модуля. При вызове действия вместо действия Zabbix по умолчанию будет выполнено действие модуля.

Файлы действий должны храниться в папке *actions*. Действия необходимо указать в файле [manifest.json](manifest).

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

[comment]: # ({aed2c24e-348a3343})
### Контроллер

Рабочий процесс контроллера действия:

1. Проверьте, что все параметры, переданные в HTTP-запросе, допустимы:
- Вызовите метод контроллера *checkInput()*;
- Используйте правила проверки, определенные в CNewValidator.php;
- Вызовите метод *validateInput()*.

2. Проверьте права пользователя.

3. Подготовьте данные в соответствии с переданными параметрами: если *checkInput()* возвращает true, Zabbix вызывает метод контроллера *doAction()*.

4. Подготовьте массив **$data** для представления. Используйте *CControllerResponseData* и метод *setResponse()* для сохранения ответа в массиве **$data**.

Пример:

````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
Полный список доступных классов контроллеров можно посмотреть в [исходном коде](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/ui/app/controllers?at=refs%2Fheads%2Frelease%2F7.4) Zabbix.
:::

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