BLV Técnico Versão 5.10 (Continuação)
Quadro - ERG0267 "diminuiu/aumentou nn vagas de xx para yy"
Visão do usuário:
Na tela [ERG0274] -Transação: Consulta de Histórico de Quadro de Cargos, foi modificada a mensagem exibida no campo histórico, mostrando a quantidade de vagas modificadas, quantidade antiga e quantidade atual.
Histórico: "Aumentado/Diminuído xx vaga(s) de nn para yy"
Detalhes Técnicos:
Foi alterada a function [mensagem_historico] da package body [pck_erg_quadro] para quando alterada a quantidade de vagas retorne a mensagem:
("Aumentado/Diminuído xx vaga(s) de nn para yy")
Temporalidade nos registros de acumulação de cargos
Visão do usuário:
A partir desta versão o sistema Ergon passa a implementar a temporalidade nos registros de acumulação de cargos. Com essa nova implementação, torna-se possível parametrizar os registros de acumulação dentro de janelas de tempo, bastando informar as datas de início e fim da acumulação na transação "Controle de Acumulação de Cargos".
Em decorrência dessa implementação, torna-se importante salientar alguns detalhes :
1. A ordem de cadastro dos cargos acumuláveis não influencia no sistema, ou seja, a acumulação "Cargo A" x "Cargo B" não tem diferença alguma da acumulação "Cargo B" x "Cargo A";
2. O sistema não permitirá o lançamento de registros de acumulação concomitantes para o mesmo par de cargos;
3. A funcionalidade do campo "Acumulação Cargo" (presente na transação "Cargos") continua funcionando normalmente, ou seja, a validação da acumulação só será realizada a partir da data informada neste campo.
Detalhes Técnicos:
O mecanismo de validação de acumulação de cargos existente na rotina PCK_ERG_COD_ACUM_CARGO.VALIDA_ACUMULACAO_CARGO foi alterado para contemplar a temporalidade implementada nesta versão. Assim, todos os pontos do sistema que verificam a acumulação (Ingresso, Eventos e Provimentos) passam a verificar a acumulação de maneira temporal.
Controle do retorno da vaga
Visão do usuário:
Modificado o controle do retorno da vaga, foi adicionado o campo "Retorna Vaga" nas telas (ERG0160), transação: Movimentação de Vagas de Quadro para Cargos e (ERG0161), transação: Movimentação de Vagas de Quadro para Funções. Para cada quadro de vagas é escolhido se a vaga retorna para QUADRO ou COMPROMISSO caso extinguir o quadro de vagas.
Detalhes Técnicos:
Criação da coluna [RETORNO_VAGA] na tabela [ERG_QUADRO]. Foi adicionado nos Forms [ERG0160], [ERG0161] o Item [RETORNO_VAGA]. Este Item estará visível somente quando o sistema estiver com a opção genérica [RESERVA_QUADRO_ORIGEM] = 'COMPROMISSO' do Grupo "QUADRO".
Movimentação de Vagas de Cargo e Função
Visão do usuário:
Foi disponibilizado um novo procedimento de movimentação de vagas de cargo/função. Este processo de movimentação consiste em, a partir de uma data informada pelo usuário (DATAREF), encerrar o provimento (cargo) ou designação (função) no dia anterior à DATAREF e se abrir um novo provimento/designação (em DATAREF) que utiliza uma nova reserva de vaga, transferida do compromisso/reserva antigo para um novo compromisso/reserva criado pelo processo. A transferência da vaga implica na criação de um novo compromisso e uma nova reserva, ambos com quantidade de 1 vaga, além da dedução de 1 vaga do compromisso e reserva antigos.
Tanto para o processo de transferência de vagas de cargo quanto para o de vagas de função, o sistema permite o lançamento de um registro de publicação que será atrelado ao novo provimento (cargo) ou à nova designação (função).
É importante lembrar que para a transferência de vagas de função, além das atividades citadas acima, ainda há a fase de transferência de registros de substituição (feita também automaticamente), uma vez que para uma designação pode haver substituição no período da transferência.
Assim, foram disponibilizadas duas novas transações que estarão disponíveis apenas para sistemas parametrizados para trabalhar com PROVIMENTOS e com controle de vaga por COMPROMISSO :
1. "Movimentação Individual de Vaga de Cargo" : Esta transação permite que se dispare o processo de movimentação de vagas relativas aos provimentos. Maiores informações sobre essa transação podem ser obtidas no help da mesma;
2. "Movimentação Individual de Vaga de Função" : Esta transação permite que se dispare o processo de movimentação de vagas relativas às designações. Maiores informações sobre essa transação podem ser obtidas no help da mesma;
Detalhes Técnicos:
As transações desenvolvidas utilizam a procedure TRANSF_VAGA_INDIVIDUAL para a realização do processo de transferência de vaga. A interface dessa procedure está descrita abaixo :
Parâmetros de Entrada
------------------------------------
P_TIPO_REG (VARCHAR2): Tipo do registro a ser transferido: (P)rovimento ou (D)esignação;
P_NUMFUNC (NUMBER): Número do funcionário;
P_NUMVINC (NUMBER): Número do vínculo;
P_DATA (DATE): Data de referência para a geração do novo provimento/designação;
P_DESCR_COMPR (VARCHAR2): Descrição do novo compromisso de vagas que será gerado;
P_FORMAPROV (VARCHAR2): Forma de provimento para o novo provimento (p_tipo_reg = 'P'). Em caso de transferência de designação (p_tipo_reg = 'D'), este parâmetro deverá ser passado com NULL;
P_SETOR_DESTINO (VARCHAR2): Setor de alocação do novo provimento/designação;
P_SUBORD (VARCHAR2): Parâmetro que informa se o novo compromisso/reserva servirá apenas para o setor destino (p_subord = 'N') ou para os setores subordinados a ele também (p_subord = 'S');
P_NUMPUBL (VARCHAR2): Número da nova publicação que será gerada para o novo provimento/designação;
P_DATAPUBL (DATE): Data da nova publicação;
P_TIPOPUBL (VARCHAR2): Tipo da nova publicação;
P_DATADO (DATE): Data de publicação no Diário Oficial;
P_TIPODO (VARCHAR2): Tipo de Diário Oficial;
P_AUTORIDADE (VARCHAR2): Autoridade responsável pela nova publicação;
P_NUMERO_PROCESSO (VARCHAR2): Número do processo da nova publicação;
P_MOTIVOPUBL (VARCHAR2): Motivo da nova publicação;
P_OBS (VARCHAR2): Observações referentes à nova publicação;
Parâmetros de Saída
---------------------------------
P_ID_EXEC (NUMBER): Parâmetro de entrada e saída que armazena o ID da auditoria de processos gerada para o processamento. Se esse parâmetro for informado no momento da chamada da procedure, a mesma o utilizará para gerar a auditoria do processo. Caso contrário, a procedure gerará um novo ID de auditoria, retornando-o, através deste parâmetro, após o término do processamento;
P_NOVA_VAGA (NUMBER): Parâmetro de entrada e saída para o ID da reserva a ser utilizada. Se for informado, a transferência será realizada utilizando-se a reserva informada. Caso contrário, uma nova reserva será gerada e o seu ID será retornado por esse parâmetro.
P_MENS OUT (VARCHAR2): Parâmetro apenas de saída que retorna a mensagem de erro ocorrida durante o processamento. Caso o processamento tenha terminado sem erros, este parâmetro retornará com valor NULL.
Obs.: Essa procedure disponibiliza o entry-point EP__TRANSF_VAGA_INDIVIDUAL para customizações no processo de transferência. A interface desse entry-point está descrita abaixo:
Parâmetros de Entrada
------------------------------------
P_TIPO_REG (VARCHAR2): Tipo do registro a ser transferido: (P)rovimento ou (D)esignação;
P_NUMFUNC (NUMBER): Número do funcionário;
P_NUMVINC (NUMBER): Número do vínculo;
P_DATA (DATE): Data de referência para a geração do novo provimento/designação;
P_DESCR_COMPR (VARCHAR2): Descrição do novo compromisso de vagas que será gerado;
P_FORMAPROV (VARCHAR2): Forma de provimento para o novo provimento (p_tipo_reg = 'P'). Em caso de transferência de designação (p_tipo_reg = 'D'), este parâmetro deverá ser passado com NULL;
P_SETOR_DESTINO (VARCHAR2): Setor de alocação do novo provimento/designação;
P_SUBORD (VARCHAR2): Parâmetro que informa se o novo compromisso/reserva servirá apenas para o setor destino (p_subord = 'N') ou para os setores subordinados a ele também (p_subord = 'S');
P_NUMPUBL (VARCHAR2): Número da nova publicação que será gerada para o novo provimento/designação;
P_DATAPUBL (DATE): Data da nova publicação;
P_TIPOPUBL (VARCHAR2): Tipo da nova publicação;
P_DATADO (DATE): Data de publicação no Diário Oficial;
P_TIPODO (VARCHAR2): Tipo de Diário Oficial;
P_AUTORIDADE (VARCHAR2): Autoridade responsável pela nova publicação;
P_NUMERO_PROCESSO (VARCHAR2): Número do processo da nova publicação;
P_MOTIVOPUBL (VARCHAR2): Motivo da nova publicação;
P_OBS (VARCHAR2): Observações referentes à nova publicação;
P_ID_EXEC (NUMBER): Parâmetro que armazena o ID da auditoria de processos gerada para o processamento;
Parâmetros de Saída
---------------------------------
P_NOVA_VAGA (NUMBER): Parâmetro de entrada e saída para o ID da reserva a ser utilizada. Se for informado, a transferência será realizada utilizando-se a reserva informada. Caso contrário, uma nova reserva será gerada e o seu ID será retornado por esse parâmetro.
P_MENS OUT (VARCHAR2): Parâmetro apenas de saída que retorna a mensagem de erro ocorrida durante o processamento. Caso o processamento tenha terminado sem erros, este parâmetro retornará com valor NULL.
A codificação desse entry-point deve levar em conta as seguintes observações:
1. Se o entry-point foi concluído sem erros, o parâmetro de saída P_MENS deverá retornar NULL e o entry-point deverá retornar o número do ID da reserva de vaga gerada;
2. Se ocorrer erro durante o processamento do entry-point, o parâmetro de saída P_MENS deverá retornar a mensagem do erro ocorrido e o entry-point deverá retornar NULL, uma vez que não deve ter havido a geração da nova reserva de vaga;
3. Quando esse entry-point for codificado, o processamento padrão do produto será ignorado. Assim, ao se codificar o entry-point, deve-se ter em mente que ele deverá realizar TODAS as tarefas necessárias, pois o código padrão do produto será ignorado.
Desenvolvimento das customizações relativas a quadro
Visão do usuário:
Na tela ERG-0187, transação: Provimentos, foi alterada a Lista de Valores do campo Número da Vaga para trazer somente as vagas que estão em reservas válidas, ou seja, não extintas. Nas telas ERG-0265, transação: Compromisso de Vagas de Quadro para Cargos, e ERG-0267, transação: Compromisso de Vagas de Quadro para Funções, na Lista de Valores do Setor será vizualisado somente os setores que o usuário logado tem acesso, adicionada a funcionalidade de transferência de vagas entre compromissos. Nas telas ERG-0266, transação: Reserva de Vagas de Quadro para Funções por Compromisso e ERG-0268, transação: Reserva de Vagas de Quadro para Cargos por Compromisso, quando é alterada a quantidade de vagas é atualizado o valor das vagas disponíveis no Compromisso.
Não é possível fazer:
Ocupar vagas de reservas extintas, extinguirem um quadro que possua compromissos que estão válidos, ou seja, não estão extintos, extinguir um compromisso que possua reservas que estão válidas, ou seja, não estão extintas, extinguir uma reserva quando há provimentos válidos, ou seja, não terminados, alterar a quantidade de vagas do (quadro, compromisso e reserva) depois de extinto.
A data de criação do (quadro, compromisso e reserva) deve ser menor ou igual a data atual, a data de extinção do (quadro, compromisso e reserva) não deve ser posterior a data atual, após a extinção do (quadro, compromisso e reserva) não voltará a ficar disponível.
Na extinção de um registro de reserva, se o campo retorna vaga do quadro a que ela pertence for 'QUADRO', a quantidade de vagas extintas será decrescentada do compromisso e acrescentada no quadro, pois neste caso as vagas extintas retornam ao registro do quadro, mas se o campo retorna vaga do quadro a que ela pertence for 'COMPROMISSO', as vagas continuam no registro do compromisso.
Detalhes Técnicos:
No Form ERG-0187, foi alterada a LOV [LOV_RESERVA_QUADRO], para trazer somente as vagas de reservas não extintas. No Form ERG-0265, no bloco ERG_QUADRO foi adicionado código para não permitir a inclusão de setores por usuário logado sem permissão, adicionado o bloco TRANSFERIR para a transferência de vagas, no bloco BLOCK_MANUT foi alterado na trigger WHEN-BUTTON-PRESSED do (B_Alterar, B_Somar, B_Subtrair) para atualizar o valor das vagas disponíveis no Compromisso. Nos Forms ERG-0266 e ERG-0268, foi retirado do bloco ERG_QUADRO o código que não permite que a quantidade de vagas reservadas fosse nula e colocado esta verificação na package pck_erg_quadro, o bloco ERG_QUADRO foi alterado para atualizar o valor das vagas disponíveis no Compromisso quando é feito um cadastramento ou manutenção de reserva. No Form ERG-0269, no bloco ERG_QUADRO, foi trocada na trigger de POST_QUERY a função quadro_pack.vagas_em_uso_reserva por quadro_pack.vagas_ocupadas_reserva.
Na Package QUADRO_PACK foi criada a função get_retorno_vaga_quadro e adicionada a chamada a função vagas_em_uso_reserva_comp.
Na Package Body QUADRO_PACK foi alterada a função vagas_disponiveis, no cálculo para opção RESERVA_QUADRO_ORIGEM='COMPROMISSO' é verificado para onde retorna a vaga no campo retorno_vaga da erg_quadro e não mais na opção genérica "VOLTA_RESERVA_COMPR". Alterada a Function checa_quadro_vagas, para não permitir ocupar vagas de reservas extintas.
A Package Body PCK_ERG_QUADRO foi alterada para não permitir cadastrar (Quadro, Compromisso ou Reserva) com valor 'null' para quantidade, retirado do Form essa validação. Adicionado código para verificar quando RESERVA_QUADRO_ORIGEM= QUADRO o campo retorno_vaga deve ser null, se for RESERVA_QUADRO_ORIGEM= COMPROMISSO não poderá ser null.