Essa
janela apresenta algunsferramenta permite adicionar ou alterar eventos e ações que
o usuário pode definir para a IDE e para a aplicação através de blocos de programação.Criar eventos e ações
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
Ao clicar em Para abrir a ferramenta, clique em Projetos > Eventos e Ações no menu do sistema , sua janela será aberta (Figura 1).
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 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 da respectiva 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 da respectiva 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
Na tabela abaixo temos a lista
Figura 1 - Janelade eventos
e açõesEventos
Um evento nada mais é que um resultado de uma ação que é reconhecida pela aplicação, podendo ser manipulada. Na janela de Eventos e Ações (Figura 1) são encontrados os seguintes eventos que podem ser manipulados:
Depois de iniciar sistema: criado somente com blocos servidores, esse evento sempre ocorredisponí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 |
ser carregada. |
| Depois de carregar a página principal |
| Cliente | Executa após a página |
|
ser carregada |
. |
| 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 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
Ações
Uma ação nada mais é que uma forma de realizar uma determinada tarefa. Na janela de Eventos e Ações (Figura 1) são encontradas as seguintes ações:
| Nota | ||
|---|---|---|
| ||
As ações usam o padrão do Cronapp. Ou seja, caso um bloco seja vinculado a qualquer uma das ações listadas, ele vai substituir o padrão; caso o bloco seja desvinculado, o padrão volta a assumir a ação. |
- Para autenticar: criado somente com blocos servidores, essa ação vai ser fazer a autenticação dos usuários que logarem na aplicação;
- Para obter grupos de acesso: criado somente com blocos servidores, essa ação vai fazer
- Para alterar senha: criado somente com blocos servidores, essa ação vai ser fazer a troca de senha dos usuários que utilizarem essa funcionalidade.
| Informações | ||
|---|---|---|
| ||
As ações para obter id do multi-inquilino e para alterar tema estão depreciadas. |
.
| 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 Nessa página
Índice maxLevel 3