Essa ferramenta permite adicionar ou alterar eventos e ações que ocorrem em momentos específicos do sistema (servidor ou cliente). Para adicionar um evento ou ação é necessário apontar para um bloco de programação.
Os campos de Eventos permitem executar uma ação antes ou após um evento específico. Já os campos de Ações, substituem uma ação padrão do Cronapp por uma nova, alterando a regra padrão da ação.
Para abrir a ferramenta, clique em Projetos > Eventos e Ações no menu do sistema (Figura 1).
Figura 1 - Janela de eventos e ações
Na tabela abaixo temos a lista de eventos disponíveis e sua descrição. Por padrão, nenhum dos campos de eventos possui blocos de programação vinculados.
Evento | Blocos aceitos | Descrição |
---|---|---|
Depois de iniciar sistema | Servidor | Executa após rodar ou debugar a aplicação em tempo de desenvolvimento na IDE ou ao iniciar o servidor da aplicação em produção. |
Depois de fazer login | Servidor e Cliente | Executa após algum usuário logar na aplicação. |
Depois de fazer logout | Servidor | Executa após algum usuário sair da aplicação. |
Ao criar sessão | Servidor | Executa após iniciar uma sessão entre a aplicação e o servidor. |
Ao destruir sessão | Servidor | Executa após finalizar uma sessão entre a aplicação e o servidor. |
Depois de carregar uma página | Cliente | Executa após uma página da aplicação ser carregada. |
Depois de carregar a página login | Cliente | Executa após a página de |
Depois de carregar a página principal | Cliente | Executa após a página |
Os eventos que utilizam blocos clientes servem para aplicações mobile e web, mas só é possível selecionar para um tipo de aplicação por vez. |
Os campos de ações permitem substituir ações padrões dos projetos Cronapp por uma regra definida em um bloco de programação. Ao desvincular o bloco do campo, a ação padrão da fonte de dados volta a assumir o controle.
Na janela (Figura 1) são encontradas as seguintes ações.
Evento | Blocos aceitos | Fonte de dados Substituída | Retorno da função | Descrição |
---|---|---|---|---|
Para Autenticar | Servidor | Autenticar |
| Faz a autenticação dos usuários ao logar na aplicação. Substitui a autenticação padrão do Cronapp. Essa ação é executada duas vezes, uma no momento de conferir a existência do usuário e a outra no momento de conferir se a senha informada corresponde com a cadastrada. |
Para Obter Grupos de Acesso | Servidor | Gerenciador de Papéis | Lista de papéis (grupos/roles) | Obtém os grupos de acesso (papéis/role) existentes na permissão de segurança. |
Para Obter Permissionável do Usuário | Servidor | Obter Autorização do Usuário | Lista de permissionáveis (securable) | Obtém os permissionáveis definidos para o usuário. |
Para Obter Visão do Permissionável | Servidor | Obter Views do Permissionável | Lista de views | Obtém as views com autorização de acesso para o permissionável. |
Para Obter Permissionáveis do Papel | Servidor | Obter Autorização do Papel | Lista de permissionáveis (securable) | Obtém os permissionáveis vinculados ao papel (grupos/roles). |
Para Alterar Senha | Servidor | Não se aplica | Não se aplica | Ação chamada quando o usuário solicita a troca de senha no modal Mudar Senha das aplicações web ou mobile. |
Para Configurar conexão | Servidor | Não se aplica | Objeto de conexão JDBC | Essa ação espera receber um objeto de conexão JDBC para permitir alterar o banco de dados configurado a partir de uma regra definida na função. Veja mais detalhes em Configurar Conexão. |
Ao selecionar um bloco de programação com parâmetros, o preenchimento desses parâmetros segue as mesmas regras das constantes da Fonte de dados (acesse o tópico "Constantes e Parâmetros" da documentação da Fonte de dados para mais detalhes) e exibirá todas as constantes globais. Porém, alguns campos de ações possuem constantes específicas, como a ação Para Alterar Senha, que possui as constantes "oldPassword", "newPassword" e "newPasswordConfirmation" (Figura 2.1).
Figura 2.1 - Seleção de constantes que serão passadas para os parâmetros da função
Lista de constantes específicas para cada ação:
Nesta página