Páginas filhas
  • DEDUINTEGRACOES-4434 DT Fracionamento do processo de contabilização / estorno

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

01. DADOS GERAIS

Linha de Produto:RM
Segmento:TOTVS Gestão Educacional
Módulo:TOTVS Educacional
Função:Contabilização / estorno por competência
Ticket:N/A
Requisito/Story/Issue (informe o requisito relacionado) :

DEDUINTEGRACOES-4434
DEDUINTEGRACOES-4744

02. SITUAÇÃO/REQUISITO

Ao gerar a contabilização a contabilização / estorno por competência do TOTVS Educacional para um grande volume de contratos, necessita-se que seja reduzido o tempo total de execução deste processo e que seja melhor aproveitado a estrutura dos servidores.

03. SOLUÇÃO

Vislumbrou-se o fracionamento do processo de contabilização de contabilização / estorno por competência, como forma de reduzir o tempo total de execução, assim como aproveitar melhor a capacidade de processamento do servidores.

DESCRIÇÃO

Com o objetivo de fracionar os processos de contabilização de contabilização / estorno por competência, foi desenvolvida funcionalidade intrínseca ao processo de contabilização de contabilização / estorno por competência, que  particiona de forma automática os contratos selecionados, criando novos processos e os colocando em execução. O sistema grava no banco de dados os identificadores dos subprocessos gerados e permite o acompanhamento das execuções, através de um tela monitora. de monitoramento.
O sistema decidirá se o fracionamento será realizado a partir dos parâmetros preenchidos para fracionamento e da quantidade de contratos a ser processada.
Ao se fracionar é criado um processo pai o qual será responsável por disparar a execução dos processos filhos.

Image Added

GERAÇÃO DA CONTABILIZAÇÃO / ESTORNO

Na tela de geração de contabilização / estorno, assim que for disparada a execução, o sistema fará uma carga de todos os contratos, conforme selecionado ou definido nos filtros ordenando os mesmos por matriz aplicada.

Uma vez feita Após a carga dos contratos, o sistema irá particionar os contratos retornados seguindo a seguinte regra: Para cada matriz aplicada, será gerado um novo processo e, caso o número de contratos de uma mesma matriz aplicada ultrapasse 1000, será gerado um novo processo para cada 1000 contratos.

Feito o particionamento do processo em vários subprocessos, os subprocessos são enfileirados para execução e o processo principal é finalizado. Dessa forma, para o acompanhamento da execução dos subprocessos, será necessário acessar a tela de acompanhamento da contabilização, através do botão na tela do processo principal, quando for aplicável, ou através do menu Financeiro/Contábil/Contabilidade.

consultará os parâmetros de fracionamento abaixo para saber se utilizará o fracionamento de processos bem como qual será o número de contratos por fracionamento e o número máximo de processos.

Image Added

  • "Utiliza fracionamento de processos: Indica se o fracionamento de processos (jobs) está habilitado. Caso esteja marcado, o sistema passará a subdividir os processos a serem executados de acordo com o número de contratos parametrizados por fracionamento. Caso não esteja marcado, o sistema se comportará conforme comportamento atual, ou seja, a framework do RM continuará gerenciando os processos conforme configuração do sistema.
  • "N° de contratos por fracionamento: Indica o número limite de contratos que o sistema considerará por fracionamento. Se o número limite de contratos não for atingido o sistema não fracionará, ou seja, será criado apenas um processo que será responsável pela contabilização / estorno de todos os contratos. O número de contratos por fracionamento só ficará habilitado se o parâmetro de utilização de fracionamento estiver marcado. O número default para o tamanho do pacote é de 1500 contratos, ou seja, se o usuário somente marcar a opção de utilização de fracionamento, o sistema assumirá esse tamanho a partir do qual os jobs são fracionados. Caso o fracionamento esteja habilitado, o sistema não permitirá um valor menor ou igual a zero.
  • Nº máximo de processos por contexto: Número limite de processos a serem gerados pelo fracionamento, ou seja, o sistema somente criará processos até o número máximo especificado por esse parâmetro.
    Se a quantidade de contratos dividida pelo número de contratos por fracionamento (arredondando sempre para o próximo número inteiro) for maior do que o número máximo de processos, o sistema ajustará o número de contratos por fracionamento na execução do processo corrente de forma que a quantidade de processos gerados não exceda o número de processos informado. Caso o fracionamento esteja habilitado, o sistema não permitirá um valor menor ou igual a zero.

    Exemplo:
    Sistema está parametrizado para "Utilizar fracionamento de processos"
    Nº de contratos por fracionamento: 100
    Nº máximo de processos por contexto: 5
    Total de contratos a serem processados: 1000

    Com essa parametrização, inicialmente, o sistema tentará quebrar o total de contratos (1000) em 10 processos com 100 contratos cada.
    Como o número máximo de processos gerados é 5, o sistema recalculará o número de contratos por processo da seguinte forma:

    Nº de contratos por fracionamento = Total de contratos a serem processados / Nº máximo de processos por contexto = (1000 / 5) = 200
    Observação: Se esse número de contratos por fracionamento calculado não for um número inteiro, o sistema arredondará para o número inteiro posterior mais próximo. Ex.: 200,05 => 201

Aviso
titleUtilização de multicontexto

Caso o usuário queira processar a contabilização / estorno por competência de contratos utilizando a opção de multi contexto, a mesma só estará disponível se o fracionamento de processos estiver habilitado.

O fracionamento de processos será efetuado para cada contexto a ser processado.

Conheça mais a opção de multi contexto <<clicando aqui>>!

TELAS DO PROCESSO

A tela abaixo mostra a tela do processo de contabilização de contabilização / estorno antes da execução ser iniciada.

Image Removed

Uma vez iniciada a execução, caso não se esteja utilizando ambiente em 3 camadas, o processo é finalizado e uma mensagem é exibida e um botão para abrir a tela de acompanhamento da contabilização é disponibilizado, conforme imagem abaixo.

Caso a tela de acompanhamento seja executada a partir do botão 'Monitorar processos em execução', serão exibidos  apenas os subprocessos relacionados ao processo que acabou de ser iniciada a execução. 

Image Removed

Caso se esteja executando o processo em um ambiente 3 camadas, a tela do processo é fechada, sendo necessário então clicar no botão de  acompanhamento da contabilização disponível no Menu Financeiro/Contábil/Contabilidade. 

Caso a tela de acompanhamento seja executada a partir do menu 'Acompanhar Contabilizações', serão exibidos  todos os subprocessos em execução, independente do processo de contabilização que os originou. 

Image Removed

Abaixo segue um exemplo da tela de companhamento da contabilização, onde é possível verificar o progresso de execução e algumas informações pertinentes ao processo dos subprocessos. 

Processos aguardando início ou em inicialização são exibidos em cor laranja, enquanto processos em andamento são exibidos em cor amarelo, conforme imagem abaixo.

Image Removed

Assim que o processo é finalizado, o processo passa a ser exibido em cor verde.

Image Removed

Através da coluna Job, é possível abrir a tela com as informações do processo. Para isso, basta clicar no ícone, conforme exibido abaixo.

Image Removed

Uma vez clicado no ícone do Job, a tela com o registro do processo é exibida para que maiores informações possam ser consultadas.

Image Removed

Da mesma forma, através da coluna Log, caso se clique no ícone contendo reticencias, será aberta a tela de Log detalhado da contabilização.

Image Added

Se o fracionamento de processos estiver habilitado, será mostrado o ícone e um texto os quais terão um hint explicativo indicando o número de contratos parametrizado para o fracionamento bem como o número máximo de processos por contexto.

Image Added

Se o ambiente não for 3 camadas e o fracionamento de jobs estiver habilitado, ao clicar em executar, será exibida a seguinte mensagem para o usuário alertando do uso de recursos e processamento da máquina:

Image Added

Caso o usuário esteja ciente e não queira que a mensagem apareça novamente, poderá ser marcada a opção "Não exibir novamente".

Ao clicar em "Sim", o processo será executado. Se clicar em "Não", a execução do mesmo será abortada.

Se a lista de processos retornada for igual a um, o sistema se comportará como se o fracionamento estivesse desabilitado (comportamento padrão de execução de processos do RM).

Se o fracionamento tiver sido realizado, isto é, caso o sistema tenha quebrado o processamento em mais de um processo filho, o sistema habilitará o botão "Monitorar processos em execução" que, ao ser clicado, fechará o formulário de contabilização / estorno e exibirá uma tela de acompanhamento da contabilização / estorno.

Image Added

Tela de acompanhamento de contabilizações:

Image Added


Caso o fracionamento não tenha sido realizado, o sistema exibirá a tela de processo com um botão para acessar o log das contabilizações realizadas.

Image Added

Dica
titleDica

Conheça mais a funcionalidade de Log de contabilizações <<clicando aqui>>!


Podemos acessar o acompanhamento da execução das contabilizações através do menu "Financeiro / Contábil → Contabilidade → Acompanhar execução das contabilizações".

Image Added

O acompanhamento poderá ter os status abaixo os quais serão mostrados na coluna "Job" e no texto explicativo ao passar o mouse sobre a respectiva linha de fracionamento (acompanhamento).

  1. Aguardando execução: Caso o processamento do fracionamento não tenha iniciado, o sistema exibirá a linha conforme abaixo:
    Image Added
  2. Executando: Caso o fracionamento esteja sendo executado, o sistema exibirá a linha conforme abaixo:
    Image Added
  3. Executado com sucesso: Caso o fracionamento tenha sido executado sem erros, o sistema exibirá a linha conforme abaixo:Image Added

  4. Executado com erros: Caso o fracionamento da contabilização / estorno tenha sido executado com erros, o sistema exibirá a linha de execução Image Added
Informações
titleInterromper execução do processo

Caso seja necessário a execução do processo poderá ser interrompida para isso basta selecionar o processo desejado e depois clicar no ícone “Interrompe a execução do processo”, após o processo ser interrompido o mesmo poderá ser excluído. 

Image Added

Dica
titleAcessando os processos no gerenciador de jobs

Clicando no respectivo ícone de status ou dando duplo clique na linha de fracionamento, o sistema exibirá o processo no gerenciador de jobs, conforme abaixo:

Image Added
Dica
titleAcessando o log de contabilização

De modo semelhante ao acesso de execução do job, clicando no ícone da coluna Log, será aberta a tela de Log detalhado da contabilização / estorno.
Image Added

...

Uma vez clicado no ícone do Log, a tela de Log detalhado

...

da contabilização / estorno será exibida. Esta por sua vez, permite avaliar o status de contabilização / estorno de

...

cada contrato, pertencente  ao processamento em questão, conforme ilustra a imagem abaixo.

Image Removed

...

tabsPasso 01, Passo 02, Passo 03, Passo 04
idspasso1,passo2

...

defaultyes
referenciapasso1

...

defaultno
referenciapasso2

04. DEMAIS INFORMAÇÕES

Card documentos
InformacaoUse esse box para destacar informações relevantes e/ou de destaque.
TituloIMPORTANTE!

Contabilização

Image Added


Estorno

Image Added




AMBIENTE TRÊS CAMADAS

No processo executado em ambiente Três Camadas com Agendamento ao informar dados para contabilização e agendar a data e hora, a tela de contabilização será fechada e é possível acompanhar o inicio da execução das contabilizações através do menu "Financeiro / Contábil → Contabilidade → Acompanhar execução das contabilizações".

Na tela do acompanhamento o processo pai fica visível com a Data Programada e Status, após o inicio do processo o pai e concluído e são criados os processos filhos com o inicio da execução das contabilizações.

Caso seja necessário desabilitar a execução do processo não iniciado foi criado um ícone "Desabilita a execução do Processo" que poderá ser habilitado novamente no ícone "Habilita a execução do Processo".
Para habilitar novamente o processo a data e hora que está sendo habilitado deverá ser anterior a data programada, caso seja superior o processo será automaticamente cancelado. 


1. Processo pai agendado, aguardando execução.

Image Added


2. Processo pai concluído

Image Added


3. Processos filhos iniciados

Image Added


4. Processos desabilitado

Image Added


Aviso
titleIMPORTANTE

O agendamento de execução de processos, no caso do fracionamento, agendará a execução do processo pai que, ao ser executado, criará e executará os processos filhos.

05. ASSUNTOS RELACIONADOS

Templatedocumentos

HTML
<style> div.theme-default .ia-splitter #main { margin-left: 0px; } .ia-fixed-sidebar, .ia-splitter-left { display: none; } #main { padding-left: 10px; padding-right: 10px; overflow-x: hidden; } .aui-header-primary .aui-nav, .aui-page-panel { margin-left: 0px !important; } .aui-header-primary .aui-nav { margin-left: 0px !important; } </style>