Question :
Comment activer la journalisation de débogage du Client Windows Explorer ?
Réponse :
Le Client Windows Explorer Client, à partir de DocuWare 6, a la capacité d'enregistrer des informations précieuses pendant son travail. Il utilise le mécanisme d'enregistrement standard de DocuWare. Il utilise le mécanisme de journalisation standard de DocuWare, ce qui signifie que la configuration et les paramètres qu'elle contient ont la même signification que dans les autres applications DocuWare.
Jusqu'à la version 6.7 de DocuWare
Pour activer la configuration, une section supplémentaire doit être ajoutée au fichier de configuration du Client DocuWare Explorer Client (DocuWare.WindowsExplorerClient.dll.settings). Ce fichier de paramètres se trouve dans %localappdata%\DocuWare\WEC.Pour activer la journalisation, la configuration suivante doit être saisie juste avant la balise de fermeture :
<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>
Les options les plus importantes de la configuration sont probablement fileName et logLevel. La première pointe vers le chemin où le fichier de configuration est créé. Il doit s'agir d'un endroit où l'utilisateur actuellement connecté à Windows a un accès en écriture. Le second indique le niveau de configuration qui sera activé. Debug est le niveau préféré, car il affichera tous les journaux pendant le travail de l'application.
Il y a quelque chose de crucial pour que le journal de Windows Explorer Client fonctionne. La configuration de la connexion GAPI doit être supprimée (ou commentée). Le fichier de configuration approprié se trouve dans le dossier d'installation du Client Windows Explorer Client : "DocuWare.Gapi.dll.config". Voici le contenu par défaut du fichier de configuration 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.settings" ObjectLifeTime="1000" CachedSelectlistLength="200" BitmapTransparencyType="Color" DefaultTrueTypeFont="Arial"/>
<loggingManagement mode="off"/>
</configuration>
La ligne en gras ci-dessus (balise loggingManagement) doit être commentée ou supprimée, par exemple comme ceci :
< !-- <loggingManagement mode="off"/> -->
Bien que la journalisation soit désactivée par défaut, la GAPI initialise toujours son journal et, en raison de la manière dont le mécanisme de journalisation est mis en œuvre, cela désactivera le journal du Windows Explorer Client. Si cela n'est pas fait, le journal du Windows Explorer Client sera rempli d'informations sur la communication GAPI. Ce n'est pas ce que nous voulons !
Le fichier de configuration GAPI se trouve dans le dossier d'installation du Client Windows Explorer (C:\NProgram Files\NDocuWare\NWindows Explorer Client) et il est spécifique à ce dernier. Cette modification n'affectera PAS les autres applications DocuWare.
Depuis la version 6.8 de DocuWare :
La Connexion est toujours activée. Seules les erreurs sont enregistrées. En cas d'analyse, la journalisation peut être étendue à une journalisation de débogage. Ouvrez le fichier DocuWare.PlatformUIProcess.exe.config dans le chemin d'installation du Client Windows Explorer (par défaut : C:\NProgram Files\NDocuWare\NWindows Explorer Client).
Localisez le TAG <loggingManagement> et le paramètre logLevel="Error" . Remplacez la valeur du paramètre "Error" par la valeur "Debug".
Le paramètre fileName contient le chemin d'accès au fichier d'enregistrement.
Par défaut, il s'agit de "%TEMP%\DocuWare\Logs\PlatformUIProcess.log".
Après l'enregistrement, les modifications sont immédiatement actives. Il n'est pas nécessaire de redémarrer quoi que ce soit.
Veuillez noter : Cet article est une traduction de l'anglais. Les informations contenues dans cet article sont basées sur la ou les versions originales des produits en langue anglaise. Il peut y avoir des erreurs mineures, notamment dans la grammaire utilisée dans la version traduite de nos articles. Bien que nous ne puissions pas garantir l'exactitude complète de la traduction, dans la plupart des cas, vous la trouverez suffisamment informative. En cas de doute, veuillez revenir à la version anglaise de cet article.