Automatisering voor Financiële Dienstverleners UBizz-UBizz Exchange For more information visit our website at www.pyrrho.com
2 Historie Revisie Datum Door Wijzigingen 1.0 23 maart 2007 AJ Eerste versie
3 1 INTRODUCTIE... 2 2 NETWERK INSTELLINGEN... 3 2.1 ONTVANGENDE PARTIJ... 3 2.2 VERSTURENDE PARTIJ... 3 3 UBIZZ INSTELLINGEN... 4 4 MAATSCHAPPIJ/AGENTSCHAP EN SUBAGENT INSTELLINGEN... 7 4.1 STUUR NAAR MIJ UBIZZ... 7 4.2 STUUR NAAR SUB UBIZZ... 9 5 VERWERKEN BINNENGEKOMEN BERICHTEN... 10 6 LICENTIE SLEUTEL... 12
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.
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.
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:
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
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.
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.
8
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.
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!
11
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.