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 possui vários tipos 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.
dependendo de cada local de utilização.
Os possíveis tipos de retorno são:
"MODELPRE" -- Lógico
"MODELPOS" -- Lógico
"FORMPRE" -- Lógico
"FORMPOS" -- Lógico
"FORMLINEPRE" -- Lógico
"FORMLINEPOS" -- Lógico
"MODELCOMMITTTS" -- Nulo
"MODELCOMMITNTTS" -- Nulo
"FORMCOMMITTTSPRE" -- Nulo
"FORMCOMMITTTSPOS" -- Nulo
"FORMCANCEL" -- Lógico
"MODELVLDACTIVE" -- Lógico
"BUTTONBAR" -- ArrayA terceira posição é o descritivo do nome do botã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
...