Table of Contents

Actions

Дії відповідають за «бізнес-логіку» модуля. Зазвичай дія складається з контролера і перегляду дії.

Модуль може:

  • Викликати дії, які вже визначені у інтерфейсі Zabbix.
  • Замінювати дії за замовчуванням власними діями.
  • Визначати абсолютно нові дії.

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

Файли дій повинні зберігатися в папці actions. Дії потрібно вказати в manifest.json.

Контролер

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

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

  2. Підготуйте дані відповідно до переданих параметрів: якщо checkInput() повертає true, Zabbix викликає метод контролера doAction().

  3. Підготуйте масив $data для перегляду. Використовуйте метод CControllerResponseData і setResponse() для збереження відповіді в масиві $data.

Приклад:

/**
        * Перевірка вхідних параметрів.
        *
        * @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;
       }
       
       /**
        * Перевірка дозволів користувача.
        *
        * @return bool
        */
       protected function checkPermissions() {
           return $this->getUserType() >= USER_TYPE_ZABBIX_ADMIN;
       }
       
       /**
        * Виконати дію та створити об’єкт відповіді.
        */
       protected function $datado Action(): void {
           $data = [
               'hosts_count' => API::Host()->get([
                   'countOutput' => true,
                   'filter' => [
                       'status' => $this->getInput('status')
                   ]
               ])
           ];
           
           $this->setResponse(new CControllerResponseData($data));
       }

Ви можете переглянути повний список доступних класів контролерів у Zabbix початковий код.