A050BUT

Modulo: SIGACOM  ·  Rotina: MATA050  ·  Momento: Montagem do menu/aRotina

Parametros (PARAMIXB)

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

Retorno esperado

Array de botoes: { {label, codeblock, vazio, vazio, vazio, nivel}, ... }

Exemplo

User Function A050BUT()
    Local aBtns := {}
    aAdd(aBtns, {"Aprovar SC",     "U_AprovSC",     0, 2, 0, .F.})
    aAdd(aBtns, {"Imprimir Etiq",  "U_ImpEtiqSC",   0, 2, 0, .F.})
Return aBtns

Pegadinhas

• Codeblock como string — Protheus avalia com EVAL.
• Visibilidade controlada pelo ultimo .F./.T. — false esconde do menu.

Quando usar

• Adicionar opcoes customizadas ao menu da rotina
• Acoes em lote sobre selecionados
• Botoes pra integracoes externas

Cuidados gerais

• 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.

Veja tambem

• A050FIL