Os robôs na Plataforma Lecom possibilitam a automação dos fluxos de processos, permitindo a execução de ações automáticas e integrações com fontes externas.

Este template exemplifica um fluxo simples para cancelamento de processos, incluindo o motivo do cancelamento. Ele utiliza o framework RotasOpenAPI, disponibilizado pela nossa equipe de Operações, o que simplifica a execução de chamadas no OpenAPI.

É importante destacar que este template, isoladamente, não atende a um cenário real. Após sua adição ao ambiente, será necessário ajustá-lo para adequá-lo às necessidades específicas do seu caso.

Visão geral

Esta página tem como objetivo exemplificar o funcionamento de um robô simples para cancelamento automático de processos, disponibilizado no marketplace. Para isso, utilizaremos a biblioteca RotasOpenAPI, disponibilizada pelo time de Operações da Lecom.

Arquivo de Configurações (application.properties)

Na pasta resources, encontra-se o arquivo application.properties. Nele, devem ser configurados os seguintes dados:

• Domínio da plataforma,

• API Key do usuário

• Informações do processo a ser cancelado.

• Nome da etapa a ser considerada na busca.

• Datas de inicio e fim a serem consideradas na busca.

• Motivo do cancelamento a ser registrado.

Exemplo de configuração:

DOMAIN=<DOMINIO DA PLATAFORMA>
API_KEY=<CHAVE OPEN API DO USUAIRO>
CODIGO_PROCESSO=<CODIGO DO PROCESSO>
VERSAO_PROCESSO=<VERSAO DO PROCESSO>
NOME_ATIVIDADE=<NOME DA ATIVIDADE PARA CONSULTA>
ATIVIDADES_PERIODO_INICIO=<DATA DE INÍCIO DO PERÍODO PARA CONSULTA>
ATIVIDADES_PERIODO_FIM=<DATA DE TÉRMINO DO PERÍODO PARA CONSULTA>
CAUSA=<MOTIVO DO CANCELAMENTO>

RotasOpenAPIConfig

A classe RotasOpenAPIConfig deve ser configurada com os valores definidos no arquivo application.properties. Isso permite a autenticação com o OpenAPI em todas as requisições realizadas.

Exemplo:

RotasOpenAPIConfig.setDomain(config.getDomain());
RotasOpenAPIConfig.setCredentials(config.getApiKey());

RotasOpenAPI

Primeiramente recuperamos uma lista de ProcessosPendentesUseratravéz do RotasOpenApi, realizando um filtro pelo nos da etapa atual do processo, assim como o período em que o mesma foi iniciada.

ResponseOpenApi<List<ProcessosPendentesUser>> processosPendentes = RotasOpenApi
		.processo()
		.buscarProcessosPendentes()
		.porCodigoProcesso(Integer.valueOf(config.getCodigoProcesso()))
		.porVersaoProcesso(Integer.valueOf(config.getVersaoProcesso()))
		.porNomeAtividade(config.getNomeAtividade())
		.porDataInicioAtividade(config.getAtividadePeriodoInicio(), config.getAtividadePeriodoFim())
		.executar();

Por fim, iteramos sobre a lista retornada, utilizando o RotasOpenApi para cancelar cada processo que se encaixe nos nossos parâmetros de consulta.

for(ProcessosPendentesUser processo : processosPendentes.getContent()){
	ResponseOpenApi<Object> response = RotasOpenApi
			.processo()
			.cancelarProcesso()
			.setCodigoInstancia(processo.getProcessInstanceId())
			.setMotivoCancelamento(config.getCausa())
			.executar();

	if (response.getStatus() != 204) {
		LOGGER.error("Erro executar UPPER_CAMEL. Erros: {}", response.getErros());
		return;
	}

	LOGGER.info("Processo cancelado com sucesso. ID da instância: {}", processo.getProcessInstanceId());

}

Conclusão

Este exemplo demonstrou o funcionamento do template disponibilizado pelo Marketplace para a automação do cancelamento de processos. É importante ressaltar que este é um modelo básico. Após a inclusão deste template na sua plataforma, ele pode ser ajustado conforme as necessidades do seu cenário específico.