Linha Microsiga Protheus

Page tree

Criação de pontos de entrada para realizar as validações na movimentação de postos

Linha de Produto:

Microsiga Protheus

Segmento:

Recursos Humanos

Módulo:

SIGAORG

Função:

ORGA060; APDXFUN;

Situação/Requisito:

Necessidade de criação de ponto de entrada para realizar validações de alterações e exclusões de postos dentro de uma Visão(ORGA060).

Por exemplo, caso o cliente possua algum modelo customizado de workflow, poderá validar sempre que um posto for alterado ou excluído de uma visão, assim permitindo manter a integridade das informações com cadastros e rotinas customizadas.

Solução/Implementação:

Para solucionar essa necessidade foram liberados 2 pontos de entrada, baseados na funcionalidade de movimentação de postos(ORGA060):

  • ORG060MOV: para ser utilizado durante a manipulação dos itens da visão;
  • APDPEXTREE: para ser utilizado na exclusão de itens durante a manipulação da arvore na estrutura da visão.

 

Ponto de Entrada ORG060MOV 

Esse ponto de entrada será sempre acionado durante a confirmação dos itens da visão, durante o processo de alteração.

Os parâmetros passados são:

  • PARAMIXB[1]: Código da filial da visão atualizada.
  • PARAMIXB[2]: Código da visão atualizada.
  • PARAMIXB[3]: Array com todas as informações referentes aos itens da visão, permitindo realizar as validações necessárias

Retorno esperado:

  • Dentro dessa user function é possível emitir um alerta específico para o usuário.
  • O retorno deverá ser .T. para permitir continuar com as alterações realizadas, ou .F. para interromper o processo de avaliação.
    qualquer retorno diferente de booleano será ignorado e o processo seguirá a atualização normalmente.

Exemplo:


Ponto de Entrada APDPEXTREE 

Esse ponto de entrada será sempre acionado durante o processo de exclusão de um item da arvore na estrutura montada, sendo que sua funcionalidade será acionada, caso nenhum inconsistência do produto padrão for localizada anteriormente, nesse caso relatório de log do padrão será carregado.

Caso a user function seja acionada, a mesma poderá validar o item que está sendo tentando eliminar, devolvendo o seu próprio relatório de log com as informações.

Os parâmetros passados são:

  • PARAMIXB[1]: Indica a opção referente a manipulação de exclusão, no caso conteúdo '6'.
  • PARAMIXB[2]: Indica o alias da tabela responsável pela montagem da estrutura da arvore, no caso dos itens da visão, conterá o valor 'RD4'.
  • PARAMIXB[3]: Esse parâmetro possui a filial da visão em manutenção (RDK)
  • PARAMIXB[4]: Esse parâmetro contém a chave completa do item (linha) da visão que está sendo tentado eliminar da arvore.

Retorno esperado:

  • Dentro dessa user function não é possível emitir um alerta específico para o usuário.
  • O retorno deverá ser sempre um array contendo as observações de log a serem mostradas no formato de relatório.
    qualquer retorno diferente de array será ignorado e o processo seguirá a atualização inicial normalmente.

Exemplo:

 


Pacotes:

12.1.7:
12.1.14: