Histórico da Página
...
02. DESCRIÇÃO
Permite ao usuário incluir botões no formulário de gestão de pendências.
O primeiro parâmetro de entrada trata do modelo principal de controle do formulário de gestão da pendência. Abaixo dele estão todos os demais modelos de formulários filhos.
O segundo parâmetro de entrada trata do número da rotina externa. A rotina externa indica as demais chamadas do botão de outras ações do browse de pendências, onde 10=Indenizar, 11=Encerrar, 12=Estornar e 13=Visualizar Conciliação. Este controle se faz necessário porque internamente o programa trata estas opções como alteração.
efetuar várias tarefas durante a execução do fonte de registro de pendências. Existe naturalmente dentro de um fonte MVC, não sendo necessária nenhuma chamada dentro do fonte. Possui locais pré-determinados para as execuções de funções customizadas.
Por exemplo: Após a gravação do modelo e fora da transação, o MVC executa automaticamente a chamada deste ponto de entrada com a localização igual a "MODELCOMMITNTTS".
O nome da função do ponto de entrada que será executado em qualquer local do fonte, deve ter o mesmo nome do modelo definido na função "MPFORMMODEL", porém o nome do fonte que agrupa o ponto de entrada, não poderá ter o mesmo nome do fonte executor do registro de pendências.
O parâmetro de entrada possui 3 posições. A primeira traz o objeto do formulário ou do modelo. A segunda traz o Id do local de execução do ponto. A terceira traz o Id do formulário.
Os possíveis locais de execução são:
Estes parâmetros devem ser capturados por meio da variável ParamIXB. "MODELPRE" //-- Antes da alteração de qualquer campo do modelo
"MODELPOS" //-- Na validação total do modelo
"FORMPRE" //-- Antes da alteração de qualquer campo do formulário
"FORMPOS" //-- Na validação total do formulário
"FORMLINEPRE" //-- Antes da alteração da linha do formulário FwFormGrid
"FORMLINEPOS" //-- Na validação total da linha do formulário FwFormGrid
"MODELCOMMITTTS" //-- Após a gravação total do modelo e dentro da transação
"MODELCOMMITNTTS" //-- Após a gravação total do modelo e fora da transação
"FORMCOMMITTTSPRE" //-- Antes da gravação da tabela do formulário
"FORMCOMMITTTSPOS" //-- Após a gravação da tabela do formulário
"FORMCANCEL" //-- No cancelamento do botão
"MODELVLDACTIVE" //-- Na ativação do modelo
"BUTTONBAR" //-- Para a inclusão de botões na ControlBar
Parâmetros de entrada:
Nome | Tipo | Descrição | Default | Obrigatório | Referência | |||||||||||||||||||||
oModelaParam | Objeto | Array | Array com as configurações de cada ponto de entrada.Objeto principal do fonte | Não há | Sim | nRotExt | Numérico | Número da rotina externa | Não há | Sim | ||||||||||||||||
A variável de retorno é um array contendo os dados de acionamento dos botões.
A primeira posição é o ícone do botão.
A segunda posição é um bloco de código com a função que será executada quando o botão for acionado.
A terceira posição é o descritivo do nome do botãopossui vários tipos de retorno dependendo de cada local de utilização.
Retorno:
Nome | Tipo | Descrição | Default | Obrigatório | Referência | |||||||||||||||
aBotõesxRet | Lógica, Array | Array com as informações da nova rotina | Não há | ou Nulo | Variável de controle de saídaSim | |||||||||||||||
03. EXEMPLO DE UTILIZAÇÃO
...