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.
Adicionar eventos e ações
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
- Nome do evento ou ação.
- Campo que informa o bloco selecionado para o evento ou ação.
- Selecionar um bloco de programação existente: abre o bloco de programação ou permite criar um novo. Dependendo da Ação / Evento, é possível selecionar blocos clientes ou servidores.
- Limpar: remove o bloco de programação do campo selecionado.
Eventos
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.
Ações
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. |
Constantes de parâmetros
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:
- Para Autenticar
- authType: informa o tipo de autenticação (configurações de autenticação) usado pelo usuário, pode retornar os seguintes tipos:
- facebook: login via rede social Facebook;
- linkedin: login via rede social Linkedin;
- google: login via rede social Google;
- github: login via rede social Github;
- cronapp: login via Cronapp;
- token (local): autenticação via Token;
- normal: autenticação via Sessão;
- activeDirectory: autenticação via Active Directory;
- ldap: autenticação via LDAP / LDAPS;
- saml: autenticação via SAML;
- sso: autenticação via SSO.
- password: senha do usuário.
- userDetails: objeto do tipo UserDetails, preenchido com os dados obtidos até então.
- authType: informa o tipo de autenticação (configurações de autenticação) usado pelo usuário, pode retornar os seguintes tipos:
- Para Obter Permissionável do Usuário
- securableName: o permissionável necessário para a ação executada pelo usuário.
- Para Obter Visão do Permissionável
- securableName: o permissionável necessário para a ação executada pelo usuário.
- Para Obter Permissionáveis do Papel
- rolename: o grupo (também chamado de papel ou role) necessário para a ação executada pelo usuário.
- Para Alterar Senha
- oldPassword: valor preenchido pelo usuário no campo "Senha Anterior" do modal Mudar Senha.
- newPassword: valor preenchido pelo usuário no campo "Nova Senha" do modal Mudar Senha.
- newPasswordConfirmation: valor preenchido pelo usuário no campo "Confirmação" do modal Mudar Senha.
- Para Configurar Conexão
- connection: informa o namespace configurado no Diagrama de dados.
Nesta página