Акције

Акције су одговорне за 'business logic' модула. Акција се обично састоји од контролера и [action view] (views#action-view).

Модул може:

• Позивати акције које су већ дефинисане у Zabbix корисничком интерфејсу.
• Заменити подразумеване акције прилагођеним акцијама.
• Дефинисати потпуно нове акције.

Да бисте заменили подразумевано понашање акције неким прилагођеним понашањем, дефинишите акцију са истим именом у конфигурацији модула. Када се акција позове, акција модула ће бити извршена уместо подразумеване Zabbix акције.

Датотеке акција треба да се чувају у датотеци actions. Акције треба да буду наведене у manifest.json.

Контролер

Ток рада контролера акција:

1) Проверите да ли су сви параметри прослеђени у HTTP захтеву важећи:

• Позовите метод контролера checkInput()
• Користите правила валидације дефинисана у CNewValidator.php
• Позовите метод validateInput()

2) Проверите корисничке дозволе.

3) Припремите податке према прослеђеним параметрима: ако checkInput() врати тачно, Zabbix позива метод doAction() контролера.

4) Припремите низ $data за приказ. Користите методе CControllerResponseData и setResponse() да бисте сачували одговор у низу $data.

Пример:

/**
 * 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));
}