Акције

Акције су одговорне за '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));
       }