Usina BRAdvPL Guia
Entrar
← Todos os tópicos
PONTO DE ENTRADAEm revisão

FA330MNU

User Function FA330MNU()

Acrescenta funcionalidades ao menu antes do browse.

FA330MNUFINA330
01 · VISÃO GERAL

Visão geral

A ficha atual documenta retorno obrigatório do array aRotina e mostra a inclusão de uma ação. A listagem P12.2210 recebe {aRotina} e substitui aRotina pelo retorno. O exemplo oficial depende de U_TESTE(), que precisa existir; a linha do menu não implementa a ação nem a autorização. Não foi encontrada implementação útil no GitHub. (Refs. 1–2)

02 · SINTAXE

Sintaxe

User Function FA330MNU()

Parâmetros

PARAMIXB[1]
ArrayContexto de execução

aRotina na chamada P12.2210; a ficha demonstra também aRotina no escopo do chamador. (Refs. 1–2)

Retorno

Array com os itens do menu, preservando as ações padrão necessárias.

03 · EXEMPLO PRÁTICO

Inclusão de ação demonstrativa

#Include "Protheus.ch"

User Function FA330MNU()
    // Adapta a inclusao TOTVS e fornece a rotina demonstrativa.
    Local aMenu := AClone(PARAMIXB[1])
    AAdd(aMenu,{"Diagnostico", "U_Ed330Info", 0, 0, 0, .F.})
Return aMenu

User Function Ed330Info()
    // Acao didatica sem alterar titulos.
    MsgInfo("Menu editorial da FINA330")
Return Nil
Resultado esperado

Acrescenta uma ação com rotina própria incluída no exemplo. Conferir formato do menu e compilar em homologação; não testado em Protheus.

04 · EXEMPLO PRÁTICO

Chamada observada e contexto

// Trecho do chamador P12.2210 (EURAI, ref. 2); não é implementação do PE.
// FINA330.PRX - FINA330() -> AROTINA := EXECBLOCK( "FA330MNU", .F., .F., { AROTINA } )
Resultado esperado

O registro mostra argumentos e uso imediato do retorno quando presentes. Não inclui o corpo completo do chamador nem comprova a posição do commit.

BOAS PRÁTICAS
  • Validar a estrutura de cada item no release utilizado. Criar e testar a rotina acionada antes de incluir a opção. Distinguir inclusão de ações em FA330MNU da seleção de botões em FA330LIB.
  • Uma chamada sem quarto argumento não documenta um layout de PARAMIXB. Preservar identificadores do chamador e não inventar campos ou posições.
  • Roteiro de homologação: comparar o fluxo padrão e o customizado, testar sucesso, recusa e repetição e conferir saldos, movimentos e contabilização conforme o processo.
  • Em revisão: exemplo não compilado nem executado em Protheus. Aliases, bloqueios, posição na transação e compatibilidade devem ser conferidos no release e patch utilizados.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. FA330MNU - Incluir funcionalidades no menu. TDN. Consulta em 2026-10-24.
  2. EURAI. Pontos de Entrada P12.2210 - Parte 2. Universo do Desenvolvedor, 2023. Consulta em 2026-10-24.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha