Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
Essa ferramenta permite adicionar ou alterar alguns eventos /e ações que ocorrem em momentos específicos do sistema (servidor ou cliente). Para adicionar ou editar um evento /ou ação , é necessário apontar para um bloco de programação previamente criado.
Os campos de Eventos permitem executar uma nova ação antes ou após o evento escolhido, enquanto que um evento específico. Já os campos de Ações, substituem uma ação padrão do Cronapp por uma nova criada pelo desenvolvedor, alterando a regra padrão da ação.
Criar ou editarAdicionar eventos e ações
Para abrir a ferramenta, clique em Projetos > Eventos e Ações no menu do sistema (Figura 1).
Image Modified
Figura 1 - Janela de eventos e ações
- Nome do evento ou da ação;.
- Campo que informa o bloco selecionado para o evento ou ação;ou ação.
- Selecionar um bloco de programação existente: seleciona um abre o bloco de programação existente, podendo ser servidor ou cliente dependendo do respectivo evento ou ação;Abrir ou criar um bloco de programação: abre o bloco previamente selecionado ou cria um novo bloco na área de edição da IDE, podendo ser servidor ou cliente dependendo do respectivo evento ou ação;ou permite criar um novo. Dependendo da Ação / Evento, é possível selecionar blocos clientes ou servidores.
- Limpar: remove o bloco selecionado de programação do respectivo campo selecionado.
Eventos
Os campos de eventos permitem adicionar uma nova ação antes ou após alguns momentos específicos. Na janela de Eventos e Ações (Figura 1) são encontrados os seguintes eventosNa 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 | Esse evento sempre ocorre Executa após rodar ou debugar a aplicação em tempo de desenvolvimento na IDE durante o desenvolvimento e ou ao iniciar o servidor da aplicação em produção. |
Depois de fazer login | Servidor e Cliente | Esse evento sempre ocorre Executa após algum usuário logar na aplicação. |
Depois de fazer logout | Servidor | Esse evento sempre ocorre Executa após algum usuário sair da aplicação. |
Ao criar sessão | Servidor | Esse evento sempre ocorre Executa após iniciar uma sessão entre a aplicação e o servidor. |
Ao destruir sessão | Servidor | Esse evento sempre ocorre Executa após finalizar uma sessão entre a aplicação e o servidor. |
Depois de carregar uma página | Cliente | Esse evento sempre ocorre Executa após uma página da aplicação ser carregada. |
Depois de carregar a página login | Cliente | Esse evento sempre ocorre Executa após a página de |
Depois de carregar a página principal | Cliente | Esse evento sempre ocorre Executa após a página |
Nota |
---|
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 já possuem um comportamento padrão do Cronapp. Porém, é possível alterar o comportamento padrão ao vincular ações permitem substituir ações padrões dos projetos Cronapp por uma regra definida em um bloco de programação ao campo. Caso Ao desvincular o bloco seja desvinculado, o padrão do Cronapp do campo, a ação padrão da fonte de dados volta a assumir a açãoo controle.
Na janela de Eventos e Ações (Figura 1) são encontradas as seguintes ações:.
Evento | Blocos aceitos | Fonte de dados Substituída | Retorno da função | Descrição | |
---|---|---|---|---|---|
Para autenticarAutenticar | Servidor | Autenticar | Lista de usuários | Faz a autenticação dos usuários ao logar na aplicação. 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 Obter Grupos de acessoAcesso | 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 | alterar senhaServidorAção chamada quando o usuário solicita a troca de senha no modal Mudar Senha das aplicações web ou mobile. | |
Para configurar Configurar conexão | ServidorAção que recebe uma função responsável por estabelecer uma conexão com o banco de dados configurado, usando o bloco Configurar Conexão | 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. |
Substituição de Fonte de dados
A maioria dos campos de ações permitem substituir uma fonte de dados (padrão do Cronapp) associada àquele recurso por um bloco de programação. Por exemplo, o campo Para Obter Visão do Permissionável substitui a Fonte de dados Obter Views do Permissionável que retorna uma lista de páginas em que o permissionável X possui permissão de acesso na aplicação Y. Dessa forma, a regra da fonte de dados Obter Views do Permissionável será substituída pela regra contida no bloco de programação associado.
No exemplo fictício abaixo, após um usuário com o perfil "Administrators" logar na aplicação, ele só terá acesso a página principalhome
(home.view.html
), pois, na primeira condição do bloco se, é gerado uma lista que contém apenas o objeto view da página home
, ao tentar acessar outra página, será direcionado para a página de acesso proibido 403
(Endereço: /error/403.view.html
). Os demais perfis que acessarem o sistema seguirão a mesma regra padrão, contida no bloco de programação Abrir Consulta, onde retorna uma lista de objetos view.
Image Added
Figura 2.1 - Exemplo de função para a ação Para Obter Visão do Permissionável
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.2).
Image Added
Figura 2.2 - 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 (exemplo: local, saml e outros). O tipo "local" é o padrão, usado pelo Cronapp.
- password: senha do usuário.
- userDetails: informações sobre o usuário.
- 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
Índice maxLevel 3