Áú»¢¶Ä²©

Accions

Les accions s¨®n responsables de la 'l¨°gica de negoci' del m¨°dul. Una acci¨® normalment consta d'un controlador i una vista d'acci¨®.

Un m¨°dul pot:

• Fer accions de crides que s¨®n definides a la interf¨ªcie de Áú»¢¶Ä²©.
• Substitu?r les accions predeterminades amb accions personalitzades.
• Definir accions totalment noves.

Per anul¡¤lar un comportament d'acci¨® predeterminat amb un comportament personalitzat, definiu una acci¨® amb el mateix nom a la configuraci¨® del m¨°dul. Quan es cridi l'acci¨®, s'executar¨¤ l'acci¨® del m¨°dul en lloc de l'acci¨® Áú»¢¶Ä²© predeterminada.

Els fitxers d'acci¨® s'han d'emmagatzemar a la carpeta actions. Les accions s'han d'especificar al manifest.json.

°ä´Ç²Ô³Ù°ù´Ç±ô¡¤±ô²¹»å´Ç°ù

Flux de treball del controlador d'acci¨®:

1. Comproveu que tots els par¨¤metres passats en una petici¨® HTTP siguin v¨¤lids:

• Crideu al m¨¨tode checkInput() del controlador
• Empreu les regles de validaci¨® definides a CNewValidator.php
• Crideu al m¨¨tode validateInput()

2. Comproveu els permisos dels usuaris.

3. Prepareu les dades segons els par¨¤metres passats: si checkInput() retorna cert, Áú»¢¶Ä²© crida al m¨¨tode doAction() del controlador.

4. Prepareu la matriu $data per a la vista. Empreu el m¨¨tode CControllerResponseData i setResponse() per emmagatzemar la resposta a la matriu $data.

Exemple:

/**
        * Validaci¨® dels par¨¤metres d'entrada.
        *
        * @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;
       }
       
       /**
        * Comproveu els permisos dels usuaris.
        *
        * @return bool
        */
       protected function checkPermissions() {
           return $this->getUserType() >= USER_TYPE_ZABBIX_ADMIN;
       }
       
       /**
        * Executar acci¨® i generar objecte de resposta.
        */
       protected function do Action(): void {
           $data = [ 
               'hosts_count' => API::Host()->get([
                   'countOutput' => true,
                   'filter' => [
                       'status' => $this->getInput('status')
                   ]
               ]) 
           ];
           
           $this->setResponse(new CControllerResponseData($data));
       }