01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

Necessidade de realizar melhorias no processo de integração de cadastros PLS com o HAT.

03. SOLUÇÃO

Implementada melhoria com a disponibilização da possibilidade de realizar a comunicação de cadastro do PLS com o HAT através Jobs inicializados pelo appserver.ini.

Este ajuste é uma alternativa a utilização do Schedule de comunicação PLENVHAT, assim o cliente pode decidir por qual processo ele deseja enviar os dados cadastrais do PLS para o HAT. Caso o método adotado seja a utilização de Jobs, recomendamos desabilitar o Schedule PLENVHAT.

Funcionamento dos jobs:

Com a utilização de jobs, diferentemente do Schedule que processava os registros por Alias, os jobs sempre vão buscar os registros sem processamento mais antigos independentes da API. Cada thread processa um registro por vez, tentando realizar a comunicação com a API da HAT.

Caso a comunicação não possa ser realizada por algum motivo, o sistema incrementará o campo Qtde Tentat. (BNV_QTDTRY). O sistema reinicializa os registros que não teve sucesso ao comunicar a cada 2 minutos para solicitações Post, 5 minutos para Get e realiza 5 tentativas para cada registro. Após as 5 tentativas, o sistema ignora esse registro para não gerar problemas de controle de fila tentando enviar a todo tempo, um registro que já apresentou problemas no envio 5 vezes. É possível posteriormente, realizar o envio manualmente deste registro na rotina Pedidos PLS x HAT (PLSA274).

O job continua realizando o controle de enviar primeiramente um registro para sua API correspondente com o verbo POST para incluir o mesmo na fila de processamento do HAT, e posteriormente, uma comunicação GET para verificar se o registro já foi processado pelo HAT com sucesso.

[PLSHAT]
ENVIRONMENT=PLS27
INSTANCES=1,1
main=PJobPlsHat

[OnStart]
jobs=HTTP,HTTPJOB,PLSHAT
RefreshRate=120

[PLS27]
SourcePath=C:\PLS27\rpo
RootPath=C:\PLS27\ProtheusData                 
StartPath=\System
RpoLanguage=Portuguese
RpoVersion=120
RpoDb=TOP
LocalFiles=CTREE
localdbextension=.DTC
SpecialKey=PLS27
dbDataBase=MSSQL
dbServer=localhost
dbALIAS=P12127MNTDBEXP
dbPort=7890
TOPMemoMega=1
JEMP=T1
JFIL=M SP 01 
EMPROBOXML=T1
FILROBOXML=M SP 01 
OPEPLSTOHAT=0001

04. DEMAIS INFORMAÇÕES

MUDANÇA NOS LOGS

Foi implementado também, uma melhoria nos logs do processo. Como o processo pode utilizar várias threads, foi criado uma estrutura de separação dos dados no modelo .CSV com separação das colunas com o caracter ;

O log plshat.log pode ser encontrado em \ProtheusData\logpls\[Data de Processamento].

Exemplo:

Para ler o log com precisão, utilize uma ferramenta de leitura de CSVs. Abaixo, é apresentado o passo-a-passo no Microsoft Excel:

Acesse Dados/De Texto:

Selecione o arquivo plshat.log:

Selecione opção Delimitado:

Em Delimitadores selecione Ponto e vírgula:

Marque todas as colunas com a opção Texto, clique em Concluir.

Selecione todos os registros e clique em Classificar. Adicione as colunas em Ordem: A, B, C e D:

Os registros são apresentados com as colunas na ordem:

1. Identificador Único
2. Número do Pedido (BNV_CODIGO)
3. Número da Thread que processou o registro
4. Horário do processamento
5. Mensagem do Processamento

Com essa organização, é possível ler o log com facilidade separando cada processamento.

05. ASSUNTOS RELACIONADOS

• Dicionário de dados atualizado:

Novos Campos SX3:

Tabela BNV:

Tabela BA0:

Pastas (folders) SXA:

Parâmetros SX6:

Observação: esse parâmetro habilita a geração do log plshatservice.log na pasta \ProtheusData\logpls\[Data de Processamento]. Ele é gerado no modelo CSV descrito no na sessão 04 deste documento.