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.
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 (
Temp DIR: Geef aan wat lokale werkmap is van de Transfer-Agent. Standaard wordt hiervoor de
Sleutel/gebruiker/
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
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
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
Onderdrukt de melding dat het bestand alreeds geopend is op de client. Alleen
Hier kan je aangeven voor welke extensies alleen naar de
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
Poort: Geef de te gebruiken poort op van de proxyserver. Gebruiker: Geef de gebruikersnaam op
Wachtwoord: Geef het wachtwoord waarmee de ingestelde gebruiker verbinding kan maken met de proxyserver. “Basic” authenticatie: Geef aan of deze vorm van
Geen proxy voor: Geef aan welke
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
Standaard instelling: Hiermee worden de standaard
|
|
|
|
"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
- ssl loopt (
- https) in Chrome en
- Edge.
Fix:
In Chrome (of
- Edge
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
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.
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: