Transfer-Agent

 

Inhoud:

Installatie
Configuratie
Debugging
De gouden regels


Oude versies

 

 

 

Installatie

De nieuwste versie (V4.2.9.36) van de Windows

  • OpenIMS Transfer-Agent is te downloaden op de OpenIMS Website (exe, msi) (changelog).
    De laatste optie is met name bedoeld voor installatie op clients die niet beschikken over een internet connectie. Voor gebruik op Apple systemen dien je de Mac Transfer Agent te gebruiken.  

 

Andere installatie-directory

Dit is mogelijk door de MSI-versie vanaf de

  • command line te installeren met het volgende commando:
  • msiexec /i "
  • OpenIMS automatic transfer agent.msi " INSTALLDIR=D:\TA

 

of voor een “stille”

  • installlatie:
  • msiexec /q /i "
  • OpenIMS automatic transfer agent.msi" INSTALLDIR=D:\TA

 

 

 

 

Configuratie

De instellingen van de

  • OpenIMS Transfer-Agent zijn op de clients te vinden onder ‘Start -> Programma’s ->
  • OpenIMS -> Configureren Agent’. Hieronder worden de diverse instellingen beschreven.

 

Algemeen

Taal: Stel de gewenste taal in van de Transfer-Agent.

  • Caching: Geef aan of
  • OpenIMS een lokale kopie van bestanden op de client moet laten staan. Het uitschakelen van de cache kan nuttig zijn bij gedeelde systemen maar heeft wel nadelige gevolgen voor de performance.

Verzend limiet: Geef aan wat de maximale pakketgrootte is waarmee de Transfer-Agent bestanden verstuurd. Dit is met name bedoeld voor Proxy servers die bepaalde eisen stellen aan de grootte van netwerk pakketten (

  • packetsize).

Temp DIR: Geef aan wat lokale werkmap is van de  Transfer-Agent. Standaard wordt hiervoor de

  • appdata/
  • roaming folder gebruikt. Als je dit wilt aanpassen moet je beginnen met de drive letter
  • gevolgt door een dubbele punt, dan een backslash en daarna het pad. (
  • bijv C:\Openims)

Sleutel/gebruiker/

  • supergroup/server:

Deze instellingen worden gebruikt bij o.a. de outlookkoppeling en verschillen per gebruiker. De instellingen kunnen ingevuld worden middels een link in het DMS.

Neem

  • lock niet over:

Als dit wordt aangevinkt, mogen gebruikers geen documenten bewerken die al door iemand anders bewerkt worden.

Keuze lokaal bestand: Bepaalt wat de transfer agent moet doen als de lokale versie afwijkt van de serverversie, bijvoorbeeld omdat een eerdere upload mislukt is. Het standaardgedrag is dat de gebruiker alleen de lokale versie kan

  • openenen. Als deze optie aangevinkt wordt, zal de gebruiker de keuze
  • kirjgen tussen de lokale versie of de server versie.

Wachttijd voor applicatie: Als applicaties heel langzaam opstarten kan dat hier aangegeven worden. Zodat wordt voorkomen dat de agent zich al afsluit voordat het bestand geopend is.

Geen al geopend

  • popup:

 Onderdrukt de melding dat het bestand alreeds geopend is op de client.

Alleen

  • LockFile met:

 Hier kan je aangeven voor welke extensies alleen naar de

  • lock van het bestand gekeken wordt
  • ipv ook het bijbehorende programma.

Standaard instelling: Hiermee worden de standaard algemene instellingen voor de Transfer-Agent ingevuld.

Forceer IP Type: Hiermee kan je het gebruikte IP protocol vastzetten op 4 (IPv4) of 6 (IPv6) indien nodig.

 

 

 

Proxy

  • instellingen

 

Automatisch: Geef aan of de Transfer-Agent automatisch de proxyserver en bijbehorende instellingen kan detecteren.

Adres: Geef het

  • ip-adres op van de proxyserver.

Poort: Geef de te gebruiken poort op van de proxyserver.

Gebruiker: Geef de gebruikersnaam op

  • waarme verbinding met de proxyserver moet worden gemaakt. 

Wachtwoord: Geef het wachtwoord waarmee de ingestelde gebruiker verbinding kan maken met de proxyserver.

 “Basic” authenticatie: Geef aan of deze vorm van

  • authenticate moet worden gebruikt. (Let op, de Transfer-Agent ondersteund geen NTLM authenticatie.) 

Geen proxy voor: Geef aan welke

  • ip-adressen of domeinnamen worden benaderd zonder gebruik te maken van de ingestelde proxyserver.

Standaard instelling: Hiermee worden de standaard proxy instellingen voor de Transfer-Agent ingevuld.

 

 

 

 

 

 

 

Debugging

Debug modus: Geef aan of de Transfer-Agent debug informatie moet tonen tijdens het uitvoeren.

Debug log: Geef aan naar welk bestand door de Transfer-Agent debug informatie wordt weggeschreven. (C:\MAP\openims-debug.log waarbij MAP een geldige map moet zijn waar de gebruiker schrijfrechten heeft.)

Profile modus: Geef aan of de Transfer-Agent profile informatie moet verzamelen tijdens het uitvoeren.

Profile log: Geef aan naar welk bestand door de Transfer-Agent debug informatie wordt weggeschreven. (C:\MAP\openims-profile.log waarbij MAP een geldige map moet zijn waar de gebruiker schrijfrechten heeft.)

Vertraging del: Dit is een debug mode om een vertraging toe te passen in het

  • deletedit commando bij het gebruik van een
  • Openims download folder.

Standaard instelling: Hiermee worden de standaard

  • debugging instellingen voor de Transfer-Agent ingevuld

 

 

 


 

 

"De gouden regels”

De TA maakt geen automatische back-ups gedurende de tijd dat de gebruiker het document geopend heeft. Om ervoor te zorgen dat binnen redelijke tijd toch een update van de versie in het

  • OpenIMS opgeslagen wordt dient de gebruiker dit zelf te doen door het programma te sluiten, en daarna het bestand weer vanuit DMS met bewerken te openen. Ons advies is om dit minimaal elke 2 uur te doen, of vaker indien er veel gewijzigd is. Dan zal de TA in werking treden en zal visueel voor de gebruiker zichtbaar worden dat het bestand wordt verstuurd naar
  • OpenIMS.

 

Indien het de TA niet lukt om het bestand naar

  • OpenIMS te sturen zal daarvan een melding richting de gebruiker worden getoond. Hierbij staan dan de acties die de gebruiker kan uitvoeren.

 

Indien de gebruiker geen visuele melding krijgt van het verzenden en/of er twijfel is of het bestand wel verzonden is, kan dit door de gebruiker eenvoudig worden nagegaan, door naar de desbetreffende pagina in

  • OpenIMS te gaan en deze te
  • refreshen. Als bestand goed is verzonden, zal de datum/tijd bijgewerkt zijn. Mocht dit niet geval zijn, dan adviseren wij om met de werkplek beheerder dit verder na te gaan.

 

Als gebruik wordt gemaakt van een virtuele werkplek (bijv. Citrix) is het advies de temp folder te laten wijzen naar een persoonlijke netwerkschijf. (zie ook: Temp Configuratie TA)

Voor het succesvol synchroniseren met het

  • OpenIMS is het essentieel dat  de werkplek/computer niet wordt uitgezet, of de laptop dichtgeklapt of uit de
  • docking station wordt gehaald, voordat het upload proces is voltooid, (dat plaatsvindt nadat  het
  • programma,waarmee je het document aan het bewerken bent, wordt afgesloten)

 

Als je een document vanuit

  • OpenIMS geopend hebt mag je nooit "Opslaan als" binnen het programma kiezen. Hierdoor wordt het bestand op een andere locatie opgeslagen en zal de TA dan niet meer werken.

 

 

 

  • Troubleshooting:

Melding in Chrome "Open met

  • OpenImsToolkit

" blijft steeds terug komen

November 2022

Geen vinkje bij de TA

  • popup
  omdat de verbinding niet via
  • ssl loopt (
  • https) in Chrome en
  • Edge.

 

 

Fix:

In Chrome (of

  • Edge
) ga je naar: chrome://flags/ (stap 1)

 

in het zoekvenster typ je "

  • insecure
  • origins", je komt dan bij het kopje: "
  • Insecure
  • origiins
  • treated as secure". Dit zet je op "
  • enabled" (stap 2) en je geeft in de box eronder de
  • url op: http://xxxx (stap3)

 

 

Vervolgens klik je op de blauwe

  • Relaunch
knop rechts onder (stap 4)

 

november 2019

In Chrome blijft de melding "Open met

  • OpenIms Toolkit" elke keer terug komen, er is geen vinkje meer om dit standaard in te stellen, zoals bij vorige versies. Dit speelt alleen bij gebruikers die dit nog niet eerder hebben ingesteld. Om dit te verhelpen moet de
  • Trasnsfer Agent
  • geallowlist worden via een register instelling in Windows:

 

Windows

  • Registry Editor Version 5.00

 

[HKEY_LOCAL_MACHINE\Software\Policies\Google\Chrome\URLAllowlist]
"1"="

  • openimstoolkit://*"

 

 

Door onderstaand bestand te downloaden en daarna te dubbelklikken en de prompts te accorderen, kan deze instelling worden

  • geimporteerd in het Windows register. Daarna moet Chrome opnieuw worden gestart.

 

 

chromefix.reg

 

 

Melding in EDGE "Wilt u echt naar een andere app overschakelen" toont elke keer bij het gebruik van de transfer agent

 

april 2020:

In EDGE kan een extra beveiliging ingesteld worden dat deze melding

  • getoont wordt bij het overschakelen naar een andere app.

 

Om ervoor te zorgen dat deze melding niet meer getoond wordt is een setting in de

  • registry nodig zodat de app
  • openimstoolkit als vertrouwd wordt gezien.

 

HKEY_CURRENT_USER\SOFTWARE\Microsoft\Internet Explorer\

  • ProtocolExecute\
  • openimstoolkit
    Sleutel "
  • WarnOnOpen" moet
  • DWord waarde "0" hebben. (Als deze waarde "1"heeft, krijg je deze melding)

 

 

 

Excel werkmap delen

Als een Excel file direct na het openen weer wordt opgeslagen dien je te controleren of Werkmap delen aan staat. Deze functie dient uit te staan. Let wel dat deze instelling per document is.

Uitgebreidere Debug informatie

De TA kent een registry setting 'DebugExtended' , toe te voegen in Computer\HKEY_CURRENT_USER\SOFTWARE\OpenIMS\Settings, waarmee je de TA uitgebreidere logging kan laten maken. Hiervoor wordt het bestaande debug bestand verder uitgebreid, deze zal dan ook erg groot kunnen worden.
De 'DebugExtended' moet dan op 'yes' gezet worden. Dit 'yes' moet allemaal kleine letters zijn.

 

 

 

 

Oude versies:

 

 

  • OpenIMS Transfer-Agent V4.2.9.35  EXE MSI

 

 

  • OpenIMS Transfer-Agent V4.2.9.30  EXE MSI

 

 

  • OpenIMS Transfer-Agent V4.2.9.19   EXE MSI

 

 

  • OpenIMS Transfer-Agent V4.2.8.802 EXE MSI

 

 

  • OpenIMS Transfer-Agent V4.2.8.797 EXE MSI

 

Altijd als eerste op de hoogte van de laatste nieuwtjes?

Schrijf je in voor onze nieuwsbrief