De client software van JOIN kan worden gebruikt om documenten te synhroniseren tussen de JOIN Server en het werkstation. Naast de clientfuncties kan er ook gebruik worden gemaakt van WebDav voor het synchroniseren van wijzigingen in documenten. Daarnaast wordt de client gebruikt voor de JOIN Template Editor (office-sjablonen).
Om wijzigingen in documenten van JOIN automatisch op te slaan is de installatie van de JOIN client software voor Windows nodig. Dit document beschrijft alle mogelijkheden en aandachtspunten voor de installatie van de JOIN client software. Dit document is bedoeld voor systeembeheerders, technisch applicatiebeheerders en consultants.
In dit document staan verwijzingen naar bestanden. Deze zijn te vinden in JOINclientToolkit.zip. Dit bestand is op te vragen via customersupport@decos.com of kan via onze wiki worden gedownload.
De JOIN client software is te downloaden via: https://wiki.decos.nl/nl/releases/releasenotes
Klik vervolgens op de JOIN versie die door uw organisatie wordt gebruikt. Download vervolgens de JOIN download software die voor uw organisatie van toepassing is:
Bij de installatie van een patch is het mogelijk om de client componenten alvast eerder te upgraden dan de serversoftware van JOIN. Het versienummer van de client software mag hoger zijn dan die van de server. Een oudere versie van de client software in combinatie met een nieuwere versie op de server wordt afgeraden.
Het versienummer van de client software kan na installatie gecontroleerd worden door DecosDirect Config te starten (C:\Program Files (x86)\JOINClient).
Bij de installatie van nieuwe client software is het niet noodzakelijk te oude versie te verwijderen. De installer zal automatisch de oude versie bijwerken naar de nieuwe.
Op de werkstations moet minimaal Microsoft .net framework 3.5 geïnstalleerd zijn.
Na het downloaden van de executable of MSI setup is het mogelijk dat het zip bestand ‘beveiligd’ is. Het is noodzakelijk deze beveiliging te verwijderen voordat het bestand wordt gebruikt om de software te installeren. Klik met de rechtermuisknop op het ZIP bestand en kies ‘Eigenschappen’.
Klik op ‘Unblock’ en vervolgens ‘OK’. Het bestand is nu geschikt voor installatie.
Zorg ervoor dat het uitpakte installatiebestand in een directory wordt geplaatst die ook na installatie nog bestaat en voor iedereen toegankelijk is. Bij een latere upgrade of reparatie van de software moet JOIN het oorspronkelijke installatiebestand namelijk kunnen bereiken.
Klik (indien mogelijk) met de rechtermuisknop op het installatiebestand en kies voor ‘Uitvoeren als administrator’ in plaats van dubbelklikken om de installatie te starten.
De JOIN client software bestaat uit twee hoofdcomponenten:
Een van de onderdelen van de JOIN Client Components is JOIN File Control. JOIN File Control (DDC) wordt na het aanmelden van de gebruiker gestart en stuurt gewijzigde versies van documenten terug naar het DMS. Dit werkt als volgt:
Als ddc.exe niet draait én niet gestart kan worden dan zal bij stap 2 het document ter download worden aangeboden. De gebruiker ziet nauwelijks verschil maar wijzigingen worden niet teruggeschreven naar JOIN.
Om te controleren of een document is geopend met JOIN File Control kan er bij de eigenschappen van het pad naar de tekst ddc worden gekeken. Als ddc niet in het pad voorkomt is het bestand gedownload en worden wijzigingen NIET teruggeschreven naar JOIN.
JOIN File Control is te vinden in de zogenaamde system tray van Windows rechtsonder in de taakbalk. Het versienummer dat hier te vinden is wijkt af van het versienummer dat voor de JOIN Clientsoftware wordt gebruikt.
De installatie van JOIN Client Components is noodzakelijk voor opslaan van wijzigingen in JOIN. Installeer deze altijd wanneer er gebruikt wordt gemaakt van JOIN op de lokale computer.
JOIN Now is een add-in voor Microsoft Office. JOIN Now voegt (afhankelijk van de instellingen) een knoppenbalk toe aan de Office applicaties of vervangt het gedrag van de openen/opslaan knoppen in de Office applicatie. De standaard opslag procedure van documenten wordt daarmee vervangen door het ‘Opslaan in JOIN’ scherm.
De installatie kent de volgende onderdelen.
De installatie kent de volgende onderdelen:
Website components
Bevat een ActiveX component voor Internet Explorer waarmee automatisch aanmelden wordt mogelijk gemaakt (SingleSignOn).
Advies: altijd installeren
Components for digital signature
Bevat onderdelen voor het gebruik van de digitale handtekening module van JOIN.
Advies: Alleen installeren wanneer hier gebruik van wordt gemaakt.
Template editor
De sjabloon editor van JOIN. Wordt gebruikt door applicatiebeheerders om sjablonen aan te passen.
Advies: altijd installeren.
Barcode reader interface BARCODE READER INTERFACE
Wordt gebruikt om een handscanner (barcode) te ondersteunen.
Advies: Alleen installeren wanneer er een handscanner voor barcodes wordt gebruikt op de PC.
De installatie kent de volgende onderdelen:
JOIN Now Client Components
Advies: altijd installeren als Microsoft Office geïnstalleerd is.
Configuration Utility
Wordt gebruikt om de instellingen te wijzigen
Advies: altijd installeren.
Quick Start
Wordt gebruikt om het opstarten van JOIN Now te versnellen.
Advies: niet installeren
OpenOffice.org Integration
Alleen installeren wanneer OpenOffice gebruikt wordt.
Outlook Integration
Advies: altijd installeren wanneer Outlook wordt gebruikt.
Word Startup Template
Zorgt ervoor dat er een knoppenbalk wordt aangeroepen vanuit een sjabloon.
Advies: Niet installeren
Groupwise Integration
Advies: Alleen installeren bij gebruik van Novell Groupwise.
Shell Integration
Maakt het mogelijk op te slaan vanuit het rechtermuisknop menu in de Windows Verkenner.
Advies: Altijd installeren
Lotus Notes Integration
Advies: Alleen installeren wanneer Lotus Notes gebruikt wordt.
JOIN Direct Interop Support
Wordt gebruikt om externe applicaties te laten koppelen met JOIN Direct (bijvoorbeeld iWriter)
Advies: altijd installeren
TWAIN scanner interface
Maakt het mogelijk om te scannen naar JOIN met een scanner die is aangesloten op de lokale computer.
Advies: alleen installeren op werkplekken waar een scanner aanwezig voor gebruik met JOIN.
De installatie van JOIN Now op Citrix wijkt af van een reguliere installatie. Na de installatie van de client software op de Citrix server(s) werkt de software niet altijd wanneer de gebruiker zich aanmeldt op de server.
Dit wordt meestal veroorzaakt door het feit dat de Citrix de registersleutels die bij installatie worden neergezet voor de lokale machine/gebruiker niet meeneemt. De volgende onderdelen moeten in dat geval worden ingesteld in de Citrix omgeving:
Zorg dat DDC.exe na het aanmelden van de gebruiker automatisch wordt gestart. Gebruik hiervoor de schakeloptie /s.
C:\Windows\DDC.exe /s
De Office add-ins worden geladen met de volgende registersleutels:
HKEY_CURRENT_USER\SOFTWARE\Wow6432Node\Microsoft\Office\Applicatie(Word\Outlook\Excel\Powerpoint)\Addins\DecosOfficeAddin.Connect
Voeg de REG_DWORD LoadBehaviour=3 variabele toe om ervoor te zorgen dat de add-in altijd wordt geladen. Of maak via de JOIN Now configuratie een export van de registerinstellingen, wanneer de client componenten reeds zijn geïnstalleerd.
Zorg ervoor dat de DDC bestandsextensie is gekoppeld aan DDC.exe.
De optie ‘JOIN’ in het menu ‘Kopiëren naar’ wordt bij een installatie op een Citrix omgeving niet altijd meegenomen. Zie de instructie ‘Rechtermuisknop menu’ in het hoofdstuk ‘Windows Verkenner integratie’.
Het gebruik van applicatie virtualisatie (zoals SoftGrid) wordt afgeraden. Mocht het toch noodzakelijk zijn om de JOIN Clientsoftware te installeren met behulp van applicatie virtualisatie houdt dan rekening het volgende:
De componenten op de werkstations hebben een primaire taak om te integreren in de applicaties waar vanuit JOIN benaderbaar moet zijn (Browser, Office-applicaties, etc.). Bij integratie in bijv. Office is het aan te raden om zowel Office als de client componenten te virtualiseren, of beide niet. Situaties waarbij slechts één van de twee applicaties virtueel is, leiden tot lastig beheersbare omgevingen en complexe problemen. De ‘best practice’ is daarom dat de client componenten op dezelfde wijze gevirtualiseerd zijn als de applicatie waarmee het moet integreren.
Met msiexec in combinatie met het MSI-installatiebestand van de client sofware is het mogelijk de installatie van de client componenten te automatiseren.
Om bijvoorbeeld alleen de gewenste componenten te installeren wordt de ADDLOCAL parameter gebruikt:
Voorbeeld
msiexec.exe /i JOINclient.msi ADDLOCAL=“JOINWebClient,Main,DigitalSignature”
Deze parameter bepaalt welke onderdelen lokaal geïnstalleerd worden door de componenten te benoemen (gescheiden door komma’s). De naam van de componenten kun je vinden door de MSI met ‘Microsoft Orca’ te openen en de Feature tabel in te zien. Hieronder een screenshot van de componentnamen van JOIN Now:
Voor meer informatie over het gebruik van de ADDLOCAL parameter: https://msdn.microsoft.com/en-us/library/aa367536(v=vs.85).aspx
Een andere mogelijkheid om de installatie te automatiseren is het gebruik van een ‘answer file’. Gebruik WISE InstallTailor om de vragen van de MSI wizard te beantwoorden en de antwoorden op te slaan in een MST-bestand.
Gebruik vervolgens msiexec om de MSI aan het MST bestand te koppelen. De oorspronkelijk MSI wordt niet gewijzigd.
Voorbeeld
msiexec /i <JOINclient.msi> TRANSFORMS=<Decos.mst> /passive
In het voorbeeld hier boven wordt de installatie uitgevoerd met alleen een voortgangsindicator. Er verschijnt geen wizard en de installatie wordt uitgevoerd zoals aangegeven in het MST-bestand.
Voor meer informatie over het gebruik van msiexec: https://technet.microsoft.com/nl-nl/library/Cc759262(v=WS.10).aspx
Vanaf versie 2023.11 is het mogelijk om de JOIN client via Microsoft Intune uit te rollen over uw organisatie. Registreer hiervoor de JOIN Client MSI als Windows app (Win32) in Intune. Kies de MSI die nodig is voor de Office-versie die bij u in gebruik is, 32-bits of 64-bits Office. Beide MSI-setups moeten als Windows app (Win32) geregistreerd worden in Intune.
Om er voor te zorgen dat na het klikken op de ‘Opslaan’ knop het document in de juiste JOIN omgeving terecht komt moet het adres van de JOIN server bekend zijn bij JOIN Now. Dit wordt ingesteld in de ‘JOIN Direct Client Configuration Utility’ (C:\Program Files (x86)\JOINClient\DecosDirect Config.exe).
Vul bij ‘Address’ de servernaam in gevolgd door /decosweb/aspx/decosdirect. Afhankelijk van de installatie kan het adres ook zonder ‘decosweb’ worden ingevuld. Bijvoorbeeld ‘http://servernaam/aspx/decosdirect’ Klik op de knop ‘Test JOIN Direct connection’ om te controleren of het pad correct is ingevuld. Als het pad correct is verschijnt er een melding ‘Connection succesfull!’ Vul bij ‘Description’ een eigen omschrijving in.
Na het correct instellen van client configuratie kunnen deze instellingen worden geëxporteerd met de ‘Export’ knop. Deze export kan gebruik wordt om de instellingen centraal uit te rollen.
Om de Office integratie in te schakelen moet ‘Office integration is currently’ op ‘Enabled’ staan.
De standaard openen en opslaan knoppen van Word zorgen ervoor dat het ‘Opslaan in JOIN’ scherm wordt geladen. Gebruik deze optie wanneer het overgrote deel van alle Word documenten in JOIN wordt opgeslagen.
Gebruik deze optie om aparte knoppen voor Open in JOIN/Opslaan in JOIN aan te maken. Het gedrag van de standaard Openen/Opslaan knoppen van Word blijft ongewijzigd. Gebruik deze optie wanneer niet alle Word documenten in JOIN worden opgeslagen.
Deze optie zorgt ervoor dat de knoppen in een aparte werkbalk in het ribbon van Office terecht komen.
Naast de installatie van de client software zijn er nog een aantal aandachtspunten die op de werkstations aangepast moeten worden om een correcte werking van JOIN te garanderen.
De JOIN website (http://servernaam) moet binnen de beveiligingsinstellingen van de browser worden opgenomen in de intranetzone.*
➔ Dit zorgt ervoor dat DDC goed werkt.
De JOIN website (http://servernaam) moet worden toegevoegd aan de lijst met ‘toegestane websites’ voor pop-up blokkering. *
➔ Dit zorgt ervoor dat JOIN altijd een pop-up scherm mag openen.
De JOIN website (servernaam) moet worden opgenomen in de ‘Safe Senders’ list van Outlook voor alle JOIN gebruikers.
➔ Dit zorgt ervoor dat e-mail overzichten van Decos correct worden weergegeven.
Als JOIN ook beschikbaar is via een DNS entry (bijvoorbeeld http://join.organisatie.nl) dan moeten deze URL’s ook worden toegevoegd.
De installatie van de optie “Kopiëren naar” > JOIN wordt geïnstalleerd als de optie “ShellIntegration” is aangevinkt bij de installatie. Mocht deze optie niet geïnstalleerd zijn (bijvoorbeeld in het geval van een Citrix installatie) dan kan deze snelkoppeling als volgt worden aangemaakt.
Plaats een snelkoppeling naar ‘C:\Program Files (x86)\JOINClient\DecosDirectDropFile.exe’ in de map ‘%appdata%\Microsoft\Windows\SendTo’.
Controleer in de betreffende Office applicatie de invoegtoepassing als volgt:
Als het versienummer bij de ‘Server version’ na het klikken op ‘Test connection’ niet zichtbaar is dan is er iets mis met de installatie van de software op de server. Voer een repair uit op de laatste patch van JOIN op de server en controleer of binnen IIS de website in 32-bits modus mag draaien.
Controleer aan de hand van de volgende pagina in de browser of de URL juist is gespeld:
http://servernaam/decosweb/aspx/decosdirect/decosdirect.asmx
of
http://servernaam/aspx/decosdirect/decosdirect.asmx
Dit zou een pagina moeten weergeven met alle mogelijke parameters van deze service.
insert into global_var (SESSION_VARIABLE, SESSION_VALUE) VALUES ('ALWAYSHASDDC', '1');
Let op: alleen uitvoeren wanneer JOIN altijd wordt gebruikt in combinatie met client software.
Importeer InternetExplorerDDC.reg of plak de volgende tekst in kladblok en sla deze op als BrowserDDC.reg:
Windows Registry Editor Version 5.00 [HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\AttachmentExecute\{0002DF01-0000-0000-C000-000000000046}] "Applications\\DDC.exe"=hex:
Importeer het .reg bestand door er op te dubbelklikken.
Gebruik de volgende checklist om te controleren of alle onderdelen van de JOIN client software correct werken: