Risoluzione dei problemi del servizio di upload

Consultare le indicazioni seguenti per risolvere eventuali problemi con il servizio di upload. Se il problema persiste, contattare il team di supporto di DocMX.

Problema di autorizzazione

Se all'apertura dell'applicazione viene visualizzato il messaggio ‘Problem authorising’, significa che il servizio non riesce a raggiungere il server di identità per l'autenticazione.

1. Verificare che il computer disponga di accesso a Internet e che dal browser sia possibile connettersi al proprio URL di DocMX. In questo modo si ha la certezza che l'URL sia stato inserito nella whitelist e che nessun firewall blocchi la connessione.

2. Fare clic sul pulsante Advanced in basso a destra e verificare la presenza di eventuali messaggi di errore. Se viene visualizzato il messaggio ‘Unable to get disco’, controllare l'URL utilizzato per il tentativo di connessione. Di solito questo indica che l'URL non è corretto oppure che il client non riesce a raggiungere l'endpoint perché è bloccato.

Connettività API

Se il client non riesce a connettersi all'API, fare clic sul pulsante Advanced e quindi sul pulsante ‘Bounce’. Se viene restituito il risultato Results: [“Connection”,”Successful”], il servizio è riuscito a raggiungere l'API. In questo caso, contattare il supporto per verificare che il client sia abilitato. Se viene restituito un errore, controllare nel log l'endpoint a cui il servizio ha tentato di connettersi e verificare dal browser che sia possibile connettersi all'indirizzo URL e che non sia necessario inserire l'URL nella whitelist o creare un'eccezione nel firewall.

Accesso locale

Se accanto all'accesso locale è presente una croce rossa, verificare che l'applicazione o il servizio disponga delle autorizzazioni corrette per accedere alla cartella della directory di lavoro. Se la cartella di lavoro non esiste, l'applicazione tenterà di crearla.

Contattare il supporto se è necessario spostare la directory locale in un'altra posizione.

Avvio dell'applicazione

In caso di problemi all'avvio dell'applicazione, verificare che l'applicazione o il servizio abbia accesso al percorso seguente; è necessario l'accesso in lettura e scrittura.

C:\Users\All Users\docmx (oppure il profilo di un utente specifico, se l'installazione è stata eseguita specificamente per tale profilo).

Registrazione

Per facilitare la diagnosi di eventuali problemi durante l'esecuzione del servizio di upload, per impostazione predefinita il log viene salvato nel seguente percorso:

%APPDATA%\Roaming\docmx oppure %APPDATA%\Local\docmx

È possibile modificare questa impostazione nel file application.config, sia per l'applicazione sia per il servizio, per salvare il log in un altro percorso.

Autorizzazioni

Se viene visualizzato un messaggio di avviso che segnala un errore di accesso al file di configurazione:

‘Error Message: Access to the Path’

Verificare che l'account di servizio utilizzato per eseguire il servizio di upload disponga delle autorizzazioni di LETTURA e SCRITTURA sul percorso e sui file specifici al suo interno:

• %programdata%/docmx/uploadservice.json

• %programdata%/docmx/uploadservicesettings.json

Il servizio si avvia e poi si arresta

Se l'applicazione funziona correttamente ma il servizio si arresta quando si tenta di avviarlo, consultare il Window Event Viewer per individuare l'errore generato.

Se nel log è presente uno dei seguenti errori, di solito significa che l'account utente che esegue i servizi non dispone di privilegi sufficienti. Verificare che l'account utente che esegue il servizio disponga dell'accesso amministrativo locale al computer. Per verificarlo, impostare l'account utente su ‘Local System Account’ e avviare il servizio. Se il servizio viene eseguito correttamente, si tratta di un problema di autorizzazioni.

Errori del Visualizzatore eventi: