SDMS WebServer

Namestitev

SDMS WebServer se namesti tako:

• pripravi se novo mapo, kjer bo instaliran strežnik SDMS Webserver, recimo C:\SDMS\WEBSERVER
• preko ftp protokola se iz naslova www.sdms.si/update/sdms41/sdmswsp/en (uporabnik anonymous) se nanjo prenese vse datoteke
• datoteko sdmswsp.txt se kopira v sdmswsp.ini
• pravilno se nastavi parametre, predvsem parameter path
• servis se instalira iz konzolne vrstice z ukazom sdmswsp -install
• ob uspešni instalaciji servisa se to izpiše v okencu, sicer pa je prišlo do problema, ki je razviden v log datoteki
• servis se zažene z ukazom sdmswsp -start
• ob uspešnem zagonu se to izpiše v konzolnem oknu.

Strežnik je sedaj nameščen in zagnan. Če se bo uporabljala varna poivezava, je potrebno namestiti tudi certifikat strežnika.

Zagon

SDMS WebServer se aktivira tako, da se v SDMS raziskovalcu doda nov modul z imenom SdmsWSP in naslednjo vsebino:

Sub OnCreate
  WebServer.Clear
  WebServer.AddHost(80, '', '', '', '')
  WebServer.Start
  ...
EndSub

Če želimo dodati tudi dostop preko varne povezave (https), to storimo takole:

Sub OnCreate
  WebServer.Clear
  WebServer.AddHost(80, '', '', '', 'http')
  WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath)
  WebServer.Start
  ...
EndSub

Če želimo zagotoviti uporabo varne povezave (https) in izvesti samodejno preusmeritev nanjo:

Sub OnCreate
  WebServer.Clear
  WebServer.AddHost(80, '', '', '', 'http').SetRedirect('https://www.test.si/')
  WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath)
  WebServer.Start
  ...
EndSub

Pri uporabi varne povezave (https) je seveda nujno tudi namestiti certifikat strežnika.

Osnovne nastavitve

Ob prijavi se uporabniku prikaže logotip velikosti 480x120 pik. Datoteko se shrani na mapo WebServer in poda njeno ime.

WebServer.Logo = 'logo.png'

Privzeto dopušča SDMS WebServer dostop samo SDMS uporabnikom. Če želimo dodati tudi možnost anonimnega dostopa, to storimo tako:

WebServer.User = [Gost]

Pri tem je Gost (oz. poljubno drugo ime) SDMS uporabnik, ki se bo uporabljal za anonimne dostope. Tega uporabnika moramo seveda dodati in mu prirediti pravice.

Določiti je treba osnovno okno, ki se prikaže uporabniku ob prvem zagonu.

WebServer.Window = '370000,25000,630000,200000'

Določiti je treba tematiko, ki se bo uporabljala za izris.

WebServer.DrawList = [Web Tematika]

Dodati je treba plasti, po katerih za izvaja iskanje in izpis podatkov.

WebServer.AddSearch([Plast A].Search('Default'))
WebServer.AddSearch([Plast B].Search('Default'))

Dobro je dodati tudi seznam priljubljenih lokacij, ki so dostopne iz menija.

WebServer.AddLocation('Slovenija', '370000,25000,630000,200000', '')
WebServer.AddLocation('Ljubljana', '370000,25000,630000,200000', '')
WebServer.AddLocation('Maribor', '370000,25000,630000,200000', '')

Možno je dodati tudi seznam dodatnih povezav, ki so ravno tako dostopne iz menija.

WebServer.AddLink('Softdata Home Page', 'http://www.softdata.si', '')

Napredne nastavitve

Ob prijavi lahko določene nastavitve spremenimo glede na prijavljenega uporabnika. To storimo tako, da dodamo novo proceduro:

Sub OnWebLogin

  If User.MatchSecurityTags('noweb', False) Then
    WebServer.User = Nil // določenim uporabnikom preprečimo dostop
  EndIf

  If User.MatchSecurityTags('ljubljana', False) Then
    WebServer.Logo = 'logo-lj.png' // določenim uporabnikom pokažemo drug logotip
    WebServer.Window = '510000,120000,630000,200000' // in drugo osnovno okno
    WebServer.DrawList = [Web Tematika LJ] // ter drugo tematiko
  EndIf

EndSub

Priprava tematike

Tematiko se pripravi kot sicer. Izjemnega pomena pa je, da se tematika v vseh merilih in z vsemi vključenimi temami izriše hitro, torej v rangu recimo 3 sekund (kar je že precej). Opimalno je pod 1 sekundo.

Dodati je potrebno še določene informacije za spletno aplikacijo. Te se dodajo v atrubutih posameznih tem.

Atribut: Alias - Dodatno ime

Teme se v spletni aplikaciji ne prižigajo/ugašajo posamezno, temveč skupinsko (in to niso iste skupine kot v client aplikaciji). Skupine določimo poljubno z neko kratko oznako, recimo karte, vod, tocke,... Vsem temam določimo v atributu dodatno ime eno oznako, na katero se vklopi/izklopi. Če tema nima oznake, se nikoli ne prikaže. Če želimo temo prikazati vedno, vnesemo za dodatno ime znak *.

Atribut: View tags

Namen tega atributa je ...

Atribut: Web info

Namen tega atributa je ...

• item=karte
• name=Pregledne karte
• sort=1
• show=1

Priprava iskanj in izpisov

...

Zagotavljanje pravic dostopa

...

Nadaljevanje ignoriraj:

Statične strani

• .htm, *.js, *.css

Dinamične strani

• .ssp

Dinamične direktne povezave

MAP.GIF, MAP.JPG, MAP.PNG

To je najbolj uporabljan URL, ki nam vrne izdelano sliko (karto). Potrebni so naslednji parametri (ali piškotki):

position=W,H,Y1,X1,Y2,X2

širina in višina slike v pikslih ter okno karte v koordinatah. Razmerje slike in okna naj bo pravilno. To je nujen parameter, alternativa pa so lahko parametri y, x, scale, width, height (vsi).

drawlist=A,B,C,...

tematika oz. seznam tematik, ki se naložijo. To je nujen parameter, alternativno pa se to lahko izvede tudi v proceduri command.

drawshow=A,B,C,...

če je ta parameter podan, se v tematiki vklopijo za izris samo tiste teme, ki imajo kot dodatno ime kakšno vrednost iz seznama.

command=C

če je ta parameter podan, se naveden ukaz izvede pred samim izrisom karte. Ukaz je lahko samo uporabniško definirana procedura (SUB) brez parametrov.

y=N

ta parameter je lahko alternativa parametru position, pomeni pa y koordinato centra karte.

x=N

ta parameter je lahko alternativa parametru position, pomeni pa x koordinato centra karte.

scale=N

ta parameter je lahko alternativa parametru position, pomeni pa merilo izrisa karte.

width=N

ta parameter je lahko alternativa parametru position, pomeni pa širino slike v pikslih.

height=N

ta parameter je lahko alternativa parametru position, pomeni pa višino slike v pikslih.

dpi=N

ta parameter je lahko podan, kadar bi želeli sliko v drugi resoluciji od privzete 96 DPI.

FUNCTION.DLL

To je tudi zelo pogosto uporabljen URL, ki vrne tekst, ki ga je izdelala uporabniško definirana funkcija tipa TStringList.

function=F

ta parameter je nujen, pomeni pa ime funkcije, ki se kliče.

TOOLKIT.DLL

Trenutno še v testni fazi.

id=id