FUNCIóNEn revisión

ShowLog

ShowLog( <cTexto> )

Muestra un texto en una ventana de log, útil para inspección visual de consultas, mensajes e información de apoyo durante pruebas.

Funciones AdvPLInterfazDepuraciónLogSQLEn revisión

01 · DESCRIPCIÓN GENERAL

Descripción general

ShowLog se usa con frecuencia en rutinas AdvPL para presentar textos largos o datos de diagnóstico en una ventana de log. En la práctica, suele aplicarse durante desarrollo y homologación para visualizar consultas SQL generadas dinámicamente, contenidos de variables o mensajes de apoyo. Por seguridad y organización, restrinja su uso a perfiles administrativos y evite mostrarlo a usuarios finales en producción.

02 · SINTAXIS

Sintaxis

ShowLog( <cTexto> )

Parámetros

cTexto

CaractereObligatorio

Texto que se mostrará en la ventana de log. Puede contener una consulta, un mensaje técnico u otro contenido de apoyo al análisis.

Retorno

La referencia usada no documenta retorno para ShowLog. Use la función con foco en exhibición de información, no como parte de una regla de decisión.

03 · EJEMPLO PRÁCTICO

Mostrar una consulta solo para administrador

#Include "TOTVS.ch"

User Function MuestraConsulta()
    Local cConsulta := ""

    cConsulta := " SELECT * "
    cConsulta += " FROM " + RetSQLName("SBM") + " SBM "
    cConsulta += " WHERE BM_FILIAL = '" + FWxFilial("SBM") + "' "
    cConsulta += " AND SBM.D_E_L_E_T_ = ' ' "

    If FWIsAdmin()
        ShowLog(cConsulta)
    EndIf
Return

Resultado esperado

Cuando el usuario es administrador, la consulta generada se muestra en una ventana de log para revisión visual.

04 · EJEMPLO PRÁCTICO

Crear una función auxiliar para visualizar consultas

#Include "TOTVS.ch"

User Function VerConsulta(cConsulta)
    Default cConsulta := ""

    If ! IsBlind() .And. ! Empty(cConsulta) .And. FWIsAdmin()
        If FWAlertYesNo("¿Desea visualizar la consulta?", "Atención (" + FunName() + ")")
            ShowLog(cConsulta)
        EndIf
    EndIf
Return

Resultado esperado

La función auxiliar centraliza validaciones: no ejecuta en modo sin interfaz, ignora texto vacío, restringe a administradores y pide confirmación antes de abrir el log.

BUENAS PRÁCTICAS

Use ShowLog como herramienta de apoyo en desarrollo, homologación o diagnóstico controlado.
Al mostrar consultas SQL, restrinja el uso a administradores con FWIsAdmin().
Evite mostrar datos sensibles, tokens, contraseñas, claves o información personal en logs visibles.
En rutinas automáticas o sin interfaz, valide el contexto antes de abrir ventanas.
Para opciones más controladas de título, barras de desplazamiento y confirmación, evalúe AtShowLog cuando esté disponible en el ambiente.

ERRORES COMUNES

Mostrar ShowLog directamente a cualquier usuario puede exponer detalles técnicos o información sensible.
Dejar logs visuales en producción puede interrumpir el flujo de la rutina y confundir a usuarios finales.
Una consulta mostrada en pantalla puede revelar nombres de tablas, filtros, aliases y reglas internas del sistema.
No use ShowLog como sustituto de log estructurado cuando sea necesario guardar histórico técnico.

Contenido relacionado

REFERENCIAS

ATILIO, Daniel. Cómo usar la función ShowLog. Terminal de Informação, 22 dic. 2021; actualización mencionada en dic. 2022.

Estado: En revisión
Página creada el: 20/08/2026 a las 22:45
Última revisión el: 20/08/2026 a las 22:45
Idioma original: Portugués
Revisión: Usina.BR