v.5.70 - Robôs

Em Serviços você encontrará uma aba chamada de Robô, na qual você visualizará os robôs cadastrados na plataforma, bem como cadastrar novos robôs para executar atividades automáticas de tempos em tempos na sua Plataforma Lecom. Para chegarmos até o conteúdo Robôs, devemos seguir o seguinte caminho:

  1. Clique no último ícone da Barra de pesquisa, em seguida, Studio.

2. Já na tela do Studio, clique em Modelador, em seguida, Serviços.

3. Clique em Robôs.

Ao clicar em “Robôs”, você encontrará, à esquerda, uma área com todos os robôs já existentes e como criar um novo partindo do zero. Neste menu, podemos encontrar os seguintes itens: Novo, Iniciar, Parar, Ver Log, conheça o conteúdo de cada um.

Ao acessar o item Robôs, encontramos um robô já cadastrado com as informações padrão da plataforma, chamado de “ServerWorkflow”. Seu objetivo é, de tempos em tempos, executar o envio automático de e-mails para os usuários, de acordo com a mudança de status das atividades “em alerta” ou “em atraso”. Clicando sobre o arquivo em destaque na imagem, todas as informações ficam disponíveis ao lado direito.

 

Para cadastrarmos um novo Robô, basta clicar no botão “Novo” e preencher todos os campos para cadastrar e configurar a realização dos serviços.

Para cadastrar o novo Robô é necessário colocar um nome para o mesmo no campo “Nome Biblioteca”, depois, escolher a opção “Upload”, pois, a partir da versão 5.40, os robôs devem ser cadastrados fazendo upload do arquivo “.JAR”. Existe um campo chamado de “Inativo”, lembrando que, se você não marcar nada, o Robô ficará ativado, ao marcar essa opção ele ficará “Inativo”. Após esse campo, se você já selecionou a opção “Upload”, um campo “Arquivo” será disponibilizado para fazer o upload do arquivo. Clique em “Escolher”, localizar o arquivo no seu computador do tipo .JAR e clicar em abrir. Quando aparecer o nome do arquivo correto, basta clicar em “Enviar” para que o arquivo possa ser incluído na Plataforma Lecom

Após realizar o “Upload” do arquivo do robô, os campos “Nome da Classe” e “Versão” já serão apresentados automaticamente, pois, o sistema irá buscar essas informações no arquivo. 

No campo “Descrição da Biblioteca” você poderá colocar informações específicas sobre o robô que você está cadastrando. 

Na versão 5.50 temos uma novidade sobre a configuração do tempo de execução do robô. Agora, ele pode ser programado para entrar em ação por horário, intervalos de tempo, dias, semanas, meses ou ano. Além da maneira simplificada de agendamento, é possível utilizar um recurso mais avançado de agendamento que utiliza a validação de expressões Cron para um agendamento preciso. Veja como é simples:

  1. No item Tempo de Execução, clique sobre o botão Editar;

 

2. Surgirá o menu Tempo de execução, no qual poderemos escolher a cada quanto tempo o robô entrará em ação;

Note que, no topo do menu, três opções foram apresentadas: Simples, Avançado (Beta) e Lista de Exemplos.

 

A opção Simples nos permite configurar o robô podendo escolher sobre os intervalos de tempo e frequência. Por exemplo, caso queiramos que o robô envie um e-mail, diariamente, para os usuários lembrando de tarefas atrasadas, sempre às 8:00, devemos, primeiramente, selecionar a opção Dia, em seguida, o número 1. Por último, digite o horário desejado para que a plataforma dispare a mensagem. Clique em Concluir.

 

É possível, também, agendar um intervalo dessa execução, definindo, inclusive, quantas vezes o robô deverá entrar em ação dentro desse período selecionado. Por exemplo, caso queiramos que o robô dispare um determinando e-mail a cada 20 minutos entre 8:00 e 09:59 devemos, inicialmente, alterar a opção Executar às para Executar entre e, em seguida, definir o restante das informações, conforme a imagem a seguir.

 

A opção Avançado (Beta) nos permite configurar o robô por meio de uma expressão Cron, que nada mais é do que uma expressão usada para configurar instâncias específicas de um acionador. Principalmente para o acionamento repetitivo agendado.

Na opção Lista de exemplos é possível encontrar programações pré-organizadas para facilitar nosso trabalho, podendo escolher entre opções tanto simples quanto avançadas com um único clique.

 

Ao final da configuração do tempo do robô, clique em Concluir.

Após o cadastro do tempo, o robô entrará em operação conforme o tempo marcado. Como no exemplo a seguir, o robô realizará a ação da qual foi programado a cada 1 hora.  

 

São apresentados, também, os campos de “Modelistas permitidos” e “Proprietários”. Para dar permissão para um usuário modelista, basta clicar em frente ao campo “Modelistas permitidos”, no botão “Selecionar”, uma janela será aberta para que você possa pesquisar os usuários que terão permissão. Coloque no campo “Pesquisar” o nome do usuário, quando ele aparecer na lista, clique sobre o nome dele e clique em “Incluir”. Você poderá repetir esses passos para cadastrar outros usuários. Ao terminar essa ação, basta clicar em “Salvar” para que os modelistas incluídos possam ter permissões de uso do robô cadastrado. 

Além da permissão do modelista, é necessário informar o proprietário. No campo “Proprietário” você deverá selecionar o usuário que é proprietário do robô. 

Em “Nível de log” você tem a opção de escolher qual o nível de informação que pretende apresentar no “Log” do robô. Você poderá escolher apresentar Log somente com um erro fatal, selecionando “Fatal” ou até apresentar todas as informações selecionando “All”. Essas opções são cumulativas, o que representa que se escolher “Info”, por exemplo, você está escolhendo essa opção e todas as anteriores. 

Além de definir o “Nível de log”, temos que selecionar também no campo “Tamanho máximo do arquivo de log (Kb)”, isso significa que o log será apresentado respeitando o tamanho do arquivo. E a “Quantidade máxima de arquivo de log”, nessa opção você coloca a quantidade de arquivos de log que pretende deixar gravado na plataforma. Se colocar 5, por exemplo, ao gerar o sexto arquivo, a plataforma apaga a primeira e deixa os últimos 5 arquivos mais atuais. 

 

Terminando de cadastrar todas as informações, basta clicar no botão “Salvar” para que o robô possa ser cadastrado com sucesso. 

Após clicar em “Salvar”, uma mensagem será apresentada: “Robô salvo com sucesso” e o robô será apresentado ao lado esquerdo da tela na área de “Robôs”

Caso não tenha o desejo de manter o robô cadastrado, basta acessar a área de “Robôs” no lado esquerdo da tela e selecionar o robô que deseja excluir. Com o robô selecionado, basta clicar no botão “Excluir” e o robô será excluído.