Systeemlabel Calculator

Systeemlabel Calculator Integratie documentatie

Document versie: Uitgiftedatum: Status: Auteur:

1.1 2015-11-25 Definitief Arian Haeser

Systeemlabel Calculator

Inhoudsopgave

Inhoudsopgave ...................................................................................................................................... 2 1

Inleiding .......................................................................................................................................... 3

2

Integratie mogelijkheden .............................................................................................................. 3 2.1 2.2

3

De calculator van FGO+ embedden in uw eigen systeem ...................................................... 3 Via webservices de rekenkern aanroepen .............................................................................. 4

Integreren van de calculator in uw eigen website...................................................................... 4 3.1 3.2 3.3

SSO Koppeling ........................................................................................................................ 4 Aanroep calculator ................................................................................................................... 5 Custom style ............................................................................................................................ 5

Versie / revisie historie In dit hoofdstuk is de wijzigingshistorie van dit document beschreven. Bij kleine wijzigingen zal alleen het revisienummer verhoogd worden. Bij grote wijzigingen zal het versienummer verhoogd en het revisienummer op 0 gezet worden.

Datum 2015-10-29 2015-11-25

Versie 1.0 1.1

Auteur 2BA\AH 2BA

Opmerking Initiële versie Definitieve versie

Pagina 2 van 5


1

Inleiding

UNETO-VNI heeft de systeemlabel calculator laten ontwikkelen voor haar leden. Via http://systeemlabel.uneto-vni.nl is de calculator te benaderen. Leden van UNETO-VNI of abonnees van FGO+ kunnen zonder overige kosten gebruik maken van deze calculator. Er mag vrij gelinkt worden naar deze calculator.

2

Integratie mogelijkheden

Naast het vrij gebruik van de calculator door leden van UNETO-VNI op zijn er de volgende mogelijkheden om de dienst in te bedden (embedden) in uw eigen systeem: 1. De visuele calculator van FGO+ inbedden in uw eigen systeem 2. De rekenkern webservices aanroepen (zinvol bij diepere integraties)

2.1

De calculator van FGO+ embedden in uw eigen systeem

De visuele calculator van FGO+ kan ook “ingebed” worden op uw eigen website met daaraan gekoppeld een custom stylesheet. Eindgebruikers hoeven niet in te loggen bij deze mogelijkheid. Om gebruik te maken van deze dienst dient een contact afgesloten te worden met UNETO-VNI. Deze optie is in principe alleen mogelijk voor partijen die bij 2BA een contract hebben mogelijk. Zie in hoofdstuk 3 de details hoe te integreren. Kosten / meer informatie 

Licentie / abonnement op de Systeemlabel- UNETO-VNI. Voor tarieven en informatie hierover kunt u contact opnemen met UNETO-VNI, contactpersoon Harm van den Oever (079-3250650)



Eenmalige setupkosten van € 450 (Hierin begrepen zijn 4 uur support voor basis SSO koppeling, integratie en invoeren stylesheet wijzigingen). Deze setupkosten worden in rekening gebracht vanaf het eerste contactmoment met onze IT specialisten. Bij overschrijding van deze 4 uur zal op basis van regie verdere ondersteuning plaatsvinden. De SSO koppeling is geen ontwikkeling van 2BA maar van UNETO-VNI, binnen de kennis van 2BA zal hier ondersteuning gegeven worden en anders zal een doorverwijzing naar UNETOVNI plaatsvinden. Voor meer informatie kunt u contact opnemen met 2BA, contactpersoon Arjo Meijrink (0882220000)

Pagina 3 van 5


2.2

Via webservices de rekenkern aanroepen

De calculator van FGO+ maakt gebruik van de door ISSO ontwikkelde webservices. Deze webservices kunnen ook rechtstreeks aangeroepen worden. Dit geeft een grotere mate van vrijheid bij de implementatie. Men kan dan geen gebruik maken van de databank van 2BA en dient een eigen interface te bouwen.

Kosten / meer informatie 

Licentie / abonnement op de Systeemlabel- UNETO-VNI. Voor tarieven en informatie hierover kunt u contact opnemen met UNETO-VNI, contactpersoon Harm van den Oever (079-3250650)



Licentie / abonnement op de ISSO Systeemlabel webservices Voor tarieven en informatie kunt u contact opnemen met ISSO, contactpersoon Michel Verkerk (010-2065969)

3

Integreren van de calculator in uw eigen website

UNETO-VNI biedt de calculator van FGO+ aan in een view die ingebed kan worden in uw eigen website. Dit kan bijv. binnen een IFrame (http://www.w3schools.com/tags/tag_iframe.asp) gebeuren. Om tot integratie te komen dienen de volgende zaken geregeld te zijn: 1. Beschikken over een abonnement (licentie) / contract van UNETO-VNI (waarmee ingelogd kan worden op de FGO+ site) a. Gebruikersnaam b. wachtwoord 2. Beschikken over de SSO gegevens t.b.v. de authenticatie a. SSO Documentatie (UNETO-VNI_20140725_SSO_Externe_partij.pdf) b. Partyname c. Klantspecifieke code d. Salt

3.1

SSO Koppeling

Om een geldige aanroep te doen dient u het SSO protocol van UNETO-VNI te ondersteunen. De SSO koppeling bestaat uit het generen van een code (accesstoken) waarmee een aanroep geautoriseerd kan worden. Voor details hoe de SSO Koppeling precies werkt zie “UNETOVNI_20140725_SSO_Externe_partij.pdf” Dit document wordt bij de support, en dus aangaan van de overeenkomst, implementatie aan u verstrek.

Pagina 4 van 5


3.2

Aanroep calculator

De basislink om de calculator aan te roepen is: https://fgoplus.unetovni.nl/Account/SSO?partyName={partyName}&uid={uid}&code={code}&returnUrl=%2FSysteemlabel% 2FCalculator In deze URL moeten de volgende parameters de juiste invulling krijgen: Parameter

Beschrijving

{partyName}

(Korte) naam van uw firma. (2b)

{uid}

Uw UNETO-VNI accountnummer voor deze koppeling (1a).

{code}

Het SSO token zoals gegenereerd conform de SSO documentatie en aan de hand van de klantspecifieke code (2c), Salt (2d) en Uid (1a)

Voorbeeldaanroep https://fgoplus.unetovni.nl/Account/SSO?partyName=OnsBedrijf&uid=351310&code=19bd3c0b93d7c3f538e919223d34ea 79&returnUrl=%2FSysteemlabel%2FCalculator

Merk op dat een dergelijke URL maximaal 15 minuten geldig is.

3.3

Custom style

Er kan een stylesheet aangeleverd worden of gewenste kleuren / lettertypes ter verwerking in de applicatie.

Pagina 5 van 5

Systeemlabel Calculator

Recommend Documents