cSeverityCaractereObrigatório
INFO, WARN, ERROR, FATAL ou DEBUG.
FUNçãOEm revisão
FWLogMsg
FWLogMsg(cSeverity, [cTransactionId], cGroup, [cCategory], [cStep], [cMsgId], [cMessage], [nMensure], [nElapseTime], [aMessage])Registra mensagem estruturada no log do Framework.
Visão geral
A API padroniza a implementação LogMsg com severidade, grupo e campos de correlação. As severidades documentadas incluem INFO, WARN, ERROR, FATAL e DEBUG; debug depende da configuração FWLOGMSG_DEBUG. Quando aMessage é fornecido no modo console, cMessage é omitido para evitar sobrecarga. O exemplo registra apenas uma mensagem editorial sem dados de usuário, tokens ou conteúdo de arquivos. Não confundir gravação de log com commit de negócio. (Fontes: refs. 1–1.)
Sintaxe
FWLogMsg(cSeverity, [cTransactionId], cGroup, [cCategory], [cStep], [cMsgId], [cMessage], [nMensure], [nElapseTime], [aMessage])Parâmetros
cTransactionIdCaractereOpcional
Identificador de correlação; LAST reutiliza o anterior.
cGroupCaractereObrigatório
Grupo da mensagem.
cCategoryCaractereOpcional
Categoria da mensagem.
cStepCaractereOpcional
Etapa de processamento.
cMsgIdCaractereOpcional
Identificador da mensagem.
cMessageCaractereOpcional
Mensagem textual, limite documentado de 10K.
nMensureNuméricoOpcional
Unidade de medida da mensagem.
nElapseTimeNuméricoOpcional
Tempo decorrido informado pela rotina.
aMessageArrayOpcional
Dados adicionais como pares chave/valor; afeta cMessage no console.
Retorno
Retorno formal não especificado na ficha; não usado.
Exemplo comentado
#Include "Protheus.ch"
User Function Ed435()
// Mensagem ficticia sem segredos.
FWLogMsg("INFO",,"EDITORIAL",,,"ED435","Revisao editorial")
Return NilResultado esperado
Registro conforme configuração do LogServer/ConsoleLog, se executado. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
- Conferir o contexto e o retorno antes de integrar; o exemplo não substitui a rotina completa.
- Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.