Histórico da Página

...

Possuímos hoje a rotina TAFA618, que realiza a importação de XML para lucros e dividendos dos eventos R-4010 e R-4020.
Como sugestão de melhoria, precisamos preparar a rotina para que seja possível usa-la via schedule.

03. SOLUÇÃO

Foi criado o Job

...

TAFA618 para uso no Schedule, abaixo será descrito um passo a passo para a configuração e também haverá informações sobre as mudanças necessárias para o funcionamento da rotina Via Job:

Foi criado no dicionário a seguinte pergunta na Sx1 para o conteúdo do EvtAdic:

TAFA618S

Tipo Caracter
8 Posições

Configuração do Schedule

Rotina de Schedule Antiga: É necessário preencher o campo "Rotina" com o nome do Job e selecionar os parâmetros.

Image Removed

	Rotina de Schedule Nova: Em agendamento, clique em novo para adicionar um novo agendamento, na tela que aparecera na sequencia, informe o nome do Job "TAFA618", e clique em avançar.
Image Added	Image Added
Em Parâmetros, Preencha o campo

...

ideEvAdic:	A primeira tela que aparecera, será a configuração do agendamento, na próxima tela, a de parametrização, é necessário informar o ideEvAdic:
Image Added	Image Added
Com isso, basta escolher a recorrência e clicar em Image Modified, o Job estará configurado.

...

Com isso, basta concluir as configurações do agendamento, e iniciar os serviços Task Manager e Queue Manager:
Image Added	Image Added

Após concluir a configuração, basta iniciar os serviços do Agent e Schedule e o Job estará funcionando conforme a recorrência escolhida.

Informações
Para saber mais sobre as configurações de Schedule, consulte os links Schedule-1 e Schedule-2.

Diretório da Pasta

A importação via rotina "TAFA618"através do menu, permite que seja escolhida uma pasta com os tanto no servidor quanto local para a importação dos arquivos .xml para a importação, já na chamada por Job esse processo funciona um pouco diferente, sendo necessário a criação da pasta 'xml_import' na estrutura da Protheus_Data com o nome 'xml_import'para o funcionamento correto do Job.

Informações
Caso a pasta 'xml_import' não seja criada manualmente, a mesma será criada na primeira execução do Job.

...

Nessa pasta, deverá ser colocado os arquivos .xml de lucros e dividendos para os eventos R-4010 e R-4020 para a importação, ficando da seguinte forma:

Console

ConsoleApós o passo, basta iniciar os serviços do Agent e Schedule e o Job estará funcionando conforme a recorrência escolhida.

no menu do TAF no caminho: Modulo 84 → Miscelanea → Integração → Import. XML Lucros e Dividendos.
Essa nova rotina ira fazer a importação dos XML's encaminhados pelos bancos, e as informações passadas nos XML's serão gravadas nas tabelas espelhos do TAF, conforme o evento da Efd Reinf, podendo ser o R-4010 (Pagamentos/Créditos a Beneficiário PF) ou o evento R-4020 (Pagamentos/Créditos a Beneficiário PJ).
Após esses dados estarem gravados nas tabelas espelho do TAF, os eventos poderão ser transmitidos através do Painel Reinf.

Image Removed

Funcionamento da Rotina:
Ao acessar a rotina, será solicitado dois parâmetros, o primeiro será a escolha do diretório onde os arquivos XML's estão armazenados e o segundo o identificador da importação (EvtAdic), ambos obrigatórios:

Protheus

Image Removed

Importante que a pasta com os arquivos seja selecionada e após isso, seja selecionada a opção de Salvar.

Image Removed

Diretório com os arquivos

Image Removed

Ao clicar em Finalizar, será apresentado uma tela confirmando se deseja realmente iniciar o processo, clicando em SIM o mesmo será iniciado, e todos os arquivos com extensão XML na pasta serão processados.

Image Removed

Caso a importação seja realizada com sucesso, o Protheus irá apresentar a mensagem de "Importação realizada com sucesso!" e o processo é finalizado, os arquivos na pasta origem são movidos para uma pasta na protheus_data, diretório: "\Protheus_data\out\xml\inproc".

Protheus

Image Removed

Diretório com os arquivos na Protheus_Data

Image Removed

Caso haja algum XML com informação incorreta, o Protheus irá apresentar a mensagem de Alerta "Processo concluído, mas alguns arquivos não puderam ser importados, favor verificar o arquivo de LOG", os arquivos na pasta origem serão movidos a uma pasta na protheus_data, diretório: "\Protheus_data\out\xml\inproc".
Nesse caso, na pasta origem dos arquivos, será criada uma pasta log, contendo um arquivo com extensão .log, esse arquivo contém a informação do XML que apresentou erro durante o processamento.

Protheus

Image Removed

Arquivo de log Gerado

Image Removed

O arquivo de log é gerado com o mesmo nome informando no campo evtadic e é criado para cada importação, desde que o nome informando no parâmetro evtadic seja diferente.

Image Removed

Exemplo de conteúdo informado no arquivo de Log:

Nesse próximo passo, será mostrado como as msgs serão apresentadas no console durante a execução do job.

Na primeira chamada, caso a pasta contenha arquivos validos para a importação, será apresentada a seguinte mensagem no console:
Image Added

Durante o processamento, será apresentada a seguinte msg para cada registro que esta sendo importado:

Importação Lucros e dividendos evento R4010 Image Added

Importação Lucros e dividendos evento R4020 Image Added

No fim do processamento, caso não tenha sido importado algum arquivo com inconsistência no xml, ou não tenha ocorrido problema na apuração, será apresentada a seguinte msg:
Image Added

Caso tenha sido importado algum arquivo com inconsistência no XML, ou tenha ocorrido algum problema na apuração, será apresentada a seguinte msg:
Image Added

Caso a pasta 'xml_import' fique em algum momento vazia, sem nenhum arquivo xml valido, será apresentada a seguinte msg:

Image Added

Arquivo de Log

A regra para a geração de arquivo de log não mudou, segue a mesma regra que a rotina TAFA618 executa, caso tenha sido importado um arquivo com inconsistência na estrutura do xml, ou caso tenha ocorrido algum problema na apuração, será gerado um arquivo .log na pasta origem da importação, nesse caso, será gerado na pasta 'xml_import', conforme img:
Image Added

Image Added

Conclusão

Após a realização do processo, os arquivos na pasta 'xml_import' serão excluídos da pasta origem, e serão armazenados na pasta out → xml → inproc, conforme img abaixo, com isso o processo de importação por Job esta finalizada, as informações estarão disponíveis no Painel Reinf, conforme o Período dos arquivos importados.

Diretório com os arquivos na Protheus_Data.

Image Added

Painel Reinf

Image AddedImage Removed