Probleemoplossing voor de uploadservice

Raadpleeg de volgende richtlijnen om problemen met de uploadservice op te lossen. Lukt het u daarna nog steeds niet om het probleem op te lossen, neem dan contact op met het supportteam van DocMX.

Probleem bij autoriseren

Als bij het openen van de applicatie het bericht ‘Problem authorising’ wordt weergegeven, betekent dit dat de service de identiteitsserver niet kan bereiken voor authenticatie.

Controleer of de computer internettoegang heeft en of u vanuit de browser verbinding kunt maken met uw DocMX-URL. Zo weet u zeker dat de URL op de whitelist staat en dat er geen firewalls zijn die de verbinding blokkeren.
Klik rechtsonder op de knop Advanced en controleer of er een foutmelding wordt weergegeven. Als het bericht ‘Unable to get disco’ wordt weergegeven, controleer dan de URL die wordt gebruikt om verbinding te maken. Dit betekent meestal dat de URL onjuist is of dat de client het eindpunt niet kan bereiken omdat het wordt geblokkeerd.

API-connectiviteit

Als de client geen verbinding kan maken met de API, klik dan op de knop Advanced en vervolgens op de knop ‘Bounce’. Als het resultaat Results: [“Connection”,”Successful”] is, heeft de service de API kunnen bereiken. Neem in dat geval contact op met support om te controleren of de client is ingeschakeld. Als er een fout wordt geretourneerd, controleer dan in het logbestand met welk eindpunt de service verbinding probeerde te maken. Controleer ook of u vanuit de browser verbinding kunt maken met het URL-adres en of het niet nodig is de URL op de whitelist te zetten of een firewalluitzondering aan te maken.

Lokale toegang

Als er een rood kruis staat bij de lokale toegang, controleer dan of de applicatie of service de juiste machtigingen heeft voor toegang tot de map van de werkdirectory. Als de werkmap niet bestaat, probeert de applicatie deze aan te maken.

Neem contact op met support als u wilt dat de lokale directory naar een andere locatie wordt verplaatst.

De applicatie starten

Als er een probleem is bij het starten van de applicatie, controleer dan of de applicatie of service toegang heeft tot de volgende locatie. Lees- en schrijftoegang is vereist.

C:\Users\All Users\docmx (of een specifieke gebruiker als de applicatie specifiek in een gebruikersprofiel is geïnstalleerd).

Logboekregistratie

Om problemen bij het uitvoeren van de uploadservice te helpen diagnosticeren, wordt het logbestand standaard op de volgende locatie opgeslagen:

%APPDATA%\Roaming\docmx of %APPDATA%\Local\docmx

U kunt dit voor zowel de applicatie als de service wijzigen in het bestand application.config om het logbestand op een andere locatie op te slaan.

Machtigingen

Als er een waarschuwing verschijnt dat er een fout is opgetreden bij de toegang tot het configuratiebestand:

‘Error Message: Access to the Path’

Controleer of het serviceaccount waarmee de uploadservice wordt uitgevoerd LEES- en SCHRIJFmachtigingen heeft voor de locatie en voor de specifieke bestanden daarin:

%programdata%/docmx/uploadservice.json
%programdata%/docmx/uploadservicesettings.json

De service start en stopt daarna

Als de applicatie goed werkt, maar de service stopt wanneer u deze probeert te starten, raadpleeg dan Window Event Viewer om te zien welke fout is opgetreden.

Als een van de volgende fouten in het logboek wordt gevonden, betekent dit meestal dat het gebruikersaccount waarmee de services worden uitgevoerd onvoldoende bevoegdheden heeft. Zorg ervoor dat het gebruikersaccount waarmee de service wordt uitgevoerd lokale beheerdersrechten op de computer heeft. Als u dit wilt testen, stelt u het gebruikersaccount in op ‘Local System Account’ en start u de service. Als de service dan correct werkt, bevestigt dit dat het om een machtigingsprobleem gaat.

Fouten in Event Viewer: