Skip to main content

Worker

Sobre

O Worker é o responsável por fazer todo o processamento de: Extração, Transformação e Carga (ETL) dos dados contidos nos arquivos; Sendo um dos principais motores do BN Simulator, seu funcionamento é vital para que tudo ocorra como o esperado!

Pré-requisitos

Se ainda não instalou o CLI do Simulador faça os Primeiros Passos

Serviço de Liquidação de Cartões (SLC)

Com a criação do SLC (Sistema de Liquidação Centralizada), que estabeleceu a centralização da compensação e liquidação das ordens eletrônicas de débito e crédito em grade única.

Saiba mais sobre o SLC

Se você ainda não esta por dentro deste sistema de liquidação clique aqui para saber mais.

Tipo de arquivos

Atualmente existem 3 tipos liquidações:

Arquivo CIPArquivo BancoDescrição
ASLC027ASLC028Debito
ASLC029ASLC030Credito
ASLC031ASLC034Antecipação

Fluxo dos arquivos

Cada arquivo SLC possui diretorios de entrada distintos, no qual o mortor de processamento Worker fica monitorando constantemente; Sempre que há arquivo, o mesmo é identificado e realizado o processamento, gerando os seguintes arquivos de saida PRO e RET ou ERR

E.G.: Definição dos arquivos

Arquivos de saidaDescrição
PROArquivo de protocolo
RETArquivo de retorno
ERRArquivo de erro

E.G.: Definição dos diretorios

LayoutInput folderOutput folder
ASLC027.xml/slc/credito/input/aslc027.xml/slc/credito/retorno-banco/aslc028.xml
/slc/credito/retorno-cip/aslc027_RET.xml
/slc/credito/retorno-cip/aslc027_PRO.xml
/slc/credito/retorno-cip/aslc027_ERR.xml
ASLC029.xml/slc/credito/input/aslc029.xml/slc/credito/retorno-banco/aslc030.xml
/slc/credito/retorno-cip/aslc029_RET.xml
/slc/credito/retorno-cip/aslc029_PRO.xml
/slc/credito/retorno-cip/aslc029_ERR.xml
ASLC031.xml/slc/credito/input/aslc031.xml/slc/credito/retorno-banco/aslc034.xml
/slc/credito/retorno-cip/aslc031_RET.xml
/slc/credito/retorno-cip/aslc031_PRO.xml
/slc/credito/retorno-cip/aslc031_ERR.xml

Alterando arquivo de configuração

ATENÇÃO

Não recomendamos alterar as configurações do CLI diretamente no arquivo de configurações; Esta ação é por risco e conta do usuario.

Recomendamos que seja feita as configurações via comando; Acesse a guia de Comandos para saber mais.

Apontamento de diretorios

Para o correto funcionamento do motor de processamento, devemos apontar quais são os diretorios dos arquivos a serem lidos e quais são os diretorios onde os arquivos processados serão devolvidos.

No diretorio de instalação do CLI acesse worker/resources/ localize e abra o arquivo app_config.ini, agora basta reapontar os diretorios para que o Worker se adapte ao seu ambiente;

Definição da seção psql

É responsavel por armazenar todas as configurações de conexão com o banco de dados.

worker/resources/app_config.ini
[psql]
host = lv-dev.betternow.com.br
port = 5433
database = rebatedor_slc_cip
schema = slc
username = postgres
password = postgres
VariavelDescrição
hostEndereço do servidor de banco de dados
portPorta do servidor de banco de dados
databaseRepositorio DB
schemaschema padrão do DB
usernameusuario DB
passwordsenha DB
Dica

Essa configuração pode ser feita ao executar o Worker via linha de comandos. clique aqui para saber mais.

Definição das seções aslc027, aslc029 e aslc031

São responsaveis por definir os diretorios onde os arquivos SLC será disponibilizado e onde será salvo os arquivos de retorno CIP e define tambem a codificação dos arquivos.

worker/resources/app_config.ini
[aslc027]
local_input_files = SLC\ASLC027\Input\
local_processed_files = SLC\ASLC027\Processados\
local_output_files = SLC\ASLC027\Retorno_CIP\
xsd_ret = resources/xsd_aslc/ASLC027.xsd
xsd_pro = resources/xsd_aslc/ASLC027PRO.xsd
xsd_err = resources/xsd_aslc/ASLC027ERR.xsd
schema_location = http://www.cip-bancos.org.br/ARQ/ASLC027.xsd
pro_schema_location = http://www.cip-bancos.org.br/ARQ/ASLC027PRO.xsd
err_schema_location = http://www.cip-bancos.org.br/ARQ/ASLC027ERR.xsd
ret_model = resources/models/ASLC027_00000000_00000000_00000_RET.xml
pro_model = resources/models/ASLC027_00000000_00000000_00000_PRO.xml
err_model = resources/models/ASLC027_00000000_00000000_00000_ERR.xml
encoding = utf-8

[aslc029]
local_input_files = SLC\ASLC029\Input\
local_processed_files = SLC\ASLC029\Processados\
local_output_files = SLC\ASLC029\Retorno_CIP\
xsd_ret = resources/xsd_aslc/ASLC029.xsd
xsd_pro = resources/xsd_aslc/ASLC029PRO.xsd
xsd_err = resources/xsd_aslc/ASLC029ERR.xsd
schema_location = http://www.cip-bancos.org.br/ARQ/ASLC029.xsd
pro_schema_location = http://www.cip-bancos.org.br/ARQ/ASLC029PRO.xsd
err_schema_location = http://www.cip-bancos.org.br/ARQ/ASLC029ERR.xsd
ret_model = resources/models/ASLC029_00000000_00000000_00000_RET.xml
pro_model = resources/models/ASLC029_00000000_00000000_00000_PRO.xml
err_model = resources/models/ASLC029_00000000_00000000_00000_ERR.xml
encoding = utf-8

[aslc031]
local_input_files = SLC\ASLC031\Input\
local_processed_files = SLC\ASLC031\Processados\
local_output_files = SLC\ASLC031\Retorno_CIP\
xsd_ret = resources/xsd_aslc/ASLC031.xsd
xsd_pro = resources/xsd_aslc/ASLC031PRO.xsd
xsd_err = resources/xsd_aslc/ASLC031ERR.xsd
schema_location = http://www.cip-bancos.org.br/ARQ/ASLC031.xsd
pro_schema_location = http://www.cip-bancos.org.br/ARQ/ASLC031PRO.xsd
err_schema_location = http://www.cip-bancos.org.br/ARQ/ASLC031ERR.xsd
ret_model = resources/models/ASLC031_00000000_00000000_00000_RET.xml
pro_model = resources/models/ASLC031_00000000_00000000_00000_PRO.xml
err_model = resources/models/ASLC031_00000000_00000000_00000_ERR.xml
encoding = utf-8
VariavelDescrição
local_input_filesDeve conter o caminho onde o Worker irá capturar os arquivos ASLC0XX.
local_processed_filesDeve conter o caminho no qual o processo irá mover os arquivos já processados.
local_output_filesDeve conter o caminho no qual será salvo os arquivos de retorno.
xsd_retApontamento do arquivo de definição do layout
xsd_proApontamento do arquivo de definição do layout
xsd_errApontamento do arquivo de definição do layout
schema_locationSchema location do layout do arquivo
pro_schema_locationSchema location do layout do arquivo
err_schema_locationSchema location do layout do arquivo
ret_modelApontamento do arquivo modelo do layout
pro_modelApontamento do arquivo modelo do layout
err_modelApontamento do arquivo modelo do layout
encodingcodificação dos arquivos de saida

Definição das seções aslc028, aslc030 e aslc034

São responsaveís por definir diretorio onde será salvo os arquivos de retorno banco e define a codificação dos arquivos de saida.

worker/resources/app_config.ini
[aslc028]
local_output_files = SLC\ASLC028\Retorno_Banco\
xsd_banco = resources/xsd_aslc/ASLC028.xsd
schema_location = http://www.cip-bancos.org.br/ARQ/ASLC028.xsd
banco_model = resources/models/ASLC028_00000000_00000000_00000.xml
encoding = utf-8

[aslc030]
local_output_files = SLC\ASLC030\Retorno_Banco\
xsd_banco = resources/xsd_aslc/ASLC030.xsd
schema_location = http://www.cip-bancos.org.br/ARQ/ASLC030.xsd
banco_model = resources/models/ASLC030_00000000_00000000_00000.xml
encoding = utf-8

[aslc034]
local_output_files = SLC\ASLC034\Retorno_Banco\
xsd_banco = resources/xsd_aslc/ASLC034.xsd
schema_location = http://www.cip-bancos.org.br/ARQ/ASLC034.xsd
banco_model = resources/models/ASLC034_00000000_00000000_00000.xml
encoding = utf-8
VariavelDescrição
local_output_filesDeve conter o caminho no qual o processo irá salvar os arquivos de retorno do banco
xsd_bancoApontamento do arquivo de definição do layout
schema_locationSchema location do layout do arquivo
banco_modelApontamento do arquivo modelo do layout
encodingcodificação dos arquivos de saida
Variaveis de ambiente

Tambem é possivel criar variaveis de ambiente para definir um diritorio;

Para isso basta criar uma variavel com nome da seção + '_' + 'nome_da_variavel'.

E.G. aslc029_local_input_files