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](visualizações#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.

Controller

Fluxo de trabalho do controller de ação:

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

• Chame o método checkInput() do controller
• 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 doAction() do controller.

4) Prepare o array $data para a view. Use CControllerResponseData e o método setResponse() para armazenar a resposta no array $data.

Exemplo:

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

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

/**
 * Executa a ação e gera o objeto 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));
}