AX Retail 2012 R2: Activar trazas del servicio Offline

2 05 2013

El servicio de sincronización de la BBDD Offline de los POS ofrece muy poca información sobre los procesos que realiza. Por defecto, tras instalar el sistema Offline mediante la utilidad Retail Database Utility, tan solo disponemos de información sobre los procesos de sincronización en la tabla RETAILOFFLINESYNCLOG de la BBDD de tienda. En esta tabla se registran el número total de registros cargados o descargados de la BBDD de tienda a las BBDD Offline de los POS pero esa información se registra una vez terminado el proceso de sincronización de cada ámbito.

En las primeras sincronizaciones, tras instalar el sistema Offline o bien en el caso que haya mucha información a sincronizar entre la BBDD de tienda y las BBDD Offline de los POS, a veces es necesario disponer de información más detallada. También en el caso de que se produzca algún error en la sincronización y no dispongamos de información suficiente, puede ser interesante activar el sistema de trazas del servicio de sincronización Offline.

Para activar las trazas del servicio de sincronización Offline, debemos añadir la entrada siguiente al archivo Microsoft. Dynamics.Retail.Offline.Service.exe.config que se encuentra en el directorio C:\Program Files (x86)\Microsoft Dynamics AX\60\Retail POS\RetailOffline. La entrada a añadir es:

  <system.diagnostics>
   <switches>
     <!-- 0-off, 1-error, 2-warn, 3-info, 4-verbose. -->
     <add name="SyncTracer" value="2" />
   </switches>
   <trace autoflush="true">
     <listeners>
       <add name="Tracing" type="System.Diagnostics.TextWriterTraceListener" initializeData="SyncTrace.log" />
     </listeners>
   </trace>
 </system.diagnostics>

En la propiedad SyncTracer podemos indicar el nivel de registro que deseamos. El más conveniente es el 2-warn, pero si quieres ver todos los procesos que realiza el servicio puedes usar la opción 4-verbose (ATENCIÓN: el volumen de trazas que se registran es muy elevado por lo que activar ese nivel de trazas puede generar un archivo de trazas de un tamaño considerable!).

Tras reiniciar el servicio de sincronización podremos revisar las trazas en el archivo SynTrace.log que se genera en el mismo directorio (o el archivo que se haya configurado en initializeData. El archivo de trazas con el nivel 3-info tiene el siguiente aspecto:

Con la información registrada en el log podremos identificar los posibles errores de sincronización y el detalle exacto por cada tabla de los registros sincronizados (no solo por ámbito como en la tabla RETAILOFFLINESYNCLOG que hemos comentado anteriormente.