Pregunta:
¿Cómo se activa el registro de depuración del Windows Explorer Client?
Respuesta:
Windows Explorer Client, a partir de DocuWare 6, tiene la capacidad de registrar información valiosa durante su trabajo. Utiliza el mecanismo de registro estándar de DocuWare. Esto significa que la configuración y los parámetros dentro de la configuración tienen el mismo significado que en las demás aplicaciones de DocuWare.
Hasta DocuWare Versión 6.7
Para habilitar la configuración hay que colocar una sección adicional en el archivo de ajustes del Windows Explorer Client (DocuWare.WindowsExplorerClient.dll.settings). Este archivo de ajustes se encuentra en %localappdata%\DocuWare\WEC.Para habilitar el registro debe introducirse la siguiente configuración justo antes de la etiqueta de cierre:
<UserSettings>
......
<loggingManagement mode="on" trace="on">
<loggingModule assembly="DocuWare.WindowsExplorerClient">
<publisher assembly="DocuWare.Common" type="DocuWare.Common.Logging.FilePublisher" logLevel="Debug" fileName="C:\DWWECLog.log" maxFileSize="30000" enhancementMethod="newFile" maxFileNumber="50" />
</loggingModule>
</loggingManagement>
Probablemente las opciones más importantes de la configuración son fileName y logLevel. La primera apunta a la ruta donde se crea el fichero de configuración. Este debe ser un lugar donde el usuario actualmente logueado en Windows tenga acceso de escritura. El segundo indica el nivel de configuración que se habilitará. Debug es el nivel preferido, ya que mostrará todos los registros durante el trabajo de la aplicación.
Hay algo crucial para que el registro de Windows Explorer Client funcione. Hay que eliminar (o comentar) la configuración de registro de GAPI. El archivo de configuración adecuado para ello se encuentra en la carpeta de instalación del Windows Explorer Client "DocuWare.Gapi.dll.config". Este es el contenido predeterminado del archivo de configuración de GAPI:
<configuration>
<configSections>
<section name="GapiConfig" type="DocuWare.Gapi.Client.GapiConfigHandler, DocuWare.Gapi"/>
<section name="loggingManagement" type="DocuWare.Common.Logging.LoggingManagerSectionHandler,DocuWare.Common"/>
</configSections>
<runtime>
<legacyUnhandledExceptionPolicy enabled="true" />
</runtime>
<appSettings>
<add key="DetailedErrors" value="off"/>
</appSettings>
<GapiConfig SettingsStorage="DocuWare.Gapi.dll.Ajustes" ObjectLifeTime="1000" CachedSelectlistLength="200" BitmapTransparencyType="Color" DefaultTrueTypeFont="Arial"/>
<loggingManagement mode="off"/>
</configuration>
La línea en negrita de arriba (etiqueta loggingManagement) debería comentarse o eliminarse, por ejemplo así:
¡<!-- <loggingManagement mode="off"/> -->
Aunque por defecto el registro está desactivado, GAPI sigue inicializando su registrador y, debido a la forma en que está implementado el mecanismo de registro, esto desactivará el registrador de Windows Explorer Client. Si no se hace esto, el registro del Windows Explorer Client se llenará de información de comunicación de GAPI. Y esto no es lo que queremos!
El archivo de configuración de GAPI se encuentra dentro de la carpeta de instalación de Windows Explorer Client (C:\Program Files\DocuWare\Windows Explorer Client) y es específico para él. Este cambio NO afectará a otras aplicaciones DocuWare.
Desde la versión 6.8 de DocuWare:
El registro está activado siempre. Sólo se escriben los errores. En caso de análisis, el registro puede ampliarse a un registro de depuración. Abra el archivo DocuWare.PlatformUIProcess.exe.config en la ruta de instalación de Windows Explorer Client (por defecto: C:\Program Files\DocuWare\Windows Explorer Client).
Busque el TAG <loggingManagement> y el parámetro logLevel="Error".. Cambie el valor del parámetro "Error " por el valor Debug".
El parámetro fileName contiene la ruta del archivo de registro.
Por defecto es "%TEMP%\DocuWare\Logs\PlatformUIProcess.log".
Después de guardar los cambios se activan de inmediato. No es necesario reiniciar nada.
Tenga en cuenta: Este artículo es una traducción del idioma inglés. La información contenida en este artículo se basa en la(s) versión(es) original(es) del producto(s) en inglés. Puede haber errores menores, como en la gramática utilizada en la versión traducida de nuestros artículos. Si bien no podemos garantizar la exactitud completa de la traducción, en la mayoría de los casos, encontrará que es lo suficientemente informativa. En caso de duda, vuelva a la versión en inglés de este artículo.