Árvore de páginas

Versões comparadas

Chave

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

...

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




oModelaParamObjeto

Array

Array com as configurações de cada ponto de entrada.Objeto principal do fonte

Não háSimnRotExtNuméricoNú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"                  -- Array
A 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 rotinaNão háou Nulo

Variável de controle de saídaSim



























03. EXEMPLO DE UTILIZAÇÃO

...