1

Installatie.

De onderstaande installaties en configuratie zal uitgevoerd worden.

Vero installatie (1)

Progress/Openedge installatie / ODBC configuratie (2)

Boexchange configuratie. (3)

KluwerEasyshopService installatie (4)

De installatie en configuratie zal uitgevoerd worden door een erkend technieker aangeduid door Wolters Kluwer. Het spreekt voor zich dat onze technieker over de noodzakelijke rechten moet beschikken om de installatie en configuratie te kunnen voltooien op de server van de gebruiker.

Vooraf zal de gebruiker er moeten voorzorgen dat de nodige poorten en URL ter beschikking zullen gesteld worden zodat externe communicatie mogelijk is naar de website van de shop.

Gebruiker

- Vero-installatie VNG 94 (1)- Boexchange installatie & configuratie (2)

Progress/Openedge/ODBC installatie (3)KluwerWebService (4)

Klant 1 van de Gebruiker

Klant2 van de Gebruiker

Klant 9999999 van de Gebruiker

Easyshop

Gebruiker 4 Gebruiker 3

Gebruiker 1 Gebruiker 2

2

Vero installatie (1).

U installeert een upgrade naar een laatste Vero versie (minimum VNG versie 94) (http://klusostore1.wkb.be/updates/vero/). Deze upgrade zal onder meer de nieuwste Boexchange, KluwerEasyshopService en vero programma’s voor de module KluwerEasyshop omvatten.

U leest de ODBC-user in (Vero-count\Utilities\Run). (zie handleiding odbc voor meer details)

U activeert en registreert de module voor de KluwerEasyshop in de Vero-toepassing. (vero-

count>Utilities).

3

Installatie & Configuratie BoExchange (2)

Dit object verzorgt een deel van de communicatie tussen de KluwerEasyshop en de Kluwer-Vero-database (Backoffice) en zal geconfigureerd worden naar de behoefte van de gebruiker en de KluwerEasyshop.

De installatie van de Boexchange kan op 2 manieren gebeuren:

1. Of we gaan naar de install\easyshop-map (vero\install\easyshop) van vero en dubbelklikken “boexch.exe”. Manueel moet men dan wel de opties aanvullen van Vero-admin (Vero-admin>Bestand\Opties).

2. Of we gaan naar de opties van Veroadmin en selecteren daar de “boexch.exe”-map. Bij het verlaten van het optie-scherm installeert hij de boexchange op jouw aanvraag.

Vervolgens moet men nog de boexchange configureren.

De config.xml omvat o.a. de coördinaten van de KluwerEasyshopwebsite en de Vero-applicatie.

4

Dit zal o.a. gebeuren via het up- en downloaden van xml-bestanden uit een queue via de FIFO-

methode (bijvoorbeeld informatieve groepen, sommige artikelgegevens, login- en klantengegevens…). De boexchange zal ook onder meer gebruikt worden voor het uitwisselen van afbeeldingen. De uitwissel directories (queue’s) worden geconfigureerd in de config.xml van de Boexchange.

Dit object omvat een configuratie file, die kan geconfigureerd worden naar de behoefte van de gebruiker en de Easyshop.

- Pas het bestand \Vero\install\ocx\BOEXCH\config.xml aan de behoefte van de gebruiker.

De beschrijving van onderstaande parameters kan je in detail vinden in het bestand \Vero\

install\easyshop \BOEXCH\readme.txt

Dit is een voorbeeld config.xml en kan niet zomaar gebruikt worden bij de gebruiker. <?xml version="1.0"?>

<configuration>

<config name="basepath">\\srv01\verovng\vero\Install\easyshop\BOEXCH</config>

<config

name="queuepath">\\srv01\verovng\vero\Install\easyshop\BOEXCH\queue</config>

<config name="site">NAAMVANDEWEBSITE</config>

<config name="servername">studio5.kluwereasyweb.be</config>

<config name="serverurl">/BackOfficeExchange</config>

<config name="boexchgurl">/BackOfficeExchange</config>

<config name="fileuploadurl">/BackOfficeFileUpload</config>

<config name="defaultmode">normal</config>

<config name="ignore-warnings">true</config>

<config name="retrieve">BRILJANT</config>

<config name="retrieve_BRILJANT_pk">/*/id</config>

<config name="retrieve_BRILJANT_interval">1</config>

<config name="retrieve_BRILJANT_condition">{/*/payment-status}!=created</config>

<config name="retrieve_BRILJANT_postprocess">DELETE</config>

<config name="encodekeys_main-group">/*/HFDGRP</config>

<config name="encodekeys_sub-group">/*/HFDGRP,/*/SUBGRP</config>

<config name="encodekeys_article">/*/HFDGRP,/*/SUBGRP,/*/GROEP</config>

<config name="clean_success">7</config>

<config name="clean_failure">7</config>

<config name="security-mode">key</config>

<config name="security-key">myFavoriteKey</config>

<config

name="picture_resizer_jpg_thumbnail">235,235,75,236,236,255,255,255</config>

<config name="picture_resizer_jpg_picture">259,259,75,260,260,255,255,255</config>

<config name="picture_resizer_jpg_zoom">999,999,75,1000,1000,255,255,255</config>

</configuration>

Groen: controleer het pad.

Oranje: Naam van website (navragen bij easyshop).

5

Progress/Openedge/ODBC installatie (3).

De databaseserver van vero zal zowel de “Workgroup” als de “Client Networking” van progress omvatten. De installatie van de “Client Networking” zal er onder meer voorzorgen dat de noodzakelijke “ODBC” drivers worden geïnstalleerd. Indien de noodzakelijke ODBC drivers niet werden geïnstalleerd (of u bevindt zich op andere server dan de databaseserver) dan kan U deze downloaden van de Vero-Klusostore1. (http://klusostore1.wkb.be/updates/vero/)

ODBC installatie is afhankelijk van de gebruikte hardware, Openedge (Progress) software en van

de gebruikte database. Voor het instellen en het configureren van een ODBC verwijzen we naar andere handleidingen. Onderstaand is dus een voorbeeld Configuratie.

ODBC zal moeten geïnstalleerd worden voor de compt1 en de vstart database van Vero. Het is sterk aan bevolen om een afzonderlijke “sqlservergroup” te nemen voor de loadbalancing van sql-statements. Voorbeeld: Zo kan men o.a. de onderstaande ODBC configuratie en installatie testen. (ODBC Data Source Administrator>Tabblad System DSN>Configure>Test Connect).

1 De ODBC zal een extra licentie gebruiken om te kunnen lezen en te schrijven in de database.

6

Opmerking: Data Source Name, Host Name, Port Number, Database Name en User ID zal gebruikt worden in de configuratie van de KluwerEasyshopwebservice (cfr. KluwerEasyShopService installatie (4).).

7

KluwerEasyShopService installatie (4).

Vervolgens installeert u de “SetupKluwerEasyShopService”, deze kan men tevens terugvinden op de Vero-Klusostore of door de link te volgen in de vero\install\easyshop directory van de nieuwste versie.

opmerking: uitvoeren als “Administrator”/

SetupKluwerEasyShopService.

De SetupKluwerEasyshopService zorgt ondermeer voor het volgende:

Link met de “ODBC”.

Link met de Vero-programma’s en de vero-database.

Configuratie van de Vero-link.

Voor de SetupKluwerEasyshopService te installeren, vervolledigt U onderstaande schermen zoals in het voorbeeld is uitgewerkt.

8

9

10

11

Voordat men de Kluwerservice opstart zal men deze Kluwerservice vooreerst moeten configureren. KluwerWebService.exe config file zal manueel aangepast worden in de <appSettings> voor onder meer de de ODBC instellingen, database instellingen, propath, homeprog en progress directory, Zie onderstaand voorbeeld (rood). Dit is een voorbeeld de instelleningen zullen afwijken gebruiker per gebruiker. Bij default kunnen we dit terugvinden in de directory C:\Program Files (x86)\Kluwer\KluwerEasyshopService\:

13

<?xml version="1.0"?> <configuration> <system.serviceModel> <behaviors> <serviceBehaviors> <behavior name="GeneralBehavior"> <serviceMetadata httpGetEnabled="true" httpGetUrl="http://0.0.0.0:80/General/Service.svc/MEX"/> </behavior> </serviceBehaviors> <endpointBehaviors> <behavior name="webby"> <webHttp/> </behavior> </endpointBehaviors> </behaviors> <services> <service behaviorConfiguration="GeneralBehavior" name="KluwerServices.GeneralService"> <endpoint address="http://0.0.0.0:80/General/Service.svc" binding="webHttpBinding" bindingConfiguration="" contract="KluwerServices.IGeneralService" behaviorConfiguration="webby"/> </service> </services> </system.serviceModel> <system.diagnostics> <sources> <source name="System.ServiceModel" switchValue="Information, ActivityTracing" propagateActivity="true"> <listeners> <add name="traceListener" type="System.Diagnostics.XmlWriterTraceListener" initializeData= "c:\temp\log\Traces.svclog" /> </listeners> </source> </sources> </system.diagnostics> <startup><supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.0"/></startup> <appSettings> <add key="connectionStringCompta" value="DSN=Compt1;HOST=localhost;PORT=2031;DB=compt1;UID=SYSPROGRESS;PWD=SYSPROGRESS"/> <!—Hier vult men de ODBC setting in van de Compt1 dbase--> <add key="connectionStringVstart" value="DSN=vstart;HOST=localhost;PORT=2030;DB=Vstart;UID=SYSPROGRESS;PWD=SYSPROGRESS"/> <!—Hier vult men de ODBC setting in vstart database--> <add key="compta" value="-db compt1 -H vero-program -S 2031 -N TCP -ld compta"/> <!—Hier vult men “Openedge” connectie-string in van de Compt(a)1 dbase (install.pf)--> <add key="vstart" value="-db vstart -H vero-program -S 2030 -N TCP"/>

14

<!—Hier vult men “Openedge” connectie-string in van de vstart dbase (install.pf)--> <add key="propath" value="\\srv01\verovng\vero\Maat\S\SandersP,\\srv01\verovng\vero"/> <!—Hier vult men het UNC- path waarnaar de vero-programma’s verwijzen (progressX.ini)--> <add key="homeprog" value="\\srv01\verovng\vero\Prog "/> <!—Hier vult men het UNC-path van de home-prog (progressX.ini)--> <add key="prowin32" value="c:\Program Files\Openedge102B\bin\prowin32.exe"/ <!—verwijzing naar waar progress/openedge staat geïnstalleerd op het toestel van de KluwerWebservice--> <add key="mm" value="1024"/> <!—zie configuratie waarde (progress explorer tool/ maximum message size, 1024--> <add key="listenport" value="23456"/> <!—vrije poort voor langs te communiceren met vero--> <add key="interval" value="10"/> <! om de 10 seconden gaat men kijken of er bijvoorbeeld weborders klaar staan om te importeren <add key="waitTimeForProgressStartup" value="30"/> <! Tijd die de progress nodig heft om op te starten <add key="fieldsKlant" value="klant-kode,naam-zaak,adres,adres2,postkode,gemeente,kode-land,kode-btw-regime-verkoop,btw-nummer,telefoon-1,telefoon-2,fax,muntkode,e-mail,e-mail-1,website,geblokkeerd"/> <add key="tagsKlant" value="KLA.NUMMER,KLA.NAAM,KLA.ADRES1,KLA.ADRES2,KLA.POSTNR,KLA.GEMEENTE,calc.KLA.LAND,calc.KLA.BTWREGIME,KLA.BTWNR,KLA.TELEFOON1,KLA.TELEFOON2,KLA.TELEFAX,KLA.VALUTA,KLA.EMAIL1,KLA.EMAIL2,KLA.URL,"/> <add key="fieldsVaKlant" value="groep-kode,fakt-klant-kode,lijn-korting,prijs-kategorie"/> <add key="fieldsArtikelWeb" value="std-deci-1"/> <add key="fieldsArtikel" value="artikel-kode,btw-kode-verkopen,groep-kode,masker,accijnzen-stdm"/> <add key="fieldsArtikelPrijs" value="promotie-prijs,promotie-kort-perc,van-promotie-dat,tot-promotie-dat,verkooppr-stdm-1,verkooppr-stdm-2,verkooppr-stdm-3,verkooppr-stdm-4,verkooppr-stdm-5,verkooppr-stdm-6,verkooppr-stdm-7,verkooppr-stdm-8,verkooppr-stdm-9,verkooppr-stdm-10"/> <add key="fieldsArtikelVoorraad" value="voorraad,gereserv-voorraad"/> <add key="fieldsClient" value="klant-kode,std-logi-1"/> <add key="fieldsContact" value="contact-kode,titel,naam-zaak,naam-2,voornaam,adres,postkode,gemeente,kode-land,e-mail-1,telefoon-1"/> <add key="tagsContact" value="KLAKTP.VOLGNR,KLAKTP.TITEL,KLAKTP.NAAM,KLAKTP.NAAM2,KLAKTP.VOORNAAM,KLAKTP.ADRES,KLAKTP.POSTNR,KLAKTP.GEMEENTE,calc.KLAKTP.LAND,KLAKTP.EMAIL,KLAKTP.TELEFOON"/> <add key="fieldsLeveringsadressen" value="code,teller,naam,adres,adres2,kode-land,postkode,gemeente,std-char-2,std-char-3,std-char-1"/> <add key="tagsLeveringsadressen" value=",LVA.LVANR,LVA.NAAM,LVA.ADRES1,LVA.ADRES2,calc.LVA.LAND,LVA.POSTNR,LVA.GEMEENTE,LVA.TELEFOON,LVA.TELEFAX,LVA.OPMERKING"/> <add key="landVero" value="001,002,003,004,005,006,007,008,009,010,011,024,028,030,032,036,038,052,060,062,063,064,068,090,388,400,404,412,436,508,624,664,720,732,800,999"/> <add key="landWeb" value="F,B,NL,D,I,GB,IER,DK,GR,P,E,IS,N,S,SF,CH,A,TR,PL,LV,CZ,SK,H,BG,YU,ZA,USA,CDN,MEX,CR,BR,IL,IND,CN,J,AUS,L"/> </appSettings> </configuration>

15

Na de installatie kan U de installatie van de KluwerEasyshopService verifiëren. Configuraties zal men steeds later kunnen aanpassen (na het herstarten van de Kluwerwebservice).

U kan nagaan bij de “Services” of de “KluwerEasyService is geïnstalleerd” en U kiest

voor de “automatic” startup type, vooraleer U de service opstart.

16