Usina BRGuía AdvPL
Ingresar
← Todos los temas
FUNCIóNEn revisión

FWLogMsg

FWLogMsg(cSeverity, [cTransactionId], cGroup, [cCategory], [cStep], [cMsgId], [cMessage], [nMensure], [nElapseTime], [aMessage])

Registra mensaje estructurado en log Framework.

FWLogMsgAdvPL
01 · DESCRIPCIÓN GENERAL

Descripción general

API estandariza LogMsg con severidad, grupo y correlación. Incluye INFO/WARN/ERROR/FATAL/DEBUG; debug depende de FWLOGMSG_DEBUG. Con aMessage en consola se omite cMessage. Ejemplo registra mensaje editorial sin datos de usuario, tokens ni archivos. Log no equivale a commit de negocio. (Fuentes: refs. 1–1.)

02 · SINTAXIS

Sintaxis

FWLogMsg(cSeverity, [cTransactionId], cGroup, [cCategory], [cStep], [cMsgId], [cMessage], [nMensure], [nElapseTime], [aMessage])

Parámetros

cSeverity
CarácterObligatorio

INFO, WARN, ERROR, FATAL o DEBUG.

cTransactionId
CarácterOpcional

ID de correlación; LAST reutiliza anterior.

cGroup
CarácterObligatorio

Grupo del mensaje.

cCategory
CarácterOpcional

Categoría del mensaje.

cStep
CarácterOpcional

Etapa de procesamiento.

cMsgId
CarácterOpcional

Identificador del mensaje.

cMessage
CarácterOpcional

Mensaje textual, límite documentado 10K.

nMensure
NuméricoOpcional

Unidad de medida del mensaje.

nElapseTime
NuméricoOpcional

Tiempo transcurrido informado por rutina.

aMessage
ArrayOpcional

Datos clave/valor adicionales; afecta cMessage en consola.

Retorno

Retorno formal no especificado; no usado.

03 · EJEMPLO PRÁCTICO

Ejemplo comentado

#Include "Protheus.ch"

User Function Ed435()
    // Mensaje ficticio sin secretos.
    FWLogMsg("INFO",,"EDITORIAL",,,"ED435","Revision editorial")
Return Nil
Resultado esperado

Registro según LogServer/ConsoleLog si se ejecuta. En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

BUENAS PRÁCTICAS
  • Comprobar contexto y retorno antes de integrar; ejemplo no sustituye rutina completa.
  • En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

Contenido relacionado

REFERENCIAS
  1. TOTVS. FWLogMsg. TDN. Consulta el 2026-10-27.
Estado
En revisión
Página creada el
Última revisión el
Idioma original
Portugués
Revisión
Usina.BR
0 comentario(s) aprobado(s)

Comentarios

Todavía no hay comentarios aprobados.

Inicia sesión con Google o Microsoft para comentar.

Desarrollado con Usina Docs · Alpha