¶ Update koppelvlakken:
De JOIN Integration Adminstration (JIA) biedt de beheerders van JOIN Zaak en Document met de bijbehorende koppelingen een eenvoudige manier om de koppelingen te updaten indien er bijvoorbeeld een nieuwe versie voor is. Gebruik altijd de meest recente versie van JIA (verderop op deze pagina vindt u informatie over de update van JIA. Kijk hier om de meest recente versie te vinden. JOIN Integration Administration is onderdeel van de JOIN Koppelvlakken Suite. De volgende koppelvlakken kunt u met JOIN Integration Administration onderhouden:
- StUF-DCR (Documentcreatie)
- StUF-BG (Basisgegevens)
- StUF-ZKN (Zaken)
- StUF-LVO (Landelijke voorziening omgevingsloket)
- BerichtenBox MOLZ (Mijn Overheid Lopende Zaken)
¶ Hoe kom ik bij deze JIA website?
Daar zijn twee manieren voor:
- Door op integratie server een browser te openen en te navigeren naar http://localhost:81/Diaweb.
- Door vanaf de werkplek een browser te openen en te navigeren naar https://integratieservernaamwaarjiaisgeinstalleerd:8443/Diaweb.
¶ Ik ben op de website. Wat nu?
Kies in het linkermenu de integratie die u wilt updaten en klik vervolgens op de knop Upgrade. JIA gaat dan verbinding maken met Decos om na te gaan welke nieuwe versies er voor de betreffende koppeling zijn. Bij een toegestane verbinding over poort 80 en 21 zal er in JIA een volgende scherm te zien zijn waar als voorbeeld StUFDCR versie 1.2 is gekozen en waar we zien dat versie 1.3 aanwezig is.
Let op! Indien de update een StUFZKNk oppeling betreft lager dan versie 2.8.0 of een StUFBG koppeling lager dan 2.1.0 graag eerst contact met Decos om de configuratie zeker te stellen. Van alle moderne koppelingen worden de configuraties bijgehouden op https://config.decos.nl.
Let op! Indien de update een StUFBG koppeling is van versie 2.4.0 of lager vergeet dan niet de instructies te lezen in dit artikel.
Indien JIA geen verbinding kan maken met Decos zie je als gebruiker het volgende scherm. Je kunt dan alleen kiezen voor Local Machine en dan navigeren naar het zip bestand dat je hebt kunnen downloaden die je van Decos Support hebt gekregen. Let op! Het zipbestand dat je hebt gedownload niet uitpakken. Bij het navigeren vanuit JIA naar het bestand, navigeer je dus naar het zipbestand. JIA draagt verder zorg voor het uitpakken en verwerken.
Klik vervolgens op de knop Update en wacht totdat de update succesvol is uitgevoerd. Dat ziet er als volgt uit:
Klik na het succes bericht op OK en zie dat het versienummer is opgehoogd van de koppeling:
¶ Installatie JOIN Integration Administration (JIA):
¶ Wat is JOIN Integration Administration?
Met JIA is het mogelijk om de upgrade naar de laatste versie van een integratie eenvoudig zelf uit te voeren. Tevens kunt u het berichtenverkeer van de verschillende koppelingen inzien.
In dit artikel worden de stappen beschreven die nodig zijn om JIA te updaten of te installeren.
¶ Prerequisites
- De applicatieserver moet toegang hebben tot het internet
JIA zal de Decos server benaderen om de benodigde installatiebestanden op te halen. Hiervoor zal het een uitgaande FTP (poort 21) en HTTP (poort 80) gebruiken.
- Microsoft .Net framework 4.5 dient geïnstalleerd te zijn op de applicatieserver
De nieuwe versie van JIA vereist Microsoft .Net framework 4.8. U kunt deze versie downloaden vanaf de Microsoft website: https://www.microsoft.com/nl-nl/download/details.aspx?id=30653
- De rol ‘Windows authentication’ dient geactiveerd te zijn in Microsoft IIS *
Deze rol kan het meest eenvoudig worden toegevoegd d.m.v. het uitvoeren van het volgende Powershell commando op een Windows server versie 2012 of nieuwer.
Install-WindowsFeature “Web-Windows-Auth” -IncludeManagementTools ;
Op oudere Windows Server versies wordt er gebruik gemaakt van Add-WindowsFeature.
¶ Installatie
¶ Stap 1: Download Powerschell script
Download het Powershell script waarmee u JIA en de benodigde vereisten kunt installeren. Voor klanten die onverhoopt nog gebruik maken van Windows 2008 of geen internet connectie van de Integratie server toestaan dient ook de meest recente JIA package gedownload te worden:
- Powershell script JIA 2.4.0 en lager: https://support.decos.nl/setups/Integrations/!JIA_JOIN_Integration_Administration/jiainstall.zip
- Powershell script JIA 2.5.0 en hoger op Windows Server 2012 en nieuwer: https://support.decos.nl/setups/Integrations/!JIA_JOIN_Integration_Administration/jiainstall.zip
JIA Package: https://support.decos.nl/setups/integrations/index/downloadJIA.html
Vergeet na het downloaden de zip bestanden niet te unblocken.
¶ Stap 2: Verwijder oude installatie (optioneel)
Indien er een Decos Integration Administration of JOIN Integration Administration van 2.2.0 of ouder/lager te vinden is in Add/Remove Programs moet deze eerst verwijderd worden a.d.h.v. de volgende stappen. Indien niet aanwezig, dan door met Stap 3.
- Stop in de Windows services de Decos.Integrations.Admin.BackgroundService en sluit weer het services scherm.
- Maak een copy van de map die normaal gesproken op de volgende locatie staat: D:\DECOS\apps\Decos Integration Administration. Er staat normaal gesproken, maar er zijn klanten die e.e.a. op C: of E hebben geïnstalleerd of zelfs een hele andere locatie.
- Via Add/Remove Programs kan dan de oude versie van Decos/JOIN Integration Administration verwijderd worden.
¶ Stap 3: Pak het zip-bestand uit
Unzip het bestand jiainstall.zip naar een handige locatie. Een veelgebruikte suggestie: D:_Install\Integrations\JIA.
¶ Stap 4: Uitvoeren installatie
Navigeer in hetzelfde scherm naar de map waar je de zips hebt neergezet en voer het volgende commando uit: .\jiainstaller.ps1
Let op: door het deinstalleren van de oude Decos/JOIN Integration Administration software kan er een melding komen in het script dat de service ontbreekt. Dit klopt dus.
Het script zal nu een aantal prompts tonen. Kies altijd voor de hoogste versie JIA maar nooit de Development versie tenzij instructies hiervoor ontvangen van Decos.
Wanneer u upgrade naar versie 2.5 of hoger zal het script een aantal aanvullende vragen stellen:
- Het IP adres van de JOIN Zaak & Document server
U kunt kiezen voor de standaardwaarde door op enter te drukken wanneer uw integraties op dezelfde separate server geïnstalleerd zijn als JOIN Zaak & Document. Wanneer JOIN Zaak & Document en uw integraties op eigen applicatieserver geïnstalleerd zijn, moet hier het IP adres van de JOIN Zaak & Document server worden ingegeven.
- De REST api baseurl:
Sinds JOIN versie 6.25 is er een REST API beschikbaar. JIA maakt nu dan ook gebruik van JOIN authenticatie om in te loggen in JIA. Alleen medewerkers met het Recht “Administrator” in JOIN Zaak & Document mogen in JIA inloggen. De REST API url is dezelfde als de JOIN URL. Bijvoorbeeld https://zaaksysteem.meervoort.nl/ De gehele URL inclusief / moeten ingevuld worden.
Voorbeeld-URL: https://zaaksysteem.joinsuite.nl/aspx/swagger/ui/index
- Een Connect systeemnaam van één van uw integraties
Vul hier de naam in van 1 van uw integratie Connect systemen. De standaardwaarde ‘STUFBG’ kan worden bevestigd door op enter te drukken. Wanneer dit systeem niet bestaat kunt u een andere waarde ingeven. Kijk voor beschikbare systemen in de lijst systemen in JOIN Beheer.
- Het client-secret van het ingegeven Connect systeem
Vul hier de client-secret in van het in vraag 2 gekozen Connectsysteem. U kunt deze waarde terugvinden in JOIN Beheer bij het desbetreffende Connect systeem:
¶ Stap 6: Afronden installatie
Zodra het script is afgelopen staat u weer in de prompt en deze kan dan, mits er geen foutmeldingen meer zijn, afgesloten worden. Er is nu een lokale groep DIA aangemaakt. Hier moeten alle gebruikers in die toegang willen hebben tot JIA. Windows 2008 Server: Indien het een Windows 2008 server betreft moet ook nog even nagegaan worden of de DIAWeb Application Pool in IIS wel .Net 4.8 als versie heeft i.p.v. de standaard 2.0.
¶ Stap 7: Test de verbindingen
U kunt nu een webbrowser openen naar http://servernaam:81/Diaweb of https://servernaam:8443/Diaweb. Indien u op de server ingelogd bent mag de servernaam natuurlijk ook localhost zijn.
Vanaf versie 2.5 is de toegang tot JIA gekoppeld aan uw JOIN Zaak & Document login. Indien u aangemerkt bent als JOIN beheerder kunt u inloggen. Indien u nog niet bent ingelogd in JOIN Zaak & Document wordt u bij het benaderen van JIA wordt u doorverwezen naar de inlogpagina van JOIN.
De installatie is succesvol afgerond!
¶ JOIN XML Import service
Maakt u gebruik van de JOIN XML Import service, dan vindt u de informatie over installatie en configuratie hier: https://joinsupport.decos.com/a/solutions/articles/17000103095
¶ Troubleshooting
Is er iets misgegaan met de installatie? Neem dan contact op met een van onze technisch specialisten of de afdeling JOIN Support.