Ações

1. Geral

A ferramenta "Ações" no Mitra permite automatizar processos e operações dentro da plataforma por meio da criação de fluxos que consistem em uma sequência de passos. Esses passos são executados em ordem, permitindo desde simples manipulações de dados até integrações complexas.

2. Como Criar uma Ação

2.1. Nome e Grupo

Ao criar uma nova ação, defina um nome para identificá-la e agrupe-a de acordo com sua finalidade ou contexto, facilitando sua organização.

2.2. Adicionando e Gerenciando Passos

Adição de Passos: A ação pode conter vários passos, que serão executados em sequência.

Ordem dos Passos: A ordem dos passos é essencial, pois determina a sequência de execução. Para reordenar, basta clicar e arrastar o passo para a nova posição.

Exclusão de Passos: Para remover um passo, clique com o botão direito sobre ele e selecione "Remover".

2.3. Agendamento de Ações

As ações podem ser agendadas para execução automática usando um código Cron (por exemplo, a cada hora, diariamente).

2.4. Log de Execução

O Mitra gera logs detalhados que registram a execução de cada ação, incluindo informações sobre o usuário que a iniciou, o horário de execução e o resultado de cada passo (sucesso ou falha).

3. Principais Passos de Ação

3.1. Alterar Relacionamento

"Alterar Relacionamento" é um passo simples que permite modificar o relacionamento entre registros de cadastros relacionados.

Configuração:

• Selecione o Cadastro principal.

• Escolha o Cadastro Pai.

• Defina o Conteúdo que deseja alterar no relacionamento.

Exemplo: Para mudar o status de uma tarefa para "Concluído", o cadastro principal seria "Tarefa", o cadastro pai seria "Status" e o conteúdo seria "Concluído".

3.2. Chamar Ação

O passo "Chamar Ação" permite que uma ação execute outra ação previamente configurada para que você possa reutilizar fluxos de passos comuns entre diferentes ações, otimizando o tempo de desenvolvimento e facilitando a manutenção.

3.3. Ir para a Tela

O passo "Ir para a Tela" redireciona o usuário de uma tela para outra dentro do Mitra.

Configuração:

• Escolha a tela de destino.

• Ative a opção "Trazer Seleção" para levar os filtros e seleções da tela atual para a nova tela.

3.4. Recarregar Tela

O passo "Recarregar Tela" é essencial quando uma ação altera dados e você deseja que a interface reflita essas mudanças.

3.5. Filtrar

O passo "Filtrar" é usado para aplicar filtros em cadastros ou registros antes de executar outras operações.

Exemplo: Em um cálculo de folha de pagamento, você poderia filtrar a natureza "Salários" antes de efetivar o cálculo de salários, depois filtrar a natureza de "Benefícios" e efetuar o cálculo.

3.6. Filtrar com Atributo

"Filtrar com Atributo" permite aplicar filtros dinamicamente, baseados em variáveis, ao invés de valores fixos.

Exemplo: Você pode criar um atributo que diz todos os clientes que compraram nos últimos 12 meses e utilizar esse atributo para filtrar sua ação, isso seria impossível no filtro comum, pois ele pediria que você selecionasse os clientes um a um.

3.7. Criar/Alterar Registro

Esse passo permite criar novos registros ou alterar registros existentes em um cadastro. Consulte a documentação da ação "Criar/Alterar Registro" para mais detalhes.

3.8. Enviar E-mails

O passo "Enviar E-mails" automatiza o envio de e-mails personalizados utilizando dados dinâmicos. Consulte a documentação da ação "Enviar E-mails" para mais detalhes.

3.9. Limpar Atributo

O passo "Limpar Atributo" permite limpar o valor de um atributo específico em registros selecionados com base no filtro atual da ação.

3.10. Limpar Cadastro

"Limpar Cadastro" remove registros de um cadastro com base no filtro atual da ação.

3.11. Executar JAR

"Executar JAR" permite executar um código Java personalizado, expandindo as capacidades da plataforma com lógica customizada.

3.12. Rodar Conexão

O passo "Rodar Conexão" permite que você execute conexões previamente configuradas dentro da ação, integrando processos de carregamento de dados em seus fluxos automatizados.

Referência: Para aprender a configurar conexões, seja via CSV ou banco de dados, consulte a documentação "Conexões". Essa documentação fornece orientações detalhadas sobre como criar conexões pelo database.

Uso do Rodar Conexão: Dentro de uma ação, você pode vincular e executar conexões que foram configuradas com SQL. Esse passo é especialmente útil para automatizar processos que envolvem a transferência de grandes volumes de dados entre sistemas.

Exemplo de Aplicação: Processos Diários de Carregamento de Dados

• Imagine que você precisa carregar dados diariamente do seu ERP para o Mitra. Você pode configurar uma série de conexões para serem executadas em sequência, garantindo que todos os dados necessários sejam importados de forma organizada e eficiente.

• Além disso, você pode agendar essa ação usando um código Cron, automatizando completamente o processo de carregamento de dados sem a necessidade de intervenção manual.

Essa abordagem permite que você integre carregamentos de dados complexos diretamente em seus fluxos automatizados, tornando o processo de integração com fontes externas rápido, eficiente e escalável.

3.13. Cálculo

O passo "Cálculo" é utilizado para realizar cálculos numéricos sobre atributos em cadastros.

Configuração:

• Selecione o atributo destino.

• Defina a VIEW que fornecerá os dados para o cálculo.

• Aplique a fórmula desejada para calcular e popular o atributo numérico.

Exemplo: Calcular o valor total de uma proposta baseada na quantidade, valor unitário e percentual de desconto.