MA460VLD

Modulo: SIGAFAT  ·  Rotina: MATA460  ·  Momento: TudoOK antes da liberacao efetivar

Parametros (PARAMIXB)

Este PE nao recebe parametros via PARAMIXB. A tabela alvo ja esta posicionada quando o PE dispara — opere via (ALIAS)->CAMPO.

Retorno

.T. = libera; .F. = nao libera

Exemplo

User Function MA460VLD()
    // Bloqueia liberacao apos 18h em dia util
    If Time() > "18:00:00"
        Help(" ", 1, "TARDE", , "Liberacao apos 18h bloqueada", 1, 0)
        Return .F.
    EndIf
Return .T.

Pegadinhas

• Mensagem ao usuario via Help() (Help+.F.).
• Use ApMsgYesNo pra confirmacao em vez de bloqueio direto, se for caso de excecao.

Quando usar

• Aplicar regras de negocio antes da gravacao (validacao fiscal, comercial, contratual)
• Bloquear operacao em horarios especificos
• Validar campos obrigatorios condicionais (só obrigatorio se X)
• Verificar permissao de usuario em operacoes sensiveis

Cuidados gerais

• Em ExecAuto: validacoes em PE podem disparar com comportamento diferente — testar separadamente.
• Mensagem de bloqueio: ao retornar .F., use Help() pra explicar o motivo. Sem Help, usuario fica confuso sem saber o que aconteceu.
• Idempotencia: PEs podem disparar mais de uma vez em retry ou reprocessamento — codigo deve ser seguro pra rodar varias vezes sem efeito colateral.
• Performance critica: PE roda em fluxo do usuario. Operacoes pesadas (loop sobre milhares de registros, chamada HTTP sincrona) podem travar a tela. Use StartJob pra background.
• Em JOB sem AppServer ativo: PE chamado via RPC pode ter cFilAnt/cEmpAnt vazios — sempre garanta RpcSetEnv.
• Begin Sequence + Recover: erros nao tratados em PE podem deixar transacao Protheus em estado inconsistente. Sempre envolver em Begin Sequence ... End Sequence.
• Logging com contexto: use FwLogger com identificacao do PE no log — facilita troubleshooting.

Tabelas afetadas

• SC9 — liberacao de pedido (geralmente posicionada quando PE dispara)

Veja tambem

• MA410GRV
• MA410IM5
• MA410PED
• MA410VLD
• MA440PARC