Registro de MS Dynamics CRM 4.0 E-mail Router

Microsoft Dynamics CRM 4.0 E-mail Router posee la capacidad de registrar las operaciones que realiza. Tanto el detalle del tipo de operaciones que registra como el lugar donde dichas operaciones son registradas puede ser configurado. No existen infinidad de combinaciones a la hora de configurar el registro del router, pero si un abanico lo suficientemente amplio como para elegir entre distintas posibilidades según el propósito de la captura del mismo

 

Detalle del tipo de operaciones a registrar

CRM E-mail Router permite cuatro diferentes niveles de detalle, que denominaremos LogLevel, en el registro de las operaciones que lleva acabo más uno que indica que se aplique el nivel predeterminado del servicio para un determinado perfil de correo entrante o saliente.

Los niveles son configurados con un valor numérico según la siguiente tabla:

LogLevel Descripción
-1 - Sólo tiene sentido para un determinado perfil de entrada o salida de correo. - Indica que el nivel de detalle será el configurado para el perfil será el mismo que el del servicio de E-mail Router.
0 - No registra operación alguna.
1 - Nivel de detalle Normal. - Registra sólo errores típicos. - Este es el nivel configurado tras la instalación de E-mail Router.
2 - Nivel de detalle Medio. - Registra la información de nivel 1 y además información acerca de las operaciones a nivel de buzón.
3 - Nivel de detalle Alto. - Registra la información de nivel 2 y además información acerca de las operaciones a nivel de mensaje.

 

Ubicación de destino

Por defecto la ubicación del registro de E-mail Router es el registro de aplicación del visor de sucesos de Windows. En dicho registro las operaciones poseen el origen MSCRMEmail.

screen01

El detalle de uno de los eventos registrados sería:

screen02

No obstante E-mail Router permite redireccionar el registro de operaciones a un fichero en formato de texto plano. De esta manera podemos obtener el registro en el siguiente formato:

screen03

 

Como configurar el registro de CRM E-mail Router

No es extraño que la configuración del registro se realice en el archivo Microsoft.CRM.Tools.EmailAgent.xml ya que, como vimos en una de las entradas previas de este blog, toda la configuración del servicio de E-mail Router realizada a través del Administrador de configuración se almacena en dicho fichero. Lo que si es una novedad es que para proceder a la mencionada configuración haya que proceder a la edición de este archivo de manera manual.

La configuración del registro se puede realizar para el servicio entero, esto es que el nivel de detalle de registro y su ubicación se configure para todos los perfiles de correo entrante o saliente; o bien que se realice para uno o varios perfiles de configuración.

La configuración se realizará mediante la inclusión de dos etiquetas xml:

  • LogLevel para definir el nivel de detalle del registro.
  • LogFile para definir un fichero en formato de texto plano. E-mail router de manera predeterminada registrará las operaciones en el registro de aplicación del visor de sucesos.

De esta manera las posibles configuraciones son:

  • Configuración del registro para todo el servicio. Se deben incluir las antes mencionadas etiquetas en la sección SystemConfiguration

     screen04a
    En este ejemplo se configura el registro para todo el servicio E-mail Router con un nivel de detalle 3 en el fichero C:\Archivos de programa\Microsoft CRM Email\Services\Log.txt

  • Configuración de un determinado perfil de correo entrante o saliente. Se deben incluir la etiqueta en la correspondiente sección

    screen05a 
    En este ejemplo se configura el registro para el perfil de correo entrante del buzón dguzman@CrmEsp.local con un nivel 3 y direccionado al archivo C:\Archivos de programa\Microsoft CRM Email\Services\Domingo_Guman_AzaLog.txt.

Por Nacho Peiro Alba