Műveletek

A műveletek felelősek a modul 'üzleti logikájáért'. Egy művelet általában egy vezérlőből és egy művelet nézetből áll.

Egy modul képes:

• A Zabbix kezelőfelületén már meghatározott műveletek meghívására.
• Az alapértelmezett műveletek felülbírálására egyéni műveletekkel.
• Teljesen új műveletek meghatározására.

Egy alapértelmezett műveleti viselkedés bizonyos egyéni viselkedéssel történő felülbírálásához adjon meg egy azonos nevű műveletet a modulkonfigurációban. A művelet meghívásakor a modulművelet kerül végrehajtásra az alapértelmezett Zabbix művelet helyett.

A műveletfájlokat az actions mappában kell tárolni. A műveleteket a manifest.json fájlban kell megadni.

Controller

Action controller workflow:

1) Check that all parameters passed in an HTTP request are valid:

• Call the controller's checkInput() method
• Use validation rules defined in CNewValidator.php
• Call validateInput() method

2) Check user permissions.

3) Prepare the data according to passed parameters: if checkInput() returns true, Zabbix calls the controller's doAction() method.

4) Prepare the $data array for the view. Use CControllerResponseData and setResponse() method to store response in the $data array.

Example:

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