Ações

As ações são responsáveis pela 'lógica de negócios' do módulo. Uma ação geralmente consiste em um controlador e uma visualização de ação.

Um módulo pode:

• Chamar ações já definidas no frontend do Zabbix.
• Sobrepor ações padrão com ações personalizadas.
• Definir ações completamente novas.

Para substituir um comportamento de ação padrão por algum comportamento personalizado, defina uma ação com o mesmo nome na configuração do módulo. Quando a ação é chamada, a ação do módulo será executada em vez da ação padrão do Zabbix.

Os arquivos de ação devem ser armazenados na pasta actions. Ações precisam ser especificadas no manifest.json.

Controlador

Workflow do controlador de ação:

1. Verifique se todos os parâmetros passados em uma requisição HTTP são válidos:

• Chame o método do controlador checkInput()
• Use as regras de validação definidas em CNewValidator.php
• Chame o método validateInput()

2. Verifique as permissões do usuário.

3. Prepare os dados de acordo com os parâmetros passados: se checkInput() retornar true, o Zabbix chama o método do controlador doAction().

4. Prepare o array $data para a visualização. Use os métodos CControllerResponseData e setResponse() para armazenar a resposta no array $data.

Exemplo:

````php /** * Valide os parâmetros de 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;

}

/** * Verifique as permissões do usuário. @return bool */ protected function checkPermissions() { return $this->getUserType() >= USER_TYPE_ZABBIX_ADMIN; }

/** * Execute a ação e gere o objeto de resposta. */ protected function doAction(): void { $data = [ 'hosts_count' => API::Host()->get([ 'countOutput' => true, 'filter' => [ 'status' => $this->getInput('status') ] ]) ];

$this->setResponse(new CControllerResponseData($data));

}