Automatisering voor Financiële Dienstverleners
UBizz-UBizz Exchange
For more information visit our website at www.pyrrho.com
Pyrrho
Advanced Industry Solutions B.V. UBizz-UBizz Exchange – Versie 1.0 2
Historie
Revisie
Datum
Door
Wijzigingen
1.0
23 maart 2007
AJ
Eerste versie
Pyrrho
Advanced Industry Solutions B.V. UBizz-UBizz Exchange – Versie 1.0 3
1
INTRODUCTIE ....................................................................................... 2
2
NETWERK INSTELLINGEN ..................................................................... 3 2.1 2.2
ONTVANGENDE PARTIJ ............................................................................. 3 VERSTURENDE PARTIJ .............................................................................. 3
3
UBIZZ INSTELLINGEN ........................................................................... 4
4
MAATSCHAPPIJ/AGENTSCHAP EN SUBAGENT INSTELLINGEN .............. 7 4.1 4.2
STUUR NAAR MIJ UBIZZ ........................................................................... 7 STUUR NAAR SUB UBIZZ .......................................................................... 9
5
VERWERKEN BINNENGEKOMEN BERICHTEN ....................................... 10
6
LICENTIE SLEUTEL .............................................................................. 12
Pyrrho
Advanced Industry Solutions B.V. UBizz-UBizz Exchange – Versie 1.0 2
1 Introductie UBizz-UBizz exchange geeft de mogelijkheid om bepaalde producten tussen verschillende UBizzServer systemen uit te wisselen. Deze uitwisseling vindt plaats door middel van gecodeerde berichten. Hoe deze uitwisseling mogelijk is wordt kort beschreven in de volgende hoofdstukken.
Pyrrho
Advanced Industry Solutions B.V. UBizz-UBizz Exchange – Versie 1.0 3
2 Netwerk instellingen Als er een UBizz product tussen twee UBizzServer systemen moet worden uitgewisseld dan moeten deze systemen een zogenaamde TCP/IP connectie met elkaar kunnen opzetten. Hiertoe is het noodzakelijk dat benodigde firewall en ‘virtual server’ instellingen correct zijn.
2.1
Ontvangende partij
De ontvangende UBizzServer verwacht een binnenkomend connectie verzoek op de poort die is aangeduid door het attribuut ‘ExchangePort’ in de sectie ‘HDN’ van de UBizzServer configuratie file. De UBizzServer configuratie file is aangegeven in de UBizzAdministrator onder ‘Mijn Instellingen’ in het veld ‘Server Config’. Bestaat er al een HDN sectie dan kan hieraan het ExchangePort attribuut worden toegevoegd, en anders dient ook de HDN sectie te worden aangemaakt. Dit poortnummer is vrij te kiezen. We raden aan hier een nummer tussen de 8100 en 9000 voor te nemen. BEGIN HDN; ExchangePort = 8888; END; Tevens moet er in de firewall instellingen en access routers voor gezorgd worden dat dit poortnummer op de UBizzServer machine bereikt kan worden. Raadpleeg hiertoe netwerkspecialisten en desbetreffende documentatie.
2.2
Versturende partij
De versturende UBizzServer moet een TCP connectie naar de ontvangende partij op kunnen zetten. Hiertoe dient het het TCP/IP adres en poortnummer, waarop de ontvangende partij de connectie verwacht, gespecificeerd te krijgen. Tevens moeten alle firewall instellingen een uitgaande connectie naar deze combinatie van adres en poort toestaan.
Pyrrho
Advanced Industry Solutions B.V. UBizz-UBizz Exchange – Versie 1.0 4
3 UBizz instellingen Een product dat wordt uitgewisseld zal zowel uitgaand als binnenkomend eerst in een bestand worden geplaatst. In UBizz moet worden aangegeven waar deze bestanden kunnen worden weggeschreven. Dit gaat als volgt: Meld je aan als gebruiker ‘pyrrho’ bij je UBizzServer. Na aanmelding kiezen onder ‘Extra’ voor ‘UBizz Instellingen’. De volgende dialoog wordt geopend:
In deze dialoog vervolgens het ‘Server Config’ subscherm openen:
Pyrrho
Advanced Industry Solutions B.V. UBizz-UBizz Exchange – Versie 1.0 5
en vervolgens het subscherm ‘HDN’:
Maak op de UBizzServer machine twee directories aan voor deze data uitwisseling, een directory voor de in-berichten en een voor de uit-berichten. Neem vervolgens
Pyrrho
Advanced Industry Solutions B.V. UBizz-UBizz Exchange – Versie 1.0 6
de directory voor in-berichten op in het ‘UBizz DirectoryIn’ veld en voor de uitberichten op in het ‘UBizz DirectoryOut’ veld. Let op dat dit de paden zijn op de UBizzServer (dus geen mapping vanaf een ander station). Om een veld te vullen kies je in het veld met de rechter-muis knop voor ‘Nieuw’.
Hierna klik je met de linker-muis knop het veld aan waarna het kan worden ingevoerd. Kies ‘/’ als scheidingsteken tussen directories. Dit wordt door UBizz weer in ‘\’ zelf omgezet. Als beiden zijn gezet, de subschermen met ‘OK’ afsluiten en het ‘Settings’ scherm opslaan. Om deze wijzigingen, en eventuele wijzigingen in de UBizzServer configuratie file, te activeren dient het UBizzServer proces herstart te worden.
Pyrrho
Advanced Industry Solutions B.V. UBizz-UBizz Exchange – Versie 1.0 7
4 Maatschappij/Agentschap en Subagent instellingen Als de ‘technische’ instellingen in orde zijn om tussen twee UBizz systemen producten te kunnen uitwisselen dient nog te worden aangegeven welk product naar wie moet worden opgestuurd. Het initieren van het versturen van een product wordt vanaf de dialoog van het product uitgevoerd. Hiertoe zijn onder de actie knop op de dialoog dan de volgende acties beschikbaar: ‘Stuur naar Mij UBizz’ en ‘Stuur naar Sub UBizz’.
4.1
Stuur naar Mij UBizz
De actie ‘Stuur naar Mij UBizz’ zal het product gaan opsturen naar de partij die is opgenomen in het veld ‘Agentschap’ van het desbetreffende product. Hiertoe dient dus op dit ‘Verzekeringsagentschap’ te zijn aangegeven waar het naartoe moet worden gestuurd. Open hiervoor de dialoog van deze ‘Agentschap’. Vul vervolgens in het veld ‘UBizz Server Adres’ het TCP/IP adres van de ontvangende partij en in het veld ‘UBizz Server Port’ het poortnummer.
Pyrrho
Advanced Industry Solutions B.V. UBizz-UBizz Exchange – Versie 1.0 8
Pyrrho
Advanced Industry Solutions B.V. UBizz-UBizz Exchange – Versie 1.0 9
4.2
Stuur naar Sub UBizz
De actie ‘Stuur naar Sub UBizz’ zal het product gaan opsturen naar de partij die is opgenomen in het veld ‘Subagent’ van het desbetreffende product. Hiertoe dient dus op deze subagent te zijn aangegeven waar het naartoe moet worden gestuurd. Open hiervoor de dialoog van deze ‘Subagent’. Vul vervolgens in het veld ‘UBizz Server Adres’ het TCP/IP adres van de ontvangende partij en in het veld ‘UBizz Server Port’ het poortnummer.
Pyrrho
Advanced Industry Solutions B.V. UBizz-UBizz Exchange – Versie 1.0 10
5 Verwerken binnengekomen berichten Als een versturende partij een product succesvol opstuurt dan kan de ontvangende partij deze berichten terugvinden in de map ‘Berichtenverkeer/HDN-UBizz Berichten/UBizz Inberichten’.
Na het openen van een van de binnengekomen berichten kan het bericht verwerkt worden. Hiertoe onder de actie knop kiezen voor ‘Verwerk’. Als het product al in het systeem voorkomt zal het worden aangepast aan de hand van de binnengekomen gegevens. Let dus op dat er geen eigen aanpassingen verloren gaan!
Pyrrho
Advanced Industry Solutions B.V. UBizz-UBizz Exchange – Versie 1.0 11
Pyrrho
Advanced Industry Solutions B.V. UBizz-UBizz Exchange – Versie 1.0 12
6 Licentie Sleutel Om de acties daadwerkelijk berichten te laten versturen en via de berichtenverkeer map UBizz Exchange berichten te kunnen inlezen is een aparte licentie sleutel nodig. Deze is te verkrijgen bij Pyrrho. Voor eventuele prijzen zie www.pyrrho.com.
