Rekenmodule. Scildon. Documentatie

(1)

Rekenmodule Rekenmodule Rekenmodule Rekenmodule

Scildon Scildon Scildon Scildon

Documentatie Documentatie Documentatie Documentatie

Laatste wijziging: maandag 25 november 2019

Bijgewerkt t/m versie: V10.7

Referentie: ProjectenScildon_koppelingen

(2)

Inhoudsopgave

1 Algemeen ... 1

1.1 Wat is de rekenmodule ... 1

1.2 Mogelijkheden van de rekenmodule ... 1

1.3 Ondersteunde producten ... 2

1.4 Gebruiksrechten ... 2

1.5 Ondersteuning en support ... 3

2 Technische inrichting ... 4

2.1 De opleverset ... 4

2.2 Installeren ... 5

2.3 Nabewerkingen na installatie ... 5

3 Gebruik van de rekenmodule... 6

3.1 Algemeen ... 6

3.2 Beschikbare methoden ... 6

3.2.1 Methode A: rechtstreekse aanroep van functies in de DLL (bestanden LGO formaat) ... 6

3.2.2 Methode B: gebruik van een tussenbestand met opstart EXE (bestanden LGO formaat) ... 7

3.2.3 Methode C: rechtstreekse aanroep van functies in de DLL (bestanden XLGO formaat) ... 8

3.2.4 Methode D: gebruik van een tussenbestand met opstart EXE (Bestanden XLGO formaat) ... 9

3.2.5 Methode E: gebruik van een service als gegevensoverdracht. (Bestanden XLGO formaat). ... 10

3.3 Gebruik methode A: rechtstreekse aanroep via parameter (LGO bestanden) 14 3.3.1 Uitvoeren van een berekening ... 14

3.3.2 Uitvoeren van een berekening met afdruk van een offerte ... 14

3.3.3 Uitvoeren van een berekening met aanmaak van een offerte in PDF-formaat . 14 3.3.4 Wijzigen van instellingen binnen de ScildonCD ... 15

3.4 Gebruik methode B: gebruik via tussenbestand met EXE. (LGO bestanden) 17 3.4.1 Uitvoeren van een berekening ... 17

3.5 Gebruik methode C: rechtstreekse aanroep via parameter (XLGO bestanden) 19 3.5.1 Uitvoeren van een berekening ... 19

3.6 Gebruik methode D: gebruik via tussenbestand met EXE. (XLGO bestanden) 22 3.6.1 Uitvoeren van een berekening ... 22

(3)

4 Testen ... 26

4.1 Testen van de installatie ... 26

4.2 Testen van de interface (LGO formaat) ... 26

4.3 Testen van berekeningen ... 26

4.4 Eerste implementatie ... 27

Bijlagen

A Uitwisseling gegevens

B Overzicht files binnen de rekenmodule

C Overige informatie

(4)

Rekenmodule Scildon CD

1 Algemeen

1.1 Wat is de rekenmodule

De rekenmodule maakt onderdeel uit van een volledig pakket van advies- en offertesoftware van Scildon. Deze biedt het intermediair mogelijkheden om persoonlijke situaties van klanten in kaart te brengen.

Vanuit deze adviessoftware kan de verzekeringsbehoefte worden geanalyseerd, waarna al dan niet automatisch een individueel gerichte offerte kan worden gemaakt.

Met het offerteprogramma kunnen berekeningen en/of offertes gemaakt worden:

1. Via een interactieve functie

2. Interactief, maar met importeren van de invoer

3. Zonder userinterface, aangestuurd vanuit een andere applicatie

1.2 Mogelijkheden van de rekenmodule

De rekenmodule is de kern van de offerteberekening en kan door vrijwel elke externe software worden aangesproken, waarbij de terug te ontvangen resultaten kunnen variëren van uitsluitend een premiebedrag t/m het volledig aanmaken van een offerte op papier of b.v. PDF-formaat.

Mogelijkheden zijn:

1. berekenen van premie als onderdeel van een website

2. berekenen van premie als onderdeel van vergelijkingssoftware 3. vervaardigen van een offerte op papier

4. vervaardigen van een offerte in PDF

De rekenmodule kan binnen Windows-omgevingen gebruikt worden, zowel op individuele PC’s, op servers als voor toepassingen via het Web.

(5)

1.3 Ondersteunde producten

Binnen de rekenmodule kunnen de volgende product(varianten) worden berekend:

Overlijdensrisicoverzekeringen (Zowel standaard als scildon lifestyle) Gelijkblijvend

Lineair dalend Annuitair dalend

Nova Polis (product met een combinatie van dekkingsmogelijkheden) Gebruik als pensioenverzekering PW, DGA, Garant

Gebruik als kapitaalverzekering Gebruik als lijfrenteverzekering Beleggerspolissen

Beleggers polis koopsom depot plan Gouden Handdruk Polis

Particulier pensioen plan (nieuw regime)

Particulier pensioen plan (nieuw regime - doorlopende provisie) Particulier pensioen plan (oud regime)

Particulier pensioen plan (oud regime - doorlopende provisie) Nabestaanden Polis

Gebruik als lijfrenteverzekering Gebruik als BoxIII (ANW) Lijfrente

Dadelijk ingaande lijfrente Direct Ingaand pensioen Erfrente

Gebruik als Erfrente

Gebruik als samengesteld stijgend.

Wezenrente

Gebruik als Wezenrente

Gebruik als Wezenrente samengesteld stijgend.

AOR

Gebruik als AOR Std/Plus Gebruik als AOR 1eJaars

Gebruik als AOR Stijgend Std/Plus

1.4 Gebruiksrechten

Het gebruik van offerteprogramma en rekenmodule is toegestaan door organisaties die van Scildon Nederland Levensverzekeringmaatschappij N.V. de gebruiksrechten hebben ontvangen.

U bent met ons een schriftelijke gebruiksovereenkomst aangegaan, waarin is

vastgelegd voor welke doeleinden u de software ter beschikking is gesteld en wat uw

(6)

rechten en plichten zijn aangaande het gebruik van de aan u beschikbaar gestelde programmatuur.

Versiebeheer en gebruik van een licentienummer geven een geldigheid aan de afzonderlijke software.

1.5 Ondersteuning en support

Ondervindt u problemen met het in gebruik nemen van de rekenmodule of heeft u op andere wijze tijdens het gebruik vragen over de techniek, inhoud of producten, dan kunt u uiteraard contact opnemen met onze helpdesk.

Computertechnische vragen:

Afdeling: Automatisering Telefoonnummer: 035 – 625 25 28 E-mail: helpdesk@scildon.nl

Productgerichte vragen:

Afdeling: Offerte

Telefoonnummer: 035 – 625 48 86 E-mail: offerte@scildon.nl

Vragen over het (uitbreiding) van gebruik

Afdeling: Marketing

Telefoonnummer: 035 – 625 25 25 E-mail: marketing@scildon.nl

(7)

Data

Interface_LGO

Documentatie

Voorbeelden Interface_XLGO

2 Technische inrichting

2.1 De opleverset

De setup bevat 2 directories:

Rekenmodule - Volledige werkende set

Documentatie - Verschillende documenten - Voorbeeldprogramma’s

- Hulpprogramma’s (Gebruik in overleg met Scildon) De directory Rekenmodule is als volgt opgebouwd.

De omvang van de bestanden is ongeveer als volgt:

< Rekenmodule > Programmatuur 12 Mb 13 files

< Rekenmodule > /Data Databestanden 0,5 Mb 2 files

< Rekenmodule > /Data/Stuur Stuurbestanden 4 Mb +/- 370 files

< Rekenmodule > /Interface_LGO Tussenbestanden 0,1 Mb 2 files

< Rekenmodule >

/Interface_XLGO

Tussenbestanden 0,1 Mb 2 files

< Documentatie> Documentatie 1,0 Mb 4 files

< Documentatie/Voorbeelden> Programmakode 1,1 Mb 11 files

<Rekenmodule>

Stuur ScildonBlackbox

(8)

2.2 Installeren

Installeren van de rekenmodule bestaat uit het eenvoudig kopiëren van de volledige directory-structuur naar een zelf te kiezen locatie op uw PC of netwerk.

De subdirectories “Data” en “Stuur” zijn vaste namen en moeten op deze manier onderdeel uitmaken van de bovenliggende directory.

De directory < Rekenmodule > kunt u elke door u gewenste naam geven.

De subdirectory “Interface_LGO” en "Interface_XLGO" is een directory die ook in de voorbeelden gebruikt wordt. De naam mag gewijzigd worden en kan ook op een andere locatie worden geplaatst.

De directory “Documentatie” bevat uitsluitend informatie over de technische koppeling met de rekenmodule. De naam mag gewijzigd worden en kan ook op een andere locatie worden geplaatst.

2.3 Nabewerkingen na installatie

Voorzie de rekenmodule van de juiste instellingen. Start hiertoe het in de directory

<Rekenmodule> aanwezige programma ScildonCD.exe op.

Doorloop en corrigeer in ieder geval: Instellingen – Relatiegegevens Instellingen – Afdruk instellingen Vul het door Scildon verstrekte licentienummer is:

Instellingen – Overige instellingen

De instellingen van de ScildonCD zijn voor een gedeelte vastgelegd in de legal_a.ini en legal_d.ini.

De overige instellingen zijn binnen de registry vastgelegd onder de key:

HKEY_CURRENT_USER\Software\LGN\LCD6.x.x\

Voor verspreiding van de installatie naar andere PC’s of locaties wordt aangeraden de instellingen met juiste waardes mee te leveren:

5. De ini-bestanden gaan mee met de uit te voeren kopie

6. De registry-entrys kunt u exporteren en als reg-file in uw eigen installatieprocedure meenemen, zodat deze ook op andere locaties initieel worden gevuld.

(9)

3 Gebruik van de rekenmodule

3.1 Algemeen

Allereerst dient u te bepalen op welke wijze u de rekenmodule vanuit uw eigen applicatie technisch wilt aansturen. Er zijn 4 methoden:

A. Vanuit de eigen applicatie rechtstreekse aanroep van de functies in de DLL.

De input en de resultaten worden hierbij als parameters uitgewisseld.

Parameters zijn text formaat. Dit formaat wordt LGO formaat genoemd.

B. De rekenmodule zelfstandig laten uitvoeren door de invoer en resultaten via een bestand uit te wisselen en de rekenmodule als EXE uit te voeren. De bestanden zijn text bestanden. Dit formaat wordt LGO formaat genoemd.

C. Vanuit de eigen applicatie rechtstreekse aanroep van de functies in de DLL.

De input en resultaten worden hierbij als parameters uitgewisseld.

Parameters zijn in XML formaat. Dit formaat wordt XLGO formaat genoemd.

D. De rekenmodule zelfstandig laten uitvoeren door de invoer en resultaten via een bestand uit te wisselen en de rekenmodule als EXE uit te voeren. De bestanden zijn xml bestanden. Dit formaat wordt XLGO formaat genoemd.

E. De rekenmodule zelfstandig laten uitvoeren door de invoer en resultaten via een service uit te wisselen. De bestanden zijn xml bestanden.

3.2 Beschikbare methoden

3.2.1 Methode A: rechtstreekse aanroep van functies in de DLL (bestanden LGO formaat)

Kenmerken van deze methode

• Rechtstreekse aanroep van de functie binnen de DLL van de rekenmodule

• De input en de resultaten worden via parameters uitgewisseld.

• U heeft nodig de naam van de DLL, de functie en de vereiste parameters

• Er wordt gebruik gemaakt van stdcall als calling convention. De meeste moderne visuele talen ondersteunen dit, zoals Delphi, Visual Basic en C++.

• Talen die de stdcall niet ondersteunen kunnen deze methode niet gebruiken.

• Beschikbare functies:

- Uitvoeren van berekeningen en maken van offertes - Oproepen van de instellingschermen via een pop-up.

• Bij afdrukken van een offerte wordt de printer en de af te drukken

offerteonderdelen gebruikt die als default in de instellingen van de ScildonCD zijn ingevuld.

(10)

• Vanuit de eigen applicatie kunnen de default instellingen gewijzigd worden door een overeenkomstige procedure in de lcd.dll aan te roepen.

Note: Wordt er geen gebruik gemaakt van afdrukken van offertes of zijn de

daarvoor benodigde instellingen altijd identiek, dan kan volstaan worden met eenmalig handmatig instellen.

3.2.2 Methode B: gebruik van een tussenbestand met opstart EXE (bestanden LGO formaat)

• De rekenmodule als zelfstandige EXE opstarten.

• De invoer en resultaten via een bestand worden uitgewisseld. Dit zijn TXT bestanden.

• Uw eigen applicatie start het door Scildon beschikbaar gestelde programma in de vorm van een EXE op.

• De invoergegevens en de resultaten staan in tussenbestanden (b.v. Input.lgo en Output.lgo) en een ini-file.

• Deze methode kan altijd worden toegepast.

• Beschikbare functie:

- Uitvoeren van berekeningen en maken van offertes

• Bij afdrukken van een offerte wordt de printer en de af te drukken

offerteonderdelen gebruikt die op dat moment via het interface wordt ingesteld.

• Vanuit de eigen applicatie kunnen deze default instelling gewijzigd worden door gebruik te maken van een EXE met opstartparameter.

Note: Het eenmalig of tussentijds wijzigen van de default instellingen is beperkt van belang. Bij elke offerteberekening kunnen de default instellingen toch via het interface doorgegeven.

De directory-structuur van de rekenmodule is zo opgezet, dat deze ook geschikt is om beperkt interactief te gebruiken. In beide gevallen is het mogelijk het standaard offerteprogramma (scildoncd.exe) handmatig op te starten. Ook daarmee kunnen de instellingen worden gewijzigd.

(11)

3.2.3

Methode C: rechtstreekse aanroep van functies in de DLL (bestanden XLGO formaat)

• Rechtstreekse aanroep van de functie binnen de DLL van de rekenmodule

• De input en de resultaten worden via parameters uitgewisseld.

• U heeft nodig de naam van de DLL, de functie en de vereiste parameters

• Er wordt gebruik gemaakt van stdcall als calling convention. De meeste moderne visuele talen ondersteunen dit, zoals Delphi, Visual Basic en C++.

• Talen die de stdcall niet ondersteunen kunnen deze methode niet gebruiken.

• Beschikbare functies:

- Uitvoeren van berekeningen en maken van offertes - Oproepen van de instellingschermen via een pop-up.

• Alle onderdelen van de output worden los afgedrukt te samen met een "Complete offerte.pdf".

• In het XML formaat wordt de directory opgegeven waar de output bestanden aangemaakt gaan worden.

• Vanuit de eigen applicatie kunnen de default instellingen gewijzigd worden door een overeenkomstige procedure in de lcd.dll aan te roepen.

Note: Wordt er geen gebruik gemaakt van afdrukken van offertes of zijn de

daarvoor benodigde instellingen altijd identiek, dan kan volstaan worden met eenmalig handmatig instellen.

(12)

3.2.4 Methode D: gebruik van een tussenbestand met opstart EXE (Bestanden XLGO formaat)

• De rekenmodule als zelfstandige EXE opstarten.

• De invoer en resultaten via een bestand worden uitgewisseld. Dit zijn XML bestanden.

• Uw eigen applicatie start het door Scildon beschikbaar gestelde programma in de vorm van een EXE op.

• De invoergegevens en de resultaten staan in tussenbestanden (b.v. Input.xlgo en Output.xlgo) en een ini-file.

• Deze methode kan altijd worden toegepast.

• Beschikbare functie:

- Uitvoeren van berekeningen en maken van offertes

• Alle onderdelen van de output worden los afgedrukt te samen met een "Complete offerte.pdf".

• In het XML formaat wordt de directory opgegeven waar de output bestanden aangemaakt gaan worden

• Vanuit de eigen applicatie kunnen deze default instelling gewijzigd worden door gebruik te maken van een EXE met opstartparameter.

Note: Het eenmalig of tussentijds wijzigen van de default instellingen is beperkt van belang. Bij elke offerteberekening kunnen de default instellingen toch via het interface doorgegeven.

De directory-structuur van de rekenmodule is zo opgezet, dat deze ook geschikt is om beperkt interactief te gebruiken. In beide gevallen is het mogelijk het standaard offerteprogramma (scildoncd.exe) handmatig op te starten. Ook daarmee kunnen de instellingen worden gewijzigd.

(13)

3.2.5 Methode E: gebruik van een service als gegevensoverdracht. (Bestanden XLGO formaat).

In de directory van de rekenmodule staat een programma:

LCDCalculationService.exe

Installatie van deze service gaat als volgt: Ga via CMD.exe naar de rekenmodule directory en start:

LCDCalculationService /install

Nu is er een service (XML-RPC) toegevoegd. Via het programma: services.msc kan deze service gestart worden.

Servicenaam is LCDCalcService.

Startup Type: automatic.

(14)

Indien de service gebruikt wordt om output (PDF) te maken dan is de volgende instelling van belang:

(15)

Via de browser kan je de functies bekijken.

http://localhost:2024/ of http://127.0.0.1:2024/

Er zijn enkele voorbeelden bijgeleverd hoe je deze service vanuit C#, Delphi, Java of VB.NET benaderd.

Gebruik van Java

Indien je Java gebruikt dan is er nog een extra service, asmx pagina in IIS, benodigd, i.v.m. het niet ondersteunen van XMLRPC binnen Java.

Pak LCD_ASPNET_Webservice.zip uit en maak in IIS een virtual directory naar deze directory. De Alias is dan LCD_ASPNET_Webservice

(16)

Rekenmodule Scildon CD Via de browser kan je de functies bekijken.

http://localhost:8080/LCD_ASPNET_Webservice/LCDWebService2012.asmx

Er is een Java voorbeeld om deze soapservice te benaderen.

(17)

3.3 Gebruik methode A: rechtstreekse aanroep via parameter (LGO bestanden)

Hier worden de functies en parameters toegelicht. Kern is hier het gebruik van de lcd.dll. Alle gegevens worden uitgewisseld via parameters.

De details en de opbouw van de berekeningsinvoer en resultaten zijn in de bijlagen toegelicht.

3.3.1 Uitvoeren van een berekening

Doel: Uitvoeren van een berekening. Het totaal van het resultaat, inclusief alle details wordt teruggegeven. Het aansturende programma kan de resultaten naar behoefte gebruiken.

Stappen: Stel de berekeningsinvoer samen in het LGO-formaat. (Zie bijlage A)

Roep van de lcd.dll aan de functie:

Calculate_ScildonCD_With_ParamStream Parameters: <berekeningsinvoer>

<berekeningsresultaat>

Verwerk het berekeningsresultaat in uw eigen programma

3.3.2 Uitvoeren van een berekening met afdruk van een offerte

Doel: Uitvoeren van een berekening en het daarna afdrukken van een of meer onderdelen van de offerte. De afdruk kan zowel op papier plaatsvinden, maar ook naar andere printerdrivers, zoals b.v. PDF. Het volledige berekeningsresultaat wordt teruggegeven.

Calculate_Print_ScildonCD_With_ParamStream Parameters: <berekeningsinvoer>

Verwerk het berekeningsresultaat in uw eigen programma Note: De afdruk wordt gemaakt op de printer die als default staat

ingesteld binnen de instellingen van de ScildonCD. Bij afwezigheid wordt de default printer van Windows gebruikt

3.3.3 Uitvoeren van een berekening met aanmaak van een offerte in PDF-formaat Doel: Uitvoeren van een berekening en het daarna in de vorm van een PDF

aanmaken van een of meer onderdelen van de offerte. Hierbij wordt geen gebruik gemaakt van een printerdriver.

(18)

Calculate_PrintPDF_ScildonCD_With_ParamStream Parameters: <berekeningsinvoer> <berekeningsresultaat>

<PDF-file>

3.3.4 Wijzigen van instellingen binnen de ScildonCD

Doel: Wijzigen van instellingen. Vanuit het aansturende programma wordt een instellingenscherm van de ScildonCD in een pop-up geopend. De gegevens worden direct bijgewerkt in de ini-bestanden en registry van de ScildonCD en PC.

Stappen:

Methode I: gebruik vanuit een eigen applicatie

Bepaal welke gegevens gewijzigd moeten

Roep van de lcd.dll aan de bijbehorende procedure.

Er zijn geen parameters nodig. Beschikbaar zijn:

ShowRelatieInstellingen Hiermee kunnen de gegevens van het eigen kantoor worden aangepast v.w.b. de NAW.

Zie ook menu: Instellingen Relatiegegevens

ShowAfdrukInstellingen Aangeven welke onderdelen van de offerte bij een verzoek tot afdruk standaard worden afgedrukt.

Per onderdeel kan de papierlayout worden opgegeven. B.v. de aanvraag op logo-papier en de toelichting op blanco papier.

Zie ook menu: Instellingen Afdruk instellingen

ShowAfdrukMargesInstellingen Per papierlayout kan

aangegeven worden welke marge voor het betreffende papier gehanteerd moeten worden.

Zie ook menu: Instellingen Afdrukmarges ShowPrinterInstellingen Instelbaar is de printer waarop de afdruk

moet plaatsvinden. Alleen van belang als deze afwijkt van de standaard in Windows gedefinieerde printer. Per papierlayout kan een andere invoerbak worden opgegeven.

Zie ook menu: Instellingen Printerinstellingen

(19)

Stappen:

Methode II: gebruik van een zelfstandige EXE

Start het programma LCDFORMS.EXE met als opstartparameter één van de volgende functies:

LCDFORMS –ShowRelatieInstellingen

LCDFORMS –ShowAfdrukInstellingen

LCDFORMS –ShowAfdrukMargesInstellingen

LCDFORMS –ShowPrinterInstellingen

De functionaliteit komt overeen met de beschrijving bij methode I.

Notitie: Methode I zult u met name gebruiken geïntegreerd in uw eigen applicatie, waar u de functie beschikbaar kunt stellen alvorens u een afdruk gaat maken.

Methode II kunt u ook opnemen als zelfstandige menukeuze b.v. in het Windows-menu.

(20)

3.4 Gebruik methode B: gebruik via tussenbestand met EXE. (LGO bestanden)

Hier worden mogelijkheden toegelicht. Kern is hier het gebruik van de lcdparts.exe en lcdparts.ini. Alle gegevens worden uitgewisseld via tussenbestanden.

Stappen: Stel de berekeningsinvoer samen en zet deze conform het LGO- formaat in een tijdelijk bestand. (Zie bijlage A)

Pas de lcdparts.ini aan met de gewenste instellingen. (Zie bijlage A)

Start het programma LCDParts.exe op Wacht tot deze klaar is

Lees de resultaten in vanuit het tijdelijke resultaatbestand (Zie bijlage A)

Verwerk dit resultaat in uw eigen programma

Stappen: Stel de berekeningsinvoer samen en zet deze conform het LGO- formaat in een tijdelijk bestand. (Zie bijlage A)

Op de gekozen printer wordt de offerte afgedrukt of bij aanmaak van PDF is deze op schijf aangemaakt.

(21)

Stappen: Werkwijze identiek aan paragraaf 3.4.2

Doel: Wijzigen van instellingen.

Note: Instellingen welke te maken hebben met de afdruk of de af te drukken onderdelen worden bij elke afzonderlijke berekening via een ini-bestand aangegeven. Onderhouden hiervan is hier niet nodig. Ingevulde Relatiegegevens zijn wel van belang.

Stappen:

Methode I: gebruik van de ScildonCD.exe

Start het programma ScildonCD.exe op

Kies in het menu de gewenste instellingen

Stappen:

Start het programma LCDFORMS.EXE met opstartparameter:

(22)

3.5 Gebruik methode C: rechtstreekse aanroep via parameter (XLGO bestanden)

Hier worden de functies en parameters toegelicht. Kern is hier het gebruik van de lcd.dll. Alle gegevens worden uitgewisseld via parameters.

Stappen: Stel de berekeningsinvoer samen in het XLGO-formaat. (Zie bijlage A)

Calculate_Print_ScildonCD_With_XLGO Parameters: <berekeningsinvoer>

Stappen: Stel de berekeningsinvoer samen in het XLGO-formaat. (Zie bijlage A) In het XML document wordt de method Printer.

(23)

Stappen: Stel de berekeningsinvoer samen in het XLGO-formaat. (Zie bijlage A) In het XML document wordt de method PDF. De outputdirectory moet ook ingevuld worden.

Calculate_Print_ScildonCD_With_XLGO

Parameters: <berekeningsinvoer> <berekeningsresultaat>

Doel: Wijzigen van instellingen. Vanuit het aansturende programma wordt een instellingenscherm van de ScildonCD in een pop-up geopend. De gegevens worden direct bijgewerkt in de ini-bestanden en registry van de ScildonCD en PC.

Stappen:

Methode I: gebruik vanuit een eigen applicatie

Roep van de lcd.dll aan de bijbehorende procedure.

Er zijn geen parameters nodig. Beschikbaar zijn:

ShowRelatieInstellingen Hiermee kunnen de gegevens van het eigen kantoor worden aangepast v.w.b. de NAW.

Zie ook menu: Instellingen Relatiegegevens

ShowAfdrukInstellingen Aangeven welke onderdelen van de offerte bij een verzoek tot afdruk standaard worden afgedrukt.

Per onderdeel kan de papierlayout worden opgegeven. B.v. de aanvraag op logo-papier en de toelichting op blanco papier.

Zie ook menu: Instellingen Afdruk instellingen

ShowAfdrukMargesInstellingen Per papierlayout kan

aangegeven worden welke marge voor het betreffende papier gehanteerd moeten worden.

Zie ook menu: Instellingen Afdrukmarges ShowPrinterInstellingen Instelbaar is de printer waarop de afdruk

moet plaatsvinden. Alleen van belang als deze afwijkt van de standaard in Windows gedefinieerde printer. Per papierlayout kan een andere invoerbak worden opgegeven.

Zie ook menu: Instellingen Printerinstellingen

(24)

Rekenmodule Scildon CD Stappen:

Start het programma LCDFORMS.EXE met als opstartparameter één van de volgende functies:

LCDFORMS –ShowAfdrukInstellingen

LCDFORMS –ShowAfdrukMargesInstellingen

LCDFORMS –ShowPrinterInstellingen

De functionaliteit komt overeen met de beschrijving bij methode I.

Notitie: Methode I zult u met name gebruiken geïntegreerd in uw eigen applicatie, waar u de functie beschikbaar kunt stellen alvorens u een afdruk gaat maken.

Methode II kunt u ook opnemen als zelfstandige menukeuze b.v. in het Windows-menu.

(25)

3.6 Gebruik methode D: gebruik via tussenbestand met EXE. (XLGO bestanden)

Hier worden mogelijkheden toegelicht. Kern is hier het gebruik van de lcdparts.exe en lcdparts.ini. Alle gegevens worden uitgewisseld via tussenbestanden.

Stappen: Stel de berekeningsinvoer samen en zet deze conform het XLGO- formaat in een tijdelijk bestand. (Zie bijlage A)

Op de gekozen printer wordt de offerte afgedrukt of bij aanmaak van PDF is deze op schijf aangemaakt.

Stappen: Werkwijze identiek aan paragraaf 3.4.2

(26)

Stappen:

Methode I: gebruik van de ScildonCD.exe

Stappen:

Start het programma LCDFORMS.EXE met opstartparameter:

(27)

3.7 Gebruik methode E: gebruik van een service als gegevensoverdracht. ( XLGO bestanden).

Hier worden de functies en parameters toegelicht. Kern is hier het gebruik van de service. Alle gegevens worden uitgewisseld via parameters.

Stappen: Stel de berekeningsinvoer samen in het XLGO-formaat. (Zie bijlage A)

Roep van de service aan de functie:

Stappen: Stel de berekeningsinvoer samen in het XLGO-formaat. (Zie bijlage A) In het XML document wordt de method Printer.

(28)

Stappen: Stel de berekeningsinvoer samen in het XLGO-formaat. (Zie bijlage A) In het XML document wordt de method PDF. De outputdirectory moet ook ingevuld worden.

Calculate_Print_ScildonCD_With_XLGO

Parameters: <berekeningsinvoer> <berekeningsresultaat>

Stappen:

I: gebruik van de ScildonCD.exe. De relatiegegevens en rekenrenten kunnen hiermee gewijzigd worden.

Stappen:

II: Marges veranderen

Plaats een MargesOverrule.ini in de rekenmodule directory. De marges kunnen in dit geval als service nog overruled worden. Het bestand MargesOverrule.ini heeft de volgende inhoud:

[Marges]

Left=12 Right=12 Top=12 Bottom=9

(29)

4 Testen

4.1 Testen van de installatie

U kunt de basiswerking controleren door:

a. Het handmatig opstarten van het programma ScildonCD.exe. Deze is aanwezig in de hoofddirectory Rekenmodule.

b. Kies een product, bij voorkeur een product dat u ook binnen de rekenmodule wilt gebruiken.

c. Voer de voor berekening relevante gegevens in. Doorloop hierbij de verschillende tabbladen.

d. Kies voor berekenen van de ingevoerde gegevens.

e. Kies voor bewaren van de offerte. Geef eerst een naam op f. Kies voor afdrukken. Kies voor alle af te drukken onderdelen.

Is een van bovenstaande acties niet mogelijk, dan is de kopie tijdens de installatie niet goed of niet volledig uitgevoerd. Voer de installatie (kopiëren) nogmaals uit.

4.2 Testen van de interface (LGO formaat)

Met deze test wordt uitsluitend de berekening uitgetest.

Om dit mogelijk te maken is het nodig om vanuit de eigen applicatie een interface in de voorgeschreven layout samen te stellen. Als alternatief kunt u gebruik maken van een interface, zoals wij dat in de documentatie hebben opgenomen. Het Excel-

bestand “Rekenmodule Scildon parameters.xls” bevat hiervoor enkele voorbeelden.

Handel daartoe als volgt:

a. Start het programma ScildonCD.exe handmatig op. Deze is aanwezig in de hoofddirectory Rekenmodule.

b. Plaats in het eigen programma de beoogde inputparameter op het clipbord of copieer deze uit onze documentatie spreadsheet.

c. Kies in het menu van de ScildonCD voor ‘Pensioen Module importeren’. Alle gegevens worden nu automatisch op het scherm ingevuld.

d. Controleer op de afzonderlijke tabbladen of de inhoud overeenkomt met hetgeen werd verwacht.

e. Kies voor berekenen. O.b.v. de invoer wordt een volledige berekening uitgevoerd.

Ontstaat bij het importeren een foutmelding of blijven de gegevens op het scherm leeg, dan is de lay-out van de input niet juist. De foutmelding geeft eventueel aan welke gegevens onjuist zijn.

Ontstaat bij het berekenen een foutmelding, dan is er mogelijk inconsistentie tussen de afzonderlijke invoergegevens of 1 van de vereiste gegevens is niet of onjuist gevuld. In de meeste gevallen wordt aangegeven welke invoerveld onjuist is. Corrigeer dit naar de juiste waarde en probeer het opnieuw.

4.3 Testen van berekeningen

U kunt de juistheid van de uitkomsten van een berekening testen door de resultaten die u via uw eigen software terugkrijgt uit de rekenmodule vergelijken met een zelfde

(30)

invoer die u handmatig invoert. Op eenzelfde wijze als u hiervoor de installatie kunt testen.

Gebruik hiervoor zo mogelijk een separaat uitgevoerde installatie van de volledige ScildonCD, zoals Scildon die als standaard offertesoftware uitlevert.

4.4 Eerste implementatie

Gaat u voor het eerst gebruik maken van de rekenmodule, dan heeft u in de contacten met Scildon afgesproken welke producten en productvarianten u gaat gebruiken.

Alvorens u de rekenmodule binnen uw eigen applicatie voor productiedoeleinden mag inzetten dient deze door Scildon te zijn vrijgegeven. Dit kan plaatsvinden o.b.v.

gezamenlijke testen of door aanlevering van een aantal voor gedefinieerde testgevallen, waarvan de resultaten overeenkomen met de verwachtingen.