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:
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.
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
Importante que a pasta com os arquivos seja selecionada e após isso, seja selecionada a opção de Salvar.
- Diretório com os arquivos
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.
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
- Diretório com os arquivos na Protheus_Data
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
- Arquivo de log Gerado
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.
Exemplo de conteúdo informado no arquivo de Log:
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. | 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. |
|---|---|
|
|
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: |
|
|
Com isso, basta escolher a recorrência e clicar em | Com isso, basta concluir as configurações do agendamento, e iniciar os serviços Task Manager e Queue Manager: |
|
|
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 através do menu, permite que seja escolhida uma pasta tanto no servidor quanto local para a importação dos arquivos .xml, 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 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
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:
Durante o processamento, será apresentada a seguinte msg para cada registro que esta sendo importado:
- Importação Lucros e dividendos evento R4010
- Importação Lucros e dividendos evento R4020
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:
Caso tenha sido importado algum arquivo com inconsistência no XML, ou tenha ocorrido algum problema na apuração, será apresentada a seguinte msg:
Caso a pasta 'xml_import' fique em algum momento vazia, sem nenhum arquivo xml valido, será apresentada a seguinte msg:
- 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:
- 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.
Painel Reinf
04. DEMAIS INFORMAÇÕES
Essa funcionalidade estará disponível nos novos pacotes de expedição continua
...
.
05. ASSUNTOS RELACIONADOS
Lucros e dividendos - Importação de XML - Rotina no Menu
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas