Ejemplo de scripting en Jitterbit App Builder - Registro

El registro aprovecha la API de registro de Microsoft. El registro facilita la depuración y el mantenimiento de un complemento, proporcionando información sobre los valores actuales y los comportamientos esperados e inesperados. El ejemplo de este artículo muestra cómo registrar mensajes.

Gravedad del registro

Solo se registrará un mensaje si el nivel de gravedad es igual o superior al valor configurado en Gravedad mínima en Configuración del registro del servidor de aplicaciones para cada configuración de destino del registro (Memoria, Base de datos y Disco).

Niveles de gravedad

Gravedad de Microsoft	Gravedad de App Builder	Descripción
`Off`	`Off`	Estado de configuración donde el registro de destino no escribirá ningún mensaje, no está destinado a usarse durante el registro.
`Trace`	`Trace`	Mensaje detallado de pasos minuciosos, este estado debe evitarse en ambientes de producción.
`Debug`	`Debug`	Se utiliza durante el desarrollo para investigar el estado y el comportamiento.
`Information`	`Info`	Se utiliza para rastrear el comportamiento esperado, por ejemplo, el procesamiento exitoso de un archivo.
`Warning`	`Warn`	Se utiliza cuando un comportamiento o estado aún no es perjudicial, pero debe tenerse en cuenta, por ejemplo, cuando el disco se queda sin espacio.
`Error`	`Error`	Se utiliza cuando el proceso actual debe detenerse debido a un fallo, por ejemplo, un valor de datos inesperado de un archivo.
`Critical`	`Fatal`	Se utiliza cuando una falla requiere atención inmediata.

Pantalla de configuración del servidor de aplicaciones, que ilustra la severidad de la información establecida para la configuración del registro de memoria

Secuencia de comandos

using Microsoft.Extensions.Logging;

var logger = Services.GetRequiredService<ILogger>();

logger.LogWarning("My warning message");

imagen

Alcance

Se admite el alcance y permite añadir información adicional al registro.

using Microsoft.Extensions.Logging;
using System.Collections.Generic;

var logger = Services.GetRequiredService<ILogger>();

logger.LogError("My unscoped error message");

// Appends "MyScope" to the log source
using (logger.BeginScope("MyScope")) {

    logger.LogWarning("My scoped warning");

    // Tags log records with the extra identifing properties.
    using (logger.BeginScope(new Dictionary<string, object>{
       `["ID del cliente"] `= 123,
       `["ID del pedido"] `= 12
    })) {

        logger.LogWarning("My warning with extra data");

    }
}

Ejemplo de salida de registros de memoria con alcance configurado

Nota

Cualquier propiedad añadida por el alcance estará protegida, lo que significa que se registrará y mostrará Registrar datos seguros tiene que ser ON.

Más información

Puede encontrar más información sobre Microsoft's Logger API así como sus métodos de extensión en el Navegador de API .NET de Microsoft.