Domanda:
Come attivare la registrazione di debug di Windows Explorer Client?
Risposta:
Windows Explorer Client, a partire da DocuWare 6, ha la possibilità di registrare informazioni importanti durante il lavoro. Utilizza il meccanismo di registrazione standard di DocuWare, il che significa che la configurazione e i parametri al suo interno hanno lo stesso significato che hanno nelle altre applicazioni DocuWare.
Fino alla versione 6.7 di DocuWare
Per abilitare la configurazione è necessario inserire una sezione aggiuntiva nel file delle impostazioni di Windows Explorer Client (DocuWare.WindowsExplorerClient.dll.settings). Questo file di impostazioni si trova in %localappdata%\DocuWare\WEC.Per abilitare la registrazione è necessario inserire la seguente configurazione appena prima del tag di chiusura:
<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>
Probabilmente le opzioni più importanti della configurazione sono fileName e logLevel. La prima indica il percorso in cui viene creato il file di configurazione. Dovrebbe essere un luogo in cui l'utente di Windows attualmente connesso ha accesso in scrittura. Il secondo indica il livello di configurazione che sarà abilitato. Debug è il livello preferito, in quanto mostrerà tutti i registri durante il lavoro dell'applicazione.
C'è qualcosa di fondamentale perché il registro di Windows Explorer Client funzioni. La configurazione del registro GAPI deve essere rimossa (o commentata). Il file di configurazione appropriato si trova nella cartella di installazione di Windows Explorer Client "DocuWare.Gapi.dll.config". Questo è il contenuto predefinito del file di configurazione di GAPI:
<configurazione>
<configSections>
<sezione 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 riga in grassetto sopra (tag loggingManagement) dovrebbe essere commentata o rimossa, ad esempio in questo modo:
<!-- <loggingManagement mode="off"/> -->
Sebbene per impostazione predefinita la registrazione sia disattivata, GAPI inizializza comunque il suo logger e, a causa del modo in cui il meccanismo di registrazione è implementato, questo disabilita il logger di Windows Explorer Client. Se questo non viene fatto, il registro di Windows Explorer Client verrà riempito con le informazioni di comunicazione di GAPI. E questo non è ciò che vogliamo!
Il file di configurazione GAPI si trova nella cartella di installazione di Windows Explorer Client (C:\Program Files\DocuWare\Windows Explorer Client) ed è specifico per esso. Questa modifica NON danneggia le altre applicazioni DocuWare.
Dalla versione 6.8 di DocuWare:
La registrazione è sempre attivata. Verranno scritti solo gli errori. In caso di analisi, la registrazione potrebbe essere estesa a una registrazione di debug. Aprire il file DocuWare.PlatformUIProcess.exe.config nel percorso di installazione di Windows Explorer Client (per impostazione predefinita: C:\Program Files\DocuWare\Windows Explorer Client).
Individuare il TAG <loggingManagement> e il parametro logLevel="Errore". Cambiare il valore del parametro "Error" con il valore Debug".
Il parametro fileName contiene il percorso del file di registrazione.
Come impostazione predefinita è "%TEMP%\DocuWare\Logs\PlatformUIProcess.log".
Dopo il salvataggio le modifiche sono subito attive. Non è necessario riavviare nulla.
Si prega di notare: Questo articolo è una traduzione dall’inglese. Le informazioni contenute in questo articolo si basano sulla/e versione/i originale/i del prodotto in inglese. Potrebbero esserci piccoli errori, come nella grammatica usata nella versione tradotta dei nostri articoli. Sebbene non possiamo garantire la completa esattezza della traduzione, nella maggior parte dei casi troverà che è sufficientemente informativa. In caso di dubbi, torni alla versione inglese di questo articolo.