SDMS - Uporabnikovi prispevki [sl]

Namestitev sistema

2023-02-01T15:05:55Z

Janez Trtnik:

__NOTOC__
[[Kategorije:Administracija sistema]]
== Zahteve strojne in programske opreme ==
Za uporabo sistema '''SDMS 4''' v omrežni verziji potrebujemo računalnike z operacijskim sistemom Windows.

Za delovanje omrežne verzije je seveda potrebno tudi omrežje.

Ostalih posebnih zahtev po strojni in programski opremi sicer ni. Načeloma sistem deluje na poljubnem sodobnem računalniku, seveda pa velja, da na hitrejšem računalniku deluje hitreje.

== Priporočena hiearhija direktorijev ==

D:
\SDMS
SDMS.exe
SDMS.ini
\DATABASE
\SDMSCL (client)
\SDMSDS (database service; obvezna za client-server način)
\SDMSAS (automation service; opcijska za client-server način)
\SDMSWS (web service; opcijska za client-server način)

== Namestitev sistema na strežnik ==
Prvi korak je namestitev samega sistema na strežnik. Postopek namestitve je naslednji:

*Na računalnik se prijavimo kot uporabnik z administratorskimi pravicami.
*Iz spletne strani '''https://www.sdms.si/''' prenesemo inštalacijske komponente, ki jih potrebujemo. Razpakiramo jih na zgoraj priporočeno direktorijsko hiearhijo.
V nadaljevanju bomo predpostavili, da je smo izbrali disk D in namestili sistem v izhodiščno mapo '''D:\SDMS'''.
*V primeru client-server sistema mapi '''D:\SDMS''' aktivirajte skupno rabo (sharing), in sicer pod imenom '''SDMS'''. S tem se bo omogočil enostaven in varen dostop odjemalcev do sistema.
*Če imate zaščitni ključ za uporabo programa, ga ustavite v USB vrata na računalniku.
*Če nimate zaščitnega ključa, je potrebno ustvariti programsko zaščito na ta računalnik:
**'''SDMS.EXE -REGISTER=Vaše_Ime'''
**Kontaktirajte Softdato, da vam pripravimo licenco za uporabo programa.
**'''SDMS.EXE -LICENCE=dodeljena_številka'''
**Na tej mapi se bo ustvarila licenčna datoteka (*.lic).
*Na namizju si ustvarimo bližnjico do programa '''SDMS.EXE''', ki se nahaja v mapi '''D:\SDMS'''. Takšno bližnjico si bomo ustvarili tudi na vsakem računalniku, ki ga bomo uporabljali kot odjemalca.
*Nato s klikom na ikono programa zaženeno program.
*Če je program pravilno nameščen, se nam odpre glavno okno programa. Preden preidemo na nameščanje strežnika, moramo program zapreti.

== Namestitev SDMS servisov ==
SDMS Database Service se namesti kot sistemski servis. To pomeni, da se avtomatsko zažene takoj po zagonu samega računalnika, še preden se uporabnik prijavi v sistem. Strežnik ostane aktiven tudi potem, ko se uporabnik odjavi iz sistema. V tem načinu deluje strežnik popolnoma pritajeno (brez uporabniškega vmesnika).

Ko smo namestili sistem SDMS na strežnik, nadaljujemo z namestitvijo SDMS strežnika tako:

*V sistemsko mapo '''D:\SDMS\SDMSDS''' prenesemo datoteke, ki smo jih prenesli.
*Kopirajte licenčno datoteko iz '''SDMSCL''' direktorija v '''SDMSDS'''.
*V urejevalniku besedila (Beležnica oz. Notepad) popravimo vsebino datoteke SDMS.INI tako, da je pot to baze podatkov pravilno navedena (tipično je to '''D:\SDMS\DATABASE''').
*Iz komandne vrstice z administratorskimi pravicami zaženemo ukaz: '''D:\SDMS\SDMSDS\SDMSDSP.EXE -INSTALL'''.
*Če se je strežnik pravilno namestil, se nam izpiše sporočilo. Sicer pa nekaj ni v redu, in za vzrok si je treba ogledati datoteko SDMS.LOG, ki se je kreirala v '''D:\SDMS\SDMSDS'''. Če te datoteke tam ni, si je potrebno ogledati datoteko SDMS-????-??-??.LOG, ki se je kreirala v mapi, kjer je baza podatkov (tipično '''D:\SDMS\DATABASE'''). Po odpravi vzroka napake ponovimo prejšnji korak.
*Iz komandne vrstice zaženemo ukaz: '''NET START SDMSDS'''.
*Če se je strežnik pravilno zagnal, se nam v komandni vrsici to tudi izpiše.
*Sedaj je SDMS strežnik pravilno nameščen in aktiven kot sistemski servis. Ob vsakem zagonu računalnika se bo avtomatsko zagnal tudi SDMS strežnik.

Za namestitev SDMS Automation Service in SDMS Web Service je postopek enak kot za SDMS Database Service.

== Namestitev odjemalcev ==
Na vsakem računalniku, kjer se bo uporabljal SDMS kot odjemalec, je priporočeno narediti trajno povezavo na mapo, kjer se nahaja SDMS odjemalec (z "Map network drive"). Primer: deljeno mapo \\SERVER\SDMS si namestimo kot disk G:.

Za lažji zagon programa si lahko ustvarite bližnjico na na namizju (primer: G:\SDMS.EXE).

Nato poženite program '''SDMS.EXE'''. Vpišete se z dodeljenim uporabniškim imenom in geslom, ki vam je dodeljen. Nato lahko (glede na licenčne pogoje) uporabljate aplikacije oz. razvojno orodje.

Namestitev sistema

2023-02-01T14:56:54Z

Janez Trtnik: /* Namestitev odjemalcev */

__NOTOC__
[[Kategorije:Administracija sistema]]
== Zahteve strojne in programske opreme ==
Za uporabo sistema '''SDMS 4''' v omrežni verziji potrebujemo računalnike z operacijskim sistemom Windows.

Za delovanje omrežne verzije je seveda potrebno tudi omrežje.

Ostalih posebnih zahtev po strojni in programski opremi sicer ni. Načeloma sistem deluje na poljubnem sodobnem računalniku, seveda pa velja, da na hitrejšem računalniku deluje hitreje.

== Priporočena hiearhija direktorijev ==

D:
\SDMS
SDMS.exe
SDMS.ini
\DATABASE
\SDMSCL (client)
\SDMSDS (database service)
\SDMSAS (automation service)
\SDMSWS (web service)

== Namestitev sistema na strežnik ==
Prvi korak je namestitev samega sistema na strežnik. Postopek namestitve je naslednji:

*Na računalnik se prijavimo kot uporabnik z administratorskimi pravicami.
*Iz spletne strani '''https://www.sdms.si/''' prenesemo inštalacijske komponente, ki jih potrebujemo. Razpakiramo jih na zgoraj priporočeno direktorijsko hiearhijo.
V nadaljevanju bomo predpostavili, da je smo izbrali disk D in namestili sistem v izhodiščno mapo '''D:\SDMS'''.
*V primeru client-server sistema mapi '''D:\SDMS''' aktivirajte skupno rabo (sharing), in sicer pod imenom '''SDMS'''. S tem se bo omogočil enostaven in varen dostop odjemalcev do sistema.
*Če imate zaščitni ključ za uporabo programa, ga ustavite v USB vrata na računalniku.
*Na namizju si ustvarimo bližnjico do programa '''SDMS.EXE''', ki se nahaja v mapi '''D:\SDMS'''. Takšno bližnjico si bomo ustvarili tudi na vsakem računalniku, ki ga bomo uporabljali kot odjemalca.
*Nato s klikom na ikono programa zaženeno program.
*Če je program pravilno nameščen, se nam odpre glavno okno programa. Preden preidemo na nameščanje strežnika, moramo program zapreti.

== Namestitev SDMS servisov ==
SDMS Database Service se namesti kot sistemski servis. To pomeni, da se avtomatsko zažene takoj po zagonu samega računalnika, še preden se uporabnik prijavi v sistem. Strežnik ostane aktiven tudi potem, ko se uporabnik odjavi iz sistema. V tem načinu deluje strežnik popolnoma pritajeno (brez uporabniškega vmesnika).

Ko smo namestili sistem SDMS na strežnik, nadaljujemo z namestitvijo SDMS strežnika tako:

*V sistemsko mapo '''D:\SDMS\SDMSDS''' prenesemo datoteke, ki smo jih prenesli.
*V urejevalniku besedila (Beležnica oz. Notepad) popravimo vsebino datoteke SDMS.INI tako, da je pot to baze podatkov pravilno navedena (tipično je to '''D:\SDMS\DATABASE''').
*Iz komandne vrstice z administratorskimi pravicami zaženemo ukaz: '''D:\SDMS\SDMSDS\SDMSDSP.EXE -INSTALL'''.
*Če se je strežnik pravilno namestil, se nam izpiše sporočilo. Sicer pa nekaj ni v redu, in za vzrok si je treba ogledati datoteko SDMS.LOG, ki se je kreirala v '''D:\SDMS\SDMSDS'''. Če te datoteke tam ni, si je potrebno ogledati datoteko SDMS-????-??-??.LOG, ki se je kreirala v mapi, kjer je baza podatkov (tipično '''D:\SDMS\DATABASE'''). Po odpravi vzroka napake ponovimo prejšnji korak.
*Iz komandne vrstice zaženemo ukaz: '''NET START SDMSDS'''.
*Če se je strežnik pravilno zagnal, se nam v komandni vrsici to tudi izpiše.
*Sedaj je SDMS strežnik pravilno nameščen in aktiven kot sistemski servis. Ob vsakem zagonu računalnika se bo avtomatsko zagnal tudi SDMS strežnik.

Za namestitev SDMS Automation Service in SDMS Web Service je postopek enak kot za SDMS Database Service.

== Namestitev odjemalcev ==
Na vsakem računalniku, kjer se bo uporabljal SDMS kot odjemalec, je priporočeno narediti trajno povezavo na mapo, kjer se nahaja SDMS odjemalec (z "Map network drive"). Primer: deljeno mapo \\SERVER\SDMS si namestimo kot disk G:.

Za lažji zagon programa si lahko ustvarite bližnjico na na namizju (primer: G:\SDMS.EXE).

Nato poženite program '''SDMS.EXE'''. Vpišete se z dodeljenim uporabniškim imenom in geslom, ki vam je dodeljen. Nato lahko (glede na licenčne pogoje) uporabljate aplikacije oz. razvojno orodje.

Namestitev sistema

2023-02-01T14:55:30Z

Janez Trtnik: /* Namestitev SDMS database strežnika */

__NOTOC__
[[Kategorije:Administracija sistema]]
== Zahteve strojne in programske opreme ==
Za uporabo sistema '''SDMS 4''' v omrežni verziji potrebujemo računalnike z operacijskim sistemom Windows.

Za delovanje omrežne verzije je seveda potrebno tudi omrežje.

Ostalih posebnih zahtev po strojni in programski opremi sicer ni. Načeloma sistem deluje na poljubnem sodobnem računalniku, seveda pa velja, da na hitrejšem računalniku deluje hitreje.

== Priporočena hiearhija direktorijev ==

D:
\SDMS
SDMS.exe
SDMS.ini
\DATABASE
\SDMSCL (client)
\SDMSDS (database service)
\SDMSAS (automation service)
\SDMSWS (web service)

== Namestitev sistema na strežnik ==
Prvi korak je namestitev samega sistema na strežnik. Postopek namestitve je naslednji:

*Na računalnik se prijavimo kot uporabnik z administratorskimi pravicami.
*Iz spletne strani '''https://www.sdms.si/''' prenesemo inštalacijske komponente, ki jih potrebujemo. Razpakiramo jih na zgoraj priporočeno direktorijsko hiearhijo.
V nadaljevanju bomo predpostavili, da je smo izbrali disk D in namestili sistem v izhodiščno mapo '''D:\SDMS'''.
*V primeru client-server sistema mapi '''D:\SDMS''' aktivirajte skupno rabo (sharing), in sicer pod imenom '''SDMS'''. S tem se bo omogočil enostaven in varen dostop odjemalcev do sistema.
*Če imate zaščitni ključ za uporabo programa, ga ustavite v USB vrata na računalniku.
*Na namizju si ustvarimo bližnjico do programa '''SDMS.EXE''', ki se nahaja v mapi '''D:\SDMS'''. Takšno bližnjico si bomo ustvarili tudi na vsakem računalniku, ki ga bomo uporabljali kot odjemalca.
*Nato s klikom na ikono programa zaženeno program.
*Če je program pravilno nameščen, se nam odpre glavno okno programa. Preden preidemo na nameščanje strežnika, moramo program zapreti.

== Namestitev SDMS servisov ==
SDMS Database Service se namesti kot sistemski servis. To pomeni, da se avtomatsko zažene takoj po zagonu samega računalnika, še preden se uporabnik prijavi v sistem. Strežnik ostane aktiven tudi potem, ko se uporabnik odjavi iz sistema. V tem načinu deluje strežnik popolnoma pritajeno (brez uporabniškega vmesnika).

Ko smo namestili sistem SDMS na strežnik, nadaljujemo z namestitvijo SDMS strežnika tako:

*V sistemsko mapo '''D:\SDMS\SDMSDS''' prenesemo datoteke, ki smo jih prenesli.
*V urejevalniku besedila (Beležnica oz. Notepad) popravimo vsebino datoteke SDMS.INI tako, da je pot to baze podatkov pravilno navedena (tipično je to '''D:\SDMS\DATABASE''').
*Iz komandne vrstice z administratorskimi pravicami zaženemo ukaz: '''D:\SDMS\SDMSDS\SDMSDSP.EXE -INSTALL'''.
*Če se je strežnik pravilno namestil, se nam izpiše sporočilo. Sicer pa nekaj ni v redu, in za vzrok si je treba ogledati datoteko SDMS.LOG, ki se je kreirala v '''D:\SDMS\SDMSDS'''. Če te datoteke tam ni, si je potrebno ogledati datoteko SDMS-????-??-??.LOG, ki se je kreirala v mapi, kjer je baza podatkov (tipično '''D:\SDMS\DATABASE'''). Po odpravi vzroka napake ponovimo prejšnji korak.
*Iz komandne vrstice zaženemo ukaz: '''NET START SDMSDS'''.
*Če se je strežnik pravilno zagnal, se nam v komandni vrsici to tudi izpiše.
*Sedaj je SDMS strežnik pravilno nameščen in aktiven kot sistemski servis. Ob vsakem zagonu računalnika se bo avtomatsko zagnal tudi SDMS strežnik.

Za namestitev SDMS Automation Service in SDMS Web Service je postopek enak kot za SDMS Database Service.

== Namestitev odjemalcev ==
Na vsakem računalniku, kjer se bo uporabljal SDMS kot odjemalec, je priporočeno narediti trajno povezavo na mapo, kjer se nahaja SDMS odjemalec (z "Map network drive"). Primer: deljeno mapo \\SERVER\SDMS si namestimo kot disk G:.

Za lažji zagon programa si lahko ustvarite bližnjico na na namizju (primer: G:\CLIENT.EXE).

Nato poženite program '''CLIENT.EXE'''. Ko prvič vstopate v sistem, vnesite uporabniško ime '''admin''' in pustite geslo prazno, kasneje pa vaše ime in geslo pod katerim vstopate v sistem. Nato lahko (glede na licenčne pogoje) uporabljate aplikacije oz. razvojno orodje.

Namestitev sistema

2023-02-01T14:52:27Z

Janez Trtnik: /* Namestitev SDMS strežnika */

__NOTOC__
[[Kategorije:Administracija sistema]]
== Zahteve strojne in programske opreme ==
Za uporabo sistema '''SDMS 4''' v omrežni verziji potrebujemo računalnike z operacijskim sistemom Windows.

Za delovanje omrežne verzije je seveda potrebno tudi omrežje.

Ostalih posebnih zahtev po strojni in programski opremi sicer ni. Načeloma sistem deluje na poljubnem sodobnem računalniku, seveda pa velja, da na hitrejšem računalniku deluje hitreje.

== Priporočena hiearhija direktorijev ==

D:
\SDMS
SDMS.exe
SDMS.ini
\DATABASE
\SDMSCL (client)
\SDMSDS (database service)
\SDMSAS (automation service)
\SDMSWS (web service)

== Namestitev sistema na strežnik ==
Prvi korak je namestitev samega sistema na strežnik. Postopek namestitve je naslednji:

*Na računalnik se prijavimo kot uporabnik z administratorskimi pravicami.
*Iz spletne strani '''https://www.sdms.si/''' prenesemo inštalacijske komponente, ki jih potrebujemo. Razpakiramo jih na zgoraj priporočeno direktorijsko hiearhijo.
V nadaljevanju bomo predpostavili, da je smo izbrali disk D in namestili sistem v izhodiščno mapo '''D:\SDMS'''.
*V primeru client-server sistema mapi '''D:\SDMS''' aktivirajte skupno rabo (sharing), in sicer pod imenom '''SDMS'''. S tem se bo omogočil enostaven in varen dostop odjemalcev do sistema.
*Če imate zaščitni ključ za uporabo programa, ga ustavite v USB vrata na računalniku.
*Na namizju si ustvarimo bližnjico do programa '''SDMS.EXE''', ki se nahaja v mapi '''D:\SDMS'''. Takšno bližnjico si bomo ustvarili tudi na vsakem računalniku, ki ga bomo uporabljali kot odjemalca.
*Nato s klikom na ikono programa zaženeno program.
*Če je program pravilno nameščen, se nam odpre glavno okno programa. Preden preidemo na nameščanje strežnika, moramo program zapreti.

== Namestitev SDMS database strežnika ==
SDMS strežnik se namesti kot sistemski servis. To pomeni, da se avtomatsko zažene takoj po zagonu samega računalnika, še preden se uporabnik prijavi v sistem. Strežnik ostane aktiven tudi potem, ko se uporabnik odjavi iz sistema. V tem načinu deluje strežnik popolnoma pritajeno (brez uporabniškega vmesnika).

Ko smo namestili sistem SDMS na strežnik, nadaljujemo z namestitvijo SDMS strežnika tako:

*V sistemsko mapo '''D:\SDMS\SDMSDS''' prenesemo datoteke, ki smo jih prenesli.
*V urejevalniku besedila (Beležnica oz. Notepad) popravimo vsebino datoteke SDMS.INI tako, da je pot to baze podatkov pravilno navedena (tipično je to '''D:\SDMS\DATABASE''').
*Iz komandne vrstice z administratorskimi pravicami zaženemo ukaz: '''D:\SDMS\SDMSDS\SDMSDSP.EXE -INSTALL'''.
*Če se je strežnik pravilno namestil, se nam izpiše sporočilo. Sicer pa nekaj ni v redu, in za vzrok si je treba ogledati datoteko SDMS.LOG, ki se je kreirala v '''D:\SDMS\SDMSDS'''. Če te datoteke tam ni, si je potrebno ogledati datoteko SDMS-????-??-??.LOG, ki se je kreirala v mapi, kjer je baza podatkov (tipično '''D:\SDMS\DATABASE'''). Po odpravi vzroka napake ponovimo prejšnji korak.
*Iz komandne vrstice zaženemo ukaz: '''NET START SDMSDS'''.
*Če se je strežnik pravilno zagnal, se nam v komandni vrsici to tudi izpiše.
*Sedaj je SDMS strežnik pravilno nameščen in aktiven kot sistemski servis. Ob vsakem zagonu računalnika se bo avtomatsko zagnal tudi SDMS strežnik.

== Namestitev odjemalcev ==
Na vsakem računalniku, kjer se bo uporabljal SDMS kot odjemalec, je priporočeno narediti trajno povezavo na mapo, kjer se nahaja SDMS odjemalec (z "Map network drive"). Primer: deljeno mapo \\SERVER\SDMS si namestimo kot disk G:.

Za lažji zagon programa si lahko ustvarite bližnjico na na namizju (primer: G:\CLIENT.EXE).

Nato poženite program '''CLIENT.EXE'''. Ko prvič vstopate v sistem, vnesite uporabniško ime '''admin''' in pustite geslo prazno, kasneje pa vaše ime in geslo pod katerim vstopate v sistem. Nato lahko (glede na licenčne pogoje) uporabljate aplikacije oz. razvojno orodje.

Namestitev sistema

2023-02-01T14:47:14Z

Janez Trtnik: /* Priporočena hiearhija direktorijev */

__NOTOC__
[[Kategorije:Administracija sistema]]
== Zahteve strojne in programske opreme ==
Za uporabo sistema '''SDMS 4''' v omrežni verziji potrebujemo računalnike z operacijskim sistemom Windows.

Za delovanje omrežne verzije je seveda potrebno tudi omrežje.

Ostalih posebnih zahtev po strojni in programski opremi sicer ni. Načeloma sistem deluje na poljubnem sodobnem računalniku, seveda pa velja, da na hitrejšem računalniku deluje hitreje.

== Priporočena hiearhija direktorijev ==

D:
\SDMS
SDMS.exe
SDMS.ini
\DATABASE
\SDMSCL (client)
\SDMSDS (database service)
\SDMSAS (automation service)
\SDMSWS (web service)

== Namestitev sistema na strežnik ==
Prvi korak je namestitev samega sistema na strežnik. Postopek namestitve je naslednji:

*Na računalnik se prijavimo kot uporabnik z administratorskimi pravicami.
*Iz spletne strani '''https://www.sdms.si/''' prenesemo inštalacijske komponente, ki jih potrebujemo. Razpakiramo jih na zgoraj priporočeno direktorijsko hiearhijo.
V nadaljevanju bomo predpostavili, da je smo izbrali disk D in namestili sistem v izhodiščno mapo '''D:\SDMS'''.
*V primeru client-server sistema mapi '''D:\SDMS''' aktivirajte skupno rabo (sharing), in sicer pod imenom '''SDMS'''. S tem se bo omogočil enostaven in varen dostop odjemalcev do sistema.
*Če imate zaščitni ključ za uporabo programa, ga ustavite v USB vrata na računalniku.
*Na namizju si ustvarimo bližnjico do programa '''SDMS.EXE''', ki se nahaja v mapi '''D:\SDMS'''. Takšno bližnjico si bomo ustvarili tudi na vsakem računalniku, ki ga bomo uporabljali kot odjemalca.
*Nato s klikom na ikono programa zaženeno program.
*Če je program pravilno nameščen, se nam odpre glavno okno programa. Preden preidemo na nameščanje strežnika, moramo program zapreti.

== Namestitev SDMS strežnika ==
SDMS strežnik se namesti kot sistemski servis. To pomeni, da se avtomatsko zažene takoj po zagonu samega računalnika, še preden se uporabnik prijavi v sistem. Strežnik ostane aktiven tudi potem, ko se uporabnik odjavi iz sistema. V tem načinu deluje strežnik popolnoma pritajeno (brez uporabniškega vmesnika).

Ko smo namestili sistem SDMS na strežnik, nadaljujemo z namestitvijo SDMS strežnika takole:

*V sistemsko mapo '''C:\WINNT\SYSTEM32''' prenesemo datoteke SDMS.EXE, SDMS.INI in SDMS.LIC.
*V urejevalniku besedila (Beležnica oz. Notepad) popravimo vsebino datoteke SDMS.INI tako, da je pot to baze podatkov pravilno navedena (tipično je to '''C:\SDMS\DATABASE''').
*Iz komandne vrstice zaženemo ukaz: '''SDMS.EXE -INSTALL'''.
*Če se je strežnik pravilno namestil, se nam izpiše sporočilo. Sicer pa nekaj ni v redu, in za vzrok si je treba ogledati datoteko SDMS.LOG, ki se je kreirala v sistemki mapi '''C:\WINNT\SYSTEM32'''. Če te datoteke tam ni, si je potrebno ogledati datoteko SDMS-????-??-??.LOG, ki se je kreirala v mapi, kjer je baza podatkov (tipično '''C:\SDMS\DATABASE'''). Po odpravi vzroka napake ponovimo prejšnji korak.
*Iz komandne vrstice zaženemo ukaz: '''NET START SDMS'''.
*Če se je strežnik pravilno zagnal, se nam v komandni vrsici to tudi izpiše.
*Sedaj je SDMS strežnik pravilno nameščen in aktiven kot sistemski servis. Ob vsakem zagonu računalnika se bo avtomatsko zagnal tudi SDMS strežnik.

== Namestitev odjemalcev ==
Na vsakem računalniku, kjer se bo uporabljal SDMS kot odjemalec, je priporočeno narediti trajno povezavo na mapo, kjer se nahaja SDMS odjemalec (z "Map network drive"). Primer: deljeno mapo \\SERVER\SDMS si namestimo kot disk G:.

Za lažji zagon programa si lahko ustvarite bližnjico na na namizju (primer: G:\CLIENT.EXE).

Nato poženite program '''CLIENT.EXE'''. Ko prvič vstopate v sistem, vnesite uporabniško ime '''admin''' in pustite geslo prazno, kasneje pa vaše ime in geslo pod katerim vstopate v sistem. Nato lahko (glede na licenčne pogoje) uporabljate aplikacije oz. razvojno orodje.

Namestitev sistema

2023-02-01T14:46:27Z

Janez Trtnik: /* Namestitev sistema na strežnik */

__NOTOC__
[[Kategorije:Administracija sistema]]
== Zahteve strojne in programske opreme ==
Za uporabo sistema '''SDMS 4''' v omrežni verziji potrebujemo računalnike z operacijskim sistemom Windows.

Za delovanje omrežne verzije je seveda potrebno tudi omrežje.

Ostalih posebnih zahtev po strojni in programski opremi sicer ni. Načeloma sistem deluje na poljubnem sodobnem računalniku, seveda pa velja, da na hitrejšem računalniku deluje hitreje.

== Priporočena hiearhija direktorijev ==

D:
\SDMS
\DATABASE
\SDMSCL (client)
\SDMSDS (database service)
\SDMSAS (automation service)
\SDMSWS (web service)

== Namestitev sistema na strežnik ==
Prvi korak je namestitev samega sistema na strežnik. Postopek namestitve je naslednji:

*Na računalnik se prijavimo kot uporabnik z administratorskimi pravicami.
*Iz spletne strani '''https://www.sdms.si/''' prenesemo inštalacijske komponente, ki jih potrebujemo. Razpakiramo jih na zgoraj priporočeno direktorijsko hiearhijo.
V nadaljevanju bomo predpostavili, da je smo izbrali disk D in namestili sistem v izhodiščno mapo '''D:\SDMS'''.
*V primeru client-server sistema mapi '''D:\SDMS''' aktivirajte skupno rabo (sharing), in sicer pod imenom '''SDMS'''. S tem se bo omogočil enostaven in varen dostop odjemalcev do sistema.
*Če imate zaščitni ključ za uporabo programa, ga ustavite v USB vrata na računalniku.
*Na namizju si ustvarimo bližnjico do programa '''SDMS.EXE''', ki se nahaja v mapi '''D:\SDMS'''. Takšno bližnjico si bomo ustvarili tudi na vsakem računalniku, ki ga bomo uporabljali kot odjemalca.
*Nato s klikom na ikono programa zaženeno program.
*Če je program pravilno nameščen, se nam odpre glavno okno programa. Preden preidemo na nameščanje strežnika, moramo program zapreti.

== Namestitev SDMS strežnika ==
SDMS strežnik se namesti kot sistemski servis. To pomeni, da se avtomatsko zažene takoj po zagonu samega računalnika, še preden se uporabnik prijavi v sistem. Strežnik ostane aktiven tudi potem, ko se uporabnik odjavi iz sistema. V tem načinu deluje strežnik popolnoma pritajeno (brez uporabniškega vmesnika).

Ko smo namestili sistem SDMS na strežnik, nadaljujemo z namestitvijo SDMS strežnika takole:

*V sistemsko mapo '''C:\WINNT\SYSTEM32''' prenesemo datoteke SDMS.EXE, SDMS.INI in SDMS.LIC.
*V urejevalniku besedila (Beležnica oz. Notepad) popravimo vsebino datoteke SDMS.INI tako, da je pot to baze podatkov pravilno navedena (tipično je to '''C:\SDMS\DATABASE''').
*Iz komandne vrstice zaženemo ukaz: '''SDMS.EXE -INSTALL'''.
*Če se je strežnik pravilno namestil, se nam izpiše sporočilo. Sicer pa nekaj ni v redu, in za vzrok si je treba ogledati datoteko SDMS.LOG, ki se je kreirala v sistemki mapi '''C:\WINNT\SYSTEM32'''. Če te datoteke tam ni, si je potrebno ogledati datoteko SDMS-????-??-??.LOG, ki se je kreirala v mapi, kjer je baza podatkov (tipično '''C:\SDMS\DATABASE'''). Po odpravi vzroka napake ponovimo prejšnji korak.
*Iz komandne vrstice zaženemo ukaz: '''NET START SDMS'''.
*Če se je strežnik pravilno zagnal, se nam v komandni vrsici to tudi izpiše.
*Sedaj je SDMS strežnik pravilno nameščen in aktiven kot sistemski servis. Ob vsakem zagonu računalnika se bo avtomatsko zagnal tudi SDMS strežnik.

== Namestitev odjemalcev ==
Na vsakem računalniku, kjer se bo uporabljal SDMS kot odjemalec, je priporočeno narediti trajno povezavo na mapo, kjer se nahaja SDMS odjemalec (z "Map network drive"). Primer: deljeno mapo \\SERVER\SDMS si namestimo kot disk G:.

Za lažji zagon programa si lahko ustvarite bližnjico na na namizju (primer: G:\CLIENT.EXE).

Nato poženite program '''CLIENT.EXE'''. Ko prvič vstopate v sistem, vnesite uporabniško ime '''admin''' in pustite geslo prazno, kasneje pa vaše ime in geslo pod katerim vstopate v sistem. Nato lahko (glede na licenčne pogoje) uporabljate aplikacije oz. razvojno orodje.

Namestitev sistema

2023-02-01T14:38:58Z

Janez Trtnik: /* Priporočena hiearhija direktorijev */

__NOTOC__
[[Kategorije:Administracija sistema]]
== Zahteve strojne in programske opreme ==
Za uporabo sistema '''SDMS 4''' v omrežni verziji potrebujemo računalnike z operacijskim sistemom Windows.

Za delovanje omrežne verzije je seveda potrebno tudi omrežje.

Ostalih posebnih zahtev po strojni in programski opremi sicer ni. Načeloma sistem deluje na poljubnem sodobnem računalniku, seveda pa velja, da na hitrejšem računalniku deluje hitreje.

== Priporočena hiearhija direktorijev ==

D:
\SDMS
\DATABASE
\SDMSCL (client)
\SDMSDS (database service)
\SDMSAS (automation service)
\SDMSWS (web service)

== Namestitev sistema na strežnik ==
Prvi korak je namestitev samega sistema na strežnik. Postopek namestitve je naslednji:

*Na računalnik se prijavimo kot uporabnik z administratorskimi pravicami.
*Iz spletne strani '''https://www.sdms.si/''' prenesemo na poljubni disk vsebino v enakem imeniškem sistemu kot je zapisana na CD-ROMu. V nadaljevanju bomo predpostavili, da je smo izbrali disk C in namestili sistem v izhodiščno mapo '''C:\SDMS'''.
*Pri prenosu datotek moramo posebej paziti, da datoteke ne ohranijo '''read-only''' atributa, ki ga imajo nastavljenega na CD-ROMu. Če imajo datoteke na disku slučajno nastavljen ta atribut, ga je treba ročno odstraniti.
*Priporočamo, da mapi '''C:\SDMS''' aktivirate skupno rabo (sharing), in sicer pod imenom '''SDMS'''. S tem se bo omogočil enostaven in varen dostop odjemalcev do sistema.
*Nato izvedemo namestitev gonilnika za zaščitni ključ. To storimo tako, da zaženemo program '''HLDRV32.EXE''', ki se nahaja v mapi '''C:\SDMS''', in sledimo namestitvi gonilnika, kakor nas vodi program.
*Po zaključeni namestitvi gonilnika vstavimo zaščitni ključ v LPT vrata na strežniku. Če imate kakšna vrata še prosta, uporabite le-ta, sicer pa priključite tiskalnik preko ključa.
*Na namizju Oken si ustvarimo bližnjico do programa '''CLIENT.EXE''', ki se nahaja v mapi '''C:\SDMS'''. Takšno bližnjico si bomo ustvarili tudi na vsakem računalniku, ki ga bomo uporabljali kot odjemalca.
*Nato s klikom na ikono programa zaženeno program. Ko prvič vstopamo v sistem, uporabimo uporabniško ime '''Administrator''' (ali krajše '''admin''') in prazno geslo, kasneje pa bo vsak uporabnik vstopal pod svojim imenom.
*Če je program pravilno nameščen, se nam odpre glavno okno programa. To nam za sedaj zadošča. Preden preidemo na nameščanje strežnika moramo program zapreti.

== Namestitev SDMS strežnika ==
SDMS strežnik se namesti kot sistemski servis. To pomeni, da se avtomatsko zažene takoj po zagonu samega računalnika, še preden se uporabnik prijavi v sistem. Strežnik ostane aktiven tudi potem, ko se uporabnik odjavi iz sistema. V tem načinu deluje strežnik popolnoma pritajeno (brez uporabniškega vmesnika).

Ko smo namestili sistem SDMS na strežnik, nadaljujemo z namestitvijo SDMS strežnika takole:

*V sistemsko mapo '''C:\WINNT\SYSTEM32''' prenesemo datoteke SDMS.EXE, SDMS.INI in SDMS.LIC.
*V urejevalniku besedila (Beležnica oz. Notepad) popravimo vsebino datoteke SDMS.INI tako, da je pot to baze podatkov pravilno navedena (tipično je to '''C:\SDMS\DATABASE''').
*Iz komandne vrstice zaženemo ukaz: '''SDMS.EXE -INSTALL'''.
*Če se je strežnik pravilno namestil, se nam izpiše sporočilo. Sicer pa nekaj ni v redu, in za vzrok si je treba ogledati datoteko SDMS.LOG, ki se je kreirala v sistemki mapi '''C:\WINNT\SYSTEM32'''. Če te datoteke tam ni, si je potrebno ogledati datoteko SDMS-????-??-??.LOG, ki se je kreirala v mapi, kjer je baza podatkov (tipično '''C:\SDMS\DATABASE'''). Po odpravi vzroka napake ponovimo prejšnji korak.
*Iz komandne vrstice zaženemo ukaz: '''NET START SDMS'''.
*Če se je strežnik pravilno zagnal, se nam v komandni vrsici to tudi izpiše.
*Sedaj je SDMS strežnik pravilno nameščen in aktiven kot sistemski servis. Ob vsakem zagonu računalnika se bo avtomatsko zagnal tudi SDMS strežnik.

== Namestitev odjemalcev ==
Na vsakem računalniku, kjer se bo uporabljal SDMS kot odjemalec, je priporočeno narediti trajno povezavo na mapo, kjer se nahaja SDMS odjemalec (z "Map network drive"). Primer: deljeno mapo \\SERVER\SDMS si namestimo kot disk G:.

Za lažji zagon programa si lahko ustvarite bližnjico na na namizju (primer: G:\CLIENT.EXE).

Nato poženite program '''CLIENT.EXE'''. Ko prvič vstopate v sistem, vnesite uporabniško ime '''admin''' in pustite geslo prazno, kasneje pa vaše ime in geslo pod katerim vstopate v sistem. Nato lahko (glede na licenčne pogoje) uporabljate aplikacije oz. razvojno orodje.

Namestitev sistema

2023-02-01T14:38:46Z

Janez Trtnik: /* Priporočena hiearhija direktorijev */

__NOTOC__
[[Kategorije:Administracija sistema]]
== Zahteve strojne in programske opreme ==
Za uporabo sistema '''SDMS 4''' v omrežni verziji potrebujemo računalnike z operacijskim sistemom Windows.

Za delovanje omrežne verzije je seveda potrebno tudi omrežje.

Ostalih posebnih zahtev po strojni in programski opremi sicer ni. Načeloma sistem deluje na poljubnem sodobnem računalniku, seveda pa velja, da na hitrejšem računalniku deluje hitreje.

== Priporočena hiearhija direktorijev ==

D:
\SDMS
\DATABASE
\SDMSCL (client)
\SDMSDS (database service)
\SDMSAS (automation service)
\SDMSWS (web service)

== Namestitev sistema na strežnik ==
Prvi korak je namestitev samega sistema na strežnik. Postopek namestitve je naslednji:

*Na računalnik se prijavimo kot uporabnik z administratorskimi pravicami.
*Iz spletne strani '''https://www.sdms.si/''' prenesemo na poljubni disk vsebino v enakem imeniškem sistemu kot je zapisana na CD-ROMu. V nadaljevanju bomo predpostavili, da je smo izbrali disk C in namestili sistem v izhodiščno mapo '''C:\SDMS'''.
*Pri prenosu datotek moramo posebej paziti, da datoteke ne ohranijo '''read-only''' atributa, ki ga imajo nastavljenega na CD-ROMu. Če imajo datoteke na disku slučajno nastavljen ta atribut, ga je treba ročno odstraniti.
*Priporočamo, da mapi '''C:\SDMS''' aktivirate skupno rabo (sharing), in sicer pod imenom '''SDMS'''. S tem se bo omogočil enostaven in varen dostop odjemalcev do sistema.
*Nato izvedemo namestitev gonilnika za zaščitni ključ. To storimo tako, da zaženemo program '''HLDRV32.EXE''', ki se nahaja v mapi '''C:\SDMS''', in sledimo namestitvi gonilnika, kakor nas vodi program.
*Po zaključeni namestitvi gonilnika vstavimo zaščitni ključ v LPT vrata na strežniku. Če imate kakšna vrata še prosta, uporabite le-ta, sicer pa priključite tiskalnik preko ključa.
*Na namizju Oken si ustvarimo bližnjico do programa '''CLIENT.EXE''', ki se nahaja v mapi '''C:\SDMS'''. Takšno bližnjico si bomo ustvarili tudi na vsakem računalniku, ki ga bomo uporabljali kot odjemalca.
*Nato s klikom na ikono programa zaženeno program. Ko prvič vstopamo v sistem, uporabimo uporabniško ime '''Administrator''' (ali krajše '''admin''') in prazno geslo, kasneje pa bo vsak uporabnik vstopal pod svojim imenom.
*Če je program pravilno nameščen, se nam odpre glavno okno programa. To nam za sedaj zadošča. Preden preidemo na nameščanje strežnika moramo program zapreti.

== Namestitev SDMS strežnika ==
SDMS strežnik se namesti kot sistemski servis. To pomeni, da se avtomatsko zažene takoj po zagonu samega računalnika, še preden se uporabnik prijavi v sistem. Strežnik ostane aktiven tudi potem, ko se uporabnik odjavi iz sistema. V tem načinu deluje strežnik popolnoma pritajeno (brez uporabniškega vmesnika).

Ko smo namestili sistem SDMS na strežnik, nadaljujemo z namestitvijo SDMS strežnika takole:

*V sistemsko mapo '''C:\WINNT\SYSTEM32''' prenesemo datoteke SDMS.EXE, SDMS.INI in SDMS.LIC.
*V urejevalniku besedila (Beležnica oz. Notepad) popravimo vsebino datoteke SDMS.INI tako, da je pot to baze podatkov pravilno navedena (tipično je to '''C:\SDMS\DATABASE''').
*Iz komandne vrstice zaženemo ukaz: '''SDMS.EXE -INSTALL'''.
*Če se je strežnik pravilno namestil, se nam izpiše sporočilo. Sicer pa nekaj ni v redu, in za vzrok si je treba ogledati datoteko SDMS.LOG, ki se je kreirala v sistemki mapi '''C:\WINNT\SYSTEM32'''. Če te datoteke tam ni, si je potrebno ogledati datoteko SDMS-????-??-??.LOG, ki se je kreirala v mapi, kjer je baza podatkov (tipično '''C:\SDMS\DATABASE'''). Po odpravi vzroka napake ponovimo prejšnji korak.
*Iz komandne vrstice zaženemo ukaz: '''NET START SDMS'''.
*Če se je strežnik pravilno zagnal, se nam v komandni vrsici to tudi izpiše.
*Sedaj je SDMS strežnik pravilno nameščen in aktiven kot sistemski servis. Ob vsakem zagonu računalnika se bo avtomatsko zagnal tudi SDMS strežnik.

== Namestitev odjemalcev ==
Na vsakem računalniku, kjer se bo uporabljal SDMS kot odjemalec, je priporočeno narediti trajno povezavo na mapo, kjer se nahaja SDMS odjemalec (z "Map network drive"). Primer: deljeno mapo \\SERVER\SDMS si namestimo kot disk G:.

Za lažji zagon programa si lahko ustvarite bližnjico na na namizju (primer: G:\CLIENT.EXE).

Nato poženite program '''CLIENT.EXE'''. Ko prvič vstopate v sistem, vnesite uporabniško ime '''admin''' in pustite geslo prazno, kasneje pa vaše ime in geslo pod katerim vstopate v sistem. Nato lahko (glede na licenčne pogoje) uporabljate aplikacije oz. razvojno orodje.

Namestitev sistema

2023-02-01T14:36:44Z

Janez Trtnik:

__NOTOC__
[[Kategorije:Administracija sistema]]
== Zahteve strojne in programske opreme ==
Za uporabo sistema '''SDMS 4''' v omrežni verziji potrebujemo računalnike z operacijskim sistemom Windows.

Za delovanje omrežne verzije je seveda potrebno tudi omrežje.

Ostalih posebnih zahtev po strojni in programski opremi sicer ni. Načeloma sistem deluje na poljubnem sodobnem računalniku, seveda pa velja, da na hitrejšem računalniku deluje hitreje.

== Priporočena hiearhija direktorijev ==

D:
\SDMS
\DATABASE
\SDMSCL (client)
\SDMSDS (database service)
\SDMSAS (automation service)
\SDMSWS (web service)

== Namestitev sistema na strežnik ==
Prvi korak je namestitev samega sistema na strežnik. Postopek namestitve je naslednji:

*Na računalnik se prijavimo kot uporabnik z administratorskimi pravicami.
*Iz spletne strani '''https://www.sdms.si/''' prenesemo na poljubni disk vsebino v enakem imeniškem sistemu kot je zapisana na CD-ROMu. V nadaljevanju bomo predpostavili, da je smo izbrali disk C in namestili sistem v izhodiščno mapo '''C:\SDMS'''.
*Pri prenosu datotek moramo posebej paziti, da datoteke ne ohranijo '''read-only''' atributa, ki ga imajo nastavljenega na CD-ROMu. Če imajo datoteke na disku slučajno nastavljen ta atribut, ga je treba ročno odstraniti.
*Priporočamo, da mapi '''C:\SDMS''' aktivirate skupno rabo (sharing), in sicer pod imenom '''SDMS'''. S tem se bo omogočil enostaven in varen dostop odjemalcev do sistema.
*Nato izvedemo namestitev gonilnika za zaščitni ključ. To storimo tako, da zaženemo program '''HLDRV32.EXE''', ki se nahaja v mapi '''C:\SDMS''', in sledimo namestitvi gonilnika, kakor nas vodi program.
*Po zaključeni namestitvi gonilnika vstavimo zaščitni ključ v LPT vrata na strežniku. Če imate kakšna vrata še prosta, uporabite le-ta, sicer pa priključite tiskalnik preko ključa.
*Na namizju Oken si ustvarimo bližnjico do programa '''CLIENT.EXE''', ki se nahaja v mapi '''C:\SDMS'''. Takšno bližnjico si bomo ustvarili tudi na vsakem računalniku, ki ga bomo uporabljali kot odjemalca.
*Nato s klikom na ikono programa zaženeno program. Ko prvič vstopamo v sistem, uporabimo uporabniško ime '''Administrator''' (ali krajše '''admin''') in prazno geslo, kasneje pa bo vsak uporabnik vstopal pod svojim imenom.
*Če je program pravilno nameščen, se nam odpre glavno okno programa. To nam za sedaj zadošča. Preden preidemo na nameščanje strežnika moramo program zapreti.

== Namestitev SDMS strežnika ==
SDMS strežnik se namesti kot sistemski servis. To pomeni, da se avtomatsko zažene takoj po zagonu samega računalnika, še preden se uporabnik prijavi v sistem. Strežnik ostane aktiven tudi potem, ko se uporabnik odjavi iz sistema. V tem načinu deluje strežnik popolnoma pritajeno (brez uporabniškega vmesnika).

Ko smo namestili sistem SDMS na strežnik, nadaljujemo z namestitvijo SDMS strežnika takole:

*V sistemsko mapo '''C:\WINNT\SYSTEM32''' prenesemo datoteke SDMS.EXE, SDMS.INI in SDMS.LIC.
*V urejevalniku besedila (Beležnica oz. Notepad) popravimo vsebino datoteke SDMS.INI tako, da je pot to baze podatkov pravilno navedena (tipično je to '''C:\SDMS\DATABASE''').
*Iz komandne vrstice zaženemo ukaz: '''SDMS.EXE -INSTALL'''.
*Če se je strežnik pravilno namestil, se nam izpiše sporočilo. Sicer pa nekaj ni v redu, in za vzrok si je treba ogledati datoteko SDMS.LOG, ki se je kreirala v sistemki mapi '''C:\WINNT\SYSTEM32'''. Če te datoteke tam ni, si je potrebno ogledati datoteko SDMS-????-??-??.LOG, ki se je kreirala v mapi, kjer je baza podatkov (tipično '''C:\SDMS\DATABASE'''). Po odpravi vzroka napake ponovimo prejšnji korak.
*Iz komandne vrstice zaženemo ukaz: '''NET START SDMS'''.
*Če se je strežnik pravilno zagnal, se nam v komandni vrsici to tudi izpiše.
*Sedaj je SDMS strežnik pravilno nameščen in aktiven kot sistemski servis. Ob vsakem zagonu računalnika se bo avtomatsko zagnal tudi SDMS strežnik.

== Namestitev odjemalcev ==
Na vsakem računalniku, kjer se bo uporabljal SDMS kot odjemalec, je priporočeno narediti trajno povezavo na mapo, kjer se nahaja SDMS odjemalec (z "Map network drive"). Primer: deljeno mapo \\SERVER\SDMS si namestimo kot disk G:.

Za lažji zagon programa si lahko ustvarite bližnjico na na namizju (primer: G:\CLIENT.EXE).

Nato poženite program '''CLIENT.EXE'''. Ko prvič vstopate v sistem, vnesite uporabniško ime '''admin''' in pustite geslo prazno, kasneje pa vaše ime in geslo pod katerim vstopate v sistem. Nato lahko (glede na licenčne pogoje) uporabljate aplikacije oz. razvojno orodje.

Namestitev sistema

2023-02-01T14:36:14Z

Janez Trtnik: /* Namestitev Web strežnika */

__NOTOC__
[[Kategorije:Administracija sistema]]
== Zahteve strojne in programske opreme ==
Za uporabo sistema '''SDMS 4''' v omrežni verziji potrebujemo računalnike z operacijskim sistemom Windows.

Za delovanje omrežne verzije je seveda potrebno tudi omrežje.

Ostalih posebnih zahtev po strojni in programski opremi sicer ni. Načeloma sistem deluje na poljubnem sodobnem računalniku, seveda pa velja, da na hitrejšem računalniku deluje hitreje.

== Namestitev sistema na strežnik ==
Prvi korak je namestitev samega sistema na strežnik. Postopek namestitve je naslednji:

*Na računalnik se prijavimo kot uporabnik z administratorskimi pravicami.
*Iz spletne strani '''https://www.sdms.si/''' prenesemo na poljubni disk vsebino v enakem imeniškem sistemu kot je zapisana na CD-ROMu. V nadaljevanju bomo predpostavili, da je smo izbrali disk C in namestili sistem v izhodiščno mapo '''C:\SDMS'''.
*Pri prenosu datotek moramo posebej paziti, da datoteke ne ohranijo '''read-only''' atributa, ki ga imajo nastavljenega na CD-ROMu. Če imajo datoteke na disku slučajno nastavljen ta atribut, ga je treba ročno odstraniti.
*Priporočamo, da mapi '''C:\SDMS''' aktivirate skupno rabo (sharing), in sicer pod imenom '''SDMS'''. S tem se bo omogočil enostaven in varen dostop odjemalcev do sistema.
*Nato izvedemo namestitev gonilnika za zaščitni ključ. To storimo tako, da zaženemo program '''HLDRV32.EXE''', ki se nahaja v mapi '''C:\SDMS''', in sledimo namestitvi gonilnika, kakor nas vodi program.
*Po zaključeni namestitvi gonilnika vstavimo zaščitni ključ v LPT vrata na strežniku. Če imate kakšna vrata še prosta, uporabite le-ta, sicer pa priključite tiskalnik preko ključa.
*Na namizju Oken si ustvarimo bližnjico do programa '''CLIENT.EXE''', ki se nahaja v mapi '''C:\SDMS'''. Takšno bližnjico si bomo ustvarili tudi na vsakem računalniku, ki ga bomo uporabljali kot odjemalca.
*Nato s klikom na ikono programa zaženeno program. Ko prvič vstopamo v sistem, uporabimo uporabniško ime '''Administrator''' (ali krajše '''admin''') in prazno geslo, kasneje pa bo vsak uporabnik vstopal pod svojim imenom.
*Če je program pravilno nameščen, se nam odpre glavno okno programa. To nam za sedaj zadošča. Preden preidemo na nameščanje strežnika moramo program zapreti.

== Namestitev SDMS strežnika ==
SDMS strežnik se namesti kot sistemski servis. To pomeni, da se avtomatsko zažene takoj po zagonu samega računalnika, še preden se uporabnik prijavi v sistem. Strežnik ostane aktiven tudi potem, ko se uporabnik odjavi iz sistema. V tem načinu deluje strežnik popolnoma pritajeno (brez uporabniškega vmesnika).

Ko smo namestili sistem SDMS na strežnik, nadaljujemo z namestitvijo SDMS strežnika takole:

*V sistemsko mapo '''C:\WINNT\SYSTEM32''' prenesemo datoteke SDMS.EXE, SDMS.INI in SDMS.LIC.
*V urejevalniku besedila (Beležnica oz. Notepad) popravimo vsebino datoteke SDMS.INI tako, da je pot to baze podatkov pravilno navedena (tipično je to '''C:\SDMS\DATABASE''').
*Iz komandne vrstice zaženemo ukaz: '''SDMS.EXE -INSTALL'''.
*Če se je strežnik pravilno namestil, se nam izpiše sporočilo. Sicer pa nekaj ni v redu, in za vzrok si je treba ogledati datoteko SDMS.LOG, ki se je kreirala v sistemki mapi '''C:\WINNT\SYSTEM32'''. Če te datoteke tam ni, si je potrebno ogledati datoteko SDMS-????-??-??.LOG, ki se je kreirala v mapi, kjer je baza podatkov (tipično '''C:\SDMS\DATABASE'''). Po odpravi vzroka napake ponovimo prejšnji korak.
*Iz komandne vrstice zaženemo ukaz: '''NET START SDMS'''.
*Če se je strežnik pravilno zagnal, se nam v komandni vrsici to tudi izpiše.
*Sedaj je SDMS strežnik pravilno nameščen in aktiven kot sistemski servis. Ob vsakem zagonu računalnika se bo avtomatsko zagnal tudi SDMS strežnik.

== Namestitev odjemalcev ==
Na vsakem računalniku, kjer se bo uporabljal SDMS kot odjemalec, je priporočeno narediti trajno povezavo na mapo, kjer se nahaja SDMS odjemalec (z "Map network drive"). Primer: deljeno mapo \\SERVER\SDMS si namestimo kot disk G:.

Za lažji zagon programa si lahko ustvarite bližnjico na na namizju (primer: G:\CLIENT.EXE).

Nato poženite program '''CLIENT.EXE'''. Ko prvič vstopate v sistem, vnesite uporabniško ime '''admin''' in pustite geslo prazno, kasneje pa vaše ime in geslo pod katerim vstopate v sistem. Nato lahko (glede na licenčne pogoje) uporabljate aplikacije oz. razvojno orodje.

== Priporočena hiearhija direktorijev ==

D:
\SDMS
\DATABASE
\SDMSCL (client)
\SDMSDS (database service)
\SDMSAS (automation service)
\SDMSWS (web service)

Namestitev sistema

2023-02-01T14:32:16Z

Janez Trtnik: /* Namestitev sistema na strežnik */

__NOTOC__
[[Kategorije:Administracija sistema]]
== Zahteve strojne in programske opreme ==
Za uporabo sistema '''SDMS 4''' v omrežni verziji potrebujemo računalnike z operacijskim sistemom Windows.

Za delovanje omrežne verzije je seveda potrebno tudi omrežje.

Ostalih posebnih zahtev po strojni in programski opremi sicer ni. Načeloma sistem deluje na poljubnem sodobnem računalniku, seveda pa velja, da na hitrejšem računalniku deluje hitreje.

== Namestitev sistema na strežnik ==
Prvi korak je namestitev samega sistema na strežnik. Postopek namestitve je naslednji:

*Na računalnik se prijavimo kot uporabnik z administratorskimi pravicami.
*Iz spletne strani '''https://www.sdms.si/''' prenesemo na poljubni disk vsebino v enakem imeniškem sistemu kot je zapisana na CD-ROMu. V nadaljevanju bomo predpostavili, da je smo izbrali disk C in namestili sistem v izhodiščno mapo '''C:\SDMS'''.
*Pri prenosu datotek moramo posebej paziti, da datoteke ne ohranijo '''read-only''' atributa, ki ga imajo nastavljenega na CD-ROMu. Če imajo datoteke na disku slučajno nastavljen ta atribut, ga je treba ročno odstraniti.
*Priporočamo, da mapi '''C:\SDMS''' aktivirate skupno rabo (sharing), in sicer pod imenom '''SDMS'''. S tem se bo omogočil enostaven in varen dostop odjemalcev do sistema.
*Nato izvedemo namestitev gonilnika za zaščitni ključ. To storimo tako, da zaženemo program '''HLDRV32.EXE''', ki se nahaja v mapi '''C:\SDMS''', in sledimo namestitvi gonilnika, kakor nas vodi program.
*Po zaključeni namestitvi gonilnika vstavimo zaščitni ključ v LPT vrata na strežniku. Če imate kakšna vrata še prosta, uporabite le-ta, sicer pa priključite tiskalnik preko ključa.
*Na namizju Oken si ustvarimo bližnjico do programa '''CLIENT.EXE''', ki se nahaja v mapi '''C:\SDMS'''. Takšno bližnjico si bomo ustvarili tudi na vsakem računalniku, ki ga bomo uporabljali kot odjemalca.
*Nato s klikom na ikono programa zaženeno program. Ko prvič vstopamo v sistem, uporabimo uporabniško ime '''Administrator''' (ali krajše '''admin''') in prazno geslo, kasneje pa bo vsak uporabnik vstopal pod svojim imenom.
*Če je program pravilno nameščen, se nam odpre glavno okno programa. To nam za sedaj zadošča. Preden preidemo na nameščanje strežnika moramo program zapreti.

== Namestitev SDMS strežnika ==
SDMS strežnik se namesti kot sistemski servis. To pomeni, da se avtomatsko zažene takoj po zagonu samega računalnika, še preden se uporabnik prijavi v sistem. Strežnik ostane aktiven tudi potem, ko se uporabnik odjavi iz sistema. V tem načinu deluje strežnik popolnoma pritajeno (brez uporabniškega vmesnika).

Ko smo namestili sistem SDMS na strežnik, nadaljujemo z namestitvijo SDMS strežnika takole:

*V sistemsko mapo '''C:\WINNT\SYSTEM32''' prenesemo datoteke SDMS.EXE, SDMS.INI in SDMS.LIC.
*V urejevalniku besedila (Beležnica oz. Notepad) popravimo vsebino datoteke SDMS.INI tako, da je pot to baze podatkov pravilno navedena (tipično je to '''C:\SDMS\DATABASE''').
*Iz komandne vrstice zaženemo ukaz: '''SDMS.EXE -INSTALL'''.
*Če se je strežnik pravilno namestil, se nam izpiše sporočilo. Sicer pa nekaj ni v redu, in za vzrok si je treba ogledati datoteko SDMS.LOG, ki se je kreirala v sistemki mapi '''C:\WINNT\SYSTEM32'''. Če te datoteke tam ni, si je potrebno ogledati datoteko SDMS-????-??-??.LOG, ki se je kreirala v mapi, kjer je baza podatkov (tipično '''C:\SDMS\DATABASE'''). Po odpravi vzroka napake ponovimo prejšnji korak.
*Iz komandne vrstice zaženemo ukaz: '''NET START SDMS'''.
*Če se je strežnik pravilno zagnal, se nam v komandni vrsici to tudi izpiše.
*Sedaj je SDMS strežnik pravilno nameščen in aktiven kot sistemski servis. Ob vsakem zagonu računalnika se bo avtomatsko zagnal tudi SDMS strežnik.

== Namestitev odjemalcev ==
Na vsakem računalniku, kjer se bo uporabljal SDMS kot odjemalec, je priporočeno narediti trajno povezavo na mapo, kjer se nahaja SDMS odjemalec (z "Map network drive"). Primer: deljeno mapo \\SERVER\SDMS si namestimo kot disk G:.

Za lažji zagon programa si lahko ustvarite bližnjico na na namizju (primer: G:\CLIENT.EXE).

Nato poženite program '''CLIENT.EXE'''. Ko prvič vstopate v sistem, vnesite uporabniško ime '''admin''' in pustite geslo prazno, kasneje pa vaše ime in geslo pod katerim vstopate v sistem. Nato lahko (glede na licenčne pogoje) uporabljate aplikacije oz. razvojno orodje.

== Namestitev Web strežnika ==
Će imate nabavljeno licenco SDMS WebServer, je potrebno instalirati tudi tega kot servis.

C:\SDMS
\DATABASE
\CLIENT
\SERVER
\WEBSERVER

Namestitev sistema

2023-02-01T14:30:25Z

Janez Trtnik: /* Zahteve strojne in programske opreme */

__NOTOC__
[[Kategorije:Administracija sistema]]
== Zahteve strojne in programske opreme ==
Za uporabo sistema '''SDMS 4''' v omrežni verziji potrebujemo računalnike z operacijskim sistemom Windows.

Za delovanje omrežne verzije je seveda potrebno tudi omrežje.

Ostalih posebnih zahtev po strojni in programski opremi sicer ni. Načeloma sistem deluje na poljubnem sodobnem računalniku, seveda pa velja, da na hitrejšem računalniku deluje hitreje.

== Namestitev sistema na strežnik ==
Prvi korak je namestitev samega sistema na strežnik. Postopek namestitve je naslednji:

*Na računalnik se prijavimo kot uporabnik z administratorskimi pravicami.
*Iz namestitvenega CD-ROMa prenesemo na poljubni disk računalnika vsebino v enakem imeniškem sistemu kot je zapisana na CD-ROMu. V nadaljevanju bomo predpostavili, da je smo izbrali disk C in namestili sistem v izhodiščno mapo '''C:\SDMS'''.
*Pri prenosu datotek moramo posebej paziti, da datoteke ne ohranijo '''read-only''' atributa, ki ga imajo nastavljenega na CD-ROMu. Če imajo datoteke na disku slučajno nastavljen ta atribut, ga je treba ročno odstraniti.
*Priporočamo, da mapi '''C:\SDMS''' aktivirate skupno rabo (sharing), in sicer pod imenom '''SDMS'''. S tem se bo omogočil enostaven in varen dostop odjemalcev do sistema.
*Nato izvedemo namestitev gonilnika za zaščitni ključ. To storimo tako, da zaženemo program '''HLDRV32.EXE''', ki se nahaja v mapi '''C:\SDMS''', in sledimo namestitvi gonilnika, kakor nas vodi program.
*Po zaključeni namestitvi gonilnika vstavimo zaščitni ključ v LPT vrata na strežniku. Če imate kakšna vrata še prosta, uporabite le-ta, sicer pa priključite tiskalnik preko ključa.
*Na namizju Oken si ustvarimo bližnjico do programa '''CLIENT.EXE''', ki se nahaja v mapi '''C:\SDMS'''. Takšno bližnjico si bomo ustvarili tudi na vsakem računalniku, ki ga bomo uporabljali kot odjemalca.
*Nato s klikom na ikono programa zaženeno program. Ko prvič vstopamo v sistem, uporabimo uporabniško ime '''Administrator''' (ali krajše '''admin''') in prazno geslo, kasneje pa bo vsak uporabnik vstopal pod svojim imenom.
*Če je program pravilno nameščen, se nam odpre glavno okno programa. To nam za sedaj zadošča. Preden preidemo na nameščanje strežnika moramo program zapreti.
== Namestitev SDMS strežnika ==
SDMS strežnik se namesti kot sistemski servis. To pomeni, da se avtomatsko zažene takoj po zagonu samega računalnika, še preden se uporabnik prijavi v sistem. Strežnik ostane aktiven tudi potem, ko se uporabnik odjavi iz sistema. V tem načinu deluje strežnik popolnoma pritajeno (brez uporabniškega vmesnika).

Ko smo namestili sistem SDMS na strežnik, nadaljujemo z namestitvijo SDMS strežnika takole:

*V sistemsko mapo '''C:\WINNT\SYSTEM32''' prenesemo datoteke SDMS.EXE, SDMS.INI in SDMS.LIC.
*V urejevalniku besedila (Beležnica oz. Notepad) popravimo vsebino datoteke SDMS.INI tako, da je pot to baze podatkov pravilno navedena (tipično je to '''C:\SDMS\DATABASE''').
*Iz komandne vrstice zaženemo ukaz: '''SDMS.EXE -INSTALL'''.
*Če se je strežnik pravilno namestil, se nam izpiše sporočilo. Sicer pa nekaj ni v redu, in za vzrok si je treba ogledati datoteko SDMS.LOG, ki se je kreirala v sistemki mapi '''C:\WINNT\SYSTEM32'''. Če te datoteke tam ni, si je potrebno ogledati datoteko SDMS-????-??-??.LOG, ki se je kreirala v mapi, kjer je baza podatkov (tipično '''C:\SDMS\DATABASE'''). Po odpravi vzroka napake ponovimo prejšnji korak.
*Iz komandne vrstice zaženemo ukaz: '''NET START SDMS'''.
*Če se je strežnik pravilno zagnal, se nam v komandni vrsici to tudi izpiše.
*Sedaj je SDMS strežnik pravilno nameščen in aktiven kot sistemski servis. Ob vsakem zagonu računalnika se bo avtomatsko zagnal tudi SDMS strežnik.

== Namestitev odjemalcev ==
Na vsakem računalniku, kjer se bo uporabljal SDMS kot odjemalec, je priporočeno narediti trajno povezavo na mapo, kjer se nahaja SDMS odjemalec (z "Map network drive"). Primer: deljeno mapo \\SERVER\SDMS si namestimo kot disk G:.

Za lažji zagon programa si lahko ustvarite bližnjico na na namizju (primer: G:\CLIENT.EXE).

Nato poženite program '''CLIENT.EXE'''. Ko prvič vstopate v sistem, vnesite uporabniško ime '''admin''' in pustite geslo prazno, kasneje pa vaše ime in geslo pod katerim vstopate v sistem. Nato lahko (glede na licenčne pogoje) uporabljate aplikacije oz. razvojno orodje.

== Namestitev Web strežnika ==
Će imate nabavljeno licenco SDMS WebServer, je potrebno instalirati tudi tega kot servis.

C:\SDMS
\DATABASE
\CLIENT
\SERVER
\WEBSERVER

Izvoz v XLSX

2021-03-12T13:49:03Z

Janez Trtnik: /* xlsCV - cell value (posebne vrednosti celic) */

== Osnovni primer ==
<pre>
Sub PrimerXLS
Dim XLS As TXlsWriter
Dim titleStyle, headerStyle, cellStyle, footerStyle As TXlsStyle
Dim lefttopCell, rightbottomCell As TXlsCell
Dim J As Long

// inicializiramo writer in prvi list
XLS = CreateXlsWriter
XLS.AddSheet('List 1')

// spremenimo normal stil
XLS.StyleNormal.FontSize = 12
XLS.StyleNormal.FontName = 'Arial'

// definiramo ostale stile po potrebi
titleStyle = XLS.AddStyle('', XLS.StyleTitle)
titleStyle.FontBold = False
titleStyle.FontItalic = True
titleStyle.FontSize = 20
titleStyle.HorAlign = XlshaCenter
titleStyle.FontName = 'Arial'

headerStyle = XLS.AddStyle('', XLS.StyleHeader)
headerStyle.FontSize = 12
headerStyle.HorAlign = xlshaAuto

footerStyle = XLS.AddStyle('', XLS.StyleFooter)
footerStyle.FontSize = 12
footerStyle.HorAlign = XlshaRight
footerStyle.TextWrap = false

// zamrznemo stolpce in/ali vrstice
XLS.SetFixedColumns(1)
XLS.SetFixedRows(2)

// dodamo naslov
XLS.AddCell('Naslov', xlsnfText, titleStyle)
XLS.MergeCells('A1', 'E1') // združimo celice za naslov

// dodamo header vrstico
XLS.AddRow
XLS.AddCell('', xlsnfText, headerStyle)
lefttopCell = XLS.GetCurCell // nastavimo referenco na zgoraj levo celico tabele
XLS.AddCell('Stolpec A', xlsnfText, headerStyle)
XLS.AddCell('Stolpec B', xlsnfText, headerStyle)
XLS.AddCell('Stolpec C', xlsnfText, headerStyle)
XLS.AddCell('Seštevek', xlsnfText, headerStyle)

// dodamo podatke v tabelo
for J = 1 to 5
XLS.AddRow
XLS.AddCell('Vrstica ' + IntToStr(J), xlsnfText, headerStyle)
XLS.AddCell(IntToStr(Random(1000)), xlsnfLong, nil)
XLS.AddCell(IntToStr(Random(1000)), xlsnfLong, nil)
XLS.AddCell(IntToStr(Random(1000)), xlsnfLong, nil)
XLS.AddCell(xlscvAutoRowSum, xlsnfLong, footerStyle) // dodamo seštevek numeričnih celic v levo
next

// dodamo footer vrstico
XLS.AddRow
XLS.AddCell('Seštevek', xlsnfText, headerStyle)
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle) // dodamo seštevek numeričnih celic navzgor
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle)
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle)
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle)
rightbottomCell = XLS.GetCurCell // nastavimo referenco na spodnjo desno celico tabele

// ročno nastavimo širino prvega stolpca
XLS.SetColumnWidth('A', 20)

// narišemo robove okoli headerja, footerja in okoli celotne tabele
XLS.SetBorders(lefttopCell.Address, lefttopCell.RelativeAddress(4,0), xlsbtAll, xlsbsThick, xlsbsUnchanged, Black) // header
XLS.SetBorders(rightbottomCell.RelativeAddress(-4,0), rightbottomCell.Address, xlsbtAll, xlsbsThick, xlsbsUnchanged, Black) // footer
XLS.SetBorders(lefttopCell.Address, rightbottomCell.Address, xlsbtAll, xlsbsThick, xlsbsUnchanged, Black) // cela tabela
EndSub
</pre>

== Definicija konstant ==
=== xlsCV - cell value (posebne vrednosti celic) ===
xlscvTrue // bool TRUE
xlscvFalse // bool FALSE
xlscvAutoColSum // avtomatski seštevek vseh numeričnih celic nad to celico
xlscvAutoRowSum // avtomatski seštevek vseh numeričnih celic levo od te celice

=== xlsNF - number format ===
Lahko se uporabi poljuben format namesto konstante.
<pre>
// text
xlsnfText = '@';

// stevilke
xlsnfLong = '0';
xlsnfLongTS = '#,##0';

xlsnfFloat1 = '0.0';
xlsnfFloat2 = '0.00';
xlsnfFloat3 = '0.000';
xlsnfFloat4 = '0.0000';

xlsnfFloat1TS = '#,##0.0';
xlsnfFloat2TS = '#,##0.00';
xlsnfFloat3TS = '#,##0.000';
xlsnfFloat4TS = '#,##0.0000';

// valute
xlsnfEuroS = '#,##0.00 €';
xlsnfEuroL = '#,##0.00 "EUR"';

// datum/cas
xlsnfDateTime = 'dd.mm.yyyy hh:mm:ss';

xlsnfDateDMY = 'd.m.yyyy';
xlsnfDateDMYD = 'd.m.yyyy (ddd)';
xlsnfDateDDMMYY = 'dd.mm.yyyy';
xlsnfDateDDMMYYD = 'dd.mm.yyyy (dddd)';
xlsnfDateIso = 'yyyy-mm-dd';

xlsnfTimeHHMM = 'hh:mm';
xlsnfTimeHHMMSS = 'hh:mm:ss';

// bool
xlsnfBoolDa = '"da";"da";;';
xlsnfBoolDaNe = '"da";"da";"ne";"ne"';
</pre>

=== xlsBT - border type ===
xlsbtAll // vsi robovi
xlsbtVer // vsi vertikalni robovi
xlsbtHor // vsi horizontalni robovi
xlsbtLeft // samo levi robovi
xlsbtRight // samo desni robovi
xlsbtTop // samo zgornji robovi
xlsbtBottom // samo spodnji robovi

=== xlsBS - border style ===
xlsbsNone
xlsbsThin
xlsbsMedium
xlsbsThick
xlsbsUnchanged // rob se ne spremeni

=== xlsHA - hor align ===
xlshaAuto // poravnava se nastavi glede na vsebino: levo za tekst, desno za številke...
xlshaLeft
xlshaCenter
xlshaRight

=== xlsVA - ver align ===
xlsvaTop
xlsvaCenter
xlsvaBottom

== Prenos podatkov iz baze ==
<pre>
Sub TabelaXLS
Dim XLS As TXlsWriter, XLSF As TXlsField
Dim L as TLayer

// inicializiramo writer in prvi list
XLS = CreateXlsWriter
XLS.AddSheet('List 1')

// pripravimo definicijo stolpcev
XLS.Table.Clear // prvi klic je opcijski, počisti definicijo stolpcev
XLS.Table.StyleTitle.HorAlign = xlshaCenter
XLS.Table.StyleNormal.FontColor = Gray

XLSF = XLS.Table.AddCounter('Zap. št.') // zapisi bodo oštevilceni
XLSF.FooterValue = 'Skupaj' // v footerju bo fiksen tekst

XLS.Table.AddFieldByName('Naslov polja', 'polje1') // fiksno nastavimo ime stolpca

XLS.Table.AddFieldByName('', 'polje2') // ime stolpca je ime polja

XLSF = XLS.Table.AddFieldByName('Število', 'polje3') // numerično polje
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca

XLSF = XLS.Table.AddFormula('Vsota 3 in 4', 'IntToStr([polje3].AsNumber + [polje4].AsNumber)') // Basic formula
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca

XLSF = XLS.Table.AddValue('Vsota levo', xlscvAutoRowSum) // v stolpcu bo vsota številk v vrstici
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca

// pripravimo podatke
L = [Layer]
L.Filter.ExecuteSQL('[polje1] = 10')
L.Sort.Load('Default')
L.Sort.Execute

// zapišemo podatke po dani definiciji
XLS.Table.AddRecordList('Naslov', L.FilteredRecords) // naslov je opcijski

// nastavimo še robove celic
RoboviXLS(XLS)

// dodamo nov list
XLS.AddSheet('List 2')

// pripravimo nove podatke
L = [Layer]
L.Filter.ExecuteSQL('[polje1] = 20')
L.Sort.Load('Default')
L.Sort.Execute

// zapišemo podatke po dani definiciji
XLS.Table.AddRecordList('Naslov', L.FilteredRecords) // naslov je opcijski

// nastavimo še robove celic
RoboviXLS(XLS)

// shranimo v file in sprostimo writer
XLS.SaveToFile('c:\temp\test.xlsx')
XLS.Destroy
EndSub

Sub RoboviXLS(XLS As TXlsWriter)
XLS.SetBorders(XLS.Table.LeftTop.RelativeAddress(0, -1), XLS.Table.RightTop.RelativeAddress(0, -1), xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba naslova
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightBottom.Address, xlsbtHor, xlsbsUnchanged, xlsbsThin, Black) // horizontalne črte jedra tabele
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightTop.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba headerja
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightBottom.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba tabele
XLS.SetBorders(XLS.Table.LeftBottom.Address, XLS.Table.RightBottom.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba footerja
EndSub
</pre>

Izvoz v XLSX

2021-03-12T13:47:23Z

Janez Trtnik: /* Definicija konstant */

== Osnovni primer ==
<pre>
Sub PrimerXLS
Dim XLS As TXlsWriter
Dim titleStyle, headerStyle, cellStyle, footerStyle As TXlsStyle
Dim lefttopCell, rightbottomCell As TXlsCell
Dim J As Long

// inicializiramo writer in prvi list
XLS = CreateXlsWriter
XLS.AddSheet('List 1')

// spremenimo normal stil
XLS.StyleNormal.FontSize = 12
XLS.StyleNormal.FontName = 'Arial'

// definiramo ostale stile po potrebi
titleStyle = XLS.AddStyle('', XLS.StyleTitle)
titleStyle.FontBold = False
titleStyle.FontItalic = True
titleStyle.FontSize = 20
titleStyle.HorAlign = XlshaCenter
titleStyle.FontName = 'Arial'

headerStyle = XLS.AddStyle('', XLS.StyleHeader)
headerStyle.FontSize = 12
headerStyle.HorAlign = xlshaAuto

footerStyle = XLS.AddStyle('', XLS.StyleFooter)
footerStyle.FontSize = 12
footerStyle.HorAlign = XlshaRight
footerStyle.TextWrap = false

// zamrznemo stolpce in/ali vrstice
XLS.SetFixedColumns(1)
XLS.SetFixedRows(2)

// dodamo naslov
XLS.AddCell('Naslov', xlsnfText, titleStyle)
XLS.MergeCells('A1', 'E1') // združimo celice za naslov

// dodamo header vrstico
XLS.AddRow
XLS.AddCell('', xlsnfText, headerStyle)
lefttopCell = XLS.GetCurCell // nastavimo referenco na zgoraj levo celico tabele
XLS.AddCell('Stolpec A', xlsnfText, headerStyle)
XLS.AddCell('Stolpec B', xlsnfText, headerStyle)
XLS.AddCell('Stolpec C', xlsnfText, headerStyle)
XLS.AddCell('Seštevek', xlsnfText, headerStyle)

// dodamo podatke v tabelo
for J = 1 to 5
XLS.AddRow
XLS.AddCell('Vrstica ' + IntToStr(J), xlsnfText, headerStyle)
XLS.AddCell(IntToStr(Random(1000)), xlsnfLong, nil)
XLS.AddCell(IntToStr(Random(1000)), xlsnfLong, nil)
XLS.AddCell(IntToStr(Random(1000)), xlsnfLong, nil)
XLS.AddCell(xlscvAutoRowSum, xlsnfLong, footerStyle) // dodamo seštevek numeričnih celic v levo
next

// dodamo footer vrstico
XLS.AddRow
XLS.AddCell('Seštevek', xlsnfText, headerStyle)
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle) // dodamo seštevek numeričnih celic navzgor
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle)
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle)
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle)
rightbottomCell = XLS.GetCurCell // nastavimo referenco na spodnjo desno celico tabele

// ročno nastavimo širino prvega stolpca
XLS.SetColumnWidth('A', 20)

// narišemo robove okoli headerja, footerja in okoli celotne tabele
XLS.SetBorders(lefttopCell.Address, lefttopCell.RelativeAddress(4,0), xlsbtAll, xlsbsThick, xlsbsUnchanged, Black) // header
XLS.SetBorders(rightbottomCell.RelativeAddress(-4,0), rightbottomCell.Address, xlsbtAll, xlsbsThick, xlsbsUnchanged, Black) // footer
XLS.SetBorders(lefttopCell.Address, rightbottomCell.Address, xlsbtAll, xlsbsThick, xlsbsUnchanged, Black) // cela tabela
EndSub
</pre>

== Definicija konstant ==
=== xlsCV - cell value (posebne vrednosti celic) ===
xlscvTrue = ':TRUE';
xlscvFalse = ':FALSE';
xlscvAutoColSum = ':AUTOCOLSUM';
xlscvAutoRowSum = ':AUTOROWSUM';

=== xlsNF - number format ===
Lahko se uporabi poljuben format namesto konstante.
<pre>
// text
xlsnfText = '@';

// stevilke
xlsnfLong = '0';
xlsnfLongTS = '#,##0';

xlsnfFloat1 = '0.0';
xlsnfFloat2 = '0.00';
xlsnfFloat3 = '0.000';
xlsnfFloat4 = '0.0000';

xlsnfFloat1TS = '#,##0.0';
xlsnfFloat2TS = '#,##0.00';
xlsnfFloat3TS = '#,##0.000';
xlsnfFloat4TS = '#,##0.0000';

// valute
xlsnfEuroS = '#,##0.00 €';
xlsnfEuroL = '#,##0.00 "EUR"';

// datum/cas
xlsnfDateTime = 'dd.mm.yyyy hh:mm:ss';

xlsnfDateDMY = 'd.m.yyyy';
xlsnfDateDMYD = 'd.m.yyyy (ddd)';
xlsnfDateDDMMYY = 'dd.mm.yyyy';
xlsnfDateDDMMYYD = 'dd.mm.yyyy (dddd)';
xlsnfDateIso = 'yyyy-mm-dd';

xlsnfTimeHHMM = 'hh:mm';
xlsnfTimeHHMMSS = 'hh:mm:ss';

// bool
xlsnfBoolDa = '"da";"da";;';
xlsnfBoolDaNe = '"da";"da";"ne";"ne"';
</pre>

=== xlsBT - border type ===
xlsbtAll // vsi robovi
xlsbtVer // vsi vertikalni robovi
xlsbtHor // vsi horizontalni robovi
xlsbtLeft // samo levi robovi
xlsbtRight // samo desni robovi
xlsbtTop // samo zgornji robovi
xlsbtBottom // samo spodnji robovi

=== xlsBS - border style ===
xlsbsNone
xlsbsThin
xlsbsMedium
xlsbsThick
xlsbsUnchanged // rob se ne spremeni

=== xlsHA - hor align ===
xlshaAuto // poravnava se nastavi glede na vsebino: levo za tekst, desno za številke...
xlshaLeft
xlshaCenter
xlshaRight

=== xlsVA - ver align ===
xlsvaTop
xlsvaCenter
xlsvaBottom

== Prenos podatkov iz baze ==
<pre>
Sub TabelaXLS
Dim XLS As TXlsWriter, XLSF As TXlsField
Dim L as TLayer

// inicializiramo writer in prvi list
XLS = CreateXlsWriter
XLS.AddSheet('List 1')

// pripravimo definicijo stolpcev
XLS.Table.Clear // prvi klic je opcijski, počisti definicijo stolpcev
XLS.Table.StyleTitle.HorAlign = xlshaCenter
XLS.Table.StyleNormal.FontColor = Gray

XLSF = XLS.Table.AddCounter('Zap. št.') // zapisi bodo oštevilceni
XLSF.FooterValue = 'Skupaj' // v footerju bo fiksen tekst

XLS.Table.AddFieldByName('Naslov polja', 'polje1') // fiksno nastavimo ime stolpca

XLS.Table.AddFieldByName('', 'polje2') // ime stolpca je ime polja

XLSF = XLS.Table.AddFieldByName('Število', 'polje3') // numerično polje
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca

XLSF = XLS.Table.AddFormula('Vsota 3 in 4', 'IntToStr([polje3].AsNumber + [polje4].AsNumber)') // Basic formula
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca

XLSF = XLS.Table.AddValue('Vsota levo', xlscvAutoRowSum) // v stolpcu bo vsota številk v vrstici
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca

// pripravimo podatke
L = [Layer]
L.Filter.ExecuteSQL('[polje1] = 10')
L.Sort.Load('Default')
L.Sort.Execute

// zapišemo podatke po dani definiciji
XLS.Table.AddRecordList('Naslov', L.FilteredRecords) // naslov je opcijski

// nastavimo še robove celic
RoboviXLS(XLS)

// dodamo nov list
XLS.AddSheet('List 2')

// pripravimo nove podatke
L = [Layer]
L.Filter.ExecuteSQL('[polje1] = 20')
L.Sort.Load('Default')
L.Sort.Execute

// zapišemo podatke po dani definiciji
XLS.Table.AddRecordList('Naslov', L.FilteredRecords) // naslov je opcijski

// nastavimo še robove celic
RoboviXLS(XLS)

// shranimo v file in sprostimo writer
XLS.SaveToFile('c:\temp\test.xlsx')
XLS.Destroy
EndSub

Sub RoboviXLS(XLS As TXlsWriter)
XLS.SetBorders(XLS.Table.LeftTop.RelativeAddress(0, -1), XLS.Table.RightTop.RelativeAddress(0, -1), xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba naslova
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightBottom.Address, xlsbtHor, xlsbsUnchanged, xlsbsThin, Black) // horizontalne črte jedra tabele
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightTop.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba headerja
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightBottom.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba tabele
XLS.SetBorders(XLS.Table.LeftBottom.Address, XLS.Table.RightBottom.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba footerja
EndSub
</pre>

Izvoz v XLSX

2021-03-12T13:43:26Z

Janez Trtnik: /* Definicija konstant */

== Osnovni primer ==
<pre>
Sub PrimerXLS
Dim XLS As TXlsWriter
Dim titleStyle, headerStyle, cellStyle, footerStyle As TXlsStyle
Dim lefttopCell, rightbottomCell As TXlsCell
Dim J As Long

// inicializiramo writer in prvi list
XLS = CreateXlsWriter
XLS.AddSheet('List 1')

// spremenimo normal stil
XLS.StyleNormal.FontSize = 12
XLS.StyleNormal.FontName = 'Arial'

// definiramo ostale stile po potrebi
titleStyle = XLS.AddStyle('', XLS.StyleTitle)
titleStyle.FontBold = False
titleStyle.FontItalic = True
titleStyle.FontSize = 20
titleStyle.HorAlign = XlshaCenter
titleStyle.FontName = 'Arial'

headerStyle = XLS.AddStyle('', XLS.StyleHeader)
headerStyle.FontSize = 12
headerStyle.HorAlign = xlshaAuto

footerStyle = XLS.AddStyle('', XLS.StyleFooter)
footerStyle.FontSize = 12
footerStyle.HorAlign = XlshaRight
footerStyle.TextWrap = false

// zamrznemo stolpce in/ali vrstice
XLS.SetFixedColumns(1)
XLS.SetFixedRows(2)

// dodamo naslov
XLS.AddCell('Naslov', xlsnfText, titleStyle)
XLS.MergeCells('A1', 'E1') // združimo celice za naslov

// dodamo header vrstico
XLS.AddRow
XLS.AddCell('', xlsnfText, headerStyle)
lefttopCell = XLS.GetCurCell // nastavimo referenco na zgoraj levo celico tabele
XLS.AddCell('Stolpec A', xlsnfText, headerStyle)
XLS.AddCell('Stolpec B', xlsnfText, headerStyle)
XLS.AddCell('Stolpec C', xlsnfText, headerStyle)
XLS.AddCell('Seštevek', xlsnfText, headerStyle)

// dodamo podatke v tabelo
for J = 1 to 5
XLS.AddRow
XLS.AddCell('Vrstica ' + IntToStr(J), xlsnfText, headerStyle)
XLS.AddCell(IntToStr(Random(1000)), xlsnfLong, nil)
XLS.AddCell(IntToStr(Random(1000)), xlsnfLong, nil)
XLS.AddCell(IntToStr(Random(1000)), xlsnfLong, nil)
XLS.AddCell(xlscvAutoRowSum, xlsnfLong, footerStyle) // dodamo seštevek numeričnih celic v levo
next

// dodamo footer vrstico
XLS.AddRow
XLS.AddCell('Seštevek', xlsnfText, headerStyle)
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle) // dodamo seštevek numeričnih celic navzgor
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle)
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle)
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle)
rightbottomCell = XLS.GetCurCell // nastavimo referenco na spodnjo desno celico tabele

// ročno nastavimo širino prvega stolpca
XLS.SetColumnWidth('A', 20)

// narišemo robove okoli headerja, footerja in okoli celotne tabele
XLS.SetBorders(lefttopCell.Address, lefttopCell.RelativeAddress(4,0), xlsbtAll, xlsbsThick, xlsbsUnchanged, Black) // header
XLS.SetBorders(rightbottomCell.RelativeAddress(-4,0), rightbottomCell.Address, xlsbtAll, xlsbsThick, xlsbsUnchanged, Black) // footer
XLS.SetBorders(lefttopCell.Address, rightbottomCell.Address, xlsbtAll, xlsbsThick, xlsbsUnchanged, Black) // cela tabela
EndSub
</pre>

== Definicija konstant ==
=== CV - cell value (posebne vrednosti celic) ===
xlscvTrue = ':TRUE';
xlscvFalse = ':FALSE';
xlscvAutoColSum = ':AUTOCOLSUM';
xlscvAutoRowSum = ':AUTOROWSUM';

=== NF - number format ===
Lahko se uporabi poljuben format namesto konstante.
<pre>
// text
xlsnfText = '@';

// stevilke
xlsnfLong = '0';
xlsnfLongTS = '#,##0';

xlsnfFloat1 = '0.0';
xlsnfFloat2 = '0.00';
xlsnfFloat3 = '0.000';
xlsnfFloat4 = '0.0000';

xlsnfFloat1TS = '#,##0.0';
xlsnfFloat2TS = '#,##0.00';
xlsnfFloat3TS = '#,##0.000';
xlsnfFloat4TS = '#,##0.0000';

// valute
xlsnfEuroS = '#,##0.00 €';
xlsnfEuroL = '#,##0.00 "EUR"';

// datum/cas
xlsnfDateTime = 'dd.mm.yyyy hh:mm:ss';

xlsnfDateDMY = 'd.m.yyyy';
xlsnfDateDMYD = 'd.m.yyyy (ddd)';
xlsnfDateDDMMYY = 'dd.mm.yyyy';
xlsnfDateDDMMYYD = 'dd.mm.yyyy (dddd)';
xlsnfDateIso = 'yyyy-mm-dd';

xlsnfTimeHHMM = 'hh:mm';
xlsnfTimeHHMMSS = 'hh:mm:ss';

// bool
xlsnfBoolDa = '"da";"da";;';
xlsnfBoolDaNe = '"da";"da";"ne";"ne"';
</pre>

=== BT - border type ===
xlsbtAll
xlsbtVer
xlsbtHor
xlsbtLeft
xlsbtRight
xlsbtTop
xlsbtBottom

=== BS - border style ===
xlsbsNone
xlsbsThin
xlsbsMedium
xlsbsThick
xlsbsUnchanged

=== HA - hor align ===
xlshaAuto
xlshaLeft
xlshaCenter
xlshaRight

=== VA - ver align ===
xlsvaTop
xlsvaCenter
xlsvaBottom

== Prenos podatkov iz baze ==
<pre>
Sub TabelaXLS
Dim XLS As TXlsWriter, XLSF As TXlsField
Dim L as TLayer

// inicializiramo writer in prvi list
XLS = CreateXlsWriter
XLS.AddSheet('List 1')

// pripravimo definicijo stolpcev
XLS.Table.Clear // prvi klic je opcijski, počisti definicijo stolpcev
XLS.Table.StyleTitle.HorAlign = xlshaCenter
XLS.Table.StyleNormal.FontColor = Gray

XLSF = XLS.Table.AddCounter('Zap. št.') // zapisi bodo oštevilceni
XLSF.FooterValue = 'Skupaj' // v footerju bo fiksen tekst

XLS.Table.AddFieldByName('Naslov polja', 'polje1') // fiksno nastavimo ime stolpca

XLS.Table.AddFieldByName('', 'polje2') // ime stolpca je ime polja

XLSF = XLS.Table.AddFieldByName('Število', 'polje3') // numerično polje
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca

XLSF = XLS.Table.AddFormula('Vsota 3 in 4', 'IntToStr([polje3].AsNumber + [polje4].AsNumber)') // Basic formula
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca

XLSF = XLS.Table.AddValue('Vsota levo', xlscvAutoRowSum) // v stolpcu bo vsota številk v vrstici
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca

// pripravimo podatke
L = [Layer]
L.Filter.ExecuteSQL('[polje1] = 10')
L.Sort.Load('Default')
L.Sort.Execute

// zapišemo podatke po dani definiciji
XLS.Table.AddRecordList('Naslov', L.FilteredRecords) // naslov je opcijski

// nastavimo še robove celic
RoboviXLS(XLS)

// dodamo nov list
XLS.AddSheet('List 2')

// pripravimo nove podatke
L = [Layer]
L.Filter.ExecuteSQL('[polje1] = 20')
L.Sort.Load('Default')
L.Sort.Execute

// zapišemo podatke po dani definiciji
XLS.Table.AddRecordList('Naslov', L.FilteredRecords) // naslov je opcijski

// nastavimo še robove celic
RoboviXLS(XLS)

// shranimo v file in sprostimo writer
XLS.SaveToFile('c:\temp\test.xlsx')
XLS.Destroy
EndSub

Sub RoboviXLS(XLS As TXlsWriter)
XLS.SetBorders(XLS.Table.LeftTop.RelativeAddress(0, -1), XLS.Table.RightTop.RelativeAddress(0, -1), xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba naslova
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightBottom.Address, xlsbtHor, xlsbsUnchanged, xlsbsThin, Black) // horizontalne črte jedra tabele
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightTop.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba headerja
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightBottom.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba tabele
XLS.SetBorders(XLS.Table.LeftBottom.Address, XLS.Table.RightBottom.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba footerja
EndSub
</pre>

Izvoz v XLSX

2021-03-12T12:36:01Z

Janez Trtnik: /* NF - number format */

== Osnovni primer ==
<pre>
Sub PrimerXLS
Dim XLS As TXlsWriter
Dim titleStyle, headerStyle, cellStyle, footerStyle As TXlsStyle
Dim lefttopCell, rightbottomCell As TXlsCell
Dim J As Long

// inicializiramo writer in prvi list
XLS = CreateXlsWriter
XLS.AddSheet('List 1')

// spremenimo normal stil
XLS.StyleNormal.FontSize = 12
XLS.StyleNormal.FontName = 'Arial'

// definiramo ostale stile po potrebi
titleStyle = XLS.AddStyle('', XLS.StyleTitle)
titleStyle.FontBold = False
titleStyle.FontItalic = True
titleStyle.FontSize = 20
titleStyle.HorAlign = XlshaCenter
titleStyle.FontName = 'Arial'

headerStyle = XLS.AddStyle('', XLS.StyleHeader)
headerStyle.FontSize = 12
headerStyle.HorAlign = xlshaAuto

footerStyle = XLS.AddStyle('', XLS.StyleFooter)
footerStyle.FontSize = 12
footerStyle.HorAlign = XlshaRight
footerStyle.TextWrap = false

// zamrznemo stolpce in/ali vrstice
XLS.SetFixedColumns(1)
XLS.SetFixedRows(2)

// dodamo naslov
XLS.AddCell('Naslov', xlsnfText, titleStyle)
XLS.MergeCells('A1', 'E1') // združimo celice za naslov

// dodamo header vrstico
XLS.AddRow
XLS.AddCell('', xlsnfText, headerStyle)
lefttopCell = XLS.GetCurCell // nastavimo referenco na zgoraj levo celico tabele
XLS.AddCell('Stolpec A', xlsnfText, headerStyle)
XLS.AddCell('Stolpec B', xlsnfText, headerStyle)
XLS.AddCell('Stolpec C', xlsnfText, headerStyle)
XLS.AddCell('Seštevek', xlsnfText, headerStyle)

// dodamo podatke v tabelo
for J = 1 to 5
XLS.AddRow
XLS.AddCell('Vrstica ' + IntToStr(J), xlsnfText, headerStyle)
XLS.AddCell(IntToStr(Random(1000)), xlsnfLong, nil)
XLS.AddCell(IntToStr(Random(1000)), xlsnfLong, nil)
XLS.AddCell(IntToStr(Random(1000)), xlsnfLong, nil)
XLS.AddCell(xlscvAutoRowSum, xlsnfLong, footerStyle) // dodamo seštevek numeričnih celic v levo
next

// dodamo footer vrstico
XLS.AddRow
XLS.AddCell('Seštevek', xlsnfText, headerStyle)
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle) // dodamo seštevek numeričnih celic navzgor
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle)
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle)
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle)
rightbottomCell = XLS.GetCurCell // nastavimo referenco na spodnjo desno celico tabele

// ročno nastavimo širino prvega stolpca
XLS.SetColumnWidth('A', 20)

// narišemo robove okoli headerja, footerja in okoli celotne tabele
XLS.SetBorders(lefttopCell.Address, lefttopCell.RelativeAddress(4,0), xlsbtAll, xlsbsThick, xlsbsUnchanged, Black) // header
XLS.SetBorders(rightbottomCell.RelativeAddress(-4,0), rightbottomCell.Address, xlsbtAll, xlsbsThick, xlsbsUnchanged, Black) // footer
XLS.SetBorders(lefttopCell.Address, rightbottomCell.Address, xlsbtAll, xlsbsThick, xlsbsUnchanged, Black) // cela tabela
EndSub
</pre>

== Definicija konstant ==
=== CV - cell value (posebne vrednosti celic) ===
xlscvTrue = ':TRUE';
xlscvFalse = ':FALSE';
xlscvAutoColSum = ':AUTOCOLSUM';
xlscvAutoRowSum = ':AUTOROWSUM';

=== NF - number format ===
<pre>
// text
xlsnfText = '@';

// stevilke
xlsnfLong = '0';
xlsnfLongTS = '#,##0';

xlsnfFloat1 = '0.0';
xlsnfFloat2 = '0.00';
xlsnfFloat3 = '0.000';
xlsnfFloat4 = '0.0000';

xlsnfFloat1TS = '#,##0.0';
xlsnfFloat2TS = '#,##0.00';
xlsnfFloat3TS = '#,##0.000';
xlsnfFloat4TS = '#,##0.0000';

// valute
xlsnfEuroS = '#,##0.00 €';
xlsnfEuroL = '#,##0.00 "EUR"';

// datum/cas
xlsnfDateTime = 'dd.mm.yyyy hh:mm:ss';

xlsnfDateDMY = 'd.m.yyyy';
xlsnfDateDMYD = 'd.m.yyyy (ddd)';
xlsnfDateDDMMYY = 'dd.mm.yyyy';
xlsnfDateDDMMYYD = 'dd.mm.yyyy (dddd)';
xlsnfDateIso = 'yyyy-mm-dd';

xlsnfTimeHHMM = 'hh:mm';
xlsnfTimeHHMMSS = 'hh:mm:ss';

// bool
xlsnfBoolDa = '"da";"da";;';
xlsnfBoolDaNe = '"da";"da";"ne";"ne"';
</pre>

=== BT - border type ===
xlsbtAll
xlsbtVer
xlsbtHor
xlsbtLeft
xlsbtRight
xlsbtTop
xlsbtBottom

=== BS - border style ===
xlsbsNone
xlsbsThin
xlsbsMedium
xlsbsThick
xlsbsUnchanged

=== HA - hor align ===
xlshaAuto
xlshaLeft
xlshaCenter
xlshaRight

=== VA - ver align ===
xlsvaTop
xlsvaCenter
xlsvaBottom

== Prenos podatkov iz baze ==
<pre>
Sub TabelaXLS
Dim XLS As TXlsWriter, XLSF As TXlsField
Dim L as TLayer

// inicializiramo writer in prvi list
XLS = CreateXlsWriter
XLS.AddSheet('List 1')

// pripravimo definicijo stolpcev
XLS.Table.Clear // prvi klic je opcijski, počisti definicijo stolpcev
XLS.Table.StyleTitle.HorAlign = xlshaCenter
XLS.Table.StyleNormal.FontColor = Gray

XLSF = XLS.Table.AddCounter('Zap. št.') // zapisi bodo oštevilceni
XLSF.FooterValue = 'Skupaj' // v footerju bo fiksen tekst

XLS.Table.AddFieldByName('Naslov polja', 'polje1') // fiksno nastavimo ime stolpca

XLS.Table.AddFieldByName('', 'polje2') // ime stolpca je ime polja

XLSF = XLS.Table.AddFieldByName('Število', 'polje3') // numerično polje
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca

XLSF = XLS.Table.AddFormula('Vsota 3 in 4', 'IntToStr([polje3].AsNumber + [polje4].AsNumber)') // Basic formula
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca

XLSF = XLS.Table.AddValue('Vsota levo', xlscvAutoRowSum) // v stolpcu bo vsota številk v vrstici
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca

// pripravimo podatke
L = [Layer]
L.Filter.ExecuteSQL('[polje1] = 10')
L.Sort.Load('Default')
L.Sort.Execute

// zapišemo podatke po dani definiciji
XLS.Table.AddRecordList('Naslov', L.FilteredRecords) // naslov je opcijski

// nastavimo še robove celic
RoboviXLS(XLS)

// dodamo nov list
XLS.AddSheet('List 2')

// pripravimo nove podatke
L = [Layer]
L.Filter.ExecuteSQL('[polje1] = 20')
L.Sort.Load('Default')
L.Sort.Execute

// zapišemo podatke po dani definiciji
XLS.Table.AddRecordList('Naslov', L.FilteredRecords) // naslov je opcijski

// nastavimo še robove celic
RoboviXLS(XLS)

// shranimo v file in sprostimo writer
XLS.SaveToFile('c:\temp\test.xlsx')
XLS.Destroy
EndSub

Sub RoboviXLS(XLS As TXlsWriter)
XLS.SetBorders(XLS.Table.LeftTop.RelativeAddress(0, -1), XLS.Table.RightTop.RelativeAddress(0, -1), xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba naslova
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightBottom.Address, xlsbtHor, xlsbsUnchanged, xlsbsThin, Black) // horizontalne črte jedra tabele
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightTop.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba headerja
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightBottom.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba tabele
XLS.SetBorders(XLS.Table.LeftBottom.Address, XLS.Table.RightBottom.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba footerja
EndSub
</pre>

Izvoz v XLSX

2021-03-12T12:33:19Z

Janez Trtnik: /* Definicija konstant */

== Osnovni primer ==
<pre>
Sub PrimerXLS
Dim XLS As TXlsWriter
Dim titleStyle, headerStyle, cellStyle, footerStyle As TXlsStyle
Dim lefttopCell, rightbottomCell As TXlsCell
Dim J As Long

// inicializiramo writer in prvi list
XLS = CreateXlsWriter
XLS.AddSheet('List 1')

// spremenimo normal stil
XLS.StyleNormal.FontSize = 12
XLS.StyleNormal.FontName = 'Arial'

// definiramo ostale stile po potrebi
titleStyle = XLS.AddStyle('', XLS.StyleTitle)
titleStyle.FontBold = False
titleStyle.FontItalic = True
titleStyle.FontSize = 20
titleStyle.HorAlign = XlshaCenter
titleStyle.FontName = 'Arial'

headerStyle = XLS.AddStyle('', XLS.StyleHeader)
headerStyle.FontSize = 12
headerStyle.HorAlign = xlshaAuto

footerStyle = XLS.AddStyle('', XLS.StyleFooter)
footerStyle.FontSize = 12
footerStyle.HorAlign = XlshaRight
footerStyle.TextWrap = false

// zamrznemo stolpce in/ali vrstice
XLS.SetFixedColumns(1)
XLS.SetFixedRows(2)

// dodamo naslov
XLS.AddCell('Naslov', xlsnfText, titleStyle)
XLS.MergeCells('A1', 'E1') // združimo celice za naslov

// dodamo header vrstico
XLS.AddRow
XLS.AddCell('', xlsnfText, headerStyle)
lefttopCell = XLS.GetCurCell // nastavimo referenco na zgoraj levo celico tabele
XLS.AddCell('Stolpec A', xlsnfText, headerStyle)
XLS.AddCell('Stolpec B', xlsnfText, headerStyle)
XLS.AddCell('Stolpec C', xlsnfText, headerStyle)
XLS.AddCell('Seštevek', xlsnfText, headerStyle)

// dodamo podatke v tabelo
for J = 1 to 5
XLS.AddRow
XLS.AddCell('Vrstica ' + IntToStr(J), xlsnfText, headerStyle)
XLS.AddCell(IntToStr(Random(1000)), xlsnfLong, nil)
XLS.AddCell(IntToStr(Random(1000)), xlsnfLong, nil)
XLS.AddCell(IntToStr(Random(1000)), xlsnfLong, nil)
XLS.AddCell(xlscvAutoRowSum, xlsnfLong, footerStyle) // dodamo seštevek numeričnih celic v levo
next

// dodamo footer vrstico
XLS.AddRow
XLS.AddCell('Seštevek', xlsnfText, headerStyle)
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle) // dodamo seštevek numeričnih celic navzgor
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle)
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle)
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle)
rightbottomCell = XLS.GetCurCell // nastavimo referenco na spodnjo desno celico tabele

// ročno nastavimo širino prvega stolpca
XLS.SetColumnWidth('A', 20)

// narišemo robove okoli headerja, footerja in okoli celotne tabele
XLS.SetBorders(lefttopCell.Address, lefttopCell.RelativeAddress(4,0), xlsbtAll, xlsbsThick, xlsbsUnchanged, Black) // header
XLS.SetBorders(rightbottomCell.RelativeAddress(-4,0), rightbottomCell.Address, xlsbtAll, xlsbsThick, xlsbsUnchanged, Black) // footer
XLS.SetBorders(lefttopCell.Address, rightbottomCell.Address, xlsbtAll, xlsbsThick, xlsbsUnchanged, Black) // cela tabela
EndSub
</pre>

== Definicija konstant ==
=== CV - cell value (posebne vrednosti celic) ===
xlscvTrue = ':TRUE';
xlscvFalse = ':FALSE';
xlscvAutoColSum = ':AUTOCOLSUM';
xlscvAutoRowSum = ':AUTOROWSUM';

=== NF - number format ===
<pre>
// text
xlsnfText = '@';

// stevilke
xlsnfLong = '0';
xlsnfLongTS = '#,##0';

xlsnfFloat1 = '0.0';
xlsnfFloat2 = '0.00';
xlsnfFloat3 = '0.000';
xlsnfFloat4 = '0.0000';

xlsnfFloat1TS = '#,##0.0';
xlsnfFloat2TS = '#,##0.00';
xlsnfFloat3TS = '#,##0.000';
xlsnfFloat4TS = '#,##0.0000';

// currency
xlsnfEuroS = '#,##0.00 €';
xlsnfEuroL = '#,##0.00 "EUR"';

// datum/cas
xlsnfDateTime = 'dd.mm.yyyy hh:mm:ss';

xlsnfDateDMY = 'd.m.yyyy';
xlsnfDateDMYD = 'd.m.yyyy (ddd)';
xlsnfDateDDMMYY = 'dd.mm.yyyy';
xlsnfDateDDMMYYD = 'dd.mm.yyyy (dddd)';
xlsnfDateIso = 'yyyy-mm-dd';

xlsnfTimeHHMM = 'hh:mm';
xlsnfTimeHHMMSS = 'hh:mm:ss';

// bool
xlsnfBoolDa = '"da";"da";;';
xlsnfBoolDaNe = '"da";"da";"ne";"ne"';
</pre>

=== BT - border type ===
xlsbtAll
xlsbtVer
xlsbtHor
xlsbtLeft
xlsbtRight
xlsbtTop
xlsbtBottom

=== BS - border style ===
xlsbsNone
xlsbsThin
xlsbsMedium
xlsbsThick
xlsbsUnchanged

=== HA - hor align ===
xlshaAuto
xlshaLeft
xlshaCenter
xlshaRight

=== VA - ver align ===
xlsvaTop
xlsvaCenter
xlsvaBottom

== Prenos podatkov iz baze ==
<pre>
Sub TabelaXLS
Dim XLS As TXlsWriter, XLSF As TXlsField
Dim L as TLayer

// inicializiramo writer in prvi list
XLS = CreateXlsWriter
XLS.AddSheet('List 1')

// pripravimo definicijo stolpcev
XLS.Table.Clear // prvi klic je opcijski, počisti definicijo stolpcev
XLS.Table.StyleTitle.HorAlign = xlshaCenter
XLS.Table.StyleNormal.FontColor = Gray

XLSF = XLS.Table.AddCounter('Zap. št.') // zapisi bodo oštevilceni
XLSF.FooterValue = 'Skupaj' // v footerju bo fiksen tekst

XLS.Table.AddFieldByName('Naslov polja', 'polje1') // fiksno nastavimo ime stolpca

XLS.Table.AddFieldByName('', 'polje2') // ime stolpca je ime polja

XLSF = XLS.Table.AddFieldByName('Število', 'polje3') // numerično polje
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca

XLSF = XLS.Table.AddFormula('Vsota 3 in 4', 'IntToStr([polje3].AsNumber + [polje4].AsNumber)') // Basic formula
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca

XLSF = XLS.Table.AddValue('Vsota levo', xlscvAutoRowSum) // v stolpcu bo vsota številk v vrstici
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca

// pripravimo podatke
L = [Layer]
L.Filter.ExecuteSQL('[polje1] = 10')
L.Sort.Load('Default')
L.Sort.Execute

// zapišemo podatke po dani definiciji
XLS.Table.AddRecordList('Naslov', L.FilteredRecords) // naslov je opcijski

// nastavimo še robove celic
RoboviXLS(XLS)

// dodamo nov list
XLS.AddSheet('List 2')

// pripravimo nove podatke
L = [Layer]
L.Filter.ExecuteSQL('[polje1] = 20')
L.Sort.Load('Default')
L.Sort.Execute

// zapišemo podatke po dani definiciji
XLS.Table.AddRecordList('Naslov', L.FilteredRecords) // naslov je opcijski

// nastavimo še robove celic
RoboviXLS(XLS)

// shranimo v file in sprostimo writer
XLS.SaveToFile('c:\temp\test.xlsx')
XLS.Destroy
EndSub

Sub RoboviXLS(XLS As TXlsWriter)
XLS.SetBorders(XLS.Table.LeftTop.RelativeAddress(0, -1), XLS.Table.RightTop.RelativeAddress(0, -1), xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba naslova
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightBottom.Address, xlsbtHor, xlsbsUnchanged, xlsbsThin, Black) // horizontalne črte jedra tabele
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightTop.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba headerja
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightBottom.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba tabele
XLS.SetBorders(XLS.Table.LeftBottom.Address, XLS.Table.RightBottom.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba footerja
EndSub
</pre>

Izvoz v XLSX

2021-03-12T12:29:18Z

Janez Trtnik:

== Osnovni primer ==
<pre>
Sub PrimerXLS
Dim XLS As TXlsWriter
Dim titleStyle, headerStyle, cellStyle, footerStyle As TXlsStyle
Dim lefttopCell, rightbottomCell As TXlsCell
Dim J As Long

// inicializiramo writer in prvi list
XLS = CreateXlsWriter
XLS.AddSheet('List 1')

// spremenimo normal stil
XLS.StyleNormal.FontSize = 12
XLS.StyleNormal.FontName = 'Arial'

// definiramo ostale stile po potrebi
titleStyle = XLS.AddStyle('', XLS.StyleTitle)
titleStyle.FontBold = False
titleStyle.FontItalic = True
titleStyle.FontSize = 20
titleStyle.HorAlign = XlshaCenter
titleStyle.FontName = 'Arial'

headerStyle = XLS.AddStyle('', XLS.StyleHeader)
headerStyle.FontSize = 12
headerStyle.HorAlign = xlshaAuto

footerStyle = XLS.AddStyle('', XLS.StyleFooter)
footerStyle.FontSize = 12
footerStyle.HorAlign = XlshaRight
footerStyle.TextWrap = false

// zamrznemo stolpce in/ali vrstice
XLS.SetFixedColumns(1)
XLS.SetFixedRows(2)

// dodamo naslov
XLS.AddCell('Naslov', xlsnfText, titleStyle)
XLS.MergeCells('A1', 'E1') // združimo celice za naslov

// dodamo header vrstico
XLS.AddRow
XLS.AddCell('', xlsnfText, headerStyle)
lefttopCell = XLS.GetCurCell // nastavimo referenco na zgoraj levo celico tabele
XLS.AddCell('Stolpec A', xlsnfText, headerStyle)
XLS.AddCell('Stolpec B', xlsnfText, headerStyle)
XLS.AddCell('Stolpec C', xlsnfText, headerStyle)
XLS.AddCell('Seštevek', xlsnfText, headerStyle)

// dodamo podatke v tabelo
for J = 1 to 5
XLS.AddRow
XLS.AddCell('Vrstica ' + IntToStr(J), xlsnfText, headerStyle)
XLS.AddCell(IntToStr(Random(1000)), xlsnfLong, nil)
XLS.AddCell(IntToStr(Random(1000)), xlsnfLong, nil)
XLS.AddCell(IntToStr(Random(1000)), xlsnfLong, nil)
XLS.AddCell(xlscvAutoRowSum, xlsnfLong, footerStyle) // dodamo seštevek numeričnih celic v levo
next

// dodamo footer vrstico
XLS.AddRow
XLS.AddCell('Seštevek', xlsnfText, headerStyle)
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle) // dodamo seštevek numeričnih celic navzgor
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle)
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle)
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle)
rightbottomCell = XLS.GetCurCell // nastavimo referenco na spodnjo desno celico tabele

// ročno nastavimo širino prvega stolpca
XLS.SetColumnWidth('A', 20)

// narišemo robove okoli headerja, footerja in okoli celotne tabele
XLS.SetBorders(lefttopCell.Address, lefttopCell.RelativeAddress(4,0), xlsbtAll, xlsbsThick, xlsbsUnchanged, Black) // header
XLS.SetBorders(rightbottomCell.RelativeAddress(-4,0), rightbottomCell.Address, xlsbtAll, xlsbsThick, xlsbsUnchanged, Black) // footer
XLS.SetBorders(lefttopCell.Address, rightbottomCell.Address, xlsbtAll, xlsbsThick, xlsbsUnchanged, Black) // cela tabela
EndSub
</pre>

== Definicija konstant ==
=== CV - cell value (posebne vrednosti celic) ===
xlscvTrue = ':TRUE';
xlscvFalse = ':FALSE';
xlscvAutoColSum = ':AUTOCOLSUM';
xlscvAutoRowSum = ':AUTOROWSUM';

=== NF - number format ===
<pre>
// text
xlsnfText = '@';

// stevilke
xlsnfLong = '0';
xlsnfLongTS = '#,##0';

xlsnfFloat1 = '0.0';
xlsnfFloat2 = '0.00';
xlsnfFloat3 = '0.000';
xlsnfFloat4 = '0.0000';

xlsnfFloat1TS = '#,##0.0';
xlsnfFloat2TS = '#,##0.00';
xlsnfFloat3TS = '#,##0.000';
xlsnfFloat4TS = '#,##0.0000';

// currency
xlsnfEuroS = '#,##0.00 €';
xlsnfEuroL = '#,##0.00 "EUR"';

// datum/cas
xlsnfDateTime = 'dd.mm.yyyy hh:mm:ss';

xlsnfDateDMY = 'd.m.yyyy';
xlsnfDateDMYD = 'd.m.yyyy (ddd)';
xlsnfDateDDMMYY = 'dd.mm.yyyy';
xlsnfDateDDMMYYD = 'dd.mm.yyyy (dddd)';
xlsnfDateIso = 'yyyy-mm-dd';

xlsnfTimeHHMM = 'hh:mm';
xlsnfTimeHHMMSS = 'hh:mm:ss';

// bool
xlsnfBoolDa = '"da";"da";;';
xlsnfBoolDaNe = '"da";"da";"ne";"ne"';
</pre>

== Prenos podatkov iz baze ==
<pre>
Sub TabelaXLS
Dim XLS As TXlsWriter, XLSF As TXlsField
Dim L as TLayer

// inicializiramo writer in prvi list
XLS = CreateXlsWriter
XLS.AddSheet('List 1')

// pripravimo definicijo stolpcev
XLS.Table.Clear // prvi klic je opcijski, počisti definicijo stolpcev
XLS.Table.StyleTitle.HorAlign = xlshaCenter
XLS.Table.StyleNormal.FontColor = Gray

XLSF = XLS.Table.AddCounter('Zap. št.') // zapisi bodo oštevilceni
XLSF.FooterValue = 'Skupaj' // v footerju bo fiksen tekst

XLS.Table.AddFieldByName('Naslov polja', 'polje1') // fiksno nastavimo ime stolpca

XLS.Table.AddFieldByName('', 'polje2') // ime stolpca je ime polja

XLSF = XLS.Table.AddFieldByName('Število', 'polje3') // numerično polje
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca

XLSF = XLS.Table.AddFormula('Vsota 3 in 4', 'IntToStr([polje3].AsNumber + [polje4].AsNumber)') // Basic formula
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca

XLSF = XLS.Table.AddValue('Vsota levo', xlscvAutoRowSum) // v stolpcu bo vsota številk v vrstici
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca

// pripravimo podatke
L = [Layer]
L.Filter.ExecuteSQL('[polje1] = 10')
L.Sort.Load('Default')
L.Sort.Execute

// zapišemo podatke po dani definiciji
XLS.Table.AddRecordList('Naslov', L.FilteredRecords) // naslov je opcijski

// nastavimo še robove celic
RoboviXLS(XLS)

// dodamo nov list
XLS.AddSheet('List 2')

// pripravimo nove podatke
L = [Layer]
L.Filter.ExecuteSQL('[polje1] = 20')
L.Sort.Load('Default')
L.Sort.Execute

// zapišemo podatke po dani definiciji
XLS.Table.AddRecordList('Naslov', L.FilteredRecords) // naslov je opcijski

// nastavimo še robove celic
RoboviXLS(XLS)

// shranimo v file in sprostimo writer
XLS.SaveToFile('c:\temp\test.xlsx')
XLS.Destroy
EndSub

Sub RoboviXLS(XLS As TXlsWriter)
XLS.SetBorders(XLS.Table.LeftTop.RelativeAddress(0, -1), XLS.Table.RightTop.RelativeAddress(0, -1), xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba naslova
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightBottom.Address, xlsbtHor, xlsbsUnchanged, xlsbsThin, Black) // horizontalne črte jedra tabele
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightTop.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba headerja
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightBottom.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba tabele
XLS.SetBorders(XLS.Table.LeftBottom.Address, XLS.Table.RightBottom.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba footerja
EndSub
</pre>

Izvoz v XLSX

2021-03-11T16:07:14Z

Janez Trtnik: /* Osnovni primer */

== Osnovni primer ==
<pre>
Sub PrimerXLS
Dim XLS As TXlsWriter
Dim titleStyle, headerStyle, cellStyle, footerStyle As TXlsStyle
Dim lefttopCell, rightbottomCell As TXlsCell
Dim J As Long

// inicializiramo writer in prvi list
XLS = CreateXlsWriter
XLS.AddSheet('List 1')

// spremenimo normal stil
XLS.StyleNormal.FontSize = 12
XLS.StyleNormal.FontName = 'Arial'

// definiramo ostale stile po potrebi
titleStyle = XLS.AddStyle('', XLS.StyleTitle)
titleStyle.FontBold = False
titleStyle.FontItalic = True
titleStyle.FontSize = 20
titleStyle.HorAlign = XlshaCenter
titleStyle.FontName = 'Arial'

headerStyle = XLS.AddStyle('', XLS.StyleHeader)
headerStyle.FontSize = 12
headerStyle.HorAlign = xlshaAuto

footerStyle = XLS.AddStyle('', XLS.StyleFooter)
footerStyle.FontSize = 12
footerStyle.HorAlign = XlshaRight
footerStyle.TextWrap = false

// zamrznemo stolpce in/ali vrstice
XLS.SetFixedColumns(1)
XLS.SetFixedRows(2)

// dodamo naslov
XLS.AddCell('Naslov', xlsnfText, titleStyle)
XLS.MergeCells('A1', 'E1') // združimo celice za naslov

// dodamo header vrstico
XLS.AddRow
XLS.AddCell('', xlsnfText, headerStyle)
lefttopCell = XLS.GetCurCell // nastavimo referenco na zgoraj levo celico tabele
XLS.AddCell('Stolpec A', xlsnfText, headerStyle)
XLS.AddCell('Stolpec B', xlsnfText, headerStyle)
XLS.AddCell('Stolpec C', xlsnfText, headerStyle)
XLS.AddCell('Seštevek', xlsnfText, headerStyle)

// dodamo podatke v tabelo
for J = 1 to 5
XLS.AddRow
XLS.AddCell('Vrstica ' + IntToStr(J), xlsnfText, headerStyle)
XLS.AddCell(IntToStr(Random(1000)), xlsnfLong, nil)
XLS.AddCell(IntToStr(Random(1000)), xlsnfLong, nil)
XLS.AddCell(IntToStr(Random(1000)), xlsnfLong, nil)
XLS.AddCell(xlscvAutoRowSum, xlsnfLong, footerStyle) // dodamo seštevek numeričnih celic v levo
next

// dodamo footer vrstico
XLS.AddRow
XLS.AddCell('Seštevek', xlsnfText, headerStyle)
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle) // dodamo seštevek numeričnih celic navzgor
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle)
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle)
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle)
rightbottomCell = XLS.GetCurCell // nastavimo referenco na spodnjo desno celico tabele

// ročno nastavimo širino prvega stolpca
XLS.SetColumnWidth('A', 20)

// narišemo robove okoli headerja, footerja in okoli celotne tabele
XLS.SetBorders(lefttopCell.Address, lefttopCell.RelativeAddress(4,0), xlsbtAll, xlsbsThick, xlsbsUnchanged, Black) // header
XLS.SetBorders(rightbottomCell.RelativeAddress(-4,0), rightbottomCell.Address, xlsbtAll, xlsbsThick, xlsbsUnchanged, Black) // footer
XLS.SetBorders(lefttopCell.Address, rightbottomCell.Address, xlsbtAll, xlsbsThick, xlsbsUnchanged, Black) // cela tabela
EndSub
</pre>

== Prenos podatkov iz baze ==
<pre>
Sub TabelaXLS
Dim XLS As TXlsWriter, XLSF As TXlsField
Dim L as TLayer

// inicializiramo writer in prvi list
XLS = CreateXlsWriter
XLS.AddSheet('List 1')

// pripravimo definicijo stolpcev
XLS.Table.Clear // prvi klic je opcijski, počisti definicijo stolpcev
XLS.Table.StyleTitle.HorAlign = xlshaCenter
XLS.Table.StyleNormal.FontColor = Gray

XLSF = XLS.Table.AddCounter('Zap. št.') // zapisi bodo oštevilceni
XLSF.FooterValue = 'Skupaj' // v footerju bo fiksen tekst

XLS.Table.AddFieldByName('Naslov polja', 'polje1') // fiksno nastavimo ime stolpca

XLS.Table.AddFieldByName('', 'polje2') // ime stolpca je ime polja

XLSF = XLS.Table.AddFieldByName('Število', 'polje3') // numerično polje
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca

XLSF = XLS.Table.AddFormula('Vsota 3 in 4', 'IntToStr([polje3].AsNumber + [polje4].AsNumber)') // Basic formula
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca

XLSF = XLS.Table.AddValue('Vsota levo', xlscvAutoRowSum) // v stolpcu bo vsota številk v vrstici
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca

// pripravimo podatke
L = [Layer]
L.Filter.ExecuteSQL('[polje1] = 10')
L.Sort.Load('Default')
L.Sort.Execute

// zapišemo podatke po dani definiciji
XLS.Table.AddRecordList('Naslov', L.FilteredRecords) // naslov je opcijski

// nastavimo še robove celic
RoboviXLS(XLS)

// dodamo nov list
XLS.AddSheet('List 2')

// pripravimo nove podatke
L = [Layer]
L.Filter.ExecuteSQL('[polje1] = 20')
L.Sort.Load('Default')
L.Sort.Execute

// zapišemo podatke po dani definiciji
XLS.Table.AddRecordList('Naslov', L.FilteredRecords) // naslov je opcijski

// nastavimo še robove celic
RoboviXLS(XLS)

// shranimo v file in sprostimo writer
XLS.SaveToFile('c:\temp\test.xlsx')
XLS.Destroy
EndSub

Sub RoboviXLS(XLS As TXlsWriter)
XLS.SetBorders(XLS.Table.LeftTop.RelativeAddress(0, -1), XLS.Table.RightTop.RelativeAddress(0, -1), xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba naslova
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightBottom.Address, xlsbtHor, xlsbsUnchanged, xlsbsThin, Black) // horizontalne črte jedra tabele
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightTop.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba headerja
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightBottom.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba tabele
XLS.SetBorders(XLS.Table.LeftBottom.Address, XLS.Table.RightBottom.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba footerja
EndSub
</pre>

Izvoz v XLSX

2021-03-11T16:06:43Z

Janez Trtnik: /* Prenos podatkov iz baze */

== Osnovni primer ==
<pre>
Sub PrimerXLS
Dim XLS As TXlsWriter
Dim titleStyle, headerStyle, cellStyle, footerStyle As TXlsStyle
Dim lefttopCell, rightbottomCell As TXlsCell
Dim J As Long

// inicializiramo writer in prvi list
XLS = CreateXlsWriter
XLS.AddSheet('List 1')

// spremenimo normal stil
XLS.StyleNormal.FontSize = 12
XLS.StyleNormal.FontName = 'Arial'

// definiramo ostale stile po potrebi
titleStyle = XLS.AddStyle('', XLS.StyleTitle)
titleStyle.FontBold = False
titleStyle.FontItalic = True
titleStyle.FontSize = 20
titleStyle.HorAlign = XlshaCenter
titleStyle.FontName = 'Arial'

headerStyle = XLS.AddStyle('', XLS.StyleHeader)
headerStyle.FontSize = 12
headerStyle.HorAlign = xlshaAuto

footerStyle = XLS.AddStyle('', XLS.StyleFooter)
footerStyle.FontSize = 12
footerStyle.HorAlign = XlshaRight
footerStyle.TextWrap = false

// zamrznemo stolpce in/ali vrstice
XLS.SetFixedColumns(1)
XLS.SetFixedRows(2)

// dodamo naslov
XLS.AddCell('Naslov', xlsnfText, titleStyle)
XLS.MergeCells('A1', 'E1') // združimo celice za naslov

// dodamo header vrstico
XLS.AddRow
XLS.AddCell('', xlsnfText, headerStyle)
lefttopCell = XLS.GetCurCell // nastavimo referenco na zgoraj levo celico tabele
XLS.AddCell('Stolpec A', xlsnfText, headerStyle)
XLS.AddCell('Stolpec B', xlsnfText, headerStyle)
XLS.AddCell('Stolpec C', xlsnfText, headerStyle)
XLS.AddCell('Seštevek', xlsnfText, headerStyle)

// dodamo podatke v tabelo
for J = 1 to 5
XLS.AddRow
XLS.AddCell('Vrstica ' + IntToStr(J), xlsnfText, headerStyle)
XLS.AddCell(IntToStr(Random(1000)), xlsnfLong, nil)
XLS.AddCell(IntToStr(Random(1000)), xlsnfLong, nil)
XLS.AddCell(IntToStr(Random(1000)), xlsnfLong, nil)
XLS.AddCell(xlscvAutoRowSum, xlsnfLong, footerStyle) // dodamo seštevek numeričnih celic v levo
next

// dodamo footer vrstico
XLS.AddRow
XLS.AddCell('Seštevek', xlsnfText, headerStyle)
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle) // dodamo seštevek numeričnih celic navzgor
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle)
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle)
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle)
rightbottomCell = XLS.GetCurCell // nastavimo referenco na spodnjo desno celico tabele

// narišemo robove okoli headerja, footerja in okoli celotne tabele
XLS.SetBorders(lefttopCell.Address, lefttopCell.RelativeAddress(4,0), xlsbtAll, xlsbsThick, xlsbsUnchanged, Black) // header
XLS.SetBorders(rightbottomCell.RelativeAddress(-4,0), rightbottomCell.Address, xlsbtAll, xlsbsThick, xlsbsUnchanged, Black) // footer
XLS.SetBorders(lefttopCell.Address, rightbottomCell.Address, xlsbtAll, xlsbsThick, xlsbsUnchanged, Black) // cela tabela
EndSub
</pre>

== Prenos podatkov iz baze ==
<pre>
Sub TabelaXLS
Dim XLS As TXlsWriter, XLSF As TXlsField
Dim L as TLayer

// inicializiramo writer in prvi list
XLS = CreateXlsWriter
XLS.AddSheet('List 1')

// pripravimo definicijo stolpcev
XLS.Table.Clear // prvi klic je opcijski, počisti definicijo stolpcev
XLS.Table.StyleTitle.HorAlign = xlshaCenter
XLS.Table.StyleNormal.FontColor = Gray

XLSF = XLS.Table.AddCounter('Zap. št.') // zapisi bodo oštevilceni
XLSF.FooterValue = 'Skupaj' // v footerju bo fiksen tekst

XLS.Table.AddFieldByName('Naslov polja', 'polje1') // fiksno nastavimo ime stolpca

XLS.Table.AddFieldByName('', 'polje2') // ime stolpca je ime polja

XLSF = XLS.Table.AddFieldByName('Število', 'polje3') // numerično polje
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca

XLSF = XLS.Table.AddFormula('Vsota 3 in 4', 'IntToStr([polje3].AsNumber + [polje4].AsNumber)') // Basic formula
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca

XLSF = XLS.Table.AddValue('Vsota levo', xlscvAutoRowSum) // v stolpcu bo vsota številk v vrstici
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca

// pripravimo podatke
L = [Layer]
L.Filter.ExecuteSQL('[polje1] = 10')
L.Sort.Load('Default')
L.Sort.Execute

// zapišemo podatke po dani definiciji
XLS.Table.AddRecordList('Naslov', L.FilteredRecords) // naslov je opcijski

// nastavimo še robove celic
RoboviXLS(XLS)

// dodamo nov list
XLS.AddSheet('List 2')

// pripravimo nove podatke
L = [Layer]
L.Filter.ExecuteSQL('[polje1] = 20')
L.Sort.Load('Default')
L.Sort.Execute

// zapišemo podatke po dani definiciji
XLS.Table.AddRecordList('Naslov', L.FilteredRecords) // naslov je opcijski

// nastavimo še robove celic
RoboviXLS(XLS)

// shranimo v file in sprostimo writer
XLS.SaveToFile('c:\temp\test.xlsx')
XLS.Destroy
EndSub

Sub RoboviXLS(XLS As TXlsWriter)
XLS.SetBorders(XLS.Table.LeftTop.RelativeAddress(0, -1), XLS.Table.RightTop.RelativeAddress(0, -1), xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba naslova
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightBottom.Address, xlsbtHor, xlsbsUnchanged, xlsbsThin, Black) // horizontalne črte jedra tabele
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightTop.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba headerja
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightBottom.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba tabele
XLS.SetBorders(XLS.Table.LeftBottom.Address, XLS.Table.RightBottom.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba footerja
EndSub
</pre>

Izvoz v XLSX

2021-03-11T15:50:54Z

Janez Trtnik: /* Prenos podatkov iz baze */

== Osnovni primer ==
<pre>
Sub PrimerXLS
Dim XLS As TXlsWriter
Dim titleStyle, headerStyle, cellStyle, footerStyle As TXlsStyle
Dim lefttopCell, rightbottomCell As TXlsCell
Dim J As Long

// inicializiramo writer in prvi list
XLS = CreateXlsWriter
XLS.AddSheet('List 1')

// spremenimo normal stil
XLS.StyleNormal.FontSize = 12
XLS.StyleNormal.FontName = 'Arial'

// definiramo ostale stile po potrebi
titleStyle = XLS.AddStyle('', XLS.StyleTitle)
titleStyle.FontBold = False
titleStyle.FontItalic = True
titleStyle.FontSize = 20
titleStyle.HorAlign = XlshaCenter
titleStyle.FontName = 'Arial'

headerStyle = XLS.AddStyle('', XLS.StyleHeader)
headerStyle.FontSize = 12
headerStyle.HorAlign = xlshaAuto

footerStyle = XLS.AddStyle('', XLS.StyleFooter)
footerStyle.FontSize = 12
footerStyle.HorAlign = XlshaRight
footerStyle.TextWrap = false

// zamrznemo stolpce in/ali vrstice
XLS.SetFixedColumns(1)
XLS.SetFixedRows(2)

// dodamo naslov
XLS.AddCell('Naslov', xlsnfText, titleStyle)
XLS.MergeCells('A1', 'E1') // združimo celice za naslov

// dodamo header vrstico
XLS.AddRow
XLS.AddCell('', xlsnfText, headerStyle)
lefttopCell = XLS.GetCurCell // nastavimo referenco na zgoraj levo celico tabele
XLS.AddCell('Stolpec A', xlsnfText, headerStyle)
XLS.AddCell('Stolpec B', xlsnfText, headerStyle)
XLS.AddCell('Stolpec C', xlsnfText, headerStyle)
XLS.AddCell('Seštevek', xlsnfText, headerStyle)

// dodamo podatke v tabelo
for J = 1 to 5
XLS.AddRow
XLS.AddCell('Vrstica ' + IntToStr(J), xlsnfText, headerStyle)
XLS.AddCell(IntToStr(Random(1000)), xlsnfLong, nil)
XLS.AddCell(IntToStr(Random(1000)), xlsnfLong, nil)
XLS.AddCell(IntToStr(Random(1000)), xlsnfLong, nil)
XLS.AddCell(xlscvAutoRowSum, xlsnfLong, footerStyle) // dodamo seštevek numeričnih celic v levo
next

// dodamo footer vrstico
XLS.AddRow
XLS.AddCell('Seštevek', xlsnfText, headerStyle)
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle) // dodamo seštevek numeričnih celic navzgor
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle)
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle)
XLS.AddCell(xlscvAutoColSum, xlsnfLong, footerStyle)
rightbottomCell = XLS.GetCurCell // nastavimo referenco na spodnjo desno celico tabele

// narišemo robove okoli headerja, footerja in okoli celotne tabele
XLS.SetBorders(lefttopCell.Address, lefttopCell.RelativeAddress(4,0), xlsbtAll, xlsbsThick, xlsbsUnchanged, Black) // header
XLS.SetBorders(rightbottomCell.RelativeAddress(-4,0), rightbottomCell.Address, xlsbtAll, xlsbsThick, xlsbsUnchanged, Black) // footer
XLS.SetBorders(lefttopCell.Address, rightbottomCell.Address, xlsbtAll, xlsbsThick, xlsbsUnchanged, Black) // cela tabela
EndSub
</pre>

== Prenos podatkov iz baze ==
<pre>
Sub TabelaXLS
Dim XLS As TXlsWriter, XLSF As TXlsField
Dim L as TLayer

// inicializiramo writer in prvi list
XLS = CreateXlsWriter
XLS.AddSheet('List 1')

// pripravimo definicijo stolpcev
XLS.Table.Clear // prvi klic je opcijski, počisti definicijo stolpcev
XLSF = XLS.Table.AddCounter('Zap. št.') // zapisi bodo oštevilceni
XLSF.FooterValue = 'Skupaj' // v footerju bo fiksen tekst
XLS.Table.AddFieldByName('Naslov polja', 'polje1') // fiksno nastavimo ime stolpca
XLS.Table.AddFieldByName('', 'polje2') // ime stolpca je ime polja
XLSF = XLS.Table.AddFieldByName('Število', 'polje3') // numerično polje
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca
XLSF = XLS.Table.AddFormula('Vsota 3 in 4', 'IntToStr([polje3].AsNumber + [polje4].AsNumber)') // Basic formula
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca
XLSF = XLS.Table.AddValue('Vsota levo', xlscvAutoRowSum) // v stolpcu bo vsota številk v vrstici
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca

// pripravimo podatke
L = [Layer]
L.Filter.ExecuteSQL('[polje1] = 10')
L.Sort.Load('Default')
L.Sort.Execute

// zapišemo podatke po dani definiciji
XLS.Table.AddRecordList('Naslov', L.FilteredRecords) // naslov je opcijski

// nastavimo še robove celic
RoboviXLS(XLS)

// dodamo nov list
XLS.AddSheet('List 2')

// pripravimo nove podatke
L = [Layer]
L.Filter.ExecuteSQL('[polje1] = 20')
L.Sort.Load('Default')
L.Sort.Execute

// zapišemo podatke po dani definiciji
XLS.Table.AddRecordList('Naslov', L.FilteredRecords) // naslov je opcijski

// nastavimo še robove celic
RoboviXLS(XLS)

// shranimo v file in sprostimo writer
XLS.SaveToFile('c:\temp\test.xlsx')
XLS.Destroy
EndSub

Sub RoboviXLS(XLS As TXlsWriter)
XLS.SetBorders(XLS.Table.LeftTop.RelativeAddress(0, -1), XLS.Table.RightTop.RelativeAddress(0, -1), xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba naslova
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightBottom.Address, xlsbtHor, xlsbsUnchanged, xlsbsThin, Black) // horizontalne črte jedra tabele
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightTop.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba headerja
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightBottom.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba tabele
XLS.SetBorders(XLS.Table.LeftBottom.Address, XLS.Table.RightBottom.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba footerja
EndSub
</pre>

Izvoz v XLSX

2021-03-11T13:32:55Z

Janez Trtnik:

== Prenos podatkov iz baze ==
<pre>
Sub TabelaXLS
Dim XLS As TXlsWriter, XLSF As TXlsField
Dim L as TLayer

// inicializiramo writer in prvi list
XLS = CreateXlsWriter
XLS.AddSheet('List 1')

// pripravimo definicijo stolpcev
XLS.Table.Clear // prvi klic je opcijski, počisti definicijo stolpcev
XLSF = XLS.Table.AddCounter('Zap. št.') // zapisi bodo oštevilceni
XLSF.FooterValue = 'Skupaj' // v footerju bo fiksen tekst
XLS.Table.AddFieldByName('Naslov polja', 'polje1') // fiksno nastavimo ime stolpca
XLS.Table.AddFieldByName('', 'polje2') // ime stolpca je ime polja
XLSF = XLS.Table.AddFieldByName('Število', 'polje3') // numerično polje
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca
XLSF = XLS.Table.AddFormula('Vsota 3 in 4', 'IntToStr([polje3].AsNumber + [polje4].AsNumber)') // Basic formula
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca
XLSF = XLS.Table.AddValue('Vsota levo', xlscvAutoRowSum) // v stolpcu bo vsota številk v vrstici
XLSF.FooterValue = xlscvAutoColSum // v footerju bo vsota stolpca

// pripravimo podatke
L = [Layer]
L.Filter.ExecuteSQL('[polje1] = 10')
L.Sort.Load('Default')
L.Sort.Execute

// zapišemo podatke po dani definiciji
XLS.Table.AddRecordList('Naslov', L.FilteredRecords) // naslov je opcijski

// nastavimo še robove celic
RoboviXLS(XLS)

// dodamo nov list
XLS.AddSheet('List 2')

// pripravimo nove podatke
L = [Layer]
L.Filter.ExecuteSQL('[polje1] = 20')
L.Sort.Load('Default')
L.Sort.Execute

// zapišemo podatke po dani definiciji
XLS.Table.AddRecordList('Naslov', L.FilteredRecords) // naslov je opcijski

// nastavimo še robove celic
RoboviXLS(XLS)

// shranimo v file in sprostimo writer
XLS.SaveToFile('c:\temp\test.xlsx')
XLS.Destroy
EndSub

Sub RoboviXLS(XLS As TXlsWriter)
XLS.SetBorders(XLS.Table.LeftTop.RelativeAddress(-1,0), XLS.Table.RightTop.RelativeAddress(-1,0), xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba naslova
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightBottom.Address, xlsbtHor, xlsbsUnchanged, xlsbsThin, Black) // horizontalne črte jedra tabele
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightTop.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba headerja
XLS.SetBorders(XLS.Table.LeftTop.Address, XLS.Table.RightBottom.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba tabele
XLS.SetBorders(XLS.Table.LeftBottom.Address, XLS.Table.RightBottom.Address, xlsbtAll, xlsbsMedium, xlsbsUnchanged, Black) // obroba footerja
EndSub
</pre>

Izvoz v XLSX

2021-03-11T10:21:49Z

Janez Trtnik: Nova stran z vsebino: == CRS*.XML (transformacije koordinatnih sistemov) == Transformacije koordinatnih sistemov so vgrajene v sam program. Parametri za Helmertovo 7-parametrsko transformacijo pa...

== CRS*.XML (transformacije koordinatnih sistemov) ==
Transformacije koordinatnih sistemov so vgrajene v sam program. Parametri za Helmertovo 7-parametrsko transformacijo pa se lahko podajo v XML datoteki.
=== Primer ===
<pre>
<?xml version="1.0" encoding="windows-1250"?>
<crs>
<projection>
<prcode>SI-D48</prcode>
<transformation>
<trcode>GURS-08</trcode>
<trnote>Cela Slovenija (15-125cm)</trnote>
<trtowgs>409.545, 72.164, 486.872, 3.085957, 5.469110, -11.020289, 17.919665</trtowgs>
<trtocrs>-473.862, -124.587, -413.576, -4.730807, -2.380796, 11.786482, -10.645117</trtocrs>
<trtest>SITRANET, 16, 0, 0, 46, 0, 0, 577825.261, 95579.074</trtest>
</transformation>
</projection>
</crs>
</pre>

== TMS*.XML (definicije tile map servisov) ==
=== Primer ===
<pre>
<?xml version="1.0" encoding="windows-1250"?>
<tms>
<service>
<code>OSM</code>
<name>OSM - OpenStreetMap</name>
<server>a.tile.openstreetmap.org</server>
<server>b.tile.openstreetmap.org</server>
<server>c.tile.openstreetmap.org</server>
<levels>
<codes>0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19</codes>
<link>/%Z/%X/%Y.png</link>
</levels>
<format>png</format>
<validity>7</validity>
</service>
</tms>
</pre>

=== Parametri taga SERVICE ===
*CODE (1) - koda, ki naj bo unikatna in naj se nikoli ne spremeni
*NAME (1) - opisno ime, tudi unikatno, da se pri izbiri lahko ločijo med sabo
*CRS (0..1) - koda koordinatnega sistema, za kode poglej v CRS.XML (privzeto WGS-84)
*ORIGIN (0..1) - izhodišče sistema, TOP za levo-zgoraj ali BOTTOM za levo-spodaj (privzeto TOP)
*ORIGINX (0..1) - koordinata izhodišča sistema (levo) (privzeto 0)
*ORIGINY (0..1) - koordinata izhodišča sistema (zgoraj/spodaj) (privzeto 0)
*PIXELSIZE (0..1) - dimenzije piksla v metrih na prvem nivoju (privzeto 104857.6)
*TILESIZE (0..1) - dimenzija slike v pikslih (privzeto 256)
*FORMAT (1) - format slike, JPG, PNG ali TIF
*VALIDITY (0..1) - število dni do ponovnega preverjanja veljavnosti (privzeto 7)
*CHROMACOLORHEX (0..1) - barva, ki se naj spremeni v prozorno, npr. FFFFFE (privzeto 0)
*CHROMATOLERANCE (0..1) - toleranca, za prozornost, npr. 1 (privzeto 0)
*TOPLEVELINDEX (0..1) - index nivoja, na katerem se začnejo karte (če želimo ignorirati zgornje nivoje) (privzeto 0)
*SERVER (1..N) - naslovi strežnikov
*LEVELS (1..N) - definicije nivojev

=== Parametri taga LEVELS ===
*CODES (1) - seznam šifer nivojev, ločenih z vejico
*LINK (1) - povezava na sliko, kjer se % sekvence nadomeščajo z dejanskimi vrednosti

=== % sekvence ===
*%Z se nadomesti s šifro nivoja
*%X se nadomesti s horizontalnim indeksom slike
*%Y se nadomesti z vertikalnim indeksom slike
*%Q se nadomesti s quad-tree nazivom slike

== CTR*.XML (definicije barvnih transformacij) ==
=== Primer ===
<pre>
<?xml version="1.0" encoding="windows-1250"?>
<cts>
<ct>
<ctcode>1</ctcode>
<ctname>Cyan, Orange - 8 Bands</ctname>
<ctlinear>true</ctlinear>
<ctshadow>NW</ctshadow>
<ctpair> 0, 806000</ctpair>
<ctpair> 100, 808000</ctpair>
<ctpair> 200, A0A000</ctpair>
<ctpair> 300, C0C000</ctpair>
<ctpair> 400, F0F000</ctpair>
<ctpair> 600, CAE8DD</ctpair>
<ctpair> 800, 55AAFF</ctpair>
<ctpair>1000, 4484DD</ctpair>
<ctpair>1300, 337CCE</ctpair>
<ctpair>1700, 2967AB</ctpair>
<ctpair>2100, 1A416C</ctpair>
<ctpair>2900, 4A484D</ctpair>
</ct>
</cts>
</pre>
=== Parametri taga CT ===
*CTCODE (1) - koda barvne transformacije
*CTNAME (1) - opisno ime barvne transformacije
*CTLINEAR (0..1) - ali se vrednosti med dvema barvama linearno prelivajo (privzeto false)
*CTSHADOW (0..1) - smer osvetlitve za senčenje NW, N, NE, W, E, SW, S, SE (privzeto se ne senči)
*CTPAIR (1..N) - seznam parov vrednost,barva (primer 200,FF00FF)

== XML struktura piramide ==
=== Uporaba ===
'''PyramidBuildAll(Code As String)''' ponovno naloži XML datoteko, izdela vse nivoje in sestavi piramido.

=== Primer ===
<pre>
<?xml version="1.0" encoding="windows-1250"?>
<store>
<name>Ortofoto (GURS-50cm)</name>
<tilesize>512</tilesize>
<crs>SI-D48</crs>
<format>jpg,75</format>
<minscale>100</minscale>
<sourcepath>D:\Podatki\Rasters\DOF-GURS\TM050</sourcepath>
<targetpath>D:\Podatki\Rasters\DOF-GURS\TM050</targetpath>
<level>
<code>050x001</code>
<pixelsize>0.50</pixelsize>
<maxscale>5000</maxscale>
<build>files,,,000000,FFFFFF,1</build>
</level>
<level>
<code>050x002</code>
<pixelsizemul>2</pixelsizemul>
<maxscalemul>2</maxscalemul>
<build>level</build>
</level>
</store>
</pre>

=== Parametri taga STORE ===

*NAME (1) - opisno ime, mora biti unikatno, da se pri izbiri lahko ločijo med sabo
*CRS (1) - koda koordinatnega sistema, za kode poglej v CRS.XML (privzeto WGS-84), trenutno se še ne uporablja
*TILESIZE (1) - velikost tilov v pikslih
*FORMAT (1) - format tilov, TG4, LZW ali JPG (ki ima lahko dodatno še kvaliteto 0-100)
*MINSCALE (0..1) - minimalno merilo, do katere se piramida izrisuje
*COLOR (0..1) - barva za črnobele slike pri TG4, na primer FF00FF
*CHROMA (0..1) - barva in toleraca za prozornost, na primer FFFFFF,10
*SOURCEPATH (0..1) - predpona, ki se doda mapam vhodnih datotek za build
*TARGETPATH (0..1) - mapa, kamor se shranijo vmesni rezultati builda (nivoji)
*BUILDWINDOW (0..1) - okno, ki oklepa piramido, za optimizacijo builda (privzeto 250000,0,750000,250000)
*LEVEL (1..N) - definicije izdelave nivojev

=== Parametri taga LEVEL ===
*CODE (1) - unikatna koda nivoja
*PIXELSIZE (0..1) - velikost piksla v metrih, obvezno podana na prvem nivoju; če ni podana, je dvojna vrednost prejšnjega nivoja
*PIXELSIZEMUL (0..1) - če je podan PIXELSIZE, se množi s to vrednostjo (privzeto 1)
*PIXELSIZEDIV (0..1) - če je podan PIXELSIZE, se deli s to vrednostjo (privzeto 1)
*MAXSCALE (0..1) - največje merilo izrisa tega nivoja, obvezno podana na prvem nivoju; če ni podana, je dvojna vrednost prejšnjega nivoja
*MAXSCALEMUL (0..1) - če je podan MAXSCALE, se množi s to vrednostjo (privzeto 1)
*PREPAINT (0..1) -
*BUILD (0..N) - navodila za kreiranje nivoja, obvezna na prvem nivoju (privzeto LEVEL)

=== Parametri taga BUILD ===
Parametri so ločeni z vejico.
*FILES,mapa,filter,barva,chroma,toleranca
**mapa (0..1) -
**filter (0..1) -
**barva (0..1) -
**chroma (0..1) -
**toleranca (0..1) -
*LIST,seznam,barva,chroma,toleranca
**seznam (1) - ascii datoteka s seznamom kart
**barva (0..1) -
**chroma (0..1) -
**toleranca (0..1) -
*LEVEL,koda
**koda (0..1) - koda nivoja, iz katerega se reducira trenutni nivo (privzeto prejšnji nivo)
*GRID,grid,polje,transformacija
**grid (1) - ime xml datoteke z definicijo grida
**polje (1) - indeks polja iz grida, ki naj se uporabi
**transformacija (1) - koda barvne transformacije
*DRAW,tematika,ymin,xmin,ymax,xmax
**tematika (1) - ime tematike, ki naj se izriše
**ymin, xmin, ymax, xmax (1) - okno izrisa

== XML struktura grida ==
=== Primer ===
<pre>
<?xml version="1.0" encoding="windows-1250"?>
<grid>
<Crs>SI-D48</Crs>
<OriginY>371200</OriginY>
<OriginX>25600</OriginX>
<TileCountY>20</TileCountY>
<TileCountX>14</TileCountX>
<CellCountY>512</CellCountY>
<CellCountX>512</CellCountX>
<CellDimenY>25</CellDimenY>
<CellDimenX>25</CellDimenX>
<CellField>I02,100,-600</CellField>
<CellField>I02,100,+300</CellField>
</Grid>
</pre>
=== Parametri taga GRID ===
*...
*...
=== Parametri taga CELLFIELD ===
*TIP (1): tip polja, ena od vrednosti: W01,W02,W04,I01,I02,I04,F04,F08
*FAKTOR (0..1): celoštevilčni množitelj vrednosti, za optimizacijo
*DELTA (0..1): celoštevilčni dodatek vrednosti, za optimizacijo

Interna vrednost polja se računa po formuli:
*interna vrednost = (realna vrednost + delta) * faktor

=== Primer grida za transformacijo koordinat ===
Primer XML datoteke (SI-D96;SI-D48):
<pre>
<?xml version="1.0" encoding="WINDOWS-1250"?>
<Grid>
<Crs>SI-D96</Crs>
<OriginY>370000</OriginY>
<OriginX>25000</OriginX>
<CellDimenY>500</CellDimenY>
<CellDimenX>500</CellDimenX>
<TileCountY>1</TileCountY>
<TileCountX>1</TileCountX>
<CellCountY>520</CellCountY>
<CellCountX>340</CellCountX>
<CellField>I02,1000,-370</CellField>
<CellField>I02,1000,+485</CellField>
</Grid>

</pre>
Procedura za izračun grida:
<pre>
Dim G As TGrid, IY, IX As Long, Y1, X1, X2, Y2 As Float
G = CreateGrid(ProgramPath + 'QTS;SI-D96;SI-D48.XML')
If Assigned(G) Then
CRSToCRSParams('SI-D48', 'SI-D96')
For IY = 0 To G.TileCountY * G.CellCountY - 1
Y1 = G.OriginY + IY * G.CellDimenY + G.CellDimenY / 2
For IX = 0 To G.TileCountX * G.CellCountX - 1
X1 = G.OriginX + IX * G.CellDimenX + G.CellDimenX / 2
CRSToCRS(Y1, X1, Y2, X2)
G.CellValue(Y1, X1, 0) = Y2 - Y1
G.CellValue(Y1, X1, 1) = X2 - X1
Next
Next
G.Save
G.Destroy
EndIf
</pre>

Glavna stran

2021-03-11T10:19:51Z

Janez Trtnik:

__NOTOC__ __NOEDITSECTION__

{| cellspacing="0" cellpadding="0"
|-
| style="width:240px; border:1px solid #cef2e0; background-color:#f8ffff; vertical-align:top; padding: 4px;" | <div style="margin: 0px; background-color:#d2ffff; font-size:120%; font-weight:bold; border:1px solid #a3bfb1; padding:2px 5px;">Splošno</div> <div style="margin: 0px; padding: 0px 6px 16px 6px;">
[[O geografskih informacijskih sistemih]]

[[O sistemu SDMS]]

[[Razlike in prednosti proti SDMS-W]]

[[Osnovni principi dela]]

[[Pogosta vprašanja]]

[[Splošno]]

[[Osnovno okno programa]]
[[Zagon programa in prijava v sistem]]</div> <div style="margin: 0px; background-color:#d2ffff; font-size:120%; font-weight:bold; border:1px solid #a3bfb1; padding:2px 5px;">Administracija</div> <div style="padding: 0px 6px 16px 6px;">
[[Namestitev sistema]]

[[Posodabljanje sistema]]

[[Varovanje podatkov]]

[[Varovanje programa]]

[[Zagonski parametri]]

[[Struktura XML datotek]]

[[Izvoz v XLSX]]</div> <div style="margin: 0px; background-color:#d2ffff; font-size:120%; font-weight:bold; border:1px solid #a3bfb1; padding:2px 5px;">Razvoj programa</div> <div style="padding: 0px 6px 16px 6px;">
[[Zgodovina verzij]]<br>
</div> <div style="margin: 0px; background-color:#d2ffff; font-size:120%; font-weight:bold; border:1px solid #a3bfb1; padding:2px 5px;">Razvoj modulov</div> <div style="padding: 0px 6px 16px 6px;">
[[Modul Rastri]]

[[Modul Analiza sistema]]

[[Uporabne rutine]]

[[LGB]]

</div> <div style="margin: 0px; background-color:#d2ffff; font-size:120%; font-weight:bold; border:1px solid #a3bfb1; padding:2px 5px;">Razvoj spletnih aplikacij</div> <div style="padding: 0px 6px 16px 6px;">
[[SDMS WebServer]]
</div> 
| style="width:10px;" | 
| style="width:1px; background-color:#000000;" | 
| style="width:10px;" | 
| style="width:240px; border:1px solid #cef2e0; background-color:#f5fffa; vertical-align:top; padding:4px;" | <div style="margin: 0px; background-color:#d2ffff; font-size:120%; font-weight:bold; border:1px solid #a3bfb1; padding:2px 5px;">Razvoj aplikacij</div> <div style="padding: 0px 6px 16px 6px;">
[[Raziskovalec]]

:[[Urejevalnik aplikacije]]
:[[Urejevalnik hitrih tipk]]
:'''[[Urejevalnik menija]]'''
:[[Urejevalnik modula]]
:[[Urejevalnik orodjarne]]
:[[Urejevalnik dialoga]]

:[[Urejevalnik tabele]]

:[[Urejevalnik podatkovne plasti]]
::[[Urejevalnik niza podatkov]]
::[[Urejevalnik indeksa]]
::[[Urejevalnik filtra]]
::[[Urejevalnik sortiranja]]
::[[Urejevalnik maske]]
::[[Urejevalnik poročila]]
::[[Urejevalnik uvoza podatkov]]
::[[Urejevalnik izvoza podatkov]]
:[[Urejevalnik predloge izrisa]]
:[[Urejevalnik tematike]]

:[[Urejevalnik šrafure]]
:[[Urejevalnik simbola]]
:[[Urejevalnik tipa linije]]

:[[Urejevalnik skupine uporabnikov]]
:[[Urejevalnik uporabnika]]
</div> <div style="margin: 0px; background-color:#d2ffff; font-size:120%; font-weight:bold; border:1px solid #a3bfb1; padding:2px 5px;">SDMS BASIC</div> <div style="padding: 0px 6px 16px 6px;">
[[SDMS BASIC]]

[[Operatorji]]
[[Podpora rastrskih formatov]]</div>
| style="width:10px;" | 
| style="width:1px; background-color:#000000;" | 
| style="width:10px;" | 
| style="width:240px; border:1px solid #cedff2;background-color:#f5faff;vertical-align:top; padding:4px;" | <div style="margin: 0px; background-color:#d2ffff; font-size:120%; font-weight:bold; border:1px solid #a3bfb1; padding:2px 5px;">Uporaba aplikacije</div> <div style="padding: 0px 6px 16px 6px;">
[[Aplikacija]]

:[[Tematika]]
:Pomožna okna:
:[[Aplikacija - Tematika]]
:[[Aplikacija - Informacije]]
:[[Aplikacija - GED]]
:[[Aplikacija - CC]]
:[[Aplikacija - AV]]
:[[Aplikacija - VID]]

[[Analiza - filtiranje podatkov]]

[[Nastavitve ekrana]]

[[Predpregled poročila]]

[[Predpregled pred izrisom na risalnik]]

[[Prostorsko preseki - overlay]]

[[Topologija na splošno]]

[[Ukazna vrstica]]

[[Urejanje atributnih podatkov]]

[[Urejanje podatkov]]
[[Urejanje vektorskih podatkov]]</div> <div style="margin: 0px; background-color:#d2ffff; font-size:120%; font-weight:bold; border:1px solid #a3bfb1; padding:2px 5px;">Primeri aplikacij</div> <div style="padding: 0px 6px 16px 6px;">
[[Aplikacija EPRESS]]

[[Aplikacija GEODEZIJA]]
[[Aplikacija GEOSTAT]]</div>
|}

SDMS WebServer

2019-08-23T07:35:03Z

Janez Trtnik: /* 2018: Offline podatki */

__NOTOC__
[[Kategorije: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'''
*za uporabo varnih povezav (https) se namesti certifikat strežnika, za navodila glej spodaj
*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
*nikakor ne smete pozabiti omogočiti uporabo želenih vrat (80, 443, ...) v požarnem zidu.

Strežnik je sedaj nameščen in zagnan.

=== Namestitev certifikata ===
Če se bo uporabljala varna povezava (https), je potrebno pridobiti in namestiti tudi certifikat strežnika. Pripravi se mapo, na katero se bo kopiral certifikat, lahko pa se ga kopira tudi kar na mapo programa. Pripravi se naslednje ASCII datoteke:
*'''''root.pem''''' - certifikat verifikacijskega strežnika
*'''''cert.pem''''' - certifikat strežnika
*'''''key.pem''''' - zakodiran privatni ključ strežnika
*'''''password.txt''''' - geslo za dekodiranje privatnega ključa

<source>
openssl pkcs12 -in xxx.pfx -out root.pem -cacerts // brez izhodnega gesla
openssl pkcs12 -in xxx.pfx -out certandkey.pem -clcerts // vnesi geslo za key, razbij na dve datoteki: cert.pem in key.pem
Geslo kodiraj z EncryptPassord in shrani v password.txt takole: ENCRYPTED:geslo
</source>

Kasneje se v modulu določi tudi pot do datotek certifikata.

== Aktivacija ==
'''SDMS WebServer''' se aktivira tako, da se v SDMS raziskovalcu doda nov modul z imenom '''SdmsWSP''' in naslednjo vsebino:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', '')
WebServer.Start
...
EndSub</source>

Če želimo dodati tudi dostop preko varne povezave (https), to storimo takole:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath)
WebServer.Start
...
EndSub</source>

Če želimo zagotoviti uporabo varne povezave (https) in izvesti samodejno preusmeritev nanjo:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http').SetRedirect('https://www.test.si/')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath + 'Certifikat\')
WebServer.Start
...
EndSub</source>

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

== Osnovne nastavitve ==
Strežniku moramo podati ime, ki se prikaže kot naslov strani. Uporablja se tudi kot identifikacija strežnika, če je ta potrebna.
<source>WebServer.Name = 'TEST'</source>
Ob prijavi se uporabniku prikaže logotip velikosti 480x120 pik. Datoteko se shrani na mapo WebServer in takole poda njeno ime.
<source>WebServer.Logo = 'logo.png'</source>

Privzeto dopušča SDMS WebServer dostop samo SDMS uporabnikom. Če želimo dodati tudi možnost anonimnega dostopa, to storimo tako:
<source>WebServer.User = [Gost]</source>
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.
<source>WebServer.Window = '370000,25000,630000,200000'</source>

Določiti je treba tematiko, ki se bo uporabljala za izris.
<source>WebServer.DrawList = [Web Tematika]</source>

Dodati je treba plasti, po katerih za izvaja iskanje in izpis podatkov.
<source>WebServer.AddSearch([Plast A].Search('Default'))
WebServer.AddSearch([Plast B].Search('Default'))</source>

Dobro je dodati tudi seznam priljubljenih lokacij, ki so dostopne iz menija.
<source>WebServer.AddLocation('Slovenija', '370000,25000,630000,200000', '')
WebServer.AddLocation('Ljubljana', '370000,25000,630000,200000', '')
WebServer.AddLocation('Maribor', '370000,25000,630000,200000', '')</source>

Možno je dodati tudi seznam dodatnih povezav, ki so ravno tako dostopne iz menija.
<source>WebServer.AddLink('Softdata Home Page', 'http://www.softdata.si', '')</source>

Dodamo tudi seznam dodatnih izrisov za tiskanje.
<source>WebServer.AddLayout([A4 Pokončno], '')
WebServer.AddLayout([A4 Ležeče], '')</source>

== 2018: Splošna dodatna opravila ==
Na mapi Database\WebServer se ustvari novo mapo 2018.

Nanjo se prekopira logo-*.png datoteke, ki so bile pri stari aplikaciji na rootu.

Nanjo se prekopira custom.js in custom.css iz mape SDMSWSP\WebServer\2018 in se ju primerno prilagodi.

== 2018: Tematika ==
Tematika za novo aplikacijo se pripravi kot prej, le da se v njej ne vnaša polja 'Informacije za web'. To polje se ignorira. Še vedno pa se uporabljata polji 'Dodatno ime' (obvezno) in 'Pravice' (opcijsko).

Kar je bilo prej določeno v informacijah za web, se sedaj določa v modulu SDMSWSP v funkciji OnCreate z dodajanjem elementov tipa TWebItem.

Obstaja tudi SDMS basic funkcija ConvertWebInfo, ki prenese stare informacije za web iz tematike v clipboard.

Tudi WebServer.AddPyramid ukazi se v novi aplikaciji ignorirajo, tako da je treba piramid dodati ročno.

<source>
WI = WebServer.AddWebItem(A, B, C, D, E, F, G, H)
</source>
Parametri funkcije AddWebItem
A: (string) koda mape, na katero želimo vstaviti dani element, prazen string za root
B: (string) koda elementa, ki mora biti unikatna(!); za 'radio gumbe' se doda predpona xxx:, kjer je xxx ime skupine gumbov, vsaka grupa gumbov naj ima natanko en gump privzeto viden (E)
C: (string) ime elementa (napis)
D: (string) legenda za dani element, ki naj vsebuje tudi copyright informacijo, lahko v HTML obliki
E: (boolean) privzeta vidnost elementa
F: (double) transparentnost podlog, 0-1, privzeto 1, lahko se določi na mapah in kartah
G: (string) pravice za uporabo v online načinu: z vejico ločen seznam security tagov, vsi = '*', nihče = '-'; dodatne natančnejše pravice za prikaz pa so lahko nastavljene tudi v tematiki
H: (string) pravice za uporabo v offline načinu: velja enako kot pri (G)
Tako ustvarimo nov element (referenca nanj je v spremenljivki WI).

Če gre za element, ki predstavlja skupino elementov, ne potrebujemo narediti nič več.
Če gre za element, ki je povezan s piramido, to storimo z WI.SetPyramid('koda piramide')
<source>WI.SetPyramid('dof2018')</source>
Če gre za element, ki je povezan s spletnimi kartami, to storimo z WI.SetTms('koda spletnih kart')
<source>WI.SetTms('gm-s')</source>
Če gre za element, ki je povezan s temo/temami tematke, to storimo z WI.SetDrawItem('alias teme/tem')
<source>WI.SetDrawItem('parcele')</source>

Priporočamo striktno poravnavanje parametrov po kolonah, da se ohrani preglednost.

<source>
Dim WI As TWebItem

WI = WebServer.AddWebItem('', 'g-maps', 'Osnovne karte', '', True, 1.0, '*', '*')
WI = WebServer.AddWebItem('g-maps', 'm:gm-m', 'Google Maps', 'Google', False, 1.0, '*', '-') WI.SetTms('GM-M')
WI = WebServer.AddWebItem('g-maps', 'm:dof', 'DOF Slovenija', 'GURS', True, 1.0, '*', '*') WI.SetPyramid('DOF-GURS')
WI = WebServer.AddWebItem('g-maps', 'm:dmr', 'DMR Slovenija', 'GURS', False, 1.0, '*', '-') WI.SetPyramid('DMR-GURS')

WI = WebServer.AddWebItem('', 'g-sp', 'Splošne vsebine', '', True, 1.0, '*', '-')
WI = WebServer.AddWebItem('g-sp', 'dkn', 'Dkn', 'pa', False, 1.0, '*', '-') WI.SetDrawItem('dkn')
WI = WebServer.AddWebItem('g-sp', 'op', 'Opombe', 'op', True, 1.0, '*', '*') WI.SetDrawItem('op')
</source>

== 2018: Offline podloge ==
Novost je možnost uporabe podlog (piramide) v offline načinu.

Za to je treba elementu piramide določiti:
pravico offline uporabe(parameter H), ne pozabite tudi za nadrejene skupine
relevantno območje, kar je izjemno pomembno narediti pravilno, da se čimbolj omeji količina potrebnih kart za prenos v cache

Definicija relevantnega območja se določa za vse offline pologe enotno z ukazom WebServer.AddOfflineArea([plast], 'opcijski filter', offset, minpixdim).
<source>
WebServer.AddOfflineArea([plast poligonov], 'filter', 0, 0)
WebServer.AddOfflineArea([plast linij], 'filter', 50, 0)
WebServer.AddOfflineArea([plast točk], 'filter', 200, 0)
</source>
Vsakokrat, ko se ta defincija spremeni, je potrebno izvesti preračun relevantnega območja s klicom povezave "http://streznik/api/2018/prepareofflinemapsinfo"

== 2018: Offline podatki ==
Novost je možnost uporabe podatkov v offline načinu.

Za to je treba elementu teme določiti:
pravico offline uporabe(parameter H), tudi za nadrejene skupine
povezavo na dejanske podatke z ukazom '''WI.SetOfflineData([plast], 'iskanje')'''

<source>WI.SetOfflineData([parcele], 'Default')</source>

V sami plasti je potrebno dodati polja, ki določajo, kako se podatki v offline načinu izrisujejo.

Za točke - font: polje '''offline-icon''' z definicijo '''"ime simbola;font mi ali fa;velikost v px;stil n ali b;barva simbola;opcijska sirina sence v px;opcijska barva sence;opcijsko xxx;opcijsko merilo"'''
Za točke - simbol: polje '''offline-icon''' z definicijo '''"ime simbola;svg;faktor;xxx;barva simbola;opcijsko xxx;opcijsko xxx;opcijsko rotacija;opcijsko merilo"'''
Za polilinije: polje '''offline-line''' z definicijo '''"debelina linije v px;barva linije;opcijski stil; opcijsko merilo"'''
Za poligone: polje '''offline-fill''' z definicijo '''"barva polnjenja;debelina linije v px;barva linije;opcijski stil; opcijsko merilo"'''
Za napise: polje '''offline-text''' z definicijo '''"napis;Roboto;velikost v px;stil n ali b;barva napisa;opcijska sirina sence v px;opcijska barva sence;opcijsko merilo"'''

Za zoom: polje '''offline-zoom-offset''' z definicijo '''"offset za zoom"'''
Za search: polje '''offline-search''' z definicijo '''"iskalne besede"'''

Za font simbolov se lahko vnese '''mi''' za Material Icons [https://material.io/tools/icons/?style=baseline] ali '''fa''' za FontAwesome [https://origin.fontawesome.com/icons].

Za barve se lahko vnese katerakoli veljavna CSS notacija [https://www.w3schools.com/cssref/css_colors.asp]: LightRed, #FF0000, rgb(255,0,0), rgba(255,0,0,1.0).

<source>
offline-icon "lens;mi;8;n;red;2;white"
offline-line "4;yellow"
offline-fill "rgba(0,0,255,0.5);1;blue"
offline-text "napis;Roboto;12;n;green;2;white"
</source>

== Napredne nastavitve ==

Ob prijavi lahko določene nastavitve spremenimo glede na prijavljenega uporabnika. To storimo tako, da dodamo novo proceduro:
<source>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</source>

== Priprava tematike ==
Tematiko se pripravi kot sicer. Izjemnega pomena pa je, da se tematika v vseh merilih in z vsemi vključenimi temami vedno izriše hitro, torej v rangu recimo 3 sekund (kar je že precej). Optimalno bi bilo 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 ta tema vklopi/izklopi. Če tema nima oznake, se nikoli ne prikaže. Če želimo temo prikazati vedno, vnesemo za znak '''*'''.

==== Atribut: View tags ====
Namen tega atributa je omejevanje vpogleda v podatke glede na uporabnika.

==== Atribut: Web info ====
V tem atributu določimo prej omenjene skupine. To storimo večvrstično v naslednji obliki:
<source>item=karte
name=Pregledne karte
sort=1
show=1
hint=...
icon=a.gif</source>
Vsaka oznaka se mora pojaviti natanko v eni temi, ni pomembno kateri. Iz teh informacij se potem generira menu za vklop/izklop v spletni aplikaciji. Prve štiri vrstice so obvezne.

== Priprava iskanj in izpisov ==
Iskanje po poljubnih podatkih se pripravi v urejevalniku podatkovne plasti (Searches). V modulu SdmsWSP pa z ukazom AddSearch dodajamo le tiste, ki jih želimo uporabljati v spletni aplikaciji.
...

== Nastavljanje pravic ==
Pri spletni aplikaciji je možno nastaviti različne nivoje dostopa (izris na karti, iskanje, izpis podatkov) glede na prijavljenega uporabnika.

V ta namen se uporablja kratke oznake, ki jih umenujemo '''Security tags'''.

=== Dodeljevanje pravic===
Te oznake se za uporabnika določa v urejevalniku uporabnika oz. v urejevalniku skupine uporabnikov (možno je tudi v varnostnem središču).

Vsak uporabnik/skupina ima lahko določenih več oznak, ki so ločene z vejico.

Uporabnik poleg svojih oznak dobi tudi vse oznake vseh skupin, v katerih je član.

=== Omejevanje pravic===
Na splošno velja naslednje:
*za vpoglede (tematika, vpogled preko iskanja/klika) velja, da če oznaka ni določena, imajo vpogled vsi, sicer pa samo tisti z oznako,
*za urejanja (dodajanje, popravljanje, brisanje) velja, da če oznaka ni določena, ne more urejati nihče, sicer pa samo tisti z oznako.

Pravice se omejuje:
*v tematiki:
**v atributu teme View tags
**v atrubutu teme Web info, v vrstici view=

*pri definiciji iskanja v podatkovni plasti:
**View access
**Append access
**Update access
**Delete access
**View in Update access pri posameznih poljih

*v SDMS Basicu, ukaz je MatchSecurityTags.

Vedno lahko določimo tudi več oznak, ločenih z vejico.

== TODO ==
*SQL pogoj filtra, uporabljenega v searchu se ne upošteva pri kliku
*dvonivojski sistem pri vsebinah za izris
*multiple datasete pri maski (vsaj view)
*images naj dela tudi za spisek datotek (RO)

== 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.* ===
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.

=== SEARCH.DLL ===
Izvede splošno iskanje po (full text search) in vrne zadetke.
:query=KLJUČNE BESEDE
::seznam ključnih besed za iskanje, ločenih s presledki
:category=KAT1,KAT2,KAT3
::seznam kategorij, po katerih se vrši iskanje (če je prazen, se vrši po vseh)
:hits=10
::maksimalno število zadetkov
:template=JSON
::ime templata, ki opredeljuje obliko zadetkov
AddSearch ...
Pred iskanjem se zažene še OnWebSearch...

SDMS WebServer

2019-02-01T14:30:13Z

Janez Trtnik: /* 2018: Offline podatki */

__NOTOC__
[[Kategorije: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'''
*za uporabo varnih povezav (https) se namesti certifikat strežnika, za navodila glej spodaj
*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
*nikakor ne smete pozabiti omogočiti uporabo želenih vrat (80, 443, ...) v požarnem zidu.

Strežnik je sedaj nameščen in zagnan.

=== Namestitev certifikata ===
Če se bo uporabljala varna povezava (https), je potrebno pridobiti in namestiti tudi certifikat strežnika. Pripravi se mapo, na katero se bo kopiral certifikat, lahko pa se ga kopira tudi kar na mapo programa. Pripravi se naslednje ASCII datoteke:
*'''''root.pem''''' - certifikat verifikacijskega strežnika
*'''''cert.pem''''' - certifikat strežnika
*'''''key.pem''''' - zakodiran privatni ključ strežnika
*'''''password.txt''''' - geslo za dekodiranje privatnega ključa

<source>
openssl pkcs12 -in xxx.pfx -out root.pem -cacerts // brez izhodnega gesla
openssl pkcs12 -in xxx.pfx -out certandkey.pem -clcerts // vnesi geslo za key, razbij na dve datoteki: cert.pem in key.pem
Geslo kodiraj z EncryptPassord in shrani v password.txt takole: ENCRYPTED:geslo
</source>

Kasneje se v modulu določi tudi pot do datotek certifikata.

== Aktivacija ==
'''SDMS WebServer''' se aktivira tako, da se v SDMS raziskovalcu doda nov modul z imenom '''SdmsWSP''' in naslednjo vsebino:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', '')
WebServer.Start
...
EndSub</source>

Če želimo dodati tudi dostop preko varne povezave (https), to storimo takole:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath)
WebServer.Start
...
EndSub</source>

Če želimo zagotoviti uporabo varne povezave (https) in izvesti samodejno preusmeritev nanjo:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http').SetRedirect('https://www.test.si/')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath + 'Certifikat\')
WebServer.Start
...
EndSub</source>

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

== Osnovne nastavitve ==
Strežniku moramo podati ime, ki se prikaže kot naslov strani. Uporablja se tudi kot identifikacija strežnika, če je ta potrebna.
<source>WebServer.Name = 'TEST'</source>
Ob prijavi se uporabniku prikaže logotip velikosti 480x120 pik. Datoteko se shrani na mapo WebServer in takole poda njeno ime.
<source>WebServer.Logo = 'logo.png'</source>

Privzeto dopušča SDMS WebServer dostop samo SDMS uporabnikom. Če želimo dodati tudi možnost anonimnega dostopa, to storimo tako:
<source>WebServer.User = [Gost]</source>
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.
<source>WebServer.Window = '370000,25000,630000,200000'</source>

Določiti je treba tematiko, ki se bo uporabljala za izris.
<source>WebServer.DrawList = [Web Tematika]</source>

Dodati je treba plasti, po katerih za izvaja iskanje in izpis podatkov.
<source>WebServer.AddSearch([Plast A].Search('Default'))
WebServer.AddSearch([Plast B].Search('Default'))</source>

Dobro je dodati tudi seznam priljubljenih lokacij, ki so dostopne iz menija.
<source>WebServer.AddLocation('Slovenija', '370000,25000,630000,200000', '')
WebServer.AddLocation('Ljubljana', '370000,25000,630000,200000', '')
WebServer.AddLocation('Maribor', '370000,25000,630000,200000', '')</source>

Možno je dodati tudi seznam dodatnih povezav, ki so ravno tako dostopne iz menija.
<source>WebServer.AddLink('Softdata Home Page', 'http://www.softdata.si', '')</source>

Dodamo tudi seznam dodatnih izrisov za tiskanje.
<source>WebServer.AddLayout([A4 Pokončno], '')
WebServer.AddLayout([A4 Ležeče], '')</source>

== 2018: Splošna dodatna opravila ==
Na mapi Database\WebServer se ustvari novo mapo 2018.

Nanjo se prekopira logo-*.png datoteke, ki so bile pri stari aplikaciji na rootu.

Nanjo se prekopira custom.js in custom.css iz mape SDMSWSP\WebServer\2018 in se ju primerno prilagodi.

== 2018: Tematika ==
Tematika za novo aplikacijo se pripravi kot prej, le da se v njej ne vnaša polja 'Informacije za web'. To polje se ignorira. Še vedno pa se uporabljata polji 'Dodatno ime' (obvezno) in 'Pravice' (opcijsko).

Kar je bilo prej določeno v informacijah za web, se sedaj določa v modulu SDMSWSP v funkciji OnCreate z dodajanjem elementov tipa TWebItem.

Obstaja tudi SDMS basic funkcija ConvertWebInfo, ki prenese stare informacije za web iz tematike v clipboard.

Tudi WebServer.AddPyramid ukazi se v novi aplikaciji ignorirajo, tako da je treba piramid dodati ročno.

<source>
WI = WebServer.AddWebItem(A, B, C, D, E, F, G, H)
</source>
Parametri funkcije AddWebItem
A: (string) koda mape, na katero želimo vstaviti dani element, prazen string za root
B: (string) koda elementa, ki mora biti unikatna(!); za 'radio gumbe' se doda predpona xxx:, kjer je xxx ime skupine gumbov, vsaka grupa gumbov naj ima natanko en gump privzeto viden (E)
C: (string) ime elementa (napis)
D: (string) legenda za dani element, ki naj vsebuje tudi copyright informacijo, lahko v HTML obliki
E: (boolean) privzeta vidnost elementa
F: (double) transparentnost podlog, 0-1, privzeto 1, lahko se določi na mapah in kartah
G: (string) pravice za uporabo v online načinu: z vejico ločen seznam security tagov, vsi = '*', nihče = '-'; dodatne natančnejše pravice za prikaz pa so lahko nastavljene tudi v tematiki
H: (string) pravice za uporabo v offline načinu: velja enako kot pri (G)
Tako ustvarimo nov element (referenca nanj je v spremenljivki WI).

Če gre za element, ki predstavlja skupino elementov, ne potrebujemo narediti nič več.
Če gre za element, ki je povezan s piramido, to storimo z WI.SetPyramid('koda piramide')
<source>WI.SetPyramid('dof2018')</source>
Če gre za element, ki je povezan s spletnimi kartami, to storimo z WI.SetTms('koda spletnih kart')
<source>WI.SetTms('gm-s')</source>
Če gre za element, ki je povezan s temo/temami tematke, to storimo z WI.SetDrawItem('alias teme/tem')
<source>WI.SetDrawItem('parcele')</source>

Priporočamo striktno poravnavanje parametrov po kolonah, da se ohrani preglednost.

<source>
Dim WI As TWebItem

WI = WebServer.AddWebItem('', 'g-maps', 'Osnovne karte', '', True, 1.0, '*', '*')
WI = WebServer.AddWebItem('g-maps', 'm:gm-m', 'Google Maps', 'Google', False, 1.0, '*', '-') WI.SetTms('GM-M')
WI = WebServer.AddWebItem('g-maps', 'm:dof', 'DOF Slovenija', 'GURS', True, 1.0, '*', '*') WI.SetPyramid('DOF-GURS')
WI = WebServer.AddWebItem('g-maps', 'm:dmr', 'DMR Slovenija', 'GURS', False, 1.0, '*', '-') WI.SetPyramid('DMR-GURS')

WI = WebServer.AddWebItem('', 'g-sp', 'Splošne vsebine', '', True, 1.0, '*', '-')
WI = WebServer.AddWebItem('g-sp', 'dkn', 'Dkn', 'pa', False, 1.0, '*', '-') WI.SetDrawItem('dkn')
WI = WebServer.AddWebItem('g-sp', 'op', 'Opombe', 'op', True, 1.0, '*', '*') WI.SetDrawItem('op')
</source>

== 2018: Offline podloge ==
Novost je možnost uporabe podlog (piramide) v offline načinu.

Za to je treba elementu piramide določiti:
pravico offline uporabe(parameter H), ne pozabite tudi za nadrejene skupine
relevantno območje, kar je izjemno pomembno narediti pravilno, da se čimbolj omeji količina potrebnih kart za prenos v cache

Definicija relevantnega območja se določa za vse offline pologe enotno z ukazom WebServer.AddOfflineArea([plast], 'opcijski filter', offset, minpixdim).
<source>
WebServer.AddOfflineArea([plast poligonov], 'filter', 0, 0)
WebServer.AddOfflineArea([plast linij], 'filter', 50, 0)
WebServer.AddOfflineArea([plast točk], 'filter', 200, 0)
</source>
Vsakokrat, ko se ta defincija spremeni, je potrebno izvesti preračun relevantnega območja s klicom povezave "http://streznik/api/2018/prepareofflinemapsinfo"

== 2018: Offline podatki ==
Novost je možnost uporabe podatkov v offline načinu.

Za to je treba elementu teme določiti:
pravico offline uporabe(parameter H), tudi za nadrejene skupine
povezavo na dejanske podatke z ukazom '''WI.SetOfflineData([plast], 'iskanje')'''

<source>WI.SetOfflineData([parcele], 'Default')</source>

V sami plasti je potrebno dodati polja, ki določajo, kako se podatki v offline načinu izrisujejo.

Za točke: polje '''offline-icon''' z definicijo '''"ime simbola;font mi ali fa;velikost v px;stil n ali b;barva simbola;opcijska sirina sence v px;opcijska barva sence"'''
Za polilinije: polje '''offline-line''' z definicijo '''"debelina linije v px;barva linije"'''
Za poligone: polje '''offline-fill''' z definicijo '''"barva polnjenja;debelina linije v px;barva linije"'''
Za napise: polje '''offline-text''' z definicijo '''"napis;Roboto;velikost v px;stil n ali b;barva napisa;sirina sence v px;barva sence"'''

Za zoom: polje '''offline-zoom-offset''' z definicijo '''"offset za zoom"'''

Za font simbolov se lahko vnese '''mi''' za Material Icons [https://material.io/tools/icons/?style=baseline] ali '''fa''' za FontAwesome [https://origin.fontawesome.com/icons].

Za barve se lahko vnese katerakoli veljavna CSS notacija [https://www.w3schools.com/cssref/css_colors.asp]: LightRed, #FF0000, rgb(255,0,0), rgba(255,0,0,1.0).

<source>
offline-icon "lens;mi;8;n;red;2;white"
offline-line "4;yellow"
offline-fill "rgba(0,0,255,0.5);1;blue"
offline-text "napis;Roboto;12;n;green;2;white"
</source>

== Napredne nastavitve ==

Ob prijavi lahko določene nastavitve spremenimo glede na prijavljenega uporabnika. To storimo tako, da dodamo novo proceduro:
<source>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</source>

== Priprava tematike ==
Tematiko se pripravi kot sicer. Izjemnega pomena pa je, da se tematika v vseh merilih in z vsemi vključenimi temami vedno izriše hitro, torej v rangu recimo 3 sekund (kar je že precej). Optimalno bi bilo 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 ta tema vklopi/izklopi. Če tema nima oznake, se nikoli ne prikaže. Če želimo temo prikazati vedno, vnesemo za znak '''*'''.

==== Atribut: View tags ====
Namen tega atributa je omejevanje vpogleda v podatke glede na uporabnika.

==== Atribut: Web info ====
V tem atributu določimo prej omenjene skupine. To storimo večvrstično v naslednji obliki:
<source>item=karte
name=Pregledne karte
sort=1
show=1
hint=...
icon=a.gif</source>
Vsaka oznaka se mora pojaviti natanko v eni temi, ni pomembno kateri. Iz teh informacij se potem generira menu za vklop/izklop v spletni aplikaciji. Prve štiri vrstice so obvezne.

== Priprava iskanj in izpisov ==
Iskanje po poljubnih podatkih se pripravi v urejevalniku podatkovne plasti (Searches). V modulu SdmsWSP pa z ukazom AddSearch dodajamo le tiste, ki jih želimo uporabljati v spletni aplikaciji.
...

== Nastavljanje pravic ==
Pri spletni aplikaciji je možno nastaviti različne nivoje dostopa (izris na karti, iskanje, izpis podatkov) glede na prijavljenega uporabnika.

V ta namen se uporablja kratke oznake, ki jih umenujemo '''Security tags'''.

=== Dodeljevanje pravic===
Te oznake se za uporabnika določa v urejevalniku uporabnika oz. v urejevalniku skupine uporabnikov (možno je tudi v varnostnem središču).

Vsak uporabnik/skupina ima lahko določenih več oznak, ki so ločene z vejico.

Uporabnik poleg svojih oznak dobi tudi vse oznake vseh skupin, v katerih je član.

=== Omejevanje pravic===
Na splošno velja naslednje:
*za vpoglede (tematika, vpogled preko iskanja/klika) velja, da če oznaka ni določena, imajo vpogled vsi, sicer pa samo tisti z oznako,
*za urejanja (dodajanje, popravljanje, brisanje) velja, da če oznaka ni določena, ne more urejati nihče, sicer pa samo tisti z oznako.

Pravice se omejuje:
*v tematiki:
**v atributu teme View tags
**v atrubutu teme Web info, v vrstici view=

*pri definiciji iskanja v podatkovni plasti:
**View access
**Append access
**Update access
**Delete access
**View in Update access pri posameznih poljih

*v SDMS Basicu, ukaz je MatchSecurityTags.

Vedno lahko določimo tudi več oznak, ločenih z vejico.

== TODO ==
*SQL pogoj filtra, uporabljenega v searchu se ne upošteva pri kliku
*dvonivojski sistem pri vsebinah za izris
*multiple datasete pri maski (vsaj view)
*images naj dela tudi za spisek datotek (RO)

== 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.* ===
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.

=== SEARCH.DLL ===
Izvede splošno iskanje po (full text search) in vrne zadetke.
:query=KLJUČNE BESEDE
::seznam ključnih besed za iskanje, ločenih s presledki
:category=KAT1,KAT2,KAT3
::seznam kategorij, po katerih se vrši iskanje (če je prazen, se vrši po vseh)
:hits=10
::maksimalno število zadetkov
:template=JSON
::ime templata, ki opredeljuje obliko zadetkov
AddSearch ...
Pred iskanjem se zažene še OnWebSearch...

SDMS WebServer

2019-01-30T13:49:15Z

Janez Trtnik: /* 2018: Tematika */

__NOTOC__
[[Kategorije: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'''
*za uporabo varnih povezav (https) se namesti certifikat strežnika, za navodila glej spodaj
*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
*nikakor ne smete pozabiti omogočiti uporabo želenih vrat (80, 443, ...) v požarnem zidu.

Strežnik je sedaj nameščen in zagnan.

=== Namestitev certifikata ===
Če se bo uporabljala varna povezava (https), je potrebno pridobiti in namestiti tudi certifikat strežnika. Pripravi se mapo, na katero se bo kopiral certifikat, lahko pa se ga kopira tudi kar na mapo programa. Pripravi se naslednje ASCII datoteke:
*'''''root.pem''''' - certifikat verifikacijskega strežnika
*'''''cert.pem''''' - certifikat strežnika
*'''''key.pem''''' - zakodiran privatni ključ strežnika
*'''''password.txt''''' - geslo za dekodiranje privatnega ključa

<source>
openssl pkcs12 -in xxx.pfx -out root.pem -cacerts // brez izhodnega gesla
openssl pkcs12 -in xxx.pfx -out certandkey.pem -clcerts // vnesi geslo za key, razbij na dve datoteki: cert.pem in key.pem
Geslo kodiraj z EncryptPassord in shrani v password.txt takole: ENCRYPTED:geslo
</source>

Kasneje se v modulu določi tudi pot do datotek certifikata.

== Aktivacija ==
'''SDMS WebServer''' se aktivira tako, da se v SDMS raziskovalcu doda nov modul z imenom '''SdmsWSP''' in naslednjo vsebino:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', '')
WebServer.Start
...
EndSub</source>

Če želimo dodati tudi dostop preko varne povezave (https), to storimo takole:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath)
WebServer.Start
...
EndSub</source>

Če želimo zagotoviti uporabo varne povezave (https) in izvesti samodejno preusmeritev nanjo:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http').SetRedirect('https://www.test.si/')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath + 'Certifikat\')
WebServer.Start
...
EndSub</source>

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

== Osnovne nastavitve ==
Strežniku moramo podati ime, ki se prikaže kot naslov strani. Uporablja se tudi kot identifikacija strežnika, če je ta potrebna.
<source>WebServer.Name = 'TEST'</source>
Ob prijavi se uporabniku prikaže logotip velikosti 480x120 pik. Datoteko se shrani na mapo WebServer in takole poda njeno ime.
<source>WebServer.Logo = 'logo.png'</source>

Privzeto dopušča SDMS WebServer dostop samo SDMS uporabnikom. Če želimo dodati tudi možnost anonimnega dostopa, to storimo tako:
<source>WebServer.User = [Gost]</source>
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.
<source>WebServer.Window = '370000,25000,630000,200000'</source>

Določiti je treba tematiko, ki se bo uporabljala za izris.
<source>WebServer.DrawList = [Web Tematika]</source>

Dodati je treba plasti, po katerih za izvaja iskanje in izpis podatkov.
<source>WebServer.AddSearch([Plast A].Search('Default'))
WebServer.AddSearch([Plast B].Search('Default'))</source>

Dobro je dodati tudi seznam priljubljenih lokacij, ki so dostopne iz menija.
<source>WebServer.AddLocation('Slovenija', '370000,25000,630000,200000', '')
WebServer.AddLocation('Ljubljana', '370000,25000,630000,200000', '')
WebServer.AddLocation('Maribor', '370000,25000,630000,200000', '')</source>

Možno je dodati tudi seznam dodatnih povezav, ki so ravno tako dostopne iz menija.
<source>WebServer.AddLink('Softdata Home Page', 'http://www.softdata.si', '')</source>

Dodamo tudi seznam dodatnih izrisov za tiskanje.
<source>WebServer.AddLayout([A4 Pokončno], '')
WebServer.AddLayout([A4 Ležeče], '')</source>

== 2018: Splošna dodatna opravila ==
Na mapi Database\WebServer se ustvari novo mapo 2018.

Nanjo se prekopira logo-*.png datoteke, ki so bile pri stari aplikaciji na rootu.

Nanjo se prekopira custom.js in custom.css iz mape SDMSWSP\WebServer\2018 in se ju primerno prilagodi.

== 2018: Tematika ==
Tematika za novo aplikacijo se pripravi kot prej, le da se v njej ne vnaša polja 'Informacije za web'. To polje se ignorira. Še vedno pa se uporabljata polji 'Dodatno ime' (obvezno) in 'Pravice' (opcijsko).

Kar je bilo prej določeno v informacijah za web, se sedaj določa v modulu SDMSWSP v funkciji OnCreate z dodajanjem elementov tipa TWebItem.

Obstaja tudi SDMS basic funkcija ConvertWebInfo, ki prenese stare informacije za web iz tematike v clipboard.

Tudi WebServer.AddPyramid ukazi se v novi aplikaciji ignorirajo, tako da je treba piramid dodati ročno.

<source>
WI = WebServer.AddWebItem(A, B, C, D, E, F, G, H)
</source>
Parametri funkcije AddWebItem
A: (string) koda mape, na katero želimo vstaviti dani element, prazen string za root
B: (string) koda elementa, ki mora biti unikatna(!); za 'radio gumbe' se doda predpona xxx:, kjer je xxx ime skupine gumbov, vsaka grupa gumbov naj ima natanko en gump privzeto viden (E)
C: (string) ime elementa (napis)
D: (string) legenda za dani element, ki naj vsebuje tudi copyright informacijo, lahko v HTML obliki
E: (boolean) privzeta vidnost elementa
F: (double) transparentnost podlog, 0-1, privzeto 1, lahko se določi na mapah in kartah
G: (string) pravice za uporabo v online načinu: z vejico ločen seznam security tagov, vsi = '*', nihče = '-'; dodatne natančnejše pravice za prikaz pa so lahko nastavljene tudi v tematiki
H: (string) pravice za uporabo v offline načinu: velja enako kot pri (G)
Tako ustvarimo nov element (referenca nanj je v spremenljivki WI).

Če gre za element, ki predstavlja skupino elementov, ne potrebujemo narediti nič več.
Če gre za element, ki je povezan s piramido, to storimo z WI.SetPyramid('koda piramide')
<source>WI.SetPyramid('dof2018')</source>
Če gre za element, ki je povezan s spletnimi kartami, to storimo z WI.SetTms('koda spletnih kart')
<source>WI.SetTms('gm-s')</source>
Če gre za element, ki je povezan s temo/temami tematke, to storimo z WI.SetDrawItem('alias teme/tem')
<source>WI.SetDrawItem('parcele')</source>

Priporočamo striktno poravnavanje parametrov po kolonah, da se ohrani preglednost.

<source>
Dim WI As TWebItem

WI = WebServer.AddWebItem('', 'g-maps', 'Osnovne karte', '', True, 1.0, '*', '*')
WI = WebServer.AddWebItem('g-maps', 'm:gm-m', 'Google Maps', 'Google', False, 1.0, '*', '-') WI.SetTms('GM-M')
WI = WebServer.AddWebItem('g-maps', 'm:dof', 'DOF Slovenija', 'GURS', True, 1.0, '*', '*') WI.SetPyramid('DOF-GURS')
WI = WebServer.AddWebItem('g-maps', 'm:dmr', 'DMR Slovenija', 'GURS', False, 1.0, '*', '-') WI.SetPyramid('DMR-GURS')

WI = WebServer.AddWebItem('', 'g-sp', 'Splošne vsebine', '', True, 1.0, '*', '-')
WI = WebServer.AddWebItem('g-sp', 'dkn', 'Dkn', 'pa', False, 1.0, '*', '-') WI.SetDrawItem('dkn')
WI = WebServer.AddWebItem('g-sp', 'op', 'Opombe', 'op', True, 1.0, '*', '*') WI.SetDrawItem('op')
</source>

== 2018: Offline podloge ==
Novost je možnost uporabe podlog (piramide) v offline načinu.

Za to je treba elementu piramide določiti:
pravico offline uporabe(parameter H), ne pozabite tudi za nadrejene skupine
relevantno območje, kar je izjemno pomembno narediti pravilno, da se čimbolj omeji količina potrebnih kart za prenos v cache

Definicija relevantnega območja se določa za vse offline pologe enotno z ukazom WebServer.AddOfflineArea([plast], 'opcijski filter', offset, minpixdim).
<source>
WebServer.AddOfflineArea([plast poligonov], 'filter', 0, 0)
WebServer.AddOfflineArea([plast linij], 'filter', 50, 0)
WebServer.AddOfflineArea([plast točk], 'filter', 200, 0)
</source>
Vsakokrat, ko se ta defincija spremeni, je potrebno izvesti preračun relevantnega območja s klicom povezave "http://streznik/api/2018/prepareofflinemapsinfo"

== 2018: Offline podatki ==
Novost je možnost uporabe podatkov v offline načinu.

Za to je treba elementu teme določiti:
pravico offline uporabe(parameter H), tudi za nadrejene skupine
povezavo na dejanske podatke z ukazom '''WI.SetOfflineData([plast], 'iskanje')'''

<source>WI.SetOfflineData([parcele], 'Default')</source>

V sami plasti je potrebno dodati polja, ki določajo, kako se podatki v offline načinu izrisujejo.

Za točke: polje '''offline-icon''' z definicijo '''"ime simbola;font mi ali fa;velikost v px;stil n ali b;barva simbola;opcijska sirina sence v px;opcijska barva sence"'''
Za polilinije: polje '''offline-line''' z definicijo '''"debelina linije v px;barva linije"'''
Za poligone: polje '''offline-fill''' z definicijo '''"barva polnjenja;debelina linije v px;barva linije"'''
Za napise: polje '''offline-text''' z definicijo '''"napis;Roboto;velikost v px;stil n ali b;barva napisa;sirina sence v px;barva sence"'''

Za font simbolov se lahko vnese '''mi''' za Material Icons [https://material.io/tools/icons/?style=baseline] ali '''fa''' za FontAwesome [https://origin.fontawesome.com/icons].

Za barve se lahko vnese katerakoli veljavna CSS notacija [https://www.w3schools.com/cssref/css_colors.asp]: LightRed, #FF0000, rgb(255,0,0), rgba(255,0,0,1.0).

<source>
offline-icon "lens;mi;8;n;red;2;white"
offline-line "4;yellow"
offline-fill "rgba(0,0,255,0.5);1;blue"
offline-text "napis;Roboto;12;n;green;2;white"
</source>

== Napredne nastavitve ==

Ob prijavi lahko določene nastavitve spremenimo glede na prijavljenega uporabnika. To storimo tako, da dodamo novo proceduro:
<source>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</source>

== Priprava tematike ==
Tematiko se pripravi kot sicer. Izjemnega pomena pa je, da se tematika v vseh merilih in z vsemi vključenimi temami vedno izriše hitro, torej v rangu recimo 3 sekund (kar je že precej). Optimalno bi bilo 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 ta tema vklopi/izklopi. Če tema nima oznake, se nikoli ne prikaže. Če želimo temo prikazati vedno, vnesemo za znak '''*'''.

==== Atribut: View tags ====
Namen tega atributa je omejevanje vpogleda v podatke glede na uporabnika.

==== Atribut: Web info ====
V tem atributu določimo prej omenjene skupine. To storimo večvrstično v naslednji obliki:
<source>item=karte
name=Pregledne karte
sort=1
show=1
hint=...
icon=a.gif</source>
Vsaka oznaka se mora pojaviti natanko v eni temi, ni pomembno kateri. Iz teh informacij se potem generira menu za vklop/izklop v spletni aplikaciji. Prve štiri vrstice so obvezne.

== Priprava iskanj in izpisov ==
Iskanje po poljubnih podatkih se pripravi v urejevalniku podatkovne plasti (Searches). V modulu SdmsWSP pa z ukazom AddSearch dodajamo le tiste, ki jih želimo uporabljati v spletni aplikaciji.
...

== Nastavljanje pravic ==
Pri spletni aplikaciji je možno nastaviti različne nivoje dostopa (izris na karti, iskanje, izpis podatkov) glede na prijavljenega uporabnika.

V ta namen se uporablja kratke oznake, ki jih umenujemo '''Security tags'''.

=== Dodeljevanje pravic===
Te oznake se za uporabnika določa v urejevalniku uporabnika oz. v urejevalniku skupine uporabnikov (možno je tudi v varnostnem središču).

Vsak uporabnik/skupina ima lahko določenih več oznak, ki so ločene z vejico.

Uporabnik poleg svojih oznak dobi tudi vse oznake vseh skupin, v katerih je član.

=== Omejevanje pravic===
Na splošno velja naslednje:
*za vpoglede (tematika, vpogled preko iskanja/klika) velja, da če oznaka ni določena, imajo vpogled vsi, sicer pa samo tisti z oznako,
*za urejanja (dodajanje, popravljanje, brisanje) velja, da če oznaka ni določena, ne more urejati nihče, sicer pa samo tisti z oznako.

Pravice se omejuje:
*v tematiki:
**v atributu teme View tags
**v atrubutu teme Web info, v vrstici view=

*pri definiciji iskanja v podatkovni plasti:
**View access
**Append access
**Update access
**Delete access
**View in Update access pri posameznih poljih

*v SDMS Basicu, ukaz je MatchSecurityTags.

Vedno lahko določimo tudi več oznak, ločenih z vejico.

== TODO ==
*SQL pogoj filtra, uporabljenega v searchu se ne upošteva pri kliku
*dvonivojski sistem pri vsebinah za izris
*multiple datasete pri maski (vsaj view)
*images naj dela tudi za spisek datotek (RO)

== 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.* ===
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.

=== SEARCH.DLL ===
Izvede splošno iskanje po (full text search) in vrne zadetke.
:query=KLJUČNE BESEDE
::seznam ključnih besed za iskanje, ločenih s presledki
:category=KAT1,KAT2,KAT3
::seznam kategorij, po katerih se vrši iskanje (če je prazen, se vrši po vseh)
:hits=10
::maksimalno število zadetkov
:template=JSON
::ime templata, ki opredeljuje obliko zadetkov
AddSearch ...
Pred iskanjem se zažene še OnWebSearch...

SDMS WebServer

2019-01-30T12:50:06Z

Janez Trtnik: /* 2018: Offline podatki */

__NOTOC__
[[Kategorije: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'''
*za uporabo varnih povezav (https) se namesti certifikat strežnika, za navodila glej spodaj
*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
*nikakor ne smete pozabiti omogočiti uporabo želenih vrat (80, 443, ...) v požarnem zidu.

Strežnik je sedaj nameščen in zagnan.

=== Namestitev certifikata ===
Če se bo uporabljala varna povezava (https), je potrebno pridobiti in namestiti tudi certifikat strežnika. Pripravi se mapo, na katero se bo kopiral certifikat, lahko pa se ga kopira tudi kar na mapo programa. Pripravi se naslednje ASCII datoteke:
*'''''root.pem''''' - certifikat verifikacijskega strežnika
*'''''cert.pem''''' - certifikat strežnika
*'''''key.pem''''' - zakodiran privatni ključ strežnika
*'''''password.txt''''' - geslo za dekodiranje privatnega ključa

<source>
openssl pkcs12 -in xxx.pfx -out root.pem -cacerts // brez izhodnega gesla
openssl pkcs12 -in xxx.pfx -out certandkey.pem -clcerts // vnesi geslo za key, razbij na dve datoteki: cert.pem in key.pem
Geslo kodiraj z EncryptPassord in shrani v password.txt takole: ENCRYPTED:geslo
</source>

Kasneje se v modulu določi tudi pot do datotek certifikata.

== Aktivacija ==
'''SDMS WebServer''' se aktivira tako, da se v SDMS raziskovalcu doda nov modul z imenom '''SdmsWSP''' in naslednjo vsebino:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', '')
WebServer.Start
...
EndSub</source>

Če želimo dodati tudi dostop preko varne povezave (https), to storimo takole:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath)
WebServer.Start
...
EndSub</source>

Če želimo zagotoviti uporabo varne povezave (https) in izvesti samodejno preusmeritev nanjo:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http').SetRedirect('https://www.test.si/')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath + 'Certifikat\')
WebServer.Start
...
EndSub</source>

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

== Osnovne nastavitve ==
Strežniku moramo podati ime, ki se prikaže kot naslov strani. Uporablja se tudi kot identifikacija strežnika, če je ta potrebna.
<source>WebServer.Name = 'TEST'</source>
Ob prijavi se uporabniku prikaže logotip velikosti 480x120 pik. Datoteko se shrani na mapo WebServer in takole poda njeno ime.
<source>WebServer.Logo = 'logo.png'</source>

Privzeto dopušča SDMS WebServer dostop samo SDMS uporabnikom. Če želimo dodati tudi možnost anonimnega dostopa, to storimo tako:
<source>WebServer.User = [Gost]</source>
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.
<source>WebServer.Window = '370000,25000,630000,200000'</source>

Določiti je treba tematiko, ki se bo uporabljala za izris.
<source>WebServer.DrawList = [Web Tematika]</source>

Dodati je treba plasti, po katerih za izvaja iskanje in izpis podatkov.
<source>WebServer.AddSearch([Plast A].Search('Default'))
WebServer.AddSearch([Plast B].Search('Default'))</source>

Dobro je dodati tudi seznam priljubljenih lokacij, ki so dostopne iz menija.
<source>WebServer.AddLocation('Slovenija', '370000,25000,630000,200000', '')
WebServer.AddLocation('Ljubljana', '370000,25000,630000,200000', '')
WebServer.AddLocation('Maribor', '370000,25000,630000,200000', '')</source>

Možno je dodati tudi seznam dodatnih povezav, ki so ravno tako dostopne iz menija.
<source>WebServer.AddLink('Softdata Home Page', 'http://www.softdata.si', '')</source>

Dodamo tudi seznam dodatnih izrisov za tiskanje.
<source>WebServer.AddLayout([A4 Pokončno], '')
WebServer.AddLayout([A4 Ležeče], '')</source>

== 2018: Splošna dodatna opravila ==
Na mapi Database\WebServer se ustvari novo mapo 2018.

Nanjo se prekopira logo-*.png datoteke, ki so bile pri stari aplikaciji na rootu.

Nanjo se prekopira custom.js in custom.css iz mape SDMSWSP\WebServer\2018 in se ju primerno prilagodi.

== 2018: Tematika ==
Tematika za novo aplikacijo se pripravi kot prej, le da se v njej ne vnaša polja 'Informacije za web'. To polje se ignorira. Še vedno pa se uporabljata polji 'Dodatno ime' (obvezno) in 'Pravice' (opcijsko).

Kar je bilo prej določeno v informacijah za web, se sedaj določa v modulu SDMSWSP v funkciji OnCreate z dodajanjem elementov tipa TWebItem.

Obstaja tudi SDMS basic funkcija ConvertWebInfo, ki prenese stare informacije za web iz tematike v clipboard.
<source>
WI = WebServer.AddWebItem(A, B, C, D, E, F, G, H)
</source>
Parametri funkcije AddWebItem
A: (string) koda mape, na katero želimo vstaviti dani element, prazen string za root
B: (string) koda elementa, ki mora biti unikatna(!); za 'radio gumbe' se doda predpona xxx:, kjer je xxx ime skupine gumbov, vsaka grupa gumbov naj ima natanko en gump privzeto viden (E)
C: (string) ime elementa (napis)
D: (string) legenda za dani element, ki naj vsebuje tudi copyright informacijo, lahko v HTML obliki
E: (boolean) privzeta vidnost elementa
F: (double) transparentnost podlog, 0-1, privzeto 1, lahko se določi na mapah in kartah
G: (string) pravice za uporabo v online načinu: z vejico ločen seznam security tagov, vsi = '*', nihče = '-'; dodatne natančnejše pravice za prikaz pa so lahko nastavljene tudi v tematiki
H: (string) pravice za uporabo v offline načinu: velja enako kot pri (G)
Tako ustvarimo nov element (referenca nanj je v spremenljivki WI).

Če gre za element, ki predstavlja skupino elementov, ne potrebujemo narediti nič več.
Če gre za element, ki je povezan s piramido, to storimo z WI.SetPyramid('koda piramide')
<source>WI.SetPyramid('dof2018')</source>
Če gre za element, ki je povezan s spletnimi kartami, to storimo z WI.SetTms('koda spletnih kart')
<source>WI.SetTms('gm-s')</source>
Če gre za element, ki je povezan s temo/temami tematke, to storimo z WI.SetDrawItem('alias teme/tem')
<source>WI.SetDrawItem('parcele')</source>

Priporočamo striktno poravnavanje parametrov po kolonah, da se ohrani preglednost.

<source>
Dim WI As TWebItem

WI = WebServer.AddWebItem('', 'g-maps', 'Osnovne karte', '', True, 1.0, '*', '*')
WI = WebServer.AddWebItem('g-maps', 'm:gm-m', 'Google Maps', 'Google', False, 1.0, '*', '-') WI.SetTms('GM-M')
WI = WebServer.AddWebItem('g-maps', 'm:dof', 'DOF Slovenija', 'GURS', True, 1.0, '*', '*') WI.SetPyramid('DOF-GURS')
WI = WebServer.AddWebItem('g-maps', 'm:dmr', 'DMR Slovenija', 'GURS', False, 1.0, '*', '-') WI.SetPyramid('DMR-GURS')

WI = WebServer.AddWebItem('', 'g-sp', 'Splošne vsebine', '', True, 1.0, '*', '-')
WI = WebServer.AddWebItem('g-sp', 'dkn', 'Dkn', 'pa', False, 1.0, '*', '-') WI.SetDrawItem('dkn')
WI = WebServer.AddWebItem('g-sp', 'op', 'Opombe', 'op', True, 1.0, '*', '*') WI.SetDrawItem('op')
</source>

== 2018: Offline podloge ==
Novost je možnost uporabe podlog (piramide) v offline načinu.

Za to je treba elementu piramide določiti:
pravico offline uporabe(parameter H), ne pozabite tudi za nadrejene skupine
relevantno območje, kar je izjemno pomembno narediti pravilno, da se čimbolj omeji količina potrebnih kart za prenos v cache

Definicija relevantnega območja se določa za vse offline pologe enotno z ukazom WebServer.AddOfflineArea([plast], 'opcijski filter', offset, minpixdim).
<source>
WebServer.AddOfflineArea([plast poligonov], 'filter', 0, 0)
WebServer.AddOfflineArea([plast linij], 'filter', 50, 0)
WebServer.AddOfflineArea([plast točk], 'filter', 200, 0)
</source>
Vsakokrat, ko se ta defincija spremeni, je potrebno izvesti preračun relevantnega območja s klicom povezave "http://streznik/api/2018/prepareofflinemapsinfo"

== 2018: Offline podatki ==
Novost je možnost uporabe podatkov v offline načinu.

Za to je treba elementu teme določiti:
pravico offline uporabe(parameter H), tudi za nadrejene skupine
povezavo na dejanske podatke z ukazom '''WI.SetOfflineData([plast], 'iskanje')'''

<source>WI.SetOfflineData([parcele], 'Default')</source>

V sami plasti je potrebno dodati polja, ki določajo, kako se podatki v offline načinu izrisujejo.

Za točke: polje '''offline-icon''' z definicijo '''"ime simbola;font mi ali fa;velikost v px;stil n ali b;barva simbola;opcijska sirina sence v px;opcijska barva sence"'''
Za polilinije: polje '''offline-line''' z definicijo '''"debelina linije v px;barva linije"'''
Za poligone: polje '''offline-fill''' z definicijo '''"barva polnjenja;debelina linije v px;barva linije"'''
Za napise: polje '''offline-text''' z definicijo '''"napis;Roboto;velikost v px;stil n ali b;barva napisa;sirina sence v px;barva sence"'''

Za font simbolov se lahko vnese '''mi''' za Material Icons [https://material.io/tools/icons/?style=baseline] ali '''fa''' za FontAwesome [https://origin.fontawesome.com/icons].

Za barve se lahko vnese katerakoli veljavna CSS notacija [https://www.w3schools.com/cssref/css_colors.asp]: LightRed, #FF0000, rgb(255,0,0), rgba(255,0,0,1.0).

<source>
offline-icon "lens;mi;8;n;red;2;white"
offline-line "4;yellow"
offline-fill "rgba(0,0,255,0.5);1;blue"
offline-text "napis;Roboto;12;n;green;2;white"
</source>

== Napredne nastavitve ==

Ob prijavi lahko določene nastavitve spremenimo glede na prijavljenega uporabnika. To storimo tako, da dodamo novo proceduro:
<source>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</source>

== Priprava tematike ==
Tematiko se pripravi kot sicer. Izjemnega pomena pa je, da se tematika v vseh merilih in z vsemi vključenimi temami vedno izriše hitro, torej v rangu recimo 3 sekund (kar je že precej). Optimalno bi bilo 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 ta tema vklopi/izklopi. Če tema nima oznake, se nikoli ne prikaže. Če želimo temo prikazati vedno, vnesemo za znak '''*'''.

==== Atribut: View tags ====
Namen tega atributa je omejevanje vpogleda v podatke glede na uporabnika.

==== Atribut: Web info ====
V tem atributu določimo prej omenjene skupine. To storimo večvrstično v naslednji obliki:
<source>item=karte
name=Pregledne karte
sort=1
show=1
hint=...
icon=a.gif</source>
Vsaka oznaka se mora pojaviti natanko v eni temi, ni pomembno kateri. Iz teh informacij se potem generira menu za vklop/izklop v spletni aplikaciji. Prve štiri vrstice so obvezne.

== Priprava iskanj in izpisov ==
Iskanje po poljubnih podatkih se pripravi v urejevalniku podatkovne plasti (Searches). V modulu SdmsWSP pa z ukazom AddSearch dodajamo le tiste, ki jih želimo uporabljati v spletni aplikaciji.
...

== Nastavljanje pravic ==
Pri spletni aplikaciji je možno nastaviti različne nivoje dostopa (izris na karti, iskanje, izpis podatkov) glede na prijavljenega uporabnika.

V ta namen se uporablja kratke oznake, ki jih umenujemo '''Security tags'''.

=== Dodeljevanje pravic===
Te oznake se za uporabnika določa v urejevalniku uporabnika oz. v urejevalniku skupine uporabnikov (možno je tudi v varnostnem središču).

Vsak uporabnik/skupina ima lahko določenih več oznak, ki so ločene z vejico.

Uporabnik poleg svojih oznak dobi tudi vse oznake vseh skupin, v katerih je član.

=== Omejevanje pravic===
Na splošno velja naslednje:
*za vpoglede (tematika, vpogled preko iskanja/klika) velja, da če oznaka ni določena, imajo vpogled vsi, sicer pa samo tisti z oznako,
*za urejanja (dodajanje, popravljanje, brisanje) velja, da če oznaka ni določena, ne more urejati nihče, sicer pa samo tisti z oznako.

Pravice se omejuje:
*v tematiki:
**v atributu teme View tags
**v atrubutu teme Web info, v vrstici view=

*pri definiciji iskanja v podatkovni plasti:
**View access
**Append access
**Update access
**Delete access
**View in Update access pri posameznih poljih

*v SDMS Basicu, ukaz je MatchSecurityTags.

Vedno lahko določimo tudi več oznak, ločenih z vejico.

== TODO ==
*SQL pogoj filtra, uporabljenega v searchu se ne upošteva pri kliku
*dvonivojski sistem pri vsebinah za izris
*multiple datasete pri maski (vsaj view)
*images naj dela tudi za spisek datotek (RO)

== 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.* ===
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.

=== SEARCH.DLL ===
Izvede splošno iskanje po (full text search) in vrne zadetke.
:query=KLJUČNE BESEDE
::seznam ključnih besed za iskanje, ločenih s presledki
:category=KAT1,KAT2,KAT3
::seznam kategorij, po katerih se vrši iskanje (če je prazen, se vrši po vseh)
:hits=10
::maksimalno število zadetkov
:template=JSON
::ime templata, ki opredeljuje obliko zadetkov
AddSearch ...
Pred iskanjem se zažene še OnWebSearch...

SDMS WebServer

2019-01-30T12:49:42Z

Janez Trtnik: /* 2018: Tematika */

__NOTOC__
[[Kategorije: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'''
*za uporabo varnih povezav (https) se namesti certifikat strežnika, za navodila glej spodaj
*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
*nikakor ne smete pozabiti omogočiti uporabo želenih vrat (80, 443, ...) v požarnem zidu.

Strežnik je sedaj nameščen in zagnan.

=== Namestitev certifikata ===
Če se bo uporabljala varna povezava (https), je potrebno pridobiti in namestiti tudi certifikat strežnika. Pripravi se mapo, na katero se bo kopiral certifikat, lahko pa se ga kopira tudi kar na mapo programa. Pripravi se naslednje ASCII datoteke:
*'''''root.pem''''' - certifikat verifikacijskega strežnika
*'''''cert.pem''''' - certifikat strežnika
*'''''key.pem''''' - zakodiran privatni ključ strežnika
*'''''password.txt''''' - geslo za dekodiranje privatnega ključa

<source>
openssl pkcs12 -in xxx.pfx -out root.pem -cacerts // brez izhodnega gesla
openssl pkcs12 -in xxx.pfx -out certandkey.pem -clcerts // vnesi geslo za key, razbij na dve datoteki: cert.pem in key.pem
Geslo kodiraj z EncryptPassord in shrani v password.txt takole: ENCRYPTED:geslo
</source>

Kasneje se v modulu določi tudi pot do datotek certifikata.

== Aktivacija ==
'''SDMS WebServer''' se aktivira tako, da se v SDMS raziskovalcu doda nov modul z imenom '''SdmsWSP''' in naslednjo vsebino:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', '')
WebServer.Start
...
EndSub</source>

Če želimo dodati tudi dostop preko varne povezave (https), to storimo takole:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath)
WebServer.Start
...
EndSub</source>

Če želimo zagotoviti uporabo varne povezave (https) in izvesti samodejno preusmeritev nanjo:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http').SetRedirect('https://www.test.si/')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath + 'Certifikat\')
WebServer.Start
...
EndSub</source>

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

== Osnovne nastavitve ==
Strežniku moramo podati ime, ki se prikaže kot naslov strani. Uporablja se tudi kot identifikacija strežnika, če je ta potrebna.
<source>WebServer.Name = 'TEST'</source>
Ob prijavi se uporabniku prikaže logotip velikosti 480x120 pik. Datoteko se shrani na mapo WebServer in takole poda njeno ime.
<source>WebServer.Logo = 'logo.png'</source>

Privzeto dopušča SDMS WebServer dostop samo SDMS uporabnikom. Če želimo dodati tudi možnost anonimnega dostopa, to storimo tako:
<source>WebServer.User = [Gost]</source>
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.
<source>WebServer.Window = '370000,25000,630000,200000'</source>

Določiti je treba tematiko, ki se bo uporabljala za izris.
<source>WebServer.DrawList = [Web Tematika]</source>

Dodati je treba plasti, po katerih za izvaja iskanje in izpis podatkov.
<source>WebServer.AddSearch([Plast A].Search('Default'))
WebServer.AddSearch([Plast B].Search('Default'))</source>

Dobro je dodati tudi seznam priljubljenih lokacij, ki so dostopne iz menija.
<source>WebServer.AddLocation('Slovenija', '370000,25000,630000,200000', '')
WebServer.AddLocation('Ljubljana', '370000,25000,630000,200000', '')
WebServer.AddLocation('Maribor', '370000,25000,630000,200000', '')</source>

Možno je dodati tudi seznam dodatnih povezav, ki so ravno tako dostopne iz menija.
<source>WebServer.AddLink('Softdata Home Page', 'http://www.softdata.si', '')</source>

Dodamo tudi seznam dodatnih izrisov za tiskanje.
<source>WebServer.AddLayout([A4 Pokončno], '')
WebServer.AddLayout([A4 Ležeče], '')</source>

== 2018: Splošna dodatna opravila ==
Na mapi Database\WebServer se ustvari novo mapo 2018.

Nanjo se prekopira logo-*.png datoteke, ki so bile pri stari aplikaciji na rootu.

Nanjo se prekopira custom.js in custom.css iz mape SDMSWSP\WebServer\2018 in se ju primerno prilagodi.

== 2018: Tematika ==
Tematika za novo aplikacijo se pripravi kot prej, le da se v njej ne vnaša polja 'Informacije za web'. To polje se ignorira. Še vedno pa se uporabljata polji 'Dodatno ime' (obvezno) in 'Pravice' (opcijsko).

Kar je bilo prej določeno v informacijah za web, se sedaj določa v modulu SDMSWSP v funkciji OnCreate z dodajanjem elementov tipa TWebItem.

Obstaja tudi SDMS basic funkcija ConvertWebInfo, ki prenese stare informacije za web iz tematike v clipboard.
<source>
WI = WebServer.AddWebItem(A, B, C, D, E, F, G, H)
</source>
Parametri funkcije AddWebItem
A: (string) koda mape, na katero želimo vstaviti dani element, prazen string za root
B: (string) koda elementa, ki mora biti unikatna(!); za 'radio gumbe' se doda predpona xxx:, kjer je xxx ime skupine gumbov, vsaka grupa gumbov naj ima natanko en gump privzeto viden (E)
C: (string) ime elementa (napis)
D: (string) legenda za dani element, ki naj vsebuje tudi copyright informacijo, lahko v HTML obliki
E: (boolean) privzeta vidnost elementa
F: (double) transparentnost podlog, 0-1, privzeto 1, lahko se določi na mapah in kartah
G: (string) pravice za uporabo v online načinu: z vejico ločen seznam security tagov, vsi = '*', nihče = '-'; dodatne natančnejše pravice za prikaz pa so lahko nastavljene tudi v tematiki
H: (string) pravice za uporabo v offline načinu: velja enako kot pri (G)
Tako ustvarimo nov element (referenca nanj je v spremenljivki WI).

Če gre za element, ki predstavlja skupino elementov, ne potrebujemo narediti nič več.
Če gre za element, ki je povezan s piramido, to storimo z WI.SetPyramid('koda piramide')
<source>WI.SetPyramid('dof2018')</source>
Če gre za element, ki je povezan s spletnimi kartami, to storimo z WI.SetTms('koda spletnih kart')
<source>WI.SetTms('gm-s')</source>
Če gre za element, ki je povezan s temo/temami tematke, to storimo z WI.SetDrawItem('alias teme/tem')
<source>WI.SetDrawItem('parcele')</source>

Priporočamo striktno poravnavanje parametrov po kolonah, da se ohrani preglednost.

<source>
Dim WI As TWebItem

WI = WebServer.AddWebItem('', 'g-maps', 'Osnovne karte', '', True, 1.0, '*', '*')
WI = WebServer.AddWebItem('g-maps', 'm:gm-m', 'Google Maps', 'Google', False, 1.0, '*', '-') WI.SetTms('GM-M')
WI = WebServer.AddWebItem('g-maps', 'm:dof', 'DOF Slovenija', 'GURS', True, 1.0, '*', '*') WI.SetPyramid('DOF-GURS')
WI = WebServer.AddWebItem('g-maps', 'm:dmr', 'DMR Slovenija', 'GURS', False, 1.0, '*', '-') WI.SetPyramid('DMR-GURS')

WI = WebServer.AddWebItem('', 'g-sp', 'Splošne vsebine', '', True, 1.0, '*', '-')
WI = WebServer.AddWebItem('g-sp', 'dkn', 'Dkn', 'pa', False, 1.0, '*', '-') WI.SetDrawItem('dkn')
WI = WebServer.AddWebItem('g-sp', 'op', 'Opombe', 'op', True, 1.0, '*', '*') WI.SetDrawItem('op')
</source>

== 2018: Offline podloge ==
Novost je možnost uporabe podlog (piramide) v offline načinu.

Za to je treba elementu piramide določiti:
pravico offline uporabe(parameter H), ne pozabite tudi za nadrejene skupine
relevantno območje, kar je izjemno pomembno narediti pravilno, da se čimbolj omeji količina potrebnih kart za prenos v cache

Definicija relevantnega območja se določa za vse offline pologe enotno z ukazom WebServer.AddOfflineArea([plast], 'opcijski filter', offset, minpixdim).
<source>
WebServer.AddOfflineArea([plast poligonov], 'filter', 0, 0)
WebServer.AddOfflineArea([plast linij], 'filter', 50, 0)
WebServer.AddOfflineArea([plast točk], 'filter', 200, 0)
</source>
Vsakokrat, ko se ta defincija spremeni, je potrebno izvesti preračun relevantnega območja s klicom povezave "http://streznik/api/2018/prepareofflinemapsinfo"

== 2018: Offline podatki ==
Novost je možnost uporabe podatkov v offline načinu.

Za to je treba elementu teme določiti:
pravico offline uporabe(parameter H), tudi za nadrejene skupine
povezavo na dejanske podatke z ukazom '''WI.SetOfflineData([plast], 'iskanje')'''

<source>WI.SetOfflineData([parcele], 'Default')</source>

V sami plasti je potrebno dodati polja, ki določajo, kako se podatki v offline načinu izrisujejo.

Za točke: polje '''offline-icon''' z definicijo '''"ime simbola;font mi ali fa;velikost v px;stil n ali b;barva simbola;opcijska sirina sence v px;opcijska barva sence"'''
Za polilinije: polje '''offline-line''' z definicijo '''"debelina linije v px;barva linije"'''
Za poligone: polje '''offline-fill''' z definicijo '''"barva polnjenja;debelina linije v px;barva linije"'''

Za napise: polje '''offline-text''' z definicijo '''"napis;Roboto;velikost v px;stil n ali b;barva napisa;sirina sence v px;barva sence"'''

Za font simbolov se lahko vnese '''mi''' za Material Icons [https://material.io/tools/icons/?style=baseline] ali '''fa''' za FontAwesome [https://origin.fontawesome.com/icons].

Za barve se lahko vnese katerakoli veljavna CSS notacija [https://www.w3schools.com/cssref/css_colors.asp]: LightRed, #FF0000, rgb(255,0,0), rgba(255,0,0,1.0).

<source>
offline-icon "lens;mi;8;n;red;2;white"
offline-line "4;yellow"
offline-fill "rgba(0,0,255,0.5);1;blue"
offline-text "napis;Roboto;12;n;green;2;white"
</source>

== Napredne nastavitve ==

Ob prijavi lahko določene nastavitve spremenimo glede na prijavljenega uporabnika. To storimo tako, da dodamo novo proceduro:
<source>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</source>

== Priprava tematike ==
Tematiko se pripravi kot sicer. Izjemnega pomena pa je, da se tematika v vseh merilih in z vsemi vključenimi temami vedno izriše hitro, torej v rangu recimo 3 sekund (kar je že precej). Optimalno bi bilo 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 ta tema vklopi/izklopi. Če tema nima oznake, se nikoli ne prikaže. Če želimo temo prikazati vedno, vnesemo za znak '''*'''.

==== Atribut: View tags ====
Namen tega atributa je omejevanje vpogleda v podatke glede na uporabnika.

==== Atribut: Web info ====
V tem atributu določimo prej omenjene skupine. To storimo večvrstično v naslednji obliki:
<source>item=karte
name=Pregledne karte
sort=1
show=1
hint=...
icon=a.gif</source>
Vsaka oznaka se mora pojaviti natanko v eni temi, ni pomembno kateri. Iz teh informacij se potem generira menu za vklop/izklop v spletni aplikaciji. Prve štiri vrstice so obvezne.

== Priprava iskanj in izpisov ==
Iskanje po poljubnih podatkih se pripravi v urejevalniku podatkovne plasti (Searches). V modulu SdmsWSP pa z ukazom AddSearch dodajamo le tiste, ki jih želimo uporabljati v spletni aplikaciji.
...

== Nastavljanje pravic ==
Pri spletni aplikaciji je možno nastaviti različne nivoje dostopa (izris na karti, iskanje, izpis podatkov) glede na prijavljenega uporabnika.

V ta namen se uporablja kratke oznake, ki jih umenujemo '''Security tags'''.

=== Dodeljevanje pravic===
Te oznake se za uporabnika določa v urejevalniku uporabnika oz. v urejevalniku skupine uporabnikov (možno je tudi v varnostnem središču).

Vsak uporabnik/skupina ima lahko določenih več oznak, ki so ločene z vejico.

Uporabnik poleg svojih oznak dobi tudi vse oznake vseh skupin, v katerih je član.

=== Omejevanje pravic===
Na splošno velja naslednje:
*za vpoglede (tematika, vpogled preko iskanja/klika) velja, da če oznaka ni določena, imajo vpogled vsi, sicer pa samo tisti z oznako,
*za urejanja (dodajanje, popravljanje, brisanje) velja, da če oznaka ni določena, ne more urejati nihče, sicer pa samo tisti z oznako.

Pravice se omejuje:
*v tematiki:
**v atributu teme View tags
**v atrubutu teme Web info, v vrstici view=

*pri definiciji iskanja v podatkovni plasti:
**View access
**Append access
**Update access
**Delete access
**View in Update access pri posameznih poljih

*v SDMS Basicu, ukaz je MatchSecurityTags.

Vedno lahko določimo tudi več oznak, ločenih z vejico.

== TODO ==
*SQL pogoj filtra, uporabljenega v searchu se ne upošteva pri kliku
*dvonivojski sistem pri vsebinah za izris
*multiple datasete pri maski (vsaj view)
*images naj dela tudi za spisek datotek (RO)

== 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.* ===
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.

=== SEARCH.DLL ===
Izvede splošno iskanje po (full text search) in vrne zadetke.
:query=KLJUČNE BESEDE
::seznam ključnih besed za iskanje, ločenih s presledki
:category=KAT1,KAT2,KAT3
::seznam kategorij, po katerih se vrši iskanje (če je prazen, se vrši po vseh)
:hits=10
::maksimalno število zadetkov
:template=JSON
::ime templata, ki opredeljuje obliko zadetkov
AddSearch ...
Pred iskanjem se zažene še OnWebSearch...

SDMS WebServer

2019-01-30T12:40:30Z

Janez Trtnik: /* 2018: Offline podatki */

__NOTOC__
[[Kategorije: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'''
*za uporabo varnih povezav (https) se namesti certifikat strežnika, za navodila glej spodaj
*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
*nikakor ne smete pozabiti omogočiti uporabo želenih vrat (80, 443, ...) v požarnem zidu.

Strežnik je sedaj nameščen in zagnan.

=== Namestitev certifikata ===
Če se bo uporabljala varna povezava (https), je potrebno pridobiti in namestiti tudi certifikat strežnika. Pripravi se mapo, na katero se bo kopiral certifikat, lahko pa se ga kopira tudi kar na mapo programa. Pripravi se naslednje ASCII datoteke:
*'''''root.pem''''' - certifikat verifikacijskega strežnika
*'''''cert.pem''''' - certifikat strežnika
*'''''key.pem''''' - zakodiran privatni ključ strežnika
*'''''password.txt''''' - geslo za dekodiranje privatnega ključa

<source>
openssl pkcs12 -in xxx.pfx -out root.pem -cacerts // brez izhodnega gesla
openssl pkcs12 -in xxx.pfx -out certandkey.pem -clcerts // vnesi geslo za key, razbij na dve datoteki: cert.pem in key.pem
Geslo kodiraj z EncryptPassord in shrani v password.txt takole: ENCRYPTED:geslo
</source>

Kasneje se v modulu določi tudi pot do datotek certifikata.

== Aktivacija ==
'''SDMS WebServer''' se aktivira tako, da se v SDMS raziskovalcu doda nov modul z imenom '''SdmsWSP''' in naslednjo vsebino:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', '')
WebServer.Start
...
EndSub</source>

Če želimo dodati tudi dostop preko varne povezave (https), to storimo takole:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath)
WebServer.Start
...
EndSub</source>

Če želimo zagotoviti uporabo varne povezave (https) in izvesti samodejno preusmeritev nanjo:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http').SetRedirect('https://www.test.si/')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath + 'Certifikat\')
WebServer.Start
...
EndSub</source>

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

== Osnovne nastavitve ==
Strežniku moramo podati ime, ki se prikaže kot naslov strani. Uporablja se tudi kot identifikacija strežnika, če je ta potrebna.
<source>WebServer.Name = 'TEST'</source>
Ob prijavi se uporabniku prikaže logotip velikosti 480x120 pik. Datoteko se shrani na mapo WebServer in takole poda njeno ime.
<source>WebServer.Logo = 'logo.png'</source>

Privzeto dopušča SDMS WebServer dostop samo SDMS uporabnikom. Če želimo dodati tudi možnost anonimnega dostopa, to storimo tako:
<source>WebServer.User = [Gost]</source>
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.
<source>WebServer.Window = '370000,25000,630000,200000'</source>

Določiti je treba tematiko, ki se bo uporabljala za izris.
<source>WebServer.DrawList = [Web Tematika]</source>

Dodati je treba plasti, po katerih za izvaja iskanje in izpis podatkov.
<source>WebServer.AddSearch([Plast A].Search('Default'))
WebServer.AddSearch([Plast B].Search('Default'))</source>

Dobro je dodati tudi seznam priljubljenih lokacij, ki so dostopne iz menija.
<source>WebServer.AddLocation('Slovenija', '370000,25000,630000,200000', '')
WebServer.AddLocation('Ljubljana', '370000,25000,630000,200000', '')
WebServer.AddLocation('Maribor', '370000,25000,630000,200000', '')</source>

Možno je dodati tudi seznam dodatnih povezav, ki so ravno tako dostopne iz menija.
<source>WebServer.AddLink('Softdata Home Page', 'http://www.softdata.si', '')</source>

Dodamo tudi seznam dodatnih izrisov za tiskanje.
<source>WebServer.AddLayout([A4 Pokončno], '')
WebServer.AddLayout([A4 Ležeče], '')</source>

== 2018: Splošna dodatna opravila ==
Na mapi Database\WebServer se ustvari novo mapo 2018.

Nanjo se prekopira logo-*.png datoteke, ki so bile pri stari aplikaciji na rootu.

Nanjo se prekopira custom.js in custom.css iz mape SDMSWSP\WebServer\2018 in se ju primerno prilagodi.

== 2018: Tematika ==
Tematika za novo aplikacijo se pripravi kot prej, le da se v njej ne vnaša polja 'Informacije za web'. To polje se ignorira. Še vedno pa se uporabljata polji 'Dodatno ime' (obvezno) in 'Pravice' (opcijsko).

Kar je bilo prej določeno v informacijah za web, se sedaj določa v modulu SDMSWSP v funkciji OnCreate z dodajanjem elementov tipa TWebItem.

Obstaja tudi SDMS basic funkcija ConvertWebInfo, ki prenese stare informacije za web iz tematike.
<source>
WI = WebServer.AddWebItem(A, B, C, D, E, F, G, H)
</source>
Parametri funkcije AddWebItem
A: (string) koda mape, na katero želimo vstaviti dani element, prazen string za root
B: (string) koda elementa, ki mora biti unikatna(!); za 'radio gumbe' se doda predpona xxx:, kjer je xxx ime skupine gumbov, vsaka grupa gumbov naj ima natanko en gump privzeto viden (E)
C: (string) ime elementa (napis)
D: (string) legenda za dani element, ki naj vsebuje tudi copyright informacijo, lahko v HTML obliki
E: (boolean) privzeta vidnost elementa
F: (double) transparentnost podlog, 0-1, privzeto 1, lahko se določi na mapah in kartah
G: (string) pravice za uporabo v online načinu: z vejico ločen seznam security tagov, vsi = '*', nihče = '-'; dodatne natančnejše pravice za prikaz pa so lahko nastavljene tudi v tematiki
H: (string) pravice za uporabo v offline načinu: velja enako kot pri (G)
Tako ustvarimo nov element (referenca nanj je v spremenljivki WI).

Če gre za element, ki predstavlja skupino elementov, ne potrebujemo narediti nič več.
Če gre za element, ki je povezan s piramido, to storimo z WI.SetPyramid('koda piramide')
<source>WI.SetPyramid('dof2018')</source>
Če gre za element, ki je povezan s spletnimi kartami, to storimo z WI.SetTms('koda spletnih kart')
<source>WI.SetTms('gm-s')</source>
Če gre za element, ki je povezan s temo/temami tematke, to storimo z WI.SetDrawItem('alias teme/tem')
<source>WI.SetDrawItem('parcele')</source>

Priporočamo striktno poravnavanje parametrov po kolonah, da se ohrani preglednost.

<source>
Dim WI As TWebItem

WI = WebServer.AddWebItem('', 'g-maps', 'Osnovne karte', '', True, 1.0, '*', '*')
WI = WebServer.AddWebItem('g-maps', 'm:gm-m', 'Google Maps', 'Google', False, 1.0, '*', '-') WI.SetTms('GM-M')
WI = WebServer.AddWebItem('g-maps', 'm:dof', 'DOF Slovenija', 'GURS', True, 1.0, '*', '*') WI.SetPyramid('DOF-GURS')
WI = WebServer.AddWebItem('g-maps', 'm:dmr', 'DMR Slovenija', 'GURS', False, 1.0, '*', '-') WI.SetPyramid('DMR-GURS')

WI = WebServer.AddWebItem('', 'g-sp', 'Splošne vsebine', '', True, 1.0, '*', '-')
WI = WebServer.AddWebItem('g-sp', 'dkn', 'Dkn', 'pa', False, 1.0, '*', '-') WI.SetDrawItem('dkn')
WI = WebServer.AddWebItem('g-sp', 'op', 'Opombe', 'op', True, 1.0, '*', '*') WI.SetDrawItem('op')
</source>

== 2018: Offline podloge ==
Novost je možnost uporabe podlog (piramide) v offline načinu.

Za to je treba elementu piramide določiti:
pravico offline uporabe(parameter H), ne pozabite tudi za nadrejene skupine
relevantno območje, kar je izjemno pomembno narediti pravilno, da se čimbolj omeji količina potrebnih kart za prenos v cache

Definicija relevantnega območja se določa za vse offline pologe enotno z ukazom WebServer.AddOfflineArea([plast], 'opcijski filter', offset, minpixdim).
<source>
WebServer.AddOfflineArea([plast poligonov], 'filter', 0, 0)
WebServer.AddOfflineArea([plast linij], 'filter', 50, 0)
WebServer.AddOfflineArea([plast točk], 'filter', 200, 0)
</source>
Vsakokrat, ko se ta defincija spremeni, je potrebno izvesti preračun relevantnega območja s klicom povezave "http://streznik/api/2018/prepareofflinemapsinfo"

== 2018: Offline podatki ==
Novost je možnost uporabe podatkov v offline načinu.

Za to je treba elementu teme določiti:
pravico offline uporabe(parameter H), tudi za nadrejene skupine
povezavo na dejanske podatke z ukazom '''WI.SetOfflineData([plast], 'iskanje')'''

<source>WI.SetOfflineData([parcele], 'Default')</source>

V sami plasti je potrebno dodati polja, ki določajo, kako se podatki v offline načinu izrisujejo.

Za točke: polje '''offline-icon''' z definicijo '''"ime simbola;font mi ali fa;velikost v px;stil n ali b;barva simbola;opcijska sirina sence v px;opcijska barva sence"'''
Za polilinije: polje '''offline-line''' z definicijo '''"debelina linije v px;barva linije"'''
Za poligone: polje '''offline-fill''' z definicijo '''"barva polnjenja;debelina linije v px;barva linije"'''

Za napise: polje '''offline-text''' z definicijo '''"napis;Roboto;velikost v px;stil n ali b;barva napisa;sirina sence v px;barva sence"'''

Za font simbolov se lahko vnese '''mi''' za Material Icons [https://material.io/tools/icons/?style=baseline] ali '''fa''' za FontAwesome [https://origin.fontawesome.com/icons].

Za barve se lahko vnese katerakoli veljavna CSS notacija [https://www.w3schools.com/cssref/css_colors.asp]: LightRed, #FF0000, rgb(255,0,0), rgba(255,0,0,1.0).

<source>
offline-icon "lens;mi;8;n;red;2;white"
offline-line "4;yellow"
offline-fill "rgba(0,0,255,0.5);1;blue"
offline-text "napis;Roboto;12;n;green;2;white"
</source>

== Napredne nastavitve ==

Ob prijavi lahko določene nastavitve spremenimo glede na prijavljenega uporabnika. To storimo tako, da dodamo novo proceduro:
<source>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</source>

== Priprava tematike ==
Tematiko se pripravi kot sicer. Izjemnega pomena pa je, da se tematika v vseh merilih in z vsemi vključenimi temami vedno izriše hitro, torej v rangu recimo 3 sekund (kar je že precej). Optimalno bi bilo 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 ta tema vklopi/izklopi. Če tema nima oznake, se nikoli ne prikaže. Če želimo temo prikazati vedno, vnesemo za znak '''*'''.

==== Atribut: View tags ====
Namen tega atributa je omejevanje vpogleda v podatke glede na uporabnika.

==== Atribut: Web info ====
V tem atributu določimo prej omenjene skupine. To storimo večvrstično v naslednji obliki:
<source>item=karte
name=Pregledne karte
sort=1
show=1
hint=...
icon=a.gif</source>
Vsaka oznaka se mora pojaviti natanko v eni temi, ni pomembno kateri. Iz teh informacij se potem generira menu za vklop/izklop v spletni aplikaciji. Prve štiri vrstice so obvezne.

== Priprava iskanj in izpisov ==
Iskanje po poljubnih podatkih se pripravi v urejevalniku podatkovne plasti (Searches). V modulu SdmsWSP pa z ukazom AddSearch dodajamo le tiste, ki jih želimo uporabljati v spletni aplikaciji.
...

== Nastavljanje pravic ==
Pri spletni aplikaciji je možno nastaviti različne nivoje dostopa (izris na karti, iskanje, izpis podatkov) glede na prijavljenega uporabnika.

V ta namen se uporablja kratke oznake, ki jih umenujemo '''Security tags'''.

=== Dodeljevanje pravic===
Te oznake se za uporabnika določa v urejevalniku uporabnika oz. v urejevalniku skupine uporabnikov (možno je tudi v varnostnem središču).

Vsak uporabnik/skupina ima lahko določenih več oznak, ki so ločene z vejico.

Uporabnik poleg svojih oznak dobi tudi vse oznake vseh skupin, v katerih je član.

=== Omejevanje pravic===
Na splošno velja naslednje:
*za vpoglede (tematika, vpogled preko iskanja/klika) velja, da če oznaka ni določena, imajo vpogled vsi, sicer pa samo tisti z oznako,
*za urejanja (dodajanje, popravljanje, brisanje) velja, da če oznaka ni določena, ne more urejati nihče, sicer pa samo tisti z oznako.

Pravice se omejuje:
*v tematiki:
**v atributu teme View tags
**v atrubutu teme Web info, v vrstici view=

*pri definiciji iskanja v podatkovni plasti:
**View access
**Append access
**Update access
**Delete access
**View in Update access pri posameznih poljih

*v SDMS Basicu, ukaz je MatchSecurityTags.

Vedno lahko določimo tudi več oznak, ločenih z vejico.

== TODO ==
*SQL pogoj filtra, uporabljenega v searchu se ne upošteva pri kliku
*dvonivojski sistem pri vsebinah za izris
*multiple datasete pri maski (vsaj view)
*images naj dela tudi za spisek datotek (RO)

== 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.* ===
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.

=== SEARCH.DLL ===
Izvede splošno iskanje po (full text search) in vrne zadetke.
:query=KLJUČNE BESEDE
::seznam ključnih besed za iskanje, ločenih s presledki
:category=KAT1,KAT2,KAT3
::seznam kategorij, po katerih se vrši iskanje (če je prazen, se vrši po vseh)
:hits=10
::maksimalno število zadetkov
:template=JSON
::ime templata, ki opredeljuje obliko zadetkov
AddSearch ...
Pred iskanjem se zažene še OnWebSearch...

SDMS WebServer

2019-01-30T12:37:13Z

Janez Trtnik: /* 2018: Tematika */

__NOTOC__
[[Kategorije: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'''
*za uporabo varnih povezav (https) se namesti certifikat strežnika, za navodila glej spodaj
*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
*nikakor ne smete pozabiti omogočiti uporabo želenih vrat (80, 443, ...) v požarnem zidu.

Strežnik je sedaj nameščen in zagnan.

=== Namestitev certifikata ===
Če se bo uporabljala varna povezava (https), je potrebno pridobiti in namestiti tudi certifikat strežnika. Pripravi se mapo, na katero se bo kopiral certifikat, lahko pa se ga kopira tudi kar na mapo programa. Pripravi se naslednje ASCII datoteke:
*'''''root.pem''''' - certifikat verifikacijskega strežnika
*'''''cert.pem''''' - certifikat strežnika
*'''''key.pem''''' - zakodiran privatni ključ strežnika
*'''''password.txt''''' - geslo za dekodiranje privatnega ključa

<source>
openssl pkcs12 -in xxx.pfx -out root.pem -cacerts // brez izhodnega gesla
openssl pkcs12 -in xxx.pfx -out certandkey.pem -clcerts // vnesi geslo za key, razbij na dve datoteki: cert.pem in key.pem
Geslo kodiraj z EncryptPassord in shrani v password.txt takole: ENCRYPTED:geslo
</source>

Kasneje se v modulu določi tudi pot do datotek certifikata.

== Aktivacija ==
'''SDMS WebServer''' se aktivira tako, da se v SDMS raziskovalcu doda nov modul z imenom '''SdmsWSP''' in naslednjo vsebino:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', '')
WebServer.Start
...
EndSub</source>

Če želimo dodati tudi dostop preko varne povezave (https), to storimo takole:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath)
WebServer.Start
...
EndSub</source>

Če želimo zagotoviti uporabo varne povezave (https) in izvesti samodejno preusmeritev nanjo:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http').SetRedirect('https://www.test.si/')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath + 'Certifikat\')
WebServer.Start
...
EndSub</source>

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

== Osnovne nastavitve ==
Strežniku moramo podati ime, ki se prikaže kot naslov strani. Uporablja se tudi kot identifikacija strežnika, če je ta potrebna.
<source>WebServer.Name = 'TEST'</source>
Ob prijavi se uporabniku prikaže logotip velikosti 480x120 pik. Datoteko se shrani na mapo WebServer in takole poda njeno ime.
<source>WebServer.Logo = 'logo.png'</source>

Privzeto dopušča SDMS WebServer dostop samo SDMS uporabnikom. Če želimo dodati tudi možnost anonimnega dostopa, to storimo tako:
<source>WebServer.User = [Gost]</source>
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.
<source>WebServer.Window = '370000,25000,630000,200000'</source>

Določiti je treba tematiko, ki se bo uporabljala za izris.
<source>WebServer.DrawList = [Web Tematika]</source>

Dodati je treba plasti, po katerih za izvaja iskanje in izpis podatkov.
<source>WebServer.AddSearch([Plast A].Search('Default'))
WebServer.AddSearch([Plast B].Search('Default'))</source>

Dobro je dodati tudi seznam priljubljenih lokacij, ki so dostopne iz menija.
<source>WebServer.AddLocation('Slovenija', '370000,25000,630000,200000', '')
WebServer.AddLocation('Ljubljana', '370000,25000,630000,200000', '')
WebServer.AddLocation('Maribor', '370000,25000,630000,200000', '')</source>

Možno je dodati tudi seznam dodatnih povezav, ki so ravno tako dostopne iz menija.
<source>WebServer.AddLink('Softdata Home Page', 'http://www.softdata.si', '')</source>

Dodamo tudi seznam dodatnih izrisov za tiskanje.
<source>WebServer.AddLayout([A4 Pokončno], '')
WebServer.AddLayout([A4 Ležeče], '')</source>

== 2018: Splošna dodatna opravila ==
Na mapi Database\WebServer se ustvari novo mapo 2018.

Nanjo se prekopira logo-*.png datoteke, ki so bile pri stari aplikaciji na rootu.

Nanjo se prekopira custom.js in custom.css iz mape SDMSWSP\WebServer\2018 in se ju primerno prilagodi.

== 2018: Tematika ==
Tematika za novo aplikacijo se pripravi kot prej, le da se v njej ne vnaša polja 'Informacije za web'. To polje se ignorira. Še vedno pa se uporabljata polji 'Dodatno ime' (obvezno) in 'Pravice' (opcijsko).

Kar je bilo prej določeno v informacijah za web, se sedaj določa v modulu SDMSWSP v funkciji OnCreate z dodajanjem elementov tipa TWebItem.

Obstaja tudi SDMS basic funkcija ConvertWebInfo, ki prenese stare informacije za web iz tematike.
<source>
WI = WebServer.AddWebItem(A, B, C, D, E, F, G, H)
</source>
Parametri funkcije AddWebItem
A: (string) koda mape, na katero želimo vstaviti dani element, prazen string za root
B: (string) koda elementa, ki mora biti unikatna(!); za 'radio gumbe' se doda predpona xxx:, kjer je xxx ime skupine gumbov, vsaka grupa gumbov naj ima natanko en gump privzeto viden (E)
C: (string) ime elementa (napis)
D: (string) legenda za dani element, ki naj vsebuje tudi copyright informacijo, lahko v HTML obliki
E: (boolean) privzeta vidnost elementa
F: (double) transparentnost podlog, 0-1, privzeto 1, lahko se določi na mapah in kartah
G: (string) pravice za uporabo v online načinu: z vejico ločen seznam security tagov, vsi = '*', nihče = '-'; dodatne natančnejše pravice za prikaz pa so lahko nastavljene tudi v tematiki
H: (string) pravice za uporabo v offline načinu: velja enako kot pri (G)
Tako ustvarimo nov element (referenca nanj je v spremenljivki WI).

Če gre za element, ki predstavlja skupino elementov, ne potrebujemo narediti nič več.
Če gre za element, ki je povezan s piramido, to storimo z WI.SetPyramid('koda piramide')
<source>WI.SetPyramid('dof2018')</source>
Če gre za element, ki je povezan s spletnimi kartami, to storimo z WI.SetTms('koda spletnih kart')
<source>WI.SetTms('gm-s')</source>
Če gre za element, ki je povezan s temo/temami tematke, to storimo z WI.SetDrawItem('alias teme/tem')
<source>WI.SetDrawItem('parcele')</source>

Priporočamo striktno poravnavanje parametrov po kolonah, da se ohrani preglednost.

<source>
Dim WI As TWebItem

WI = WebServer.AddWebItem('', 'g-maps', 'Osnovne karte', '', True, 1.0, '*', '*')
WI = WebServer.AddWebItem('g-maps', 'm:gm-m', 'Google Maps', 'Google', False, 1.0, '*', '-') WI.SetTms('GM-M')
WI = WebServer.AddWebItem('g-maps', 'm:dof', 'DOF Slovenija', 'GURS', True, 1.0, '*', '*') WI.SetPyramid('DOF-GURS')
WI = WebServer.AddWebItem('g-maps', 'm:dmr', 'DMR Slovenija', 'GURS', False, 1.0, '*', '-') WI.SetPyramid('DMR-GURS')

WI = WebServer.AddWebItem('', 'g-sp', 'Splošne vsebine', '', True, 1.0, '*', '-')
WI = WebServer.AddWebItem('g-sp', 'dkn', 'Dkn', 'pa', False, 1.0, '*', '-') WI.SetDrawItem('dkn')
WI = WebServer.AddWebItem('g-sp', 'op', 'Opombe', 'op', True, 1.0, '*', '*') WI.SetDrawItem('op')
</source>

== 2018: Offline podloge ==
Novost je možnost uporabe podlog (piramide) v offline načinu.

Za to je treba elementu piramide določiti:
pravico offline uporabe(parameter H), ne pozabite tudi za nadrejene skupine
relevantno območje, kar je izjemno pomembno narediti pravilno, da se čimbolj omeji količina potrebnih kart za prenos v cache

Definicija relevantnega območja se določa za vse offline pologe enotno z ukazom WebServer.AddOfflineArea([plast], 'opcijski filter', offset, minpixdim).
<source>
WebServer.AddOfflineArea([plast poligonov], 'filter', 0, 0)
WebServer.AddOfflineArea([plast linij], 'filter', 50, 0)
WebServer.AddOfflineArea([plast točk], 'filter', 200, 0)
</source>
Vsakokrat, ko se ta defincija spremeni, je potrebno izvesti preračun relevantnega območja s klicom povezave "http://streznik/api/2018/prepareofflinemapsinfo"

== 2018: Offline podatki ==
Novost je možnost uporabe podatkov v offline načinu.

Za to je treba elementu teme določiti:
pravico offline uporabe(parameter H), tudi za nadrejene skupine
povezavo na dejanske podatke z ukazom '''WI.SetOfflineData([plast], 'iskanje')'''

<source>WI.SetOfflineData([parcele], 'Default')</source>

V sami plasti je potrebno dodati polja, ki določajo, kako se podatki v offline načinu izrisujejo.

Za točke: polje '''offline-icon''' z definicijo '''"ime simbola;font mi ali fa;velikost v px;stil n ali b;barva simbola;opcijska sirina sence v px;opcijska barva sence"'''
Za polilinije: polje '''offline-line''' z definicijo '''"debelina linije v px;barva linije"'''
Za poligone: polje '''offline-fill''' z definicijo '''"barva polnjenja;debelina linije v px;barva linije"'''

Za napise: polje '''offline-text''' z definicijo '''"napis;Roboto;velikost v px;stil n ali b;barva napisa;sirina sence v px;barva sence"'''

Za font simbolov se lahko vnese '''mi''' za Material Icons [https://material.io/tools/icons/?style=baseline] ali '''fa''' za FontAwesome [https://origin.fontawesome.com/icons].

Za barve se lahko vnese katerakoli veljavna CSS notacija [https://www.w3schools.com/cssref/css_colors.asp]: LightRed, #FF0000, rgb(255,0,0), rgba(255,0,0,1.0).

== Napredne nastavitve ==

Ob prijavi lahko določene nastavitve spremenimo glede na prijavljenega uporabnika. To storimo tako, da dodamo novo proceduro:
<source>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</source>

== Priprava tematike ==
Tematiko se pripravi kot sicer. Izjemnega pomena pa je, da se tematika v vseh merilih in z vsemi vključenimi temami vedno izriše hitro, torej v rangu recimo 3 sekund (kar je že precej). Optimalno bi bilo 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 ta tema vklopi/izklopi. Če tema nima oznake, se nikoli ne prikaže. Če želimo temo prikazati vedno, vnesemo za znak '''*'''.

==== Atribut: View tags ====
Namen tega atributa je omejevanje vpogleda v podatke glede na uporabnika.

==== Atribut: Web info ====
V tem atributu določimo prej omenjene skupine. To storimo večvrstično v naslednji obliki:
<source>item=karte
name=Pregledne karte
sort=1
show=1
hint=...
icon=a.gif</source>
Vsaka oznaka se mora pojaviti natanko v eni temi, ni pomembno kateri. Iz teh informacij se potem generira menu za vklop/izklop v spletni aplikaciji. Prve štiri vrstice so obvezne.

== Priprava iskanj in izpisov ==
Iskanje po poljubnih podatkih se pripravi v urejevalniku podatkovne plasti (Searches). V modulu SdmsWSP pa z ukazom AddSearch dodajamo le tiste, ki jih želimo uporabljati v spletni aplikaciji.
...

== Nastavljanje pravic ==
Pri spletni aplikaciji je možno nastaviti različne nivoje dostopa (izris na karti, iskanje, izpis podatkov) glede na prijavljenega uporabnika.

V ta namen se uporablja kratke oznake, ki jih umenujemo '''Security tags'''.

=== Dodeljevanje pravic===
Te oznake se za uporabnika določa v urejevalniku uporabnika oz. v urejevalniku skupine uporabnikov (možno je tudi v varnostnem središču).

Vsak uporabnik/skupina ima lahko določenih več oznak, ki so ločene z vejico.

Uporabnik poleg svojih oznak dobi tudi vse oznake vseh skupin, v katerih je član.

=== Omejevanje pravic===
Na splošno velja naslednje:
*za vpoglede (tematika, vpogled preko iskanja/klika) velja, da če oznaka ni določena, imajo vpogled vsi, sicer pa samo tisti z oznako,
*za urejanja (dodajanje, popravljanje, brisanje) velja, da če oznaka ni določena, ne more urejati nihče, sicer pa samo tisti z oznako.

Pravice se omejuje:
*v tematiki:
**v atributu teme View tags
**v atrubutu teme Web info, v vrstici view=

*pri definiciji iskanja v podatkovni plasti:
**View access
**Append access
**Update access
**Delete access
**View in Update access pri posameznih poljih

*v SDMS Basicu, ukaz je MatchSecurityTags.

Vedno lahko določimo tudi več oznak, ločenih z vejico.

== TODO ==
*SQL pogoj filtra, uporabljenega v searchu se ne upošteva pri kliku
*dvonivojski sistem pri vsebinah za izris
*multiple datasete pri maski (vsaj view)
*images naj dela tudi za spisek datotek (RO)

== 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.* ===
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.

=== SEARCH.DLL ===
Izvede splošno iskanje po (full text search) in vrne zadetke.
:query=KLJUČNE BESEDE
::seznam ključnih besed za iskanje, ločenih s presledki
:category=KAT1,KAT2,KAT3
::seznam kategorij, po katerih se vrši iskanje (če je prazen, se vrši po vseh)
:hits=10
::maksimalno število zadetkov
:template=JSON
::ime templata, ki opredeljuje obliko zadetkov
AddSearch ...
Pred iskanjem se zažene še OnWebSearch...

SDMS WebServer

2019-01-30T12:36:57Z

Janez Trtnik: /* 2018: Tematika */

__NOTOC__
[[Kategorije: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'''
*za uporabo varnih povezav (https) se namesti certifikat strežnika, za navodila glej spodaj
*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
*nikakor ne smete pozabiti omogočiti uporabo želenih vrat (80, 443, ...) v požarnem zidu.

Strežnik je sedaj nameščen in zagnan.

=== Namestitev certifikata ===
Če se bo uporabljala varna povezava (https), je potrebno pridobiti in namestiti tudi certifikat strežnika. Pripravi se mapo, na katero se bo kopiral certifikat, lahko pa se ga kopira tudi kar na mapo programa. Pripravi se naslednje ASCII datoteke:
*'''''root.pem''''' - certifikat verifikacijskega strežnika
*'''''cert.pem''''' - certifikat strežnika
*'''''key.pem''''' - zakodiran privatni ključ strežnika
*'''''password.txt''''' - geslo za dekodiranje privatnega ključa

<source>
openssl pkcs12 -in xxx.pfx -out root.pem -cacerts // brez izhodnega gesla
openssl pkcs12 -in xxx.pfx -out certandkey.pem -clcerts // vnesi geslo za key, razbij na dve datoteki: cert.pem in key.pem
Geslo kodiraj z EncryptPassord in shrani v password.txt takole: ENCRYPTED:geslo
</source>

Kasneje se v modulu določi tudi pot do datotek certifikata.

== Aktivacija ==
'''SDMS WebServer''' se aktivira tako, da se v SDMS raziskovalcu doda nov modul z imenom '''SdmsWSP''' in naslednjo vsebino:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', '')
WebServer.Start
...
EndSub</source>

Če želimo dodati tudi dostop preko varne povezave (https), to storimo takole:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath)
WebServer.Start
...
EndSub</source>

Če želimo zagotoviti uporabo varne povezave (https) in izvesti samodejno preusmeritev nanjo:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http').SetRedirect('https://www.test.si/')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath + 'Certifikat\')
WebServer.Start
...
EndSub</source>

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

== Osnovne nastavitve ==
Strežniku moramo podati ime, ki se prikaže kot naslov strani. Uporablja se tudi kot identifikacija strežnika, če je ta potrebna.
<source>WebServer.Name = 'TEST'</source>
Ob prijavi se uporabniku prikaže logotip velikosti 480x120 pik. Datoteko se shrani na mapo WebServer in takole poda njeno ime.
<source>WebServer.Logo = 'logo.png'</source>

Privzeto dopušča SDMS WebServer dostop samo SDMS uporabnikom. Če želimo dodati tudi možnost anonimnega dostopa, to storimo tako:
<source>WebServer.User = [Gost]</source>
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.
<source>WebServer.Window = '370000,25000,630000,200000'</source>

Določiti je treba tematiko, ki se bo uporabljala za izris.
<source>WebServer.DrawList = [Web Tematika]</source>

Dodati je treba plasti, po katerih za izvaja iskanje in izpis podatkov.
<source>WebServer.AddSearch([Plast A].Search('Default'))
WebServer.AddSearch([Plast B].Search('Default'))</source>

Dobro je dodati tudi seznam priljubljenih lokacij, ki so dostopne iz menija.
<source>WebServer.AddLocation('Slovenija', '370000,25000,630000,200000', '')
WebServer.AddLocation('Ljubljana', '370000,25000,630000,200000', '')
WebServer.AddLocation('Maribor', '370000,25000,630000,200000', '')</source>

Možno je dodati tudi seznam dodatnih povezav, ki so ravno tako dostopne iz menija.
<source>WebServer.AddLink('Softdata Home Page', 'http://www.softdata.si', '')</source>

Dodamo tudi seznam dodatnih izrisov za tiskanje.
<source>WebServer.AddLayout([A4 Pokončno], '')
WebServer.AddLayout([A4 Ležeče], '')</source>

== 2018: Splošna dodatna opravila ==
Na mapi Database\WebServer se ustvari novo mapo 2018.

Nanjo se prekopira logo-*.png datoteke, ki so bile pri stari aplikaciji na rootu.

Nanjo se prekopira custom.js in custom.css iz mape SDMSWSP\WebServer\2018 in se ju primerno prilagodi.

== 2018: Tematika ==
Tematika za novo aplikacijo se pripravi kot prej, le da se v njej ne vnaša polja 'Informacije za web'. To polje se ignorira. Še vedno pa se uporabljata polji 'Dodatno ime' (obvezno) in 'Pravice' (opcijsko).

Kar je bilo prej določeno v informacijah za web, se sedaj določa v modulu SDMSWSP v funkciji OnCreate z dodajanjem elementov tipa TWebItem.
Obstaja tudi SDMS basic funkcija ConvertWebInfo, ki prenese stare informacije za web iz tematike.
<source>
WI = WebServer.AddWebItem(A, B, C, D, E, F, G, H)
</source>
Parametri funkcije AddWebItem
A: (string) koda mape, na katero želimo vstaviti dani element, prazen string za root
B: (string) koda elementa, ki mora biti unikatna(!); za 'radio gumbe' se doda predpona xxx:, kjer je xxx ime skupine gumbov, vsaka grupa gumbov naj ima natanko en gump privzeto viden (E)
C: (string) ime elementa (napis)
D: (string) legenda za dani element, ki naj vsebuje tudi copyright informacijo, lahko v HTML obliki
E: (boolean) privzeta vidnost elementa
F: (double) transparentnost podlog, 0-1, privzeto 1, lahko se določi na mapah in kartah
G: (string) pravice za uporabo v online načinu: z vejico ločen seznam security tagov, vsi = '*', nihče = '-'; dodatne natančnejše pravice za prikaz pa so lahko nastavljene tudi v tematiki
H: (string) pravice za uporabo v offline načinu: velja enako kot pri (G)
Tako ustvarimo nov element (referenca nanj je v spremenljivki WI).

Če gre za element, ki predstavlja skupino elementov, ne potrebujemo narediti nič več.
Če gre za element, ki je povezan s piramido, to storimo z WI.SetPyramid('koda piramide')
<source>WI.SetPyramid('dof2018')</source>
Če gre za element, ki je povezan s spletnimi kartami, to storimo z WI.SetTms('koda spletnih kart')
<source>WI.SetTms('gm-s')</source>
Če gre za element, ki je povezan s temo/temami tematke, to storimo z WI.SetDrawItem('alias teme/tem')
<source>WI.SetDrawItem('parcele')</source>

Priporočamo striktno poravnavanje parametrov po kolonah, da se ohrani preglednost.

<source>
Dim WI As TWebItem

WI = WebServer.AddWebItem('', 'g-maps', 'Osnovne karte', '', True, 1.0, '*', '*')
WI = WebServer.AddWebItem('g-maps', 'm:gm-m', 'Google Maps', 'Google', False, 1.0, '*', '-') WI.SetTms('GM-M')
WI = WebServer.AddWebItem('g-maps', 'm:dof', 'DOF Slovenija', 'GURS', True, 1.0, '*', '*') WI.SetPyramid('DOF-GURS')
WI = WebServer.AddWebItem('g-maps', 'm:dmr', 'DMR Slovenija', 'GURS', False, 1.0, '*', '-') WI.SetPyramid('DMR-GURS')

WI = WebServer.AddWebItem('', 'g-sp', 'Splošne vsebine', '', True, 1.0, '*', '-')
WI = WebServer.AddWebItem('g-sp', 'dkn', 'Dkn', 'pa', False, 1.0, '*', '-') WI.SetDrawItem('dkn')
WI = WebServer.AddWebItem('g-sp', 'op', 'Opombe', 'op', True, 1.0, '*', '*') WI.SetDrawItem('op')
</source>

== 2018: Offline podloge ==
Novost je možnost uporabe podlog (piramide) v offline načinu.

Za to je treba elementu piramide določiti:
pravico offline uporabe(parameter H), ne pozabite tudi za nadrejene skupine
relevantno območje, kar je izjemno pomembno narediti pravilno, da se čimbolj omeji količina potrebnih kart za prenos v cache

Definicija relevantnega območja se določa za vse offline pologe enotno z ukazom WebServer.AddOfflineArea([plast], 'opcijski filter', offset, minpixdim).
<source>
WebServer.AddOfflineArea([plast poligonov], 'filter', 0, 0)
WebServer.AddOfflineArea([plast linij], 'filter', 50, 0)
WebServer.AddOfflineArea([plast točk], 'filter', 200, 0)
</source>
Vsakokrat, ko se ta defincija spremeni, je potrebno izvesti preračun relevantnega območja s klicom povezave "http://streznik/api/2018/prepareofflinemapsinfo"

== 2018: Offline podatki ==
Novost je možnost uporabe podatkov v offline načinu.

Za to je treba elementu teme določiti:
pravico offline uporabe(parameter H), tudi za nadrejene skupine
povezavo na dejanske podatke z ukazom '''WI.SetOfflineData([plast], 'iskanje')'''

<source>WI.SetOfflineData([parcele], 'Default')</source>

V sami plasti je potrebno dodati polja, ki določajo, kako se podatki v offline načinu izrisujejo.

Za točke: polje '''offline-icon''' z definicijo '''"ime simbola;font mi ali fa;velikost v px;stil n ali b;barva simbola;opcijska sirina sence v px;opcijska barva sence"'''
Za polilinije: polje '''offline-line''' z definicijo '''"debelina linije v px;barva linije"'''
Za poligone: polje '''offline-fill''' z definicijo '''"barva polnjenja;debelina linije v px;barva linije"'''

Za napise: polje '''offline-text''' z definicijo '''"napis;Roboto;velikost v px;stil n ali b;barva napisa;sirina sence v px;barva sence"'''

Za font simbolov se lahko vnese '''mi''' za Material Icons [https://material.io/tools/icons/?style=baseline] ali '''fa''' za FontAwesome [https://origin.fontawesome.com/icons].

Za barve se lahko vnese katerakoli veljavna CSS notacija [https://www.w3schools.com/cssref/css_colors.asp]: LightRed, #FF0000, rgb(255,0,0), rgba(255,0,0,1.0).

== Napredne nastavitve ==

Ob prijavi lahko določene nastavitve spremenimo glede na prijavljenega uporabnika. To storimo tako, da dodamo novo proceduro:
<source>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</source>

== Priprava tematike ==
Tematiko se pripravi kot sicer. Izjemnega pomena pa je, da se tematika v vseh merilih in z vsemi vključenimi temami vedno izriše hitro, torej v rangu recimo 3 sekund (kar je že precej). Optimalno bi bilo 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 ta tema vklopi/izklopi. Če tema nima oznake, se nikoli ne prikaže. Če želimo temo prikazati vedno, vnesemo za znak '''*'''.

==== Atribut: View tags ====
Namen tega atributa je omejevanje vpogleda v podatke glede na uporabnika.

==== Atribut: Web info ====
V tem atributu določimo prej omenjene skupine. To storimo večvrstično v naslednji obliki:
<source>item=karte
name=Pregledne karte
sort=1
show=1
hint=...
icon=a.gif</source>
Vsaka oznaka se mora pojaviti natanko v eni temi, ni pomembno kateri. Iz teh informacij se potem generira menu za vklop/izklop v spletni aplikaciji. Prve štiri vrstice so obvezne.

== Priprava iskanj in izpisov ==
Iskanje po poljubnih podatkih se pripravi v urejevalniku podatkovne plasti (Searches). V modulu SdmsWSP pa z ukazom AddSearch dodajamo le tiste, ki jih želimo uporabljati v spletni aplikaciji.
...

== Nastavljanje pravic ==
Pri spletni aplikaciji je možno nastaviti različne nivoje dostopa (izris na karti, iskanje, izpis podatkov) glede na prijavljenega uporabnika.

V ta namen se uporablja kratke oznake, ki jih umenujemo '''Security tags'''.

=== Dodeljevanje pravic===
Te oznake se za uporabnika določa v urejevalniku uporabnika oz. v urejevalniku skupine uporabnikov (možno je tudi v varnostnem središču).

Vsak uporabnik/skupina ima lahko določenih več oznak, ki so ločene z vejico.

Uporabnik poleg svojih oznak dobi tudi vse oznake vseh skupin, v katerih je član.

=== Omejevanje pravic===
Na splošno velja naslednje:
*za vpoglede (tematika, vpogled preko iskanja/klika) velja, da če oznaka ni določena, imajo vpogled vsi, sicer pa samo tisti z oznako,
*za urejanja (dodajanje, popravljanje, brisanje) velja, da če oznaka ni določena, ne more urejati nihče, sicer pa samo tisti z oznako.

Pravice se omejuje:
*v tematiki:
**v atributu teme View tags
**v atrubutu teme Web info, v vrstici view=

*pri definiciji iskanja v podatkovni plasti:
**View access
**Append access
**Update access
**Delete access
**View in Update access pri posameznih poljih

*v SDMS Basicu, ukaz je MatchSecurityTags.

Vedno lahko določimo tudi več oznak, ločenih z vejico.

== TODO ==
*SQL pogoj filtra, uporabljenega v searchu se ne upošteva pri kliku
*dvonivojski sistem pri vsebinah za izris
*multiple datasete pri maski (vsaj view)
*images naj dela tudi za spisek datotek (RO)

== 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.* ===
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.

=== SEARCH.DLL ===
Izvede splošno iskanje po (full text search) in vrne zadetke.
:query=KLJUČNE BESEDE
::seznam ključnih besed za iskanje, ločenih s presledki
:category=KAT1,KAT2,KAT3
::seznam kategorij, po katerih se vrši iskanje (če je prazen, se vrši po vseh)
:hits=10
::maksimalno število zadetkov
:template=JSON
::ime templata, ki opredeljuje obliko zadetkov
AddSearch ...
Pred iskanjem se zažene še OnWebSearch...

SDMS WebServer

2019-01-30T12:35:10Z

Janez Trtnik: /* 2018: Offline podloge */

__NOTOC__
[[Kategorije: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'''
*za uporabo varnih povezav (https) se namesti certifikat strežnika, za navodila glej spodaj
*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
*nikakor ne smete pozabiti omogočiti uporabo želenih vrat (80, 443, ...) v požarnem zidu.

Strežnik je sedaj nameščen in zagnan.

=== Namestitev certifikata ===
Če se bo uporabljala varna povezava (https), je potrebno pridobiti in namestiti tudi certifikat strežnika. Pripravi se mapo, na katero se bo kopiral certifikat, lahko pa se ga kopira tudi kar na mapo programa. Pripravi se naslednje ASCII datoteke:
*'''''root.pem''''' - certifikat verifikacijskega strežnika
*'''''cert.pem''''' - certifikat strežnika
*'''''key.pem''''' - zakodiran privatni ključ strežnika
*'''''password.txt''''' - geslo za dekodiranje privatnega ključa

<source>
openssl pkcs12 -in xxx.pfx -out root.pem -cacerts // brez izhodnega gesla
openssl pkcs12 -in xxx.pfx -out certandkey.pem -clcerts // vnesi geslo za key, razbij na dve datoteki: cert.pem in key.pem
Geslo kodiraj z EncryptPassord in shrani v password.txt takole: ENCRYPTED:geslo
</source>

Kasneje se v modulu določi tudi pot do datotek certifikata.

== Aktivacija ==
'''SDMS WebServer''' se aktivira tako, da se v SDMS raziskovalcu doda nov modul z imenom '''SdmsWSP''' in naslednjo vsebino:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', '')
WebServer.Start
...
EndSub</source>

Če želimo dodati tudi dostop preko varne povezave (https), to storimo takole:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath)
WebServer.Start
...
EndSub</source>

Če želimo zagotoviti uporabo varne povezave (https) in izvesti samodejno preusmeritev nanjo:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http').SetRedirect('https://www.test.si/')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath + 'Certifikat\')
WebServer.Start
...
EndSub</source>

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

== Osnovne nastavitve ==
Strežniku moramo podati ime, ki se prikaže kot naslov strani. Uporablja se tudi kot identifikacija strežnika, če je ta potrebna.
<source>WebServer.Name = 'TEST'</source>
Ob prijavi se uporabniku prikaže logotip velikosti 480x120 pik. Datoteko se shrani na mapo WebServer in takole poda njeno ime.
<source>WebServer.Logo = 'logo.png'</source>

Privzeto dopušča SDMS WebServer dostop samo SDMS uporabnikom. Če želimo dodati tudi možnost anonimnega dostopa, to storimo tako:
<source>WebServer.User = [Gost]</source>
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.
<source>WebServer.Window = '370000,25000,630000,200000'</source>

Določiti je treba tematiko, ki se bo uporabljala za izris.
<source>WebServer.DrawList = [Web Tematika]</source>

Dodati je treba plasti, po katerih za izvaja iskanje in izpis podatkov.
<source>WebServer.AddSearch([Plast A].Search('Default'))
WebServer.AddSearch([Plast B].Search('Default'))</source>

Dobro je dodati tudi seznam priljubljenih lokacij, ki so dostopne iz menija.
<source>WebServer.AddLocation('Slovenija', '370000,25000,630000,200000', '')
WebServer.AddLocation('Ljubljana', '370000,25000,630000,200000', '')
WebServer.AddLocation('Maribor', '370000,25000,630000,200000', '')</source>

Možno je dodati tudi seznam dodatnih povezav, ki so ravno tako dostopne iz menija.
<source>WebServer.AddLink('Softdata Home Page', 'http://www.softdata.si', '')</source>

Dodamo tudi seznam dodatnih izrisov za tiskanje.
<source>WebServer.AddLayout([A4 Pokončno], '')
WebServer.AddLayout([A4 Ležeče], '')</source>

== 2018: Splošna dodatna opravila ==
Na mapi Database\WebServer se ustvari novo mapo 2018.

Nanjo se prekopira logo-*.png datoteke, ki so bile pri stari aplikaciji na rootu.

Nanjo se prekopira custom.js in custom.css iz mape SDMSWSP\WebServer\2018 in se ju primerno prilagodi.

== 2018: Tematika ==
Tematika za novo aplikacijo se pripravi kot prej, le da se v njej ne vnaša polja 'Informacije za web'. To polje se ignorira. Še vedno pa se uporabljata polji 'Dodatno ime' (obvezno) in 'Pravice' (opcijsko).

Kar je bilo prej določeno v informacijah za web, se sedaj določa v modulu SDMSWSP v funkciji OnCreate z dodajanjem elementov tipa TWebItem.
<source>
WI = WebServer.AddWebItem(A, B, C, D, E, F, G, H)
</source>
Parametri funkcije AddWebItem
A: (string) koda mape, na katero želimo vstaviti dani element, prazen string za root
B: (string) koda elementa, ki mora biti unikatna(!); za 'radio gumbe' se doda predpona xxx:, kjer je xxx ime skupine gumbov, vsaka grupa gumbov naj ima natanko en gump privzeto viden (E)
C: (string) ime elementa (napis)
D: (string) legenda za dani element, ki naj vsebuje tudi copyright informacijo, lahko v HTML obliki
E: (boolean) privzeta vidnost elementa
F: (double) transparentnost podlog, 0-1, privzeto 1, lahko se določi na mapah in kartah
G: (string) pravice za uporabo v online načinu: z vejico ločen seznam security tagov, vsi = '*', nihče = '-'; dodatne natančnejše pravice za prikaz pa so lahko nastavljene tudi v tematiki
H: (string) pravice za uporabo v offline načinu: velja enako kot pri (G)
Tako ustvarimo nov element (referenca nanj je v spremenljivki WI).

Če gre za element, ki predstavlja skupino elementov, ne potrebujemo narediti nič več.
Če gre za element, ki je povezan s piramido, to storimo z WI.SetPyramid('koda piramide')
<source>WI.SetPyramid('dof2018')</source>
Če gre za element, ki je povezan s spletnimi kartami, to storimo z WI.SetTms('koda spletnih kart')
<source>WI.SetTms('gm-s')</source>
Če gre za element, ki je povezan s temo/temami tematke, to storimo z WI.SetDrawItem('alias teme/tem')
<source>WI.SetDrawItem('parcele')</source>

Priporočamo striktno poravnavanje parametrov po kolonah, da se ohrani preglednost.

<source>
Dim WI As TWebItem

WI = WebServer.AddWebItem('', 'g-maps', 'Osnovne karte', '', True, 1.0, '*', '*')
WI = WebServer.AddWebItem('g-maps', 'm:gm-m', 'Google Maps', 'Google', False, 1.0, '*', '-') WI.SetTms('GM-M')
WI = WebServer.AddWebItem('g-maps', 'm:dof', 'DOF Slovenija', 'GURS', True, 1.0, '*', '*') WI.SetPyramid('DOF-GURS')
WI = WebServer.AddWebItem('g-maps', 'm:dmr', 'DMR Slovenija', 'GURS', False, 1.0, '*', '-') WI.SetPyramid('DMR-GURS')

WI = WebServer.AddWebItem('', 'g-sp', 'Splošne vsebine', '', True, 1.0, '*', '-')
WI = WebServer.AddWebItem('g-sp', 'dkn', 'Dkn', 'pa', False, 1.0, '*', '-') WI.SetDrawItem('dkn')
WI = WebServer.AddWebItem('g-sp', 'op', 'Opombe', 'op', True, 1.0, '*', '*') WI.SetDrawItem('op')
</source>

== 2018: Offline podloge ==
Novost je možnost uporabe podlog (piramide) v offline načinu.

Za to je treba elementu piramide določiti:
pravico offline uporabe(parameter H), ne pozabite tudi za nadrejene skupine
relevantno območje, kar je izjemno pomembno narediti pravilno, da se čimbolj omeji količina potrebnih kart za prenos v cache

Definicija relevantnega območja se določa za vse offline pologe enotno z ukazom WebServer.AddOfflineArea([plast], 'opcijski filter', offset, minpixdim).
<source>
WebServer.AddOfflineArea([plast poligonov], 'filter', 0, 0)
WebServer.AddOfflineArea([plast linij], 'filter', 50, 0)
WebServer.AddOfflineArea([plast točk], 'filter', 200, 0)
</source>
Vsakokrat, ko se ta defincija spremeni, je potrebno izvesti preračun relevantnega območja s klicom povezave "http://streznik/api/2018/prepareofflinemapsinfo"

== 2018: Offline podatki ==
Novost je možnost uporabe podatkov v offline načinu.

Za to je treba elementu teme določiti:
pravico offline uporabe(parameter H), tudi za nadrejene skupine
povezavo na dejanske podatke z ukazom '''WI.SetOfflineData([plast], 'iskanje')'''

<source>WI.SetOfflineData([parcele], 'Default')</source>

V sami plasti je potrebno dodati polja, ki določajo, kako se podatki v offline načinu izrisujejo.

Za točke: polje '''offline-icon''' z definicijo '''"ime simbola;font mi ali fa;velikost v px;stil n ali b;barva simbola;opcijska sirina sence v px;opcijska barva sence"'''
Za polilinije: polje '''offline-line''' z definicijo '''"debelina linije v px;barva linije"'''
Za poligone: polje '''offline-fill''' z definicijo '''"barva polnjenja;debelina linije v px;barva linije"'''

Za napise: polje '''offline-text''' z definicijo '''"napis;Roboto;velikost v px;stil n ali b;barva napisa;sirina sence v px;barva sence"'''

Za font simbolov se lahko vnese '''mi''' za Material Icons [https://material.io/tools/icons/?style=baseline] ali '''fa''' za FontAwesome [https://origin.fontawesome.com/icons].

Za barve se lahko vnese katerakoli veljavna CSS notacija [https://www.w3schools.com/cssref/css_colors.asp]: LightRed, #FF0000, rgb(255,0,0), rgba(255,0,0,1.0).

== Napredne nastavitve ==

Ob prijavi lahko določene nastavitve spremenimo glede na prijavljenega uporabnika. To storimo tako, da dodamo novo proceduro:
<source>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</source>

== Priprava tematike ==
Tematiko se pripravi kot sicer. Izjemnega pomena pa je, da se tematika v vseh merilih in z vsemi vključenimi temami vedno izriše hitro, torej v rangu recimo 3 sekund (kar je že precej). Optimalno bi bilo 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 ta tema vklopi/izklopi. Če tema nima oznake, se nikoli ne prikaže. Če želimo temo prikazati vedno, vnesemo za znak '''*'''.

==== Atribut: View tags ====
Namen tega atributa je omejevanje vpogleda v podatke glede na uporabnika.

==== Atribut: Web info ====
V tem atributu določimo prej omenjene skupine. To storimo večvrstično v naslednji obliki:
<source>item=karte
name=Pregledne karte
sort=1
show=1
hint=...
icon=a.gif</source>
Vsaka oznaka se mora pojaviti natanko v eni temi, ni pomembno kateri. Iz teh informacij se potem generira menu za vklop/izklop v spletni aplikaciji. Prve štiri vrstice so obvezne.

== Priprava iskanj in izpisov ==
Iskanje po poljubnih podatkih se pripravi v urejevalniku podatkovne plasti (Searches). V modulu SdmsWSP pa z ukazom AddSearch dodajamo le tiste, ki jih želimo uporabljati v spletni aplikaciji.
...

== Nastavljanje pravic ==
Pri spletni aplikaciji je možno nastaviti različne nivoje dostopa (izris na karti, iskanje, izpis podatkov) glede na prijavljenega uporabnika.

V ta namen se uporablja kratke oznake, ki jih umenujemo '''Security tags'''.

=== Dodeljevanje pravic===
Te oznake se za uporabnika določa v urejevalniku uporabnika oz. v urejevalniku skupine uporabnikov (možno je tudi v varnostnem središču).

Vsak uporabnik/skupina ima lahko določenih več oznak, ki so ločene z vejico.

Uporabnik poleg svojih oznak dobi tudi vse oznake vseh skupin, v katerih je član.

=== Omejevanje pravic===
Na splošno velja naslednje:
*za vpoglede (tematika, vpogled preko iskanja/klika) velja, da če oznaka ni določena, imajo vpogled vsi, sicer pa samo tisti z oznako,
*za urejanja (dodajanje, popravljanje, brisanje) velja, da če oznaka ni določena, ne more urejati nihče, sicer pa samo tisti z oznako.

Pravice se omejuje:
*v tematiki:
**v atributu teme View tags
**v atrubutu teme Web info, v vrstici view=

*pri definiciji iskanja v podatkovni plasti:
**View access
**Append access
**Update access
**Delete access
**View in Update access pri posameznih poljih

*v SDMS Basicu, ukaz je MatchSecurityTags.

Vedno lahko določimo tudi več oznak, ločenih z vejico.

== TODO ==
*SQL pogoj filtra, uporabljenega v searchu se ne upošteva pri kliku
*dvonivojski sistem pri vsebinah za izris
*multiple datasete pri maski (vsaj view)
*images naj dela tudi za spisek datotek (RO)

== 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.* ===
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.

=== SEARCH.DLL ===
Izvede splošno iskanje po (full text search) in vrne zadetke.
:query=KLJUČNE BESEDE
::seznam ključnih besed za iskanje, ločenih s presledki
:category=KAT1,KAT2,KAT3
::seznam kategorij, po katerih se vrši iskanje (če je prazen, se vrši po vseh)
:hits=10
::maksimalno število zadetkov
:template=JSON
::ime templata, ki opredeljuje obliko zadetkov
AddSearch ...
Pred iskanjem se zažene še OnWebSearch...

SDMS WebServer

2019-01-30T11:29:44Z

Janez Trtnik: /* 2018: Offline podatki */

__NOTOC__
[[Kategorije: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'''
*za uporabo varnih povezav (https) se namesti certifikat strežnika, za navodila glej spodaj
*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
*nikakor ne smete pozabiti omogočiti uporabo želenih vrat (80, 443, ...) v požarnem zidu.

Strežnik je sedaj nameščen in zagnan.

=== Namestitev certifikata ===
Če se bo uporabljala varna povezava (https), je potrebno pridobiti in namestiti tudi certifikat strežnika. Pripravi se mapo, na katero se bo kopiral certifikat, lahko pa se ga kopira tudi kar na mapo programa. Pripravi se naslednje ASCII datoteke:
*'''''root.pem''''' - certifikat verifikacijskega strežnika
*'''''cert.pem''''' - certifikat strežnika
*'''''key.pem''''' - zakodiran privatni ključ strežnika
*'''''password.txt''''' - geslo za dekodiranje privatnega ključa

<source>
openssl pkcs12 -in xxx.pfx -out root.pem -cacerts // brez izhodnega gesla
openssl pkcs12 -in xxx.pfx -out certandkey.pem -clcerts // vnesi geslo za key, razbij na dve datoteki: cert.pem in key.pem
Geslo kodiraj z EncryptPassord in shrani v password.txt takole: ENCRYPTED:geslo
</source>

Kasneje se v modulu določi tudi pot do datotek certifikata.

== Aktivacija ==
'''SDMS WebServer''' se aktivira tako, da se v SDMS raziskovalcu doda nov modul z imenom '''SdmsWSP''' in naslednjo vsebino:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', '')
WebServer.Start
...
EndSub</source>

Če želimo dodati tudi dostop preko varne povezave (https), to storimo takole:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath)
WebServer.Start
...
EndSub</source>

Če želimo zagotoviti uporabo varne povezave (https) in izvesti samodejno preusmeritev nanjo:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http').SetRedirect('https://www.test.si/')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath + 'Certifikat\')
WebServer.Start
...
EndSub</source>

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

== Osnovne nastavitve ==
Strežniku moramo podati ime, ki se prikaže kot naslov strani. Uporablja se tudi kot identifikacija strežnika, če je ta potrebna.
<source>WebServer.Name = 'TEST'</source>
Ob prijavi se uporabniku prikaže logotip velikosti 480x120 pik. Datoteko se shrani na mapo WebServer in takole poda njeno ime.
<source>WebServer.Logo = 'logo.png'</source>

Privzeto dopušča SDMS WebServer dostop samo SDMS uporabnikom. Če želimo dodati tudi možnost anonimnega dostopa, to storimo tako:
<source>WebServer.User = [Gost]</source>
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.
<source>WebServer.Window = '370000,25000,630000,200000'</source>

Določiti je treba tematiko, ki se bo uporabljala za izris.
<source>WebServer.DrawList = [Web Tematika]</source>

Dodati je treba plasti, po katerih za izvaja iskanje in izpis podatkov.
<source>WebServer.AddSearch([Plast A].Search('Default'))
WebServer.AddSearch([Plast B].Search('Default'))</source>

Dobro je dodati tudi seznam priljubljenih lokacij, ki so dostopne iz menija.
<source>WebServer.AddLocation('Slovenija', '370000,25000,630000,200000', '')
WebServer.AddLocation('Ljubljana', '370000,25000,630000,200000', '')
WebServer.AddLocation('Maribor', '370000,25000,630000,200000', '')</source>

Možno je dodati tudi seznam dodatnih povezav, ki so ravno tako dostopne iz menija.
<source>WebServer.AddLink('Softdata Home Page', 'http://www.softdata.si', '')</source>

Dodamo tudi seznam dodatnih izrisov za tiskanje.
<source>WebServer.AddLayout([A4 Pokončno], '')
WebServer.AddLayout([A4 Ležeče], '')</source>

== 2018: Splošna dodatna opravila ==
Na mapi Database\WebServer se ustvari novo mapo 2018.

Nanjo se prekopira logo-*.png datoteke, ki so bile pri stari aplikaciji na rootu.

Nanjo se prekopira custom.js in custom.css iz mape SDMSWSP\WebServer\2018 in se ju primerno prilagodi.

== 2018: Tematika ==
Tematika za novo aplikacijo se pripravi kot prej, le da se v njej ne vnaša polja 'Informacije za web'. To polje se ignorira. Še vedno pa se uporabljata polji 'Dodatno ime' (obvezno) in 'Pravice' (opcijsko).

Kar je bilo prej določeno v informacijah za web, se sedaj določa v modulu SDMSWSP v funkciji OnCreate z dodajanjem elementov tipa TWebItem.
<source>
WI = WebServer.AddWebItem(A, B, C, D, E, F, G, H)
</source>
Parametri funkcije AddWebItem
A: (string) koda mape, na katero želimo vstaviti dani element, prazen string za root
B: (string) koda elementa, ki mora biti unikatna(!); za 'radio gumbe' se doda predpona xxx:, kjer je xxx ime skupine gumbov, vsaka grupa gumbov naj ima natanko en gump privzeto viden (E)
C: (string) ime elementa (napis)
D: (string) legenda za dani element, ki naj vsebuje tudi copyright informacijo, lahko v HTML obliki
E: (boolean) privzeta vidnost elementa
F: (double) transparentnost podlog, 0-1, privzeto 1, lahko se določi na mapah in kartah
G: (string) pravice za uporabo v online načinu: z vejico ločen seznam security tagov, vsi = '*', nihče = '-'; dodatne natančnejše pravice za prikaz pa so lahko nastavljene tudi v tematiki
H: (string) pravice za uporabo v offline načinu: velja enako kot pri (G)
Tako ustvarimo nov element (referenca nanj je v spremenljivki WI).

Če gre za element, ki predstavlja skupino elementov, ne potrebujemo narediti nič več.
Če gre za element, ki je povezan s piramido, to storimo z WI.SetPyramid('koda piramide')
<source>WI.SetPyramid('dof2018')</source>
Če gre za element, ki je povezan s spletnimi kartami, to storimo z WI.SetTms('koda spletnih kart')
<source>WI.SetTms('gm-s')</source>
Če gre za element, ki je povezan s temo/temami tematke, to storimo z WI.SetDrawItem('alias teme/tem')
<source>WI.SetDrawItem('parcele')</source>

Priporočamo striktno poravnavanje parametrov po kolonah, da se ohrani preglednost.

<source>
Dim WI As TWebItem

WI = WebServer.AddWebItem('', 'g-maps', 'Osnovne karte', '', True, 1.0, '*', '*')
WI = WebServer.AddWebItem('g-maps', 'm:gm-m', 'Google Maps', 'Google', False, 1.0, '*', '-') WI.SetTms('GM-M')
WI = WebServer.AddWebItem('g-maps', 'm:dof', 'DOF Slovenija', 'GURS', True, 1.0, '*', '*') WI.SetPyramid('DOF-GURS')
WI = WebServer.AddWebItem('g-maps', 'm:dmr', 'DMR Slovenija', 'GURS', False, 1.0, '*', '-') WI.SetPyramid('DMR-GURS')

WI = WebServer.AddWebItem('', 'g-sp', 'Splošne vsebine', '', True, 1.0, '*', '-')
WI = WebServer.AddWebItem('g-sp', 'dkn', 'Dkn', 'pa', False, 1.0, '*', '-') WI.SetDrawItem('dkn')
WI = WebServer.AddWebItem('g-sp', 'op', 'Opombe', 'op', True, 1.0, '*', '*') WI.SetDrawItem('op')
</source>

== 2018: Offline podloge ==
Novost je možnost uporabe podlog (piramide) v offline načinu.

Za to je treba elementu piramide določiti:
pravico offline uporabe(parameter H), ne pozabite tudi za nadrejene skupine
relevantno območje, kar je izjemno pomembno narediti pravilno, da se čimbolj omeji količina potrebnih kart za prenos v cache

Definicija relevantnega območja se določa za vse offline pologe enotno z ukazom WebServer.AddOfflineArea([plast], 'filter', offset, minpixdim).
<source>
WebServer.AddOfflineArea([plast poligonov], 'filter', 0, 0)
WebServer.AddOfflineArea([plast linij], 'filter', 50, 0)
WebServer.AddOfflineArea([plast točk], 'filter', 200, 0)
</source>
Vsakokrat, ko se ta defincija spremeni, je potrebno izvesti preračun relevantnega območja s klicom povezave "http://streznik/api/2018/prepareofflinemapsinfo"

== 2018: Offline podatki ==
Novost je možnost uporabe podatkov v offline načinu.

Za to je treba elementu teme določiti:
pravico offline uporabe(parameter H), tudi za nadrejene skupine
povezavo na dejanske podatke z ukazom '''WI.SetOfflineData([plast], 'iskanje')'''

<source>WI.SetOfflineData([parcele], 'Default')</source>

V sami plasti je potrebno dodati polja, ki določajo, kako se podatki v offline načinu izrisujejo.

Za točke: polje '''offline-icon''' z definicijo '''"ime simbola;font mi ali fa;velikost v px;stil n ali b;barva simbola;opcijska sirina sence v px;opcijska barva sence"'''
Za polilinije: polje '''offline-line''' z definicijo '''"debelina linije v px;barva linije"'''
Za poligone: polje '''offline-fill''' z definicijo '''"barva polnjenja;debelina linije v px;barva linije"'''

Za napise: polje '''offline-text''' z definicijo '''"napis;Roboto;velikost v px;stil n ali b;barva napisa;sirina sence v px;barva sence"'''

Za font simbolov se lahko vnese '''mi''' za Material Icons [https://material.io/tools/icons/?style=baseline] ali '''fa''' za FontAwesome [https://origin.fontawesome.com/icons].

Za barve se lahko vnese katerakoli veljavna CSS notacija [https://www.w3schools.com/cssref/css_colors.asp]: LightRed, #FF0000, rgb(255,0,0), rgba(255,0,0,1.0).

== Napredne nastavitve ==

Ob prijavi lahko določene nastavitve spremenimo glede na prijavljenega uporabnika. To storimo tako, da dodamo novo proceduro:
<source>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</source>

== Priprava tematike ==
Tematiko se pripravi kot sicer. Izjemnega pomena pa je, da se tematika v vseh merilih in z vsemi vključenimi temami vedno izriše hitro, torej v rangu recimo 3 sekund (kar je že precej). Optimalno bi bilo 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 ta tema vklopi/izklopi. Če tema nima oznake, se nikoli ne prikaže. Če želimo temo prikazati vedno, vnesemo za znak '''*'''.

==== Atribut: View tags ====
Namen tega atributa je omejevanje vpogleda v podatke glede na uporabnika.

==== Atribut: Web info ====
V tem atributu določimo prej omenjene skupine. To storimo večvrstično v naslednji obliki:
<source>item=karte
name=Pregledne karte
sort=1
show=1
hint=...
icon=a.gif</source>
Vsaka oznaka se mora pojaviti natanko v eni temi, ni pomembno kateri. Iz teh informacij se potem generira menu za vklop/izklop v spletni aplikaciji. Prve štiri vrstice so obvezne.

== Priprava iskanj in izpisov ==
Iskanje po poljubnih podatkih se pripravi v urejevalniku podatkovne plasti (Searches). V modulu SdmsWSP pa z ukazom AddSearch dodajamo le tiste, ki jih želimo uporabljati v spletni aplikaciji.
...

== Nastavljanje pravic ==
Pri spletni aplikaciji je možno nastaviti različne nivoje dostopa (izris na karti, iskanje, izpis podatkov) glede na prijavljenega uporabnika.

V ta namen se uporablja kratke oznake, ki jih umenujemo '''Security tags'''.

=== Dodeljevanje pravic===
Te oznake se za uporabnika določa v urejevalniku uporabnika oz. v urejevalniku skupine uporabnikov (možno je tudi v varnostnem središču).

Vsak uporabnik/skupina ima lahko določenih več oznak, ki so ločene z vejico.

Uporabnik poleg svojih oznak dobi tudi vse oznake vseh skupin, v katerih je član.

=== Omejevanje pravic===
Na splošno velja naslednje:
*za vpoglede (tematika, vpogled preko iskanja/klika) velja, da če oznaka ni določena, imajo vpogled vsi, sicer pa samo tisti z oznako,
*za urejanja (dodajanje, popravljanje, brisanje) velja, da če oznaka ni določena, ne more urejati nihče, sicer pa samo tisti z oznako.

Pravice se omejuje:
*v tematiki:
**v atributu teme View tags
**v atrubutu teme Web info, v vrstici view=

*pri definiciji iskanja v podatkovni plasti:
**View access
**Append access
**Update access
**Delete access
**View in Update access pri posameznih poljih

*v SDMS Basicu, ukaz je MatchSecurityTags.

Vedno lahko določimo tudi več oznak, ločenih z vejico.

== TODO ==
*SQL pogoj filtra, uporabljenega v searchu se ne upošteva pri kliku
*dvonivojski sistem pri vsebinah za izris
*multiple datasete pri maski (vsaj view)
*images naj dela tudi za spisek datotek (RO)

== 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.* ===
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.

=== SEARCH.DLL ===
Izvede splošno iskanje po (full text search) in vrne zadetke.
:query=KLJUČNE BESEDE
::seznam ključnih besed za iskanje, ločenih s presledki
:category=KAT1,KAT2,KAT3
::seznam kategorij, po katerih se vrši iskanje (če je prazen, se vrši po vseh)
:hits=10
::maksimalno število zadetkov
:template=JSON
::ime templata, ki opredeljuje obliko zadetkov
AddSearch ...
Pred iskanjem se zažene še OnWebSearch...

SDMS WebServer

2019-01-30T11:22:45Z

Janez Trtnik: /* 2018: Offline podatki */

__NOTOC__
[[Kategorije: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'''
*za uporabo varnih povezav (https) se namesti certifikat strežnika, za navodila glej spodaj
*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
*nikakor ne smete pozabiti omogočiti uporabo želenih vrat (80, 443, ...) v požarnem zidu.

Strežnik je sedaj nameščen in zagnan.

=== Namestitev certifikata ===
Če se bo uporabljala varna povezava (https), je potrebno pridobiti in namestiti tudi certifikat strežnika. Pripravi se mapo, na katero se bo kopiral certifikat, lahko pa se ga kopira tudi kar na mapo programa. Pripravi se naslednje ASCII datoteke:
*'''''root.pem''''' - certifikat verifikacijskega strežnika
*'''''cert.pem''''' - certifikat strežnika
*'''''key.pem''''' - zakodiran privatni ključ strežnika
*'''''password.txt''''' - geslo za dekodiranje privatnega ključa

<source>
openssl pkcs12 -in xxx.pfx -out root.pem -cacerts // brez izhodnega gesla
openssl pkcs12 -in xxx.pfx -out certandkey.pem -clcerts // vnesi geslo za key, razbij na dve datoteki: cert.pem in key.pem
Geslo kodiraj z EncryptPassord in shrani v password.txt takole: ENCRYPTED:geslo
</source>

Kasneje se v modulu določi tudi pot do datotek certifikata.

== Aktivacija ==
'''SDMS WebServer''' se aktivira tako, da se v SDMS raziskovalcu doda nov modul z imenom '''SdmsWSP''' in naslednjo vsebino:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', '')
WebServer.Start
...
EndSub</source>

Če želimo dodati tudi dostop preko varne povezave (https), to storimo takole:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath)
WebServer.Start
...
EndSub</source>

Če želimo zagotoviti uporabo varne povezave (https) in izvesti samodejno preusmeritev nanjo:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http').SetRedirect('https://www.test.si/')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath + 'Certifikat\')
WebServer.Start
...
EndSub</source>

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

== Osnovne nastavitve ==
Strežniku moramo podati ime, ki se prikaže kot naslov strani. Uporablja se tudi kot identifikacija strežnika, če je ta potrebna.
<source>WebServer.Name = 'TEST'</source>
Ob prijavi se uporabniku prikaže logotip velikosti 480x120 pik. Datoteko se shrani na mapo WebServer in takole poda njeno ime.
<source>WebServer.Logo = 'logo.png'</source>

Privzeto dopušča SDMS WebServer dostop samo SDMS uporabnikom. Če želimo dodati tudi možnost anonimnega dostopa, to storimo tako:
<source>WebServer.User = [Gost]</source>
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.
<source>WebServer.Window = '370000,25000,630000,200000'</source>

Določiti je treba tematiko, ki se bo uporabljala za izris.
<source>WebServer.DrawList = [Web Tematika]</source>

Dodati je treba plasti, po katerih za izvaja iskanje in izpis podatkov.
<source>WebServer.AddSearch([Plast A].Search('Default'))
WebServer.AddSearch([Plast B].Search('Default'))</source>

Dobro je dodati tudi seznam priljubljenih lokacij, ki so dostopne iz menija.
<source>WebServer.AddLocation('Slovenija', '370000,25000,630000,200000', '')
WebServer.AddLocation('Ljubljana', '370000,25000,630000,200000', '')
WebServer.AddLocation('Maribor', '370000,25000,630000,200000', '')</source>

Možno je dodati tudi seznam dodatnih povezav, ki so ravno tako dostopne iz menija.
<source>WebServer.AddLink('Softdata Home Page', 'http://www.softdata.si', '')</source>

Dodamo tudi seznam dodatnih izrisov za tiskanje.
<source>WebServer.AddLayout([A4 Pokončno], '')
WebServer.AddLayout([A4 Ležeče], '')</source>

== 2018: Splošna dodatna opravila ==
Na mapi Database\WebServer se ustvari novo mapo 2018.

Nanjo se prekopira logo-*.png datoteke, ki so bile pri stari aplikaciji na rootu.

Nanjo se prekopira custom.js in custom.css iz mape SDMSWSP\WebServer\2018 in se ju primerno prilagodi.

== 2018: Tematika ==
Tematika za novo aplikacijo se pripravi kot prej, le da se v njej ne vnaša polja 'Informacije za web'. To polje se ignorira. Še vedno pa se uporabljata polji 'Dodatno ime' (obvezno) in 'Pravice' (opcijsko).

Kar je bilo prej določeno v informacijah za web, se sedaj določa v modulu SDMSWSP v funkciji OnCreate z dodajanjem elementov tipa TWebItem.
<source>
WI = WebServer.AddWebItem(A, B, C, D, E, F, G, H)
</source>
Parametri funkcije AddWebItem
A: (string) koda mape, na katero želimo vstaviti dani element, prazen string za root
B: (string) koda elementa, ki mora biti unikatna(!); za 'radio gumbe' se doda predpona xxx:, kjer je xxx ime skupine gumbov, vsaka grupa gumbov naj ima natanko en gump privzeto viden (E)
C: (string) ime elementa (napis)
D: (string) legenda za dani element, ki naj vsebuje tudi copyright informacijo, lahko v HTML obliki
E: (boolean) privzeta vidnost elementa
F: (double) transparentnost podlog, 0-1, privzeto 1, lahko se določi na mapah in kartah
G: (string) pravice za uporabo v online načinu: z vejico ločen seznam security tagov, vsi = '*', nihče = '-'; dodatne natančnejše pravice za prikaz pa so lahko nastavljene tudi v tematiki
H: (string) pravice za uporabo v offline načinu: velja enako kot pri (G)
Tako ustvarimo nov element (referenca nanj je v spremenljivki WI).

Če gre za element, ki predstavlja skupino elementov, ne potrebujemo narediti nič več.
Če gre za element, ki je povezan s piramido, to storimo z WI.SetPyramid('koda piramide')
<source>WI.SetPyramid('dof2018')</source>
Če gre za element, ki je povezan s spletnimi kartami, to storimo z WI.SetTms('koda spletnih kart')
<source>WI.SetTms('gm-s')</source>
Če gre za element, ki je povezan s temo/temami tematke, to storimo z WI.SetDrawItem('alias teme/tem')
<source>WI.SetDrawItem('parcele')</source>

Priporočamo striktno poravnavanje parametrov po kolonah, da se ohrani preglednost.

<source>
Dim WI As TWebItem

WI = WebServer.AddWebItem('', 'g-maps', 'Osnovne karte', '', True, 1.0, '*', '*')
WI = WebServer.AddWebItem('g-maps', 'm:gm-m', 'Google Maps', 'Google', False, 1.0, '*', '-') WI.SetTms('GM-M')
WI = WebServer.AddWebItem('g-maps', 'm:dof', 'DOF Slovenija', 'GURS', True, 1.0, '*', '*') WI.SetPyramid('DOF-GURS')
WI = WebServer.AddWebItem('g-maps', 'm:dmr', 'DMR Slovenija', 'GURS', False, 1.0, '*', '-') WI.SetPyramid('DMR-GURS')

WI = WebServer.AddWebItem('', 'g-sp', 'Splošne vsebine', '', True, 1.0, '*', '-')
WI = WebServer.AddWebItem('g-sp', 'dkn', 'Dkn', 'pa', False, 1.0, '*', '-') WI.SetDrawItem('dkn')
WI = WebServer.AddWebItem('g-sp', 'op', 'Opombe', 'op', True, 1.0, '*', '*') WI.SetDrawItem('op')
</source>

== 2018: Offline podloge ==
Novost je možnost uporabe podlog (piramide) v offline načinu.

Za to je treba elementu piramide določiti:
pravico offline uporabe(parameter H), ne pozabite tudi za nadrejene skupine
relevantno območje, kar je izjemno pomembno narediti pravilno, da se čimbolj omeji količina potrebnih kart za prenos v cache

Definicija relevantnega območja se določa za vse offline pologe enotno z ukazom WebServer.AddOfflineArea([plast], 'filter', offset, minpixdim).
<source>
WebServer.AddOfflineArea([plast poligonov], 'filter', 0, 0)
WebServer.AddOfflineArea([plast linij], 'filter', 50, 0)
WebServer.AddOfflineArea([plast točk], 'filter', 200, 0)
</source>
Vsakokrat, ko se ta defincija spremeni, je potrebno izvesti preračun relevantnega območja s klicom povezave "http://streznik/api/2018/prepareofflinemapsinfo"

== 2018: Offline podatki ==
Novost je možnost uporabe podatkov v offline načinu.

Za to je treba elementu teme določiti:
pravico offline uporabe(parameter H), tudi za nadrejene skupine
povezavo na dejanske podatke z ukazom '''WI.SetOfflineData([plast], 'iskanje')'''

<source>WI.SetOfflineData([parcele], 'Default')</source>

V sami plasti je potrebno dodati polja, ki določajo, kako se podatki v offline načinu izrisujejo.

Za točke: polje '''offline-icon''' z definicijo '''"ime simbola;font mi ali fa;velikost v px;stil n ali b;barva simbola;opcijska sirina sence v px;opcijska barva sence"'''
Za polilinije: polje '''offline-line''' z definicijo '''"debelina linije v px;barva linije"'''
Za poligone: polje '''offline-fill''' z definicijo '''"barva polnjenja;debelina linije v px;barva linije"'''

Za napise: polje '''offline-text''' z definicijo '''"napis;Roboto;velikost v px;stil n ali b;barva napisa;sirina sence v px;barva sence"'''

Za barve se lahko vnese katerakoli veljavna CSS notacija: LightRed, #FF0000, rgb(255,0,0), rgba(255,0,0,1.0), glej šš[[https://www.w3schools.com/cssref/css_colors.asp]]

== Napredne nastavitve ==

Ob prijavi lahko določene nastavitve spremenimo glede na prijavljenega uporabnika. To storimo tako, da dodamo novo proceduro:
<source>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</source>

== Priprava tematike ==
Tematiko se pripravi kot sicer. Izjemnega pomena pa je, da se tematika v vseh merilih in z vsemi vključenimi temami vedno izriše hitro, torej v rangu recimo 3 sekund (kar je že precej). Optimalno bi bilo 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 ta tema vklopi/izklopi. Če tema nima oznake, se nikoli ne prikaže. Če želimo temo prikazati vedno, vnesemo za znak '''*'''.

==== Atribut: View tags ====
Namen tega atributa je omejevanje vpogleda v podatke glede na uporabnika.

==== Atribut: Web info ====
V tem atributu določimo prej omenjene skupine. To storimo večvrstično v naslednji obliki:
<source>item=karte
name=Pregledne karte
sort=1
show=1
hint=...
icon=a.gif</source>
Vsaka oznaka se mora pojaviti natanko v eni temi, ni pomembno kateri. Iz teh informacij se potem generira menu za vklop/izklop v spletni aplikaciji. Prve štiri vrstice so obvezne.

== Priprava iskanj in izpisov ==
Iskanje po poljubnih podatkih se pripravi v urejevalniku podatkovne plasti (Searches). V modulu SdmsWSP pa z ukazom AddSearch dodajamo le tiste, ki jih želimo uporabljati v spletni aplikaciji.
...

== Nastavljanje pravic ==
Pri spletni aplikaciji je možno nastaviti različne nivoje dostopa (izris na karti, iskanje, izpis podatkov) glede na prijavljenega uporabnika.

V ta namen se uporablja kratke oznake, ki jih umenujemo '''Security tags'''.

=== Dodeljevanje pravic===
Te oznake se za uporabnika določa v urejevalniku uporabnika oz. v urejevalniku skupine uporabnikov (možno je tudi v varnostnem središču).

Vsak uporabnik/skupina ima lahko določenih več oznak, ki so ločene z vejico.

Uporabnik poleg svojih oznak dobi tudi vse oznake vseh skupin, v katerih je član.

=== Omejevanje pravic===
Na splošno velja naslednje:
*za vpoglede (tematika, vpogled preko iskanja/klika) velja, da če oznaka ni določena, imajo vpogled vsi, sicer pa samo tisti z oznako,
*za urejanja (dodajanje, popravljanje, brisanje) velja, da če oznaka ni določena, ne more urejati nihče, sicer pa samo tisti z oznako.

Pravice se omejuje:
*v tematiki:
**v atributu teme View tags
**v atrubutu teme Web info, v vrstici view=

*pri definiciji iskanja v podatkovni plasti:
**View access
**Append access
**Update access
**Delete access
**View in Update access pri posameznih poljih

*v SDMS Basicu, ukaz je MatchSecurityTags.

Vedno lahko določimo tudi več oznak, ločenih z vejico.

== TODO ==
*SQL pogoj filtra, uporabljenega v searchu se ne upošteva pri kliku
*dvonivojski sistem pri vsebinah za izris
*multiple datasete pri maski (vsaj view)
*images naj dela tudi za spisek datotek (RO)

== 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.* ===
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.

=== SEARCH.DLL ===
Izvede splošno iskanje po (full text search) in vrne zadetke.
:query=KLJUČNE BESEDE
::seznam ključnih besed za iskanje, ločenih s presledki
:category=KAT1,KAT2,KAT3
::seznam kategorij, po katerih se vrši iskanje (če je prazen, se vrši po vseh)
:hits=10
::maksimalno število zadetkov
:template=JSON
::ime templata, ki opredeljuje obliko zadetkov
AddSearch ...
Pred iskanjem se zažene še OnWebSearch...

SDMS WebServer

2019-01-30T11:09:28Z

Janez Trtnik: /* 2018: Splošna opravila */

__NOTOC__
[[Kategorije: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'''
*za uporabo varnih povezav (https) se namesti certifikat strežnika, za navodila glej spodaj
*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
*nikakor ne smete pozabiti omogočiti uporabo želenih vrat (80, 443, ...) v požarnem zidu.

Strežnik je sedaj nameščen in zagnan.

=== Namestitev certifikata ===
Če se bo uporabljala varna povezava (https), je potrebno pridobiti in namestiti tudi certifikat strežnika. Pripravi se mapo, na katero se bo kopiral certifikat, lahko pa se ga kopira tudi kar na mapo programa. Pripravi se naslednje ASCII datoteke:
*'''''root.pem''''' - certifikat verifikacijskega strežnika
*'''''cert.pem''''' - certifikat strežnika
*'''''key.pem''''' - zakodiran privatni ključ strežnika
*'''''password.txt''''' - geslo za dekodiranje privatnega ključa

<source>
openssl pkcs12 -in xxx.pfx -out root.pem -cacerts // brez izhodnega gesla
openssl pkcs12 -in xxx.pfx -out certandkey.pem -clcerts // vnesi geslo za key, razbij na dve datoteki: cert.pem in key.pem
Geslo kodiraj z EncryptPassord in shrani v password.txt takole: ENCRYPTED:geslo
</source>

Kasneje se v modulu določi tudi pot do datotek certifikata.

== Aktivacija ==
'''SDMS WebServer''' se aktivira tako, da se v SDMS raziskovalcu doda nov modul z imenom '''SdmsWSP''' in naslednjo vsebino:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', '')
WebServer.Start
...
EndSub</source>

Če želimo dodati tudi dostop preko varne povezave (https), to storimo takole:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath)
WebServer.Start
...
EndSub</source>

Če želimo zagotoviti uporabo varne povezave (https) in izvesti samodejno preusmeritev nanjo:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http').SetRedirect('https://www.test.si/')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath + 'Certifikat\')
WebServer.Start
...
EndSub</source>

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

== Osnovne nastavitve ==
Strežniku moramo podati ime, ki se prikaže kot naslov strani. Uporablja se tudi kot identifikacija strežnika, če je ta potrebna.
<source>WebServer.Name = 'TEST'</source>
Ob prijavi se uporabniku prikaže logotip velikosti 480x120 pik. Datoteko se shrani na mapo WebServer in takole poda njeno ime.
<source>WebServer.Logo = 'logo.png'</source>

Privzeto dopušča SDMS WebServer dostop samo SDMS uporabnikom. Če želimo dodati tudi možnost anonimnega dostopa, to storimo tako:
<source>WebServer.User = [Gost]</source>
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.
<source>WebServer.Window = '370000,25000,630000,200000'</source>

Določiti je treba tematiko, ki se bo uporabljala za izris.
<source>WebServer.DrawList = [Web Tematika]</source>

Dodati je treba plasti, po katerih za izvaja iskanje in izpis podatkov.
<source>WebServer.AddSearch([Plast A].Search('Default'))
WebServer.AddSearch([Plast B].Search('Default'))</source>

Dobro je dodati tudi seznam priljubljenih lokacij, ki so dostopne iz menija.
<source>WebServer.AddLocation('Slovenija', '370000,25000,630000,200000', '')
WebServer.AddLocation('Ljubljana', '370000,25000,630000,200000', '')
WebServer.AddLocation('Maribor', '370000,25000,630000,200000', '')</source>

Možno je dodati tudi seznam dodatnih povezav, ki so ravno tako dostopne iz menija.
<source>WebServer.AddLink('Softdata Home Page', 'http://www.softdata.si', '')</source>

Dodamo tudi seznam dodatnih izrisov za tiskanje.
<source>WebServer.AddLayout([A4 Pokončno], '')
WebServer.AddLayout([A4 Ležeče], '')</source>

== 2018: Splošna dodatna opravila ==
Na mapi Database\WebServer se ustvari novo mapo 2018.

Nanjo se prekopira logo-*.png datoteke, ki so bile pri stari aplikaciji na rootu.

Nanjo se prekopira custom.js in custom.css iz mape SDMSWSP\WebServer\2018 in se ju primerno prilagodi.

== 2018: Tematika ==
Tematika za novo aplikacijo se pripravi kot prej, le da se v njej ne vnaša polja 'Informacije za web'. To polje se ignorira. Še vedno pa se uporabljata polji 'Dodatno ime' (obvezno) in 'Pravice' (opcijsko).

Kar je bilo prej določeno v informacijah za web, se sedaj določa v modulu SDMSWSP v funkciji OnCreate z dodajanjem elementov tipa TWebItem.
<source>
WI = WebServer.AddWebItem(A, B, C, D, E, F, G, H)
</source>
Parametri funkcije AddWebItem
A: (string) koda mape, na katero želimo vstaviti dani element, prazen string za root
B: (string) koda elementa, ki mora biti unikatna(!); za 'radio gumbe' se doda predpona xxx:, kjer je xxx ime skupine gumbov, vsaka grupa gumbov naj ima natanko en gump privzeto viden (E)
C: (string) ime elementa (napis)
D: (string) legenda za dani element, ki naj vsebuje tudi copyright informacijo, lahko v HTML obliki
E: (boolean) privzeta vidnost elementa
F: (double) transparentnost podlog, 0-1, privzeto 1, lahko se določi na mapah in kartah
G: (string) pravice za uporabo v online načinu: z vejico ločen seznam security tagov, vsi = '*', nihče = '-'; dodatne natančnejše pravice za prikaz pa so lahko nastavljene tudi v tematiki
H: (string) pravice za uporabo v offline načinu: velja enako kot pri (G)
Tako ustvarimo nov element (referenca nanj je v spremenljivki WI).

Če gre za element, ki predstavlja skupino elementov, ne potrebujemo narediti nič več.
Če gre za element, ki je povezan s piramido, to storimo z WI.SetPyramid('koda piramide')
<source>WI.SetPyramid('dof2018')</source>
Če gre za element, ki je povezan s spletnimi kartami, to storimo z WI.SetTms('koda spletnih kart')
<source>WI.SetTms('gm-s')</source>
Če gre za element, ki je povezan s temo/temami tematke, to storimo z WI.SetDrawItem('alias teme/tem')
<source>WI.SetDrawItem('parcele')</source>

Priporočamo striktno poravnavanje parametrov po kolonah, da se ohrani preglednost.

<source>
Dim WI As TWebItem

WI = WebServer.AddWebItem('', 'g-maps', 'Osnovne karte', '', True, 1.0, '*', '*')
WI = WebServer.AddWebItem('g-maps', 'm:gm-m', 'Google Maps', 'Google', False, 1.0, '*', '-') WI.SetTms('GM-M')
WI = WebServer.AddWebItem('g-maps', 'm:dof', 'DOF Slovenija', 'GURS', True, 1.0, '*', '*') WI.SetPyramid('DOF-GURS')
WI = WebServer.AddWebItem('g-maps', 'm:dmr', 'DMR Slovenija', 'GURS', False, 1.0, '*', '-') WI.SetPyramid('DMR-GURS')

WI = WebServer.AddWebItem('', 'g-sp', 'Splošne vsebine', '', True, 1.0, '*', '-')
WI = WebServer.AddWebItem('g-sp', 'dkn', 'Dkn', 'pa', False, 1.0, '*', '-') WI.SetDrawItem('dkn')
WI = WebServer.AddWebItem('g-sp', 'op', 'Opombe', 'op', True, 1.0, '*', '*') WI.SetDrawItem('op')
</source>

== 2018: Offline podloge ==
Novost je možnost uporabe podlog (piramide) v offline načinu.

Za to je treba elementu piramide določiti:
pravico offline uporabe(parameter H), ne pozabite tudi za nadrejene skupine
relevantno območje, kar je izjemno pomembno narediti pravilno, da se čimbolj omeji količina potrebnih kart za prenos v cache

Definicija relevantnega območja se določa za vse offline pologe enotno z ukazom WebServer.AddOfflineArea([plast], 'filter', offset, minpixdim).
<source>
WebServer.AddOfflineArea([plast poligonov], 'filter', 0, 0)
WebServer.AddOfflineArea([plast linij], 'filter', 50, 0)
WebServer.AddOfflineArea([plast točk], 'filter', 200, 0)
</source>
Vsakokrat, ko se ta defincija spremeni, je potrebno izvesti preračun relevantnega območja s klicom povezave "http://streznik/api/2018/prepareofflinemapsinfo"

== 2018: Offline podatki ==
Novost je možnost uporabe podatkov v offline načinu.

Za to je treba elementu teme določiti:
pravico offline uporabe(parameter H), tudi za nadrejene skupine
povezavo na dejanske podatke z ukazom WI.SetOfflineData([plast], 'iskanje')

<source>WI.SetOfflineData([parcele], 'Default')</source>

== Napredne nastavitve ==

Ob prijavi lahko določene nastavitve spremenimo glede na prijavljenega uporabnika. To storimo tako, da dodamo novo proceduro:
<source>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</source>

== Priprava tematike ==
Tematiko se pripravi kot sicer. Izjemnega pomena pa je, da se tematika v vseh merilih in z vsemi vključenimi temami vedno izriše hitro, torej v rangu recimo 3 sekund (kar je že precej). Optimalno bi bilo 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 ta tema vklopi/izklopi. Če tema nima oznake, se nikoli ne prikaže. Če želimo temo prikazati vedno, vnesemo za znak '''*'''.

==== Atribut: View tags ====
Namen tega atributa je omejevanje vpogleda v podatke glede na uporabnika.

==== Atribut: Web info ====
V tem atributu določimo prej omenjene skupine. To storimo večvrstično v naslednji obliki:
<source>item=karte
name=Pregledne karte
sort=1
show=1
hint=...
icon=a.gif</source>
Vsaka oznaka se mora pojaviti natanko v eni temi, ni pomembno kateri. Iz teh informacij se potem generira menu za vklop/izklop v spletni aplikaciji. Prve štiri vrstice so obvezne.

== Priprava iskanj in izpisov ==
Iskanje po poljubnih podatkih se pripravi v urejevalniku podatkovne plasti (Searches). V modulu SdmsWSP pa z ukazom AddSearch dodajamo le tiste, ki jih želimo uporabljati v spletni aplikaciji.
...

== Nastavljanje pravic ==
Pri spletni aplikaciji je možno nastaviti različne nivoje dostopa (izris na karti, iskanje, izpis podatkov) glede na prijavljenega uporabnika.

V ta namen se uporablja kratke oznake, ki jih umenujemo '''Security tags'''.

=== Dodeljevanje pravic===
Te oznake se za uporabnika določa v urejevalniku uporabnika oz. v urejevalniku skupine uporabnikov (možno je tudi v varnostnem središču).

Vsak uporabnik/skupina ima lahko določenih več oznak, ki so ločene z vejico.

Uporabnik poleg svojih oznak dobi tudi vse oznake vseh skupin, v katerih je član.

=== Omejevanje pravic===
Na splošno velja naslednje:
*za vpoglede (tematika, vpogled preko iskanja/klika) velja, da če oznaka ni določena, imajo vpogled vsi, sicer pa samo tisti z oznako,
*za urejanja (dodajanje, popravljanje, brisanje) velja, da če oznaka ni določena, ne more urejati nihče, sicer pa samo tisti z oznako.

Pravice se omejuje:
*v tematiki:
**v atributu teme View tags
**v atrubutu teme Web info, v vrstici view=

*pri definiciji iskanja v podatkovni plasti:
**View access
**Append access
**Update access
**Delete access
**View in Update access pri posameznih poljih

*v SDMS Basicu, ukaz je MatchSecurityTags.

Vedno lahko določimo tudi več oznak, ločenih z vejico.

== TODO ==
*SQL pogoj filtra, uporabljenega v searchu se ne upošteva pri kliku
*dvonivojski sistem pri vsebinah za izris
*multiple datasete pri maski (vsaj view)
*images naj dela tudi za spisek datotek (RO)

== 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.* ===
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.

=== SEARCH.DLL ===
Izvede splošno iskanje po (full text search) in vrne zadetke.
:query=KLJUČNE BESEDE
::seznam ključnih besed za iskanje, ločenih s presledki
:category=KAT1,KAT2,KAT3
::seznam kategorij, po katerih se vrši iskanje (če je prazen, se vrši po vseh)
:hits=10
::maksimalno število zadetkov
:template=JSON
::ime templata, ki opredeljuje obliko zadetkov
AddSearch ...
Pred iskanjem se zažene še OnWebSearch...

SDMS WebServer

2019-01-30T11:09:03Z

Janez Trtnik: /* 2018: Splošno */

__NOTOC__
[[Kategorije: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'''
*za uporabo varnih povezav (https) se namesti certifikat strežnika, za navodila glej spodaj
*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
*nikakor ne smete pozabiti omogočiti uporabo želenih vrat (80, 443, ...) v požarnem zidu.

Strežnik je sedaj nameščen in zagnan.

=== Namestitev certifikata ===
Če se bo uporabljala varna povezava (https), je potrebno pridobiti in namestiti tudi certifikat strežnika. Pripravi se mapo, na katero se bo kopiral certifikat, lahko pa se ga kopira tudi kar na mapo programa. Pripravi se naslednje ASCII datoteke:
*'''''root.pem''''' - certifikat verifikacijskega strežnika
*'''''cert.pem''''' - certifikat strežnika
*'''''key.pem''''' - zakodiran privatni ključ strežnika
*'''''password.txt''''' - geslo za dekodiranje privatnega ključa

<source>
openssl pkcs12 -in xxx.pfx -out root.pem -cacerts // brez izhodnega gesla
openssl pkcs12 -in xxx.pfx -out certandkey.pem -clcerts // vnesi geslo za key, razbij na dve datoteki: cert.pem in key.pem
Geslo kodiraj z EncryptPassord in shrani v password.txt takole: ENCRYPTED:geslo
</source>

Kasneje se v modulu določi tudi pot do datotek certifikata.

== Aktivacija ==
'''SDMS WebServer''' se aktivira tako, da se v SDMS raziskovalcu doda nov modul z imenom '''SdmsWSP''' in naslednjo vsebino:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', '')
WebServer.Start
...
EndSub</source>

Če želimo dodati tudi dostop preko varne povezave (https), to storimo takole:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath)
WebServer.Start
...
EndSub</source>

Če želimo zagotoviti uporabo varne povezave (https) in izvesti samodejno preusmeritev nanjo:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http').SetRedirect('https://www.test.si/')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath + 'Certifikat\')
WebServer.Start
...
EndSub</source>

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

== Osnovne nastavitve ==
Strežniku moramo podati ime, ki se prikaže kot naslov strani. Uporablja se tudi kot identifikacija strežnika, če je ta potrebna.
<source>WebServer.Name = 'TEST'</source>
Ob prijavi se uporabniku prikaže logotip velikosti 480x120 pik. Datoteko se shrani na mapo WebServer in takole poda njeno ime.
<source>WebServer.Logo = 'logo.png'</source>

Privzeto dopušča SDMS WebServer dostop samo SDMS uporabnikom. Če želimo dodati tudi možnost anonimnega dostopa, to storimo tako:
<source>WebServer.User = [Gost]</source>
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.
<source>WebServer.Window = '370000,25000,630000,200000'</source>

Določiti je treba tematiko, ki se bo uporabljala za izris.
<source>WebServer.DrawList = [Web Tematika]</source>

Dodati je treba plasti, po katerih za izvaja iskanje in izpis podatkov.
<source>WebServer.AddSearch([Plast A].Search('Default'))
WebServer.AddSearch([Plast B].Search('Default'))</source>

Dobro je dodati tudi seznam priljubljenih lokacij, ki so dostopne iz menija.
<source>WebServer.AddLocation('Slovenija', '370000,25000,630000,200000', '')
WebServer.AddLocation('Ljubljana', '370000,25000,630000,200000', '')
WebServer.AddLocation('Maribor', '370000,25000,630000,200000', '')</source>

Možno je dodati tudi seznam dodatnih povezav, ki so ravno tako dostopne iz menija.
<source>WebServer.AddLink('Softdata Home Page', 'http://www.softdata.si', '')</source>

Dodamo tudi seznam dodatnih izrisov za tiskanje.
<source>WebServer.AddLayout([A4 Pokončno], '')
WebServer.AddLayout([A4 Ležeče], '')</source>

== 2018: Splošna opravila ==
Na mapi Database\WebServer se ustvari novo mapo 2018.
Nanjo se prekopira logo-*.png datoteke, ki so bile pri stari aplikaciji na rootu.
Nanjo se prekopira custom.js in custom.css iz mape SDMSWSP\WebServer\2018 in se ju primerno prilagodi.

== 2018: Tematika ==
Tematika za novo aplikacijo se pripravi kot prej, le da se v njej ne vnaša polja 'Informacije za web'. To polje se ignorira. Še vedno pa se uporabljata polji 'Dodatno ime' (obvezno) in 'Pravice' (opcijsko).

Kar je bilo prej določeno v informacijah za web, se sedaj določa v modulu SDMSWSP v funkciji OnCreate z dodajanjem elementov tipa TWebItem.
<source>
WI = WebServer.AddWebItem(A, B, C, D, E, F, G, H)
</source>
Parametri funkcije AddWebItem
A: (string) koda mape, na katero želimo vstaviti dani element, prazen string za root
B: (string) koda elementa, ki mora biti unikatna(!); za 'radio gumbe' se doda predpona xxx:, kjer je xxx ime skupine gumbov, vsaka grupa gumbov naj ima natanko en gump privzeto viden (E)
C: (string) ime elementa (napis)
D: (string) legenda za dani element, ki naj vsebuje tudi copyright informacijo, lahko v HTML obliki
E: (boolean) privzeta vidnost elementa
F: (double) transparentnost podlog, 0-1, privzeto 1, lahko se določi na mapah in kartah
G: (string) pravice za uporabo v online načinu: z vejico ločen seznam security tagov, vsi = '*', nihče = '-'; dodatne natančnejše pravice za prikaz pa so lahko nastavljene tudi v tematiki
H: (string) pravice za uporabo v offline načinu: velja enako kot pri (G)
Tako ustvarimo nov element (referenca nanj je v spremenljivki WI).

Če gre za element, ki predstavlja skupino elementov, ne potrebujemo narediti nič več.
Če gre za element, ki je povezan s piramido, to storimo z WI.SetPyramid('koda piramide')
<source>WI.SetPyramid('dof2018')</source>
Če gre za element, ki je povezan s spletnimi kartami, to storimo z WI.SetTms('koda spletnih kart')
<source>WI.SetTms('gm-s')</source>
Če gre za element, ki je povezan s temo/temami tematke, to storimo z WI.SetDrawItem('alias teme/tem')
<source>WI.SetDrawItem('parcele')</source>

Priporočamo striktno poravnavanje parametrov po kolonah, da se ohrani preglednost.

<source>
Dim WI As TWebItem

WI = WebServer.AddWebItem('', 'g-maps', 'Osnovne karte', '', True, 1.0, '*', '*')
WI = WebServer.AddWebItem('g-maps', 'm:gm-m', 'Google Maps', 'Google', False, 1.0, '*', '-') WI.SetTms('GM-M')
WI = WebServer.AddWebItem('g-maps', 'm:dof', 'DOF Slovenija', 'GURS', True, 1.0, '*', '*') WI.SetPyramid('DOF-GURS')
WI = WebServer.AddWebItem('g-maps', 'm:dmr', 'DMR Slovenija', 'GURS', False, 1.0, '*', '-') WI.SetPyramid('DMR-GURS')

WI = WebServer.AddWebItem('', 'g-sp', 'Splošne vsebine', '', True, 1.0, '*', '-')
WI = WebServer.AddWebItem('g-sp', 'dkn', 'Dkn', 'pa', False, 1.0, '*', '-') WI.SetDrawItem('dkn')
WI = WebServer.AddWebItem('g-sp', 'op', 'Opombe', 'op', True, 1.0, '*', '*') WI.SetDrawItem('op')
</source>

== 2018: Offline podloge ==
Novost je možnost uporabe podlog (piramide) v offline načinu.

Za to je treba elementu piramide določiti:
pravico offline uporabe(parameter H), ne pozabite tudi za nadrejene skupine
relevantno območje, kar je izjemno pomembno narediti pravilno, da se čimbolj omeji količina potrebnih kart za prenos v cache

Definicija relevantnega območja se določa za vse offline pologe enotno z ukazom WebServer.AddOfflineArea([plast], 'filter', offset, minpixdim).
<source>
WebServer.AddOfflineArea([plast poligonov], 'filter', 0, 0)
WebServer.AddOfflineArea([plast linij], 'filter', 50, 0)
WebServer.AddOfflineArea([plast točk], 'filter', 200, 0)
</source>
Vsakokrat, ko se ta defincija spremeni, je potrebno izvesti preračun relevantnega območja s klicom povezave "http://streznik/api/2018/prepareofflinemapsinfo"

== 2018: Offline podatki ==
Novost je možnost uporabe podatkov v offline načinu.

Za to je treba elementu teme določiti:
pravico offline uporabe(parameter H), tudi za nadrejene skupine
povezavo na dejanske podatke z ukazom WI.SetOfflineData([plast], 'iskanje')

<source>WI.SetOfflineData([parcele], 'Default')</source>

== Napredne nastavitve ==

Ob prijavi lahko določene nastavitve spremenimo glede na prijavljenega uporabnika. To storimo tako, da dodamo novo proceduro:
<source>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</source>

== Priprava tematike ==
Tematiko se pripravi kot sicer. Izjemnega pomena pa je, da se tematika v vseh merilih in z vsemi vključenimi temami vedno izriše hitro, torej v rangu recimo 3 sekund (kar je že precej). Optimalno bi bilo 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 ta tema vklopi/izklopi. Če tema nima oznake, se nikoli ne prikaže. Če želimo temo prikazati vedno, vnesemo za znak '''*'''.

==== Atribut: View tags ====
Namen tega atributa je omejevanje vpogleda v podatke glede na uporabnika.

==== Atribut: Web info ====
V tem atributu določimo prej omenjene skupine. To storimo večvrstično v naslednji obliki:
<source>item=karte
name=Pregledne karte
sort=1
show=1
hint=...
icon=a.gif</source>
Vsaka oznaka se mora pojaviti natanko v eni temi, ni pomembno kateri. Iz teh informacij se potem generira menu za vklop/izklop v spletni aplikaciji. Prve štiri vrstice so obvezne.

== Priprava iskanj in izpisov ==
Iskanje po poljubnih podatkih se pripravi v urejevalniku podatkovne plasti (Searches). V modulu SdmsWSP pa z ukazom AddSearch dodajamo le tiste, ki jih želimo uporabljati v spletni aplikaciji.
...

== Nastavljanje pravic ==
Pri spletni aplikaciji je možno nastaviti različne nivoje dostopa (izris na karti, iskanje, izpis podatkov) glede na prijavljenega uporabnika.

V ta namen se uporablja kratke oznake, ki jih umenujemo '''Security tags'''.

=== Dodeljevanje pravic===
Te oznake se za uporabnika določa v urejevalniku uporabnika oz. v urejevalniku skupine uporabnikov (možno je tudi v varnostnem središču).

Vsak uporabnik/skupina ima lahko določenih več oznak, ki so ločene z vejico.

Uporabnik poleg svojih oznak dobi tudi vse oznake vseh skupin, v katerih je član.

=== Omejevanje pravic===
Na splošno velja naslednje:
*za vpoglede (tematika, vpogled preko iskanja/klika) velja, da če oznaka ni določena, imajo vpogled vsi, sicer pa samo tisti z oznako,
*za urejanja (dodajanje, popravljanje, brisanje) velja, da če oznaka ni določena, ne more urejati nihče, sicer pa samo tisti z oznako.

Pravice se omejuje:
*v tematiki:
**v atributu teme View tags
**v atrubutu teme Web info, v vrstici view=

*pri definiciji iskanja v podatkovni plasti:
**View access
**Append access
**Update access
**Delete access
**View in Update access pri posameznih poljih

*v SDMS Basicu, ukaz je MatchSecurityTags.

Vedno lahko določimo tudi več oznak, ločenih z vejico.

== TODO ==
*SQL pogoj filtra, uporabljenega v searchu se ne upošteva pri kliku
*dvonivojski sistem pri vsebinah za izris
*multiple datasete pri maski (vsaj view)
*images naj dela tudi za spisek datotek (RO)

== 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.* ===
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.

=== SEARCH.DLL ===
Izvede splošno iskanje po (full text search) in vrne zadetke.
:query=KLJUČNE BESEDE
::seznam ključnih besed za iskanje, ločenih s presledki
:category=KAT1,KAT2,KAT3
::seznam kategorij, po katerih se vrši iskanje (če je prazen, se vrši po vseh)
:hits=10
::maksimalno število zadetkov
:template=JSON
::ime templata, ki opredeljuje obliko zadetkov
AddSearch ...
Pred iskanjem se zažene še OnWebSearch...

SDMS WebServer

2019-01-30T11:04:44Z

Janez Trtnik: /* 2018: Offline podloge */

__NOTOC__
[[Kategorije: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'''
*za uporabo varnih povezav (https) se namesti certifikat strežnika, za navodila glej spodaj
*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
*nikakor ne smete pozabiti omogočiti uporabo želenih vrat (80, 443, ...) v požarnem zidu.

Strežnik je sedaj nameščen in zagnan.

=== Namestitev certifikata ===
Če se bo uporabljala varna povezava (https), je potrebno pridobiti in namestiti tudi certifikat strežnika. Pripravi se mapo, na katero se bo kopiral certifikat, lahko pa se ga kopira tudi kar na mapo programa. Pripravi se naslednje ASCII datoteke:
*'''''root.pem''''' - certifikat verifikacijskega strežnika
*'''''cert.pem''''' - certifikat strežnika
*'''''key.pem''''' - zakodiran privatni ključ strežnika
*'''''password.txt''''' - geslo za dekodiranje privatnega ključa

<source>
openssl pkcs12 -in xxx.pfx -out root.pem -cacerts // brez izhodnega gesla
openssl pkcs12 -in xxx.pfx -out certandkey.pem -clcerts // vnesi geslo za key, razbij na dve datoteki: cert.pem in key.pem
Geslo kodiraj z EncryptPassord in shrani v password.txt takole: ENCRYPTED:geslo
</source>

Kasneje se v modulu določi tudi pot do datotek certifikata.

== Aktivacija ==
'''SDMS WebServer''' se aktivira tako, da se v SDMS raziskovalcu doda nov modul z imenom '''SdmsWSP''' in naslednjo vsebino:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', '')
WebServer.Start
...
EndSub</source>

Če želimo dodati tudi dostop preko varne povezave (https), to storimo takole:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath)
WebServer.Start
...
EndSub</source>

Če želimo zagotoviti uporabo varne povezave (https) in izvesti samodejno preusmeritev nanjo:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http').SetRedirect('https://www.test.si/')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath + 'Certifikat\')
WebServer.Start
...
EndSub</source>

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

== Osnovne nastavitve ==
Strežniku moramo podati ime, ki se prikaže kot naslov strani. Uporablja se tudi kot identifikacija strežnika, če je ta potrebna.
<source>WebServer.Name = 'TEST'</source>
Ob prijavi se uporabniku prikaže logotip velikosti 480x120 pik. Datoteko se shrani na mapo WebServer in takole poda njeno ime.
<source>WebServer.Logo = 'logo.png'</source>

Privzeto dopušča SDMS WebServer dostop samo SDMS uporabnikom. Če želimo dodati tudi možnost anonimnega dostopa, to storimo tako:
<source>WebServer.User = [Gost]</source>
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.
<source>WebServer.Window = '370000,25000,630000,200000'</source>

Določiti je treba tematiko, ki se bo uporabljala za izris.
<source>WebServer.DrawList = [Web Tematika]</source>

Dodati je treba plasti, po katerih za izvaja iskanje in izpis podatkov.
<source>WebServer.AddSearch([Plast A].Search('Default'))
WebServer.AddSearch([Plast B].Search('Default'))</source>

Dobro je dodati tudi seznam priljubljenih lokacij, ki so dostopne iz menija.
<source>WebServer.AddLocation('Slovenija', '370000,25000,630000,200000', '')
WebServer.AddLocation('Ljubljana', '370000,25000,630000,200000', '')
WebServer.AddLocation('Maribor', '370000,25000,630000,200000', '')</source>

Možno je dodati tudi seznam dodatnih povezav, ki so ravno tako dostopne iz menija.
<source>WebServer.AddLink('Softdata Home Page', 'http://www.softdata.si', '')</source>

Dodamo tudi seznam dodatnih izrisov za tiskanje.
<source>WebServer.AddLayout([A4 Pokončno], '')
WebServer.AddLayout([A4 Ležeče], '')</source>

== 2018: Splošno ==
2018/logo*
2018/custom.js

== 2018: Tematika ==
Tematika za novo aplikacijo se pripravi kot prej, le da se v njej ne vnaša polja 'Informacije za web'. To polje se ignorira. Še vedno pa se uporabljata polji 'Dodatno ime' (obvezno) in 'Pravice' (opcijsko).

Kar je bilo prej določeno v informacijah za web, se sedaj določa v modulu SDMSWSP v funkciji OnCreate z dodajanjem elementov tipa TWebItem.
<source>
WI = WebServer.AddWebItem(A, B, C, D, E, F, G, H)
</source>
Parametri funkcije AddWebItem
A: (string) koda mape, na katero želimo vstaviti dani element, prazen string za root
B: (string) koda elementa, ki mora biti unikatna(!); za 'radio gumbe' se doda predpona xxx:, kjer je xxx ime skupine gumbov, vsaka grupa gumbov naj ima natanko en gump privzeto viden (E)
C: (string) ime elementa (napis)
D: (string) legenda za dani element, ki naj vsebuje tudi copyright informacijo, lahko v HTML obliki
E: (boolean) privzeta vidnost elementa
F: (double) transparentnost podlog, 0-1, privzeto 1, lahko se določi na mapah in kartah
G: (string) pravice za uporabo v online načinu: z vejico ločen seznam security tagov, vsi = '*', nihče = '-'; dodatne natančnejše pravice za prikaz pa so lahko nastavljene tudi v tematiki
H: (string) pravice za uporabo v offline načinu: velja enako kot pri (G)
Tako ustvarimo nov element (referenca nanj je v spremenljivki WI).

Če gre za element, ki predstavlja skupino elementov, ne potrebujemo narediti nič več.
Če gre za element, ki je povezan s piramido, to storimo z WI.SetPyramid('koda piramide')
<source>WI.SetPyramid('dof2018')</source>
Če gre za element, ki je povezan s spletnimi kartami, to storimo z WI.SetTms('koda spletnih kart')
<source>WI.SetTms('gm-s')</source>
Če gre za element, ki je povezan s temo/temami tematke, to storimo z WI.SetDrawItem('alias teme/tem')
<source>WI.SetDrawItem('parcele')</source>

Priporočamo striktno poravnavanje parametrov po kolonah, da se ohrani preglednost.

<source>
Dim WI As TWebItem

WI = WebServer.AddWebItem('', 'g-maps', 'Osnovne karte', '', True, 1.0, '*', '*')
WI = WebServer.AddWebItem('g-maps', 'm:gm-m', 'Google Maps', 'Google', False, 1.0, '*', '-') WI.SetTms('GM-M')
WI = WebServer.AddWebItem('g-maps', 'm:dof', 'DOF Slovenija', 'GURS', True, 1.0, '*', '*') WI.SetPyramid('DOF-GURS')
WI = WebServer.AddWebItem('g-maps', 'm:dmr', 'DMR Slovenija', 'GURS', False, 1.0, '*', '-') WI.SetPyramid('DMR-GURS')

WI = WebServer.AddWebItem('', 'g-sp', 'Splošne vsebine', '', True, 1.0, '*', '-')
WI = WebServer.AddWebItem('g-sp', 'dkn', 'Dkn', 'pa', False, 1.0, '*', '-') WI.SetDrawItem('dkn')
WI = WebServer.AddWebItem('g-sp', 'op', 'Opombe', 'op', True, 1.0, '*', '*') WI.SetDrawItem('op')
</source>

== 2018: Offline podloge ==
Novost je možnost uporabe podlog (piramide) v offline načinu.

Za to je treba elementu piramide določiti:
pravico offline uporabe(parameter H), ne pozabite tudi za nadrejene skupine
relevantno območje, kar je izjemno pomembno narediti pravilno, da se čimbolj omeji količina potrebnih kart za prenos v cache

Definicija relevantnega območja se določa za vse offline pologe enotno z ukazom WebServer.AddOfflineArea([plast], 'filter', offset, minpixdim).
<source>
WebServer.AddOfflineArea([plast poligonov], 'filter', 0, 0)
WebServer.AddOfflineArea([plast linij], 'filter', 50, 0)
WebServer.AddOfflineArea([plast točk], 'filter', 200, 0)
</source>
Vsakokrat, ko se ta defincija spremeni, je potrebno izvesti preračun relevantnega območja s klicom povezave "http://streznik/api/2018/prepareofflinemapsinfo"

== 2018: Offline podatki ==
Novost je možnost uporabe podatkov v offline načinu.

Za to je treba elementu teme določiti:
pravico offline uporabe(parameter H), tudi za nadrejene skupine
povezavo na dejanske podatke z ukazom WI.SetOfflineData([plast], 'iskanje')

<source>WI.SetOfflineData([parcele], 'Default')</source>

== Napredne nastavitve ==

Ob prijavi lahko določene nastavitve spremenimo glede na prijavljenega uporabnika. To storimo tako, da dodamo novo proceduro:
<source>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</source>

== Priprava tematike ==
Tematiko se pripravi kot sicer. Izjemnega pomena pa je, da se tematika v vseh merilih in z vsemi vključenimi temami vedno izriše hitro, torej v rangu recimo 3 sekund (kar je že precej). Optimalno bi bilo 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 ta tema vklopi/izklopi. Če tema nima oznake, se nikoli ne prikaže. Če želimo temo prikazati vedno, vnesemo za znak '''*'''.

==== Atribut: View tags ====
Namen tega atributa je omejevanje vpogleda v podatke glede na uporabnika.

==== Atribut: Web info ====
V tem atributu določimo prej omenjene skupine. To storimo večvrstično v naslednji obliki:
<source>item=karte
name=Pregledne karte
sort=1
show=1
hint=...
icon=a.gif</source>
Vsaka oznaka se mora pojaviti natanko v eni temi, ni pomembno kateri. Iz teh informacij se potem generira menu za vklop/izklop v spletni aplikaciji. Prve štiri vrstice so obvezne.

== Priprava iskanj in izpisov ==
Iskanje po poljubnih podatkih se pripravi v urejevalniku podatkovne plasti (Searches). V modulu SdmsWSP pa z ukazom AddSearch dodajamo le tiste, ki jih želimo uporabljati v spletni aplikaciji.
...

== Nastavljanje pravic ==
Pri spletni aplikaciji je možno nastaviti različne nivoje dostopa (izris na karti, iskanje, izpis podatkov) glede na prijavljenega uporabnika.

V ta namen se uporablja kratke oznake, ki jih umenujemo '''Security tags'''.

=== Dodeljevanje pravic===
Te oznake se za uporabnika določa v urejevalniku uporabnika oz. v urejevalniku skupine uporabnikov (možno je tudi v varnostnem središču).

Vsak uporabnik/skupina ima lahko določenih več oznak, ki so ločene z vejico.

Uporabnik poleg svojih oznak dobi tudi vse oznake vseh skupin, v katerih je član.

=== Omejevanje pravic===
Na splošno velja naslednje:
*za vpoglede (tematika, vpogled preko iskanja/klika) velja, da če oznaka ni določena, imajo vpogled vsi, sicer pa samo tisti z oznako,
*za urejanja (dodajanje, popravljanje, brisanje) velja, da če oznaka ni določena, ne more urejati nihče, sicer pa samo tisti z oznako.

Pravice se omejuje:
*v tematiki:
**v atributu teme View tags
**v atrubutu teme Web info, v vrstici view=

*pri definiciji iskanja v podatkovni plasti:
**View access
**Append access
**Update access
**Delete access
**View in Update access pri posameznih poljih

*v SDMS Basicu, ukaz je MatchSecurityTags.

Vedno lahko določimo tudi več oznak, ločenih z vejico.

== TODO ==
*SQL pogoj filtra, uporabljenega v searchu se ne upošteva pri kliku
*dvonivojski sistem pri vsebinah za izris
*multiple datasete pri maski (vsaj view)
*images naj dela tudi za spisek datotek (RO)

== 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.* ===
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.

=== SEARCH.DLL ===
Izvede splošno iskanje po (full text search) in vrne zadetke.
:query=KLJUČNE BESEDE
::seznam ključnih besed za iskanje, ločenih s presledki
:category=KAT1,KAT2,KAT3
::seznam kategorij, po katerih se vrši iskanje (če je prazen, se vrši po vseh)
:hits=10
::maksimalno število zadetkov
:template=JSON
::ime templata, ki opredeljuje obliko zadetkov
AddSearch ...
Pred iskanjem se zažene še OnWebSearch...

SDMS WebServer

2019-01-30T11:02:33Z

Janez Trtnik: /* 2018: Tematika */

__NOTOC__
[[Kategorije: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'''
*za uporabo varnih povezav (https) se namesti certifikat strežnika, za navodila glej spodaj
*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
*nikakor ne smete pozabiti omogočiti uporabo želenih vrat (80, 443, ...) v požarnem zidu.

Strežnik je sedaj nameščen in zagnan.

=== Namestitev certifikata ===
Če se bo uporabljala varna povezava (https), je potrebno pridobiti in namestiti tudi certifikat strežnika. Pripravi se mapo, na katero se bo kopiral certifikat, lahko pa se ga kopira tudi kar na mapo programa. Pripravi se naslednje ASCII datoteke:
*'''''root.pem''''' - certifikat verifikacijskega strežnika
*'''''cert.pem''''' - certifikat strežnika
*'''''key.pem''''' - zakodiran privatni ključ strežnika
*'''''password.txt''''' - geslo za dekodiranje privatnega ključa

<source>
openssl pkcs12 -in xxx.pfx -out root.pem -cacerts // brez izhodnega gesla
openssl pkcs12 -in xxx.pfx -out certandkey.pem -clcerts // vnesi geslo za key, razbij na dve datoteki: cert.pem in key.pem
Geslo kodiraj z EncryptPassord in shrani v password.txt takole: ENCRYPTED:geslo
</source>

Kasneje se v modulu določi tudi pot do datotek certifikata.

== Aktivacija ==
'''SDMS WebServer''' se aktivira tako, da se v SDMS raziskovalcu doda nov modul z imenom '''SdmsWSP''' in naslednjo vsebino:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', '')
WebServer.Start
...
EndSub</source>

Če želimo dodati tudi dostop preko varne povezave (https), to storimo takole:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath)
WebServer.Start
...
EndSub</source>

Če želimo zagotoviti uporabo varne povezave (https) in izvesti samodejno preusmeritev nanjo:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http').SetRedirect('https://www.test.si/')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath + 'Certifikat\')
WebServer.Start
...
EndSub</source>

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

== Osnovne nastavitve ==
Strežniku moramo podati ime, ki se prikaže kot naslov strani. Uporablja se tudi kot identifikacija strežnika, če je ta potrebna.
<source>WebServer.Name = 'TEST'</source>
Ob prijavi se uporabniku prikaže logotip velikosti 480x120 pik. Datoteko se shrani na mapo WebServer in takole poda njeno ime.
<source>WebServer.Logo = 'logo.png'</source>

Privzeto dopušča SDMS WebServer dostop samo SDMS uporabnikom. Če želimo dodati tudi možnost anonimnega dostopa, to storimo tako:
<source>WebServer.User = [Gost]</source>
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.
<source>WebServer.Window = '370000,25000,630000,200000'</source>

Določiti je treba tematiko, ki se bo uporabljala za izris.
<source>WebServer.DrawList = [Web Tematika]</source>

Dodati je treba plasti, po katerih za izvaja iskanje in izpis podatkov.
<source>WebServer.AddSearch([Plast A].Search('Default'))
WebServer.AddSearch([Plast B].Search('Default'))</source>

Dobro je dodati tudi seznam priljubljenih lokacij, ki so dostopne iz menija.
<source>WebServer.AddLocation('Slovenija', '370000,25000,630000,200000', '')
WebServer.AddLocation('Ljubljana', '370000,25000,630000,200000', '')
WebServer.AddLocation('Maribor', '370000,25000,630000,200000', '')</source>

Možno je dodati tudi seznam dodatnih povezav, ki so ravno tako dostopne iz menija.
<source>WebServer.AddLink('Softdata Home Page', 'http://www.softdata.si', '')</source>

Dodamo tudi seznam dodatnih izrisov za tiskanje.
<source>WebServer.AddLayout([A4 Pokončno], '')
WebServer.AddLayout([A4 Ležeče], '')</source>

== 2018: Splošno ==
2018/logo*
2018/custom.js

== 2018: Tematika ==
Tematika za novo aplikacijo se pripravi kot prej, le da se v njej ne vnaša polja 'Informacije za web'. To polje se ignorira. Še vedno pa se uporabljata polji 'Dodatno ime' (obvezno) in 'Pravice' (opcijsko).

Kar je bilo prej določeno v informacijah za web, se sedaj določa v modulu SDMSWSP v funkciji OnCreate z dodajanjem elementov tipa TWebItem.
<source>
WI = WebServer.AddWebItem(A, B, C, D, E, F, G, H)
</source>
Parametri funkcije AddWebItem
A: (string) koda mape, na katero želimo vstaviti dani element, prazen string za root
B: (string) koda elementa, ki mora biti unikatna(!); za 'radio gumbe' se doda predpona xxx:, kjer je xxx ime skupine gumbov, vsaka grupa gumbov naj ima natanko en gump privzeto viden (E)
C: (string) ime elementa (napis)
D: (string) legenda za dani element, ki naj vsebuje tudi copyright informacijo, lahko v HTML obliki
E: (boolean) privzeta vidnost elementa
F: (double) transparentnost podlog, 0-1, privzeto 1, lahko se določi na mapah in kartah
G: (string) pravice za uporabo v online načinu: z vejico ločen seznam security tagov, vsi = '*', nihče = '-'; dodatne natančnejše pravice za prikaz pa so lahko nastavljene tudi v tematiki
H: (string) pravice za uporabo v offline načinu: velja enako kot pri (G)
Tako ustvarimo nov element (referenca nanj je v spremenljivki WI).

Če gre za element, ki predstavlja skupino elementov, ne potrebujemo narediti nič več.
Če gre za element, ki je povezan s piramido, to storimo z WI.SetPyramid('koda piramide')
<source>WI.SetPyramid('dof2018')</source>
Če gre za element, ki je povezan s spletnimi kartami, to storimo z WI.SetTms('koda spletnih kart')
<source>WI.SetTms('gm-s')</source>
Če gre za element, ki je povezan s temo/temami tematke, to storimo z WI.SetDrawItem('alias teme/tem')
<source>WI.SetDrawItem('parcele')</source>

Priporočamo striktno poravnavanje parametrov po kolonah, da se ohrani preglednost.

<source>
Dim WI As TWebItem

WI = WebServer.AddWebItem('', 'g-maps', 'Osnovne karte', '', True, 1.0, '*', '*')
WI = WebServer.AddWebItem('g-maps', 'm:gm-m', 'Google Maps', 'Google', False, 1.0, '*', '-') WI.SetTms('GM-M')
WI = WebServer.AddWebItem('g-maps', 'm:dof', 'DOF Slovenija', 'GURS', True, 1.0, '*', '*') WI.SetPyramid('DOF-GURS')
WI = WebServer.AddWebItem('g-maps', 'm:dmr', 'DMR Slovenija', 'GURS', False, 1.0, '*', '-') WI.SetPyramid('DMR-GURS')

WI = WebServer.AddWebItem('', 'g-sp', 'Splošne vsebine', '', True, 1.0, '*', '-')
WI = WebServer.AddWebItem('g-sp', 'dkn', 'Dkn', 'pa', False, 1.0, '*', '-') WI.SetDrawItem('dkn')
WI = WebServer.AddWebItem('g-sp', 'op', 'Opombe', 'op', True, 1.0, '*', '*') WI.SetDrawItem('op')
</source>

== 2018: Offline podloge ==
Novost je možnost uporabe podlog (piramide) v offline načinu.

Za to je treba elementu piramide določiti:
pravico offline uporabe(parameter H), tudi za nadrejene skupine
relevantno območje, kar je izjemno pomembno narediti pravilno, da se čimbolj omeji količina potrebnih kart za prenos v cache

Definicija relevantnega območja se določa za vse offline elemente piramid enotno z ukazom WebServer.AddOfflineArea([plast], 'filter', offset, limit).
<source>
WebServer.AddOfflineArea([plast poligonov], 'filter', 0, 0)
WebServer.AddOfflineArea([plast linij], 'filter', 50, 0)
WebServer.AddOfflineArea([plast točk], 'filter', 200, 0)
</source>
Vsakič, ko se ta defincija spremeni, je potrebno izvesti preračun relevantnega območja klicom "povezave http://streznik/api/2018/prepareofflinemapsinfo"

== 2018: Offline podatki ==
Novost je možnost uporabe podatkov v offline načinu.

Za to je treba elementu teme določiti:
pravico offline uporabe(parameter H), tudi za nadrejene skupine
povezavo na dejanske podatke z ukazom WI.SetOfflineData([plast], 'iskanje')

<source>WI.SetOfflineData([parcele], 'Default')</source>

== Napredne nastavitve ==

Ob prijavi lahko določene nastavitve spremenimo glede na prijavljenega uporabnika. To storimo tako, da dodamo novo proceduro:
<source>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</source>

== Priprava tematike ==
Tematiko se pripravi kot sicer. Izjemnega pomena pa je, da se tematika v vseh merilih in z vsemi vključenimi temami vedno izriše hitro, torej v rangu recimo 3 sekund (kar je že precej). Optimalno bi bilo 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 ta tema vklopi/izklopi. Če tema nima oznake, se nikoli ne prikaže. Če želimo temo prikazati vedno, vnesemo za znak '''*'''.

==== Atribut: View tags ====
Namen tega atributa je omejevanje vpogleda v podatke glede na uporabnika.

==== Atribut: Web info ====
V tem atributu določimo prej omenjene skupine. To storimo večvrstično v naslednji obliki:
<source>item=karte
name=Pregledne karte
sort=1
show=1
hint=...
icon=a.gif</source>
Vsaka oznaka se mora pojaviti natanko v eni temi, ni pomembno kateri. Iz teh informacij se potem generira menu za vklop/izklop v spletni aplikaciji. Prve štiri vrstice so obvezne.

== Priprava iskanj in izpisov ==
Iskanje po poljubnih podatkih se pripravi v urejevalniku podatkovne plasti (Searches). V modulu SdmsWSP pa z ukazom AddSearch dodajamo le tiste, ki jih želimo uporabljati v spletni aplikaciji.
...

== Nastavljanje pravic ==
Pri spletni aplikaciji je možno nastaviti različne nivoje dostopa (izris na karti, iskanje, izpis podatkov) glede na prijavljenega uporabnika.

V ta namen se uporablja kratke oznake, ki jih umenujemo '''Security tags'''.

=== Dodeljevanje pravic===
Te oznake se za uporabnika določa v urejevalniku uporabnika oz. v urejevalniku skupine uporabnikov (možno je tudi v varnostnem središču).

Vsak uporabnik/skupina ima lahko določenih več oznak, ki so ločene z vejico.

Uporabnik poleg svojih oznak dobi tudi vse oznake vseh skupin, v katerih je član.

=== Omejevanje pravic===
Na splošno velja naslednje:
*za vpoglede (tematika, vpogled preko iskanja/klika) velja, da če oznaka ni določena, imajo vpogled vsi, sicer pa samo tisti z oznako,
*za urejanja (dodajanje, popravljanje, brisanje) velja, da če oznaka ni določena, ne more urejati nihče, sicer pa samo tisti z oznako.

Pravice se omejuje:
*v tematiki:
**v atributu teme View tags
**v atrubutu teme Web info, v vrstici view=

*pri definiciji iskanja v podatkovni plasti:
**View access
**Append access
**Update access
**Delete access
**View in Update access pri posameznih poljih

*v SDMS Basicu, ukaz je MatchSecurityTags.

Vedno lahko določimo tudi več oznak, ločenih z vejico.

== TODO ==
*SQL pogoj filtra, uporabljenega v searchu se ne upošteva pri kliku
*dvonivojski sistem pri vsebinah za izris
*multiple datasete pri maski (vsaj view)
*images naj dela tudi za spisek datotek (RO)

== 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.* ===
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.

=== SEARCH.DLL ===
Izvede splošno iskanje po (full text search) in vrne zadetke.
:query=KLJUČNE BESEDE
::seznam ključnih besed za iskanje, ločenih s presledki
:category=KAT1,KAT2,KAT3
::seznam kategorij, po katerih se vrši iskanje (če je prazen, se vrši po vseh)
:hits=10
::maksimalno število zadetkov
:template=JSON
::ime templata, ki opredeljuje obliko zadetkov
AddSearch ...
Pred iskanjem se zažene še OnWebSearch...

SDMS WebServer

2019-01-30T11:00:30Z

Janez Trtnik: /* 2018: Tematika */

__NOTOC__
[[Kategorije: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'''
*za uporabo varnih povezav (https) se namesti certifikat strežnika, za navodila glej spodaj
*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
*nikakor ne smete pozabiti omogočiti uporabo želenih vrat (80, 443, ...) v požarnem zidu.

Strežnik je sedaj nameščen in zagnan.

=== Namestitev certifikata ===
Če se bo uporabljala varna povezava (https), je potrebno pridobiti in namestiti tudi certifikat strežnika. Pripravi se mapo, na katero se bo kopiral certifikat, lahko pa se ga kopira tudi kar na mapo programa. Pripravi se naslednje ASCII datoteke:
*'''''root.pem''''' - certifikat verifikacijskega strežnika
*'''''cert.pem''''' - certifikat strežnika
*'''''key.pem''''' - zakodiran privatni ključ strežnika
*'''''password.txt''''' - geslo za dekodiranje privatnega ključa

<source>
openssl pkcs12 -in xxx.pfx -out root.pem -cacerts // brez izhodnega gesla
openssl pkcs12 -in xxx.pfx -out certandkey.pem -clcerts // vnesi geslo za key, razbij na dve datoteki: cert.pem in key.pem
Geslo kodiraj z EncryptPassord in shrani v password.txt takole: ENCRYPTED:geslo
</source>

Kasneje se v modulu določi tudi pot do datotek certifikata.

== Aktivacija ==
'''SDMS WebServer''' se aktivira tako, da se v SDMS raziskovalcu doda nov modul z imenom '''SdmsWSP''' in naslednjo vsebino:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', '')
WebServer.Start
...
EndSub</source>

Če želimo dodati tudi dostop preko varne povezave (https), to storimo takole:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath)
WebServer.Start
...
EndSub</source>

Če želimo zagotoviti uporabo varne povezave (https) in izvesti samodejno preusmeritev nanjo:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http').SetRedirect('https://www.test.si/')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath + 'Certifikat\')
WebServer.Start
...
EndSub</source>

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

== Osnovne nastavitve ==
Strežniku moramo podati ime, ki se prikaže kot naslov strani. Uporablja se tudi kot identifikacija strežnika, če je ta potrebna.
<source>WebServer.Name = 'TEST'</source>
Ob prijavi se uporabniku prikaže logotip velikosti 480x120 pik. Datoteko se shrani na mapo WebServer in takole poda njeno ime.
<source>WebServer.Logo = 'logo.png'</source>

Privzeto dopušča SDMS WebServer dostop samo SDMS uporabnikom. Če želimo dodati tudi možnost anonimnega dostopa, to storimo tako:
<source>WebServer.User = [Gost]</source>
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.
<source>WebServer.Window = '370000,25000,630000,200000'</source>

Določiti je treba tematiko, ki se bo uporabljala za izris.
<source>WebServer.DrawList = [Web Tematika]</source>

Dodati je treba plasti, po katerih za izvaja iskanje in izpis podatkov.
<source>WebServer.AddSearch([Plast A].Search('Default'))
WebServer.AddSearch([Plast B].Search('Default'))</source>

Dobro je dodati tudi seznam priljubljenih lokacij, ki so dostopne iz menija.
<source>WebServer.AddLocation('Slovenija', '370000,25000,630000,200000', '')
WebServer.AddLocation('Ljubljana', '370000,25000,630000,200000', '')
WebServer.AddLocation('Maribor', '370000,25000,630000,200000', '')</source>

Možno je dodati tudi seznam dodatnih povezav, ki so ravno tako dostopne iz menija.
<source>WebServer.AddLink('Softdata Home Page', 'http://www.softdata.si', '')</source>

Dodamo tudi seznam dodatnih izrisov za tiskanje.
<source>WebServer.AddLayout([A4 Pokončno], '')
WebServer.AddLayout([A4 Ležeče], '')</source>

== 2018: Splošno ==
2018/logo*
2018/custom.js

== 2018: Tematika ==
Tematika za novo aplikacijo se pripravi kot prej, le da se v njej ne vnaša polja 'Informacije za web'. To polje se ignorira. Še vedno pa se uporabljata polji 'Dodatno ime' (obvezno) in 'Pravice' (opcijsko).

Kar je bilo prej določeno v informacijah za web, se sedaj določa v modulu SDMSWSP v funkciji OnCreate z dodajanjem elementov tipa TWebItem.
<source>
Dim WI As TWebItem
WI = WebServer.AddWebItem(A, B, C, D, E, F, G, H)
</source>
Parametri funkcije AddWebItem
A: (string) koda mape, na katero želimo vstaviti dani element, prazen string za root
B: (string) koda elementa, ki mora biti unikatna(!); za 'radio gumbe' se doda predpona xxx:, kjer je xxx ime skupine gumbov, vsaka grupa gumbov naj ima natanko en gump privzeto viden (E)
C: (string) ime elementa (napis)
D: (string) legenda za dani element, ki naj vsebuje tudi copyright informacijo, lahko v HTML obliki
E: (boolean) privzeta vidnost elementa
F: (double) transparentnost podlog, 0-1, privzeto 1, lahko se določi na mapah in kartah
G: (string) pravice za uporabo v online načinu: z vejico ločen seznam security tagov, vsi = '*', nihče = '-'; dodatne natančnejše pravice za prikaz pa so lahko nastavljene tudi v tematiki
H: (string) pravice za uporabo v offline načinu: velja enako kot pri (G)
Tako ustvarimo nov element (referenca nanj je v spremenljivki WI).

Če gre za element, ki predstavlja skupino elementov, ne potrebujemo narediti nič več.
Če gre za element, ki je povezan s piramido, to storimo z WI.SetPyramid('koda piramide')
<source>WI.SetPyramid('dof2018')</source>
Če gre za element, ki je povezan s spletnimi kartami, to storimo z WI.SetTms('koda spletnih kart')
<source>WI.SetTms('gm-s')</source>
Če gre za element, ki je povezan s temo/temami tematke, to storimo z WI.SetDrawItem('alias teme/tem')
<source>WI.SetDrawItem('parcele')</source>

Priporočamo striktno poravnavanje parametrov po kolonah, da se ohrani preglednost.

<source>
WI = WebServer.AddWebItem('', 'g-maps', 'Osnovne karte', '', True, 1.0, '*', '*')
WI = WebServer.AddWebItem('g-maps', 'm:gm-m', 'Google Maps', 'Google', False, 1.0, '*', '-') WI.SetTms('GM-M')
WI = WebServer.AddWebItem('g-maps', 'm:dof', 'DOF Slovenija', 'GURS', True, 1.0, '*', '*') WI.SetPyramid('DOF-GURS')
WI = WebServer.AddWebItem('g-maps', 'm:dmr', 'DMR Slovenija', 'GURS', False, 1.0, '*', '-') WI.SetPyramid('DMR-GURS')

WI = WebServer.AddWebItem('', 'g-sp', 'Splošne vsebine', '', True, 1.0, '*', '-')
WI = WebServer.AddWebItem('g-sp', 'dkn', 'Dkn', 'pa', False, 1.0, '*', '-') WI.SetDrawItem('dkn')
WI = WebServer.AddWebItem('g-sp', 'op', 'Opombe', 'op', True, 1.0, '*', '*') WI.SetDrawItem('op')

</source>

== 2018: Offline podloge ==
Novost je možnost uporabe podlog (piramide) v offline načinu.

Za to je treba elementu piramide določiti:
pravico offline uporabe(parameter H), tudi za nadrejene skupine
relevantno območje, kar je izjemno pomembno narediti pravilno, da se čimbolj omeji količina potrebnih kart za prenos v cache

Definicija relevantnega območja se določa za vse offline elemente piramid enotno z ukazom WebServer.AddOfflineArea([plast], 'filter', offset, limit).
<source>
WebServer.AddOfflineArea([plast poligonov], 'filter', 0, 0)
WebServer.AddOfflineArea([plast linij], 'filter', 50, 0)
WebServer.AddOfflineArea([plast točk], 'filter', 200, 0)
</source>
Vsakič, ko se ta defincija spremeni, je potrebno izvesti preračun relevantnega območja klicom "povezave http://streznik/api/2018/prepareofflinemapsinfo"

== 2018: Offline podatki ==
Novost je možnost uporabe podatkov v offline načinu.

Za to je treba elementu teme določiti:
pravico offline uporabe(parameter H), tudi za nadrejene skupine
povezavo na dejanske podatke z ukazom WI.SetOfflineData([plast], 'iskanje')

<source>WI.SetOfflineData([parcele], 'Default')</source>

== Napredne nastavitve ==

Ob prijavi lahko določene nastavitve spremenimo glede na prijavljenega uporabnika. To storimo tako, da dodamo novo proceduro:
<source>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</source>

== Priprava tematike ==
Tematiko se pripravi kot sicer. Izjemnega pomena pa je, da se tematika v vseh merilih in z vsemi vključenimi temami vedno izriše hitro, torej v rangu recimo 3 sekund (kar je že precej). Optimalno bi bilo 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 ta tema vklopi/izklopi. Če tema nima oznake, se nikoli ne prikaže. Če želimo temo prikazati vedno, vnesemo za znak '''*'''.

==== Atribut: View tags ====
Namen tega atributa je omejevanje vpogleda v podatke glede na uporabnika.

==== Atribut: Web info ====
V tem atributu določimo prej omenjene skupine. To storimo večvrstično v naslednji obliki:
<source>item=karte
name=Pregledne karte
sort=1
show=1
hint=...
icon=a.gif</source>
Vsaka oznaka se mora pojaviti natanko v eni temi, ni pomembno kateri. Iz teh informacij se potem generira menu za vklop/izklop v spletni aplikaciji. Prve štiri vrstice so obvezne.

== Priprava iskanj in izpisov ==
Iskanje po poljubnih podatkih se pripravi v urejevalniku podatkovne plasti (Searches). V modulu SdmsWSP pa z ukazom AddSearch dodajamo le tiste, ki jih želimo uporabljati v spletni aplikaciji.
...

== Nastavljanje pravic ==
Pri spletni aplikaciji je možno nastaviti različne nivoje dostopa (izris na karti, iskanje, izpis podatkov) glede na prijavljenega uporabnika.

V ta namen se uporablja kratke oznake, ki jih umenujemo '''Security tags'''.

=== Dodeljevanje pravic===
Te oznake se za uporabnika določa v urejevalniku uporabnika oz. v urejevalniku skupine uporabnikov (možno je tudi v varnostnem središču).

Vsak uporabnik/skupina ima lahko določenih več oznak, ki so ločene z vejico.

Uporabnik poleg svojih oznak dobi tudi vse oznake vseh skupin, v katerih je član.

=== Omejevanje pravic===
Na splošno velja naslednje:
*za vpoglede (tematika, vpogled preko iskanja/klika) velja, da če oznaka ni določena, imajo vpogled vsi, sicer pa samo tisti z oznako,
*za urejanja (dodajanje, popravljanje, brisanje) velja, da če oznaka ni določena, ne more urejati nihče, sicer pa samo tisti z oznako.

Pravice se omejuje:
*v tematiki:
**v atributu teme View tags
**v atrubutu teme Web info, v vrstici view=

*pri definiciji iskanja v podatkovni plasti:
**View access
**Append access
**Update access
**Delete access
**View in Update access pri posameznih poljih

*v SDMS Basicu, ukaz je MatchSecurityTags.

Vedno lahko določimo tudi več oznak, ločenih z vejico.

== TODO ==
*SQL pogoj filtra, uporabljenega v searchu se ne upošteva pri kliku
*dvonivojski sistem pri vsebinah za izris
*multiple datasete pri maski (vsaj view)
*images naj dela tudi za spisek datotek (RO)

== 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.* ===
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.

=== SEARCH.DLL ===
Izvede splošno iskanje po (full text search) in vrne zadetke.
:query=KLJUČNE BESEDE
::seznam ključnih besed za iskanje, ločenih s presledki
:category=KAT1,KAT2,KAT3
::seznam kategorij, po katerih se vrši iskanje (če je prazen, se vrši po vseh)
:hits=10
::maksimalno število zadetkov
:template=JSON
::ime templata, ki opredeljuje obliko zadetkov
AddSearch ...
Pred iskanjem se zažene še OnWebSearch...

SDMS WebServer

2019-01-30T10:56:33Z

Janez Trtnik: /* 2018: Tematika */

__NOTOC__
[[Kategorije: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'''
*za uporabo varnih povezav (https) se namesti certifikat strežnika, za navodila glej spodaj
*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
*nikakor ne smete pozabiti omogočiti uporabo želenih vrat (80, 443, ...) v požarnem zidu.

Strežnik je sedaj nameščen in zagnan.

=== Namestitev certifikata ===
Če se bo uporabljala varna povezava (https), je potrebno pridobiti in namestiti tudi certifikat strežnika. Pripravi se mapo, na katero se bo kopiral certifikat, lahko pa se ga kopira tudi kar na mapo programa. Pripravi se naslednje ASCII datoteke:
*'''''root.pem''''' - certifikat verifikacijskega strežnika
*'''''cert.pem''''' - certifikat strežnika
*'''''key.pem''''' - zakodiran privatni ključ strežnika
*'''''password.txt''''' - geslo za dekodiranje privatnega ključa

<source>
openssl pkcs12 -in xxx.pfx -out root.pem -cacerts // brez izhodnega gesla
openssl pkcs12 -in xxx.pfx -out certandkey.pem -clcerts // vnesi geslo za key, razbij na dve datoteki: cert.pem in key.pem
Geslo kodiraj z EncryptPassord in shrani v password.txt takole: ENCRYPTED:geslo
</source>

Kasneje se v modulu določi tudi pot do datotek certifikata.

== Aktivacija ==
'''SDMS WebServer''' se aktivira tako, da se v SDMS raziskovalcu doda nov modul z imenom '''SdmsWSP''' in naslednjo vsebino:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', '')
WebServer.Start
...
EndSub</source>

Če želimo dodati tudi dostop preko varne povezave (https), to storimo takole:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath)
WebServer.Start
...
EndSub</source>

Če želimo zagotoviti uporabo varne povezave (https) in izvesti samodejno preusmeritev nanjo:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http').SetRedirect('https://www.test.si/')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath + 'Certifikat\')
WebServer.Start
...
EndSub</source>

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

== Osnovne nastavitve ==
Strežniku moramo podati ime, ki se prikaže kot naslov strani. Uporablja se tudi kot identifikacija strežnika, če je ta potrebna.
<source>WebServer.Name = 'TEST'</source>
Ob prijavi se uporabniku prikaže logotip velikosti 480x120 pik. Datoteko se shrani na mapo WebServer in takole poda njeno ime.
<source>WebServer.Logo = 'logo.png'</source>

Privzeto dopušča SDMS WebServer dostop samo SDMS uporabnikom. Če želimo dodati tudi možnost anonimnega dostopa, to storimo tako:
<source>WebServer.User = [Gost]</source>
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.
<source>WebServer.Window = '370000,25000,630000,200000'</source>

Določiti je treba tematiko, ki se bo uporabljala za izris.
<source>WebServer.DrawList = [Web Tematika]</source>

Dodati je treba plasti, po katerih za izvaja iskanje in izpis podatkov.
<source>WebServer.AddSearch([Plast A].Search('Default'))
WebServer.AddSearch([Plast B].Search('Default'))</source>

Dobro je dodati tudi seznam priljubljenih lokacij, ki so dostopne iz menija.
<source>WebServer.AddLocation('Slovenija', '370000,25000,630000,200000', '')
WebServer.AddLocation('Ljubljana', '370000,25000,630000,200000', '')
WebServer.AddLocation('Maribor', '370000,25000,630000,200000', '')</source>

Možno je dodati tudi seznam dodatnih povezav, ki so ravno tako dostopne iz menija.
<source>WebServer.AddLink('Softdata Home Page', 'http://www.softdata.si', '')</source>

Dodamo tudi seznam dodatnih izrisov za tiskanje.
<source>WebServer.AddLayout([A4 Pokončno], '')
WebServer.AddLayout([A4 Ležeče], '')</source>

== 2018: Splošno ==
2018/logo*
2018/custom.js

== 2018: Tematika ==
Tematika za novo aplikacijo se pripravi kot prej, le da se v njej ne vnaša polja 'Informacije za web'. To polje se ignorira. Še vedno pa se uporabljata polji 'Dodatno ime' (obvezno) in 'Pravice' (opcijsko).

Kar je bilo prej določeno v informacijah za web, se sedaj določa v modulu SDMSWSP v funkciji OnCreate z dodajanjem elementov tipa TWebItem.
<source>
Dim WI As TWebItem
WI = WebServer.AddWebItem(A, B, C, D, E, F, G, H)
</source>
Parametri funkcije AddWebItem
A: (string) koda mape, na katero želimo vstaviti dani element, prazen string za root
B: (string) koda elementa, ki mora biti unikatna(!); za 'radio gumbe' se doda predpona xxx:, kjer je xxx ime skupine gumbov, vsaka grupa gumbov naj ima natanko en gump privzeto viden (E)
C: (string) ime elementa (napis)
D: (string) legenda za dani element, ki naj vsebuje tudi copyright informacijo, lahko v HTML obliki
E: (boolean) privzeta vidnost elementa
F: (double) transparentnost podlog, 0-1, privzeto 1, lahko se določi na mapah in kartah
G: (string) pravice za uporabo v online načinu: z vejico ločen seznam security tagov, vsi = '*', nihče = '-'; dodatne natančnejše pravice za prikaz pa so lahko nastavljene tudi v tematiki
H: (string) pravice za uporabo v offline načinu: velja enako kot pri (G)
Tako ustvarimo nov element (referenca nanj je v spremenljivki WI).

Če gre za element, ki predstavlja skupino elementov, ne potrebujemo narediti nič več.
Če gre za element, ki je povezan s piramido, to storimo z WI.SetPyramid('koda piramide')
<source>WI.SetPyramid('dof2018')</source>
Če gre za element, ki je povezan s spletnimi kartami, to storimo z WI.SetTms('koda spletnih kart')
<source>WI.SetTms('gm-s')</source>
Če gre za element, ki je povezan s temo/temami tematke, to storimo z WI.SetDrawItem('alias teme/tem')
<source>WI.SetDrawItem('parcele')</source>

Priporočamo striktno poravnavanje parametrov po kolonah, da se ohrani preglednost.

== 2018: Offline podloge ==
Novost je možnost uporabe podlog (piramide) v offline načinu.

Za to je treba elementu piramide določiti:
pravico offline uporabe(parameter H), tudi za nadrejene skupine
relevantno območje, kar je izjemno pomembno narediti pravilno, da se čimbolj omeji količina potrebnih kart za prenos v cache

Definicija relevantnega območja se določa za vse offline elemente piramid enotno z ukazom WebServer.AddOfflineArea([plast], 'filter', offset, limit).
<source>
WebServer.AddOfflineArea([plast poligonov], 'filter', 0, 0)
WebServer.AddOfflineArea([plast linij], 'filter', 50, 0)
WebServer.AddOfflineArea([plast točk], 'filter', 200, 0)
</source>
Vsakič, ko se ta defincija spremeni, je potrebno izvesti preračun relevantnega območja klicom "povezave http://streznik/api/2018/prepareofflinemapsinfo"

== 2018: Offline podatki ==
Novost je možnost uporabe podatkov v offline načinu.

Za to je treba elementu teme določiti:
pravico offline uporabe(parameter H), tudi za nadrejene skupine
povezavo na dejanske podatke z ukazom WI.SetOfflineData([plast], 'iskanje')

<source>WI.SetOfflineData([parcele], 'Default')</source>

== Napredne nastavitve ==

Ob prijavi lahko določene nastavitve spremenimo glede na prijavljenega uporabnika. To storimo tako, da dodamo novo proceduro:
<source>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</source>

== Priprava tematike ==
Tematiko se pripravi kot sicer. Izjemnega pomena pa je, da se tematika v vseh merilih in z vsemi vključenimi temami vedno izriše hitro, torej v rangu recimo 3 sekund (kar je že precej). Optimalno bi bilo 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 ta tema vklopi/izklopi. Če tema nima oznake, se nikoli ne prikaže. Če želimo temo prikazati vedno, vnesemo za znak '''*'''.

==== Atribut: View tags ====
Namen tega atributa je omejevanje vpogleda v podatke glede na uporabnika.

==== Atribut: Web info ====
V tem atributu določimo prej omenjene skupine. To storimo večvrstično v naslednji obliki:
<source>item=karte
name=Pregledne karte
sort=1
show=1
hint=...
icon=a.gif</source>
Vsaka oznaka se mora pojaviti natanko v eni temi, ni pomembno kateri. Iz teh informacij se potem generira menu za vklop/izklop v spletni aplikaciji. Prve štiri vrstice so obvezne.

== Priprava iskanj in izpisov ==
Iskanje po poljubnih podatkih se pripravi v urejevalniku podatkovne plasti (Searches). V modulu SdmsWSP pa z ukazom AddSearch dodajamo le tiste, ki jih želimo uporabljati v spletni aplikaciji.
...

== Nastavljanje pravic ==
Pri spletni aplikaciji je možno nastaviti različne nivoje dostopa (izris na karti, iskanje, izpis podatkov) glede na prijavljenega uporabnika.

V ta namen se uporablja kratke oznake, ki jih umenujemo '''Security tags'''.

=== Dodeljevanje pravic===
Te oznake se za uporabnika določa v urejevalniku uporabnika oz. v urejevalniku skupine uporabnikov (možno je tudi v varnostnem središču).

Vsak uporabnik/skupina ima lahko določenih več oznak, ki so ločene z vejico.

Uporabnik poleg svojih oznak dobi tudi vse oznake vseh skupin, v katerih je član.

=== Omejevanje pravic===
Na splošno velja naslednje:
*za vpoglede (tematika, vpogled preko iskanja/klika) velja, da če oznaka ni določena, imajo vpogled vsi, sicer pa samo tisti z oznako,
*za urejanja (dodajanje, popravljanje, brisanje) velja, da če oznaka ni določena, ne more urejati nihče, sicer pa samo tisti z oznako.

Pravice se omejuje:
*v tematiki:
**v atributu teme View tags
**v atrubutu teme Web info, v vrstici view=

*pri definiciji iskanja v podatkovni plasti:
**View access
**Append access
**Update access
**Delete access
**View in Update access pri posameznih poljih

*v SDMS Basicu, ukaz je MatchSecurityTags.

Vedno lahko določimo tudi več oznak, ločenih z vejico.

== TODO ==
*SQL pogoj filtra, uporabljenega v searchu se ne upošteva pri kliku
*dvonivojski sistem pri vsebinah za izris
*multiple datasete pri maski (vsaj view)
*images naj dela tudi za spisek datotek (RO)

== 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.* ===
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.

=== SEARCH.DLL ===
Izvede splošno iskanje po (full text search) in vrne zadetke.
:query=KLJUČNE BESEDE
::seznam ključnih besed za iskanje, ločenih s presledki
:category=KAT1,KAT2,KAT3
::seznam kategorij, po katerih se vrši iskanje (če je prazen, se vrši po vseh)
:hits=10
::maksimalno število zadetkov
:template=JSON
::ime templata, ki opredeljuje obliko zadetkov
AddSearch ...
Pred iskanjem se zažene še OnWebSearch...

SDMS WebServer

2019-01-30T10:55:32Z

Janez Trtnik: /* 2018: Tematika */

__NOTOC__
[[Kategorije: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'''
*za uporabo varnih povezav (https) se namesti certifikat strežnika, za navodila glej spodaj
*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
*nikakor ne smete pozabiti omogočiti uporabo želenih vrat (80, 443, ...) v požarnem zidu.

Strežnik je sedaj nameščen in zagnan.

=== Namestitev certifikata ===
Če se bo uporabljala varna povezava (https), je potrebno pridobiti in namestiti tudi certifikat strežnika. Pripravi se mapo, na katero se bo kopiral certifikat, lahko pa se ga kopira tudi kar na mapo programa. Pripravi se naslednje ASCII datoteke:
*'''''root.pem''''' - certifikat verifikacijskega strežnika
*'''''cert.pem''''' - certifikat strežnika
*'''''key.pem''''' - zakodiran privatni ključ strežnika
*'''''password.txt''''' - geslo za dekodiranje privatnega ključa

<source>
openssl pkcs12 -in xxx.pfx -out root.pem -cacerts // brez izhodnega gesla
openssl pkcs12 -in xxx.pfx -out certandkey.pem -clcerts // vnesi geslo za key, razbij na dve datoteki: cert.pem in key.pem
Geslo kodiraj z EncryptPassord in shrani v password.txt takole: ENCRYPTED:geslo
</source>

Kasneje se v modulu določi tudi pot do datotek certifikata.

== Aktivacija ==
'''SDMS WebServer''' se aktivira tako, da se v SDMS raziskovalcu doda nov modul z imenom '''SdmsWSP''' in naslednjo vsebino:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', '')
WebServer.Start
...
EndSub</source>

Če želimo dodati tudi dostop preko varne povezave (https), to storimo takole:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath)
WebServer.Start
...
EndSub</source>

Če želimo zagotoviti uporabo varne povezave (https) in izvesti samodejno preusmeritev nanjo:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http').SetRedirect('https://www.test.si/')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath + 'Certifikat\')
WebServer.Start
...
EndSub</source>

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

== Osnovne nastavitve ==
Strežniku moramo podati ime, ki se prikaže kot naslov strani. Uporablja se tudi kot identifikacija strežnika, če je ta potrebna.
<source>WebServer.Name = 'TEST'</source>
Ob prijavi se uporabniku prikaže logotip velikosti 480x120 pik. Datoteko se shrani na mapo WebServer in takole poda njeno ime.
<source>WebServer.Logo = 'logo.png'</source>

Privzeto dopušča SDMS WebServer dostop samo SDMS uporabnikom. Če želimo dodati tudi možnost anonimnega dostopa, to storimo tako:
<source>WebServer.User = [Gost]</source>
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.
<source>WebServer.Window = '370000,25000,630000,200000'</source>

Določiti je treba tematiko, ki se bo uporabljala za izris.
<source>WebServer.DrawList = [Web Tematika]</source>

Dodati je treba plasti, po katerih za izvaja iskanje in izpis podatkov.
<source>WebServer.AddSearch([Plast A].Search('Default'))
WebServer.AddSearch([Plast B].Search('Default'))</source>

Dobro je dodati tudi seznam priljubljenih lokacij, ki so dostopne iz menija.
<source>WebServer.AddLocation('Slovenija', '370000,25000,630000,200000', '')
WebServer.AddLocation('Ljubljana', '370000,25000,630000,200000', '')
WebServer.AddLocation('Maribor', '370000,25000,630000,200000', '')</source>

Možno je dodati tudi seznam dodatnih povezav, ki so ravno tako dostopne iz menija.
<source>WebServer.AddLink('Softdata Home Page', 'http://www.softdata.si', '')</source>

Dodamo tudi seznam dodatnih izrisov za tiskanje.
<source>WebServer.AddLayout([A4 Pokončno], '')
WebServer.AddLayout([A4 Ležeče], '')</source>

== 2018: Splošno ==
2018/logo*
2018/custom.js

== 2018: Tematika ==
Tematika za novo aplikacijo se pripravi kot prej, le da se v njej ne vnaša polja 'Informacije za web'. To polje se ignorira. Še vedno pa se uporabljata polji 'Dodatno ime' (obvezno) in 'Pravice' (opcijsko).

Kar je bilo prej določeno v informacijah za web, se sedaj določa v modulu SDMSWSP v funkciji OnCreate z dodajanjem elementov tipa TWebItem.
<source>
Dim WI As TWebItem
WI = WebServer.AddWebItem(A, B, C, D, E, F, G, H)
</source>
Parametri funkcije AddWebItem:
A: (string) koda mape, na katero želimo vstaviti dani element, prazen string za root
B: (string) koda elementa, ki mora biti unikatna(!); za 'radio gumbe' se doda predpona xxx:, kjer je xxx ime skupine gumbov, vsaka grupa gumbov naj ima natanko en gump privzeto viden (E)
C: (string) ime elementa (napis)
D: (string) legenda za dani element, ki naj vsebuje tudi copyright informacijo, lahko v HTML obliki
E: (boolean) privzeta vidnost elementa
F: (double) transparentnost podlog, 0-1, privzeto 1, lahko se določi na mapah in kartah
G: (string) pravice za uporabo v online načinu: z vejico ločen seznam security tagov, vsi = '*', nihče = '-'; dodatne natančnejše pravice za prikaz pa so lahko nastavljene tudi v tematiki
H: (string) pravice za uporabo v offline načinu: velja enako kot pri (G)

Tako ustvarimo nov element (referenca nanj je v spremenljivki WI).

Če gre za element, ki predstavlja skupino elementov, ne potrebujemo narediti nič več.
Če gre za element, ki je povezan s piramido, to storimo z WI.SetPyramid('koda piramide')
<source>WI.SetPyramid('dof2018')</source>
Če gre za element, ki je povezan s spletnimi kartami, to storimo z WI.SetTms('koda spletnih kart')
<source>WI.SetTms('gm-s')</source>
Če gre za element, ki je povezan s temo/temami tematke, to storimo z WI.SetDrawItem('alias teme/tem')
<source>WI.SetDrawItem('parcele')</source>

Priporočamo striktno poravnavanje parametrov po kolonah, da se ohrani preglednost.

== 2018: Offline podloge ==
Novost je možnost uporabe podlog (piramide) v offline načinu.

Za to je treba elementu piramide določiti:
pravico offline uporabe(parameter H), tudi za nadrejene skupine
relevantno območje, kar je izjemno pomembno narediti pravilno, da se čimbolj omeji količina potrebnih kart za prenos v cache

Definicija relevantnega območja se določa za vse offline elemente piramid enotno z ukazom WebServer.AddOfflineArea([plast], 'filter', offset, limit).
<source>
WebServer.AddOfflineArea([plast poligonov], 'filter', 0, 0)
WebServer.AddOfflineArea([plast linij], 'filter', 50, 0)
WebServer.AddOfflineArea([plast točk], 'filter', 200, 0)
</source>
Vsakič, ko se ta defincija spremeni, je potrebno izvesti preračun relevantnega območja klicom "povezave http://streznik/api/2018/prepareofflinemapsinfo"

== 2018: Offline podatki ==
Novost je možnost uporabe podatkov v offline načinu.

Za to je treba elementu teme določiti:
pravico offline uporabe(parameter H), tudi za nadrejene skupine
povezavo na dejanske podatke z ukazom WI.SetOfflineData([plast], 'iskanje')

<source>WI.SetOfflineData([parcele], 'Default')</source>

== Napredne nastavitve ==

Ob prijavi lahko določene nastavitve spremenimo glede na prijavljenega uporabnika. To storimo tako, da dodamo novo proceduro:
<source>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</source>

== Priprava tematike ==
Tematiko se pripravi kot sicer. Izjemnega pomena pa je, da se tematika v vseh merilih in z vsemi vključenimi temami vedno izriše hitro, torej v rangu recimo 3 sekund (kar je že precej). Optimalno bi bilo 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 ta tema vklopi/izklopi. Če tema nima oznake, se nikoli ne prikaže. Če želimo temo prikazati vedno, vnesemo za znak '''*'''.

==== Atribut: View tags ====
Namen tega atributa je omejevanje vpogleda v podatke glede na uporabnika.

==== Atribut: Web info ====
V tem atributu določimo prej omenjene skupine. To storimo večvrstično v naslednji obliki:
<source>item=karte
name=Pregledne karte
sort=1
show=1
hint=...
icon=a.gif</source>
Vsaka oznaka se mora pojaviti natanko v eni temi, ni pomembno kateri. Iz teh informacij se potem generira menu za vklop/izklop v spletni aplikaciji. Prve štiri vrstice so obvezne.

== Priprava iskanj in izpisov ==
Iskanje po poljubnih podatkih se pripravi v urejevalniku podatkovne plasti (Searches). V modulu SdmsWSP pa z ukazom AddSearch dodajamo le tiste, ki jih želimo uporabljati v spletni aplikaciji.
...

== Nastavljanje pravic ==
Pri spletni aplikaciji je možno nastaviti različne nivoje dostopa (izris na karti, iskanje, izpis podatkov) glede na prijavljenega uporabnika.

V ta namen se uporablja kratke oznake, ki jih umenujemo '''Security tags'''.

=== Dodeljevanje pravic===
Te oznake se za uporabnika določa v urejevalniku uporabnika oz. v urejevalniku skupine uporabnikov (možno je tudi v varnostnem središču).

Vsak uporabnik/skupina ima lahko določenih več oznak, ki so ločene z vejico.

Uporabnik poleg svojih oznak dobi tudi vse oznake vseh skupin, v katerih je član.

=== Omejevanje pravic===
Na splošno velja naslednje:
*za vpoglede (tematika, vpogled preko iskanja/klika) velja, da če oznaka ni določena, imajo vpogled vsi, sicer pa samo tisti z oznako,
*za urejanja (dodajanje, popravljanje, brisanje) velja, da če oznaka ni določena, ne more urejati nihče, sicer pa samo tisti z oznako.

Pravice se omejuje:
*v tematiki:
**v atributu teme View tags
**v atrubutu teme Web info, v vrstici view=

*pri definiciji iskanja v podatkovni plasti:
**View access
**Append access
**Update access
**Delete access
**View in Update access pri posameznih poljih

*v SDMS Basicu, ukaz je MatchSecurityTags.

Vedno lahko določimo tudi več oznak, ločenih z vejico.

== TODO ==
*SQL pogoj filtra, uporabljenega v searchu se ne upošteva pri kliku
*dvonivojski sistem pri vsebinah za izris
*multiple datasete pri maski (vsaj view)
*images naj dela tudi za spisek datotek (RO)

== 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.* ===
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.

=== SEARCH.DLL ===
Izvede splošno iskanje po (full text search) in vrne zadetke.
:query=KLJUČNE BESEDE
::seznam ključnih besed za iskanje, ločenih s presledki
:category=KAT1,KAT2,KAT3
::seznam kategorij, po katerih se vrši iskanje (če je prazen, se vrši po vseh)
:hits=10
::maksimalno število zadetkov
:template=JSON
::ime templata, ki opredeljuje obliko zadetkov
AddSearch ...
Pred iskanjem se zažene še OnWebSearch...

SDMS WebServer

2019-01-30T10:16:04Z

Janez Trtnik: /* 2018 */

__NOTOC__
[[Kategorije: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'''
*za uporabo varnih povezav (https) se namesti certifikat strežnika, za navodila glej spodaj
*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
*nikakor ne smete pozabiti omogočiti uporabo želenih vrat (80, 443, ...) v požarnem zidu.

Strežnik je sedaj nameščen in zagnan.

=== Namestitev certifikata ===
Če se bo uporabljala varna povezava (https), je potrebno pridobiti in namestiti tudi certifikat strežnika. Pripravi se mapo, na katero se bo kopiral certifikat, lahko pa se ga kopira tudi kar na mapo programa. Pripravi se naslednje ASCII datoteke:
*'''''root.pem''''' - certifikat verifikacijskega strežnika
*'''''cert.pem''''' - certifikat strežnika
*'''''key.pem''''' - zakodiran privatni ključ strežnika
*'''''password.txt''''' - geslo za dekodiranje privatnega ključa

<source>
openssl pkcs12 -in xxx.pfx -out root.pem -cacerts // brez izhodnega gesla
openssl pkcs12 -in xxx.pfx -out certandkey.pem -clcerts // vnesi geslo za key, razbij na dve datoteki: cert.pem in key.pem
Geslo kodiraj z EncryptPassord in shrani v password.txt takole: ENCRYPTED:geslo
</source>

Kasneje se v modulu določi tudi pot do datotek certifikata.

== Aktivacija ==
'''SDMS WebServer''' se aktivira tako, da se v SDMS raziskovalcu doda nov modul z imenom '''SdmsWSP''' in naslednjo vsebino:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', '')
WebServer.Start
...
EndSub</source>

Če želimo dodati tudi dostop preko varne povezave (https), to storimo takole:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath)
WebServer.Start
...
EndSub</source>

Če želimo zagotoviti uporabo varne povezave (https) in izvesti samodejno preusmeritev nanjo:
<source>Sub OnCreate
WebServer.Clear
WebServer.AddHost(80, '', '', '', 'http').SetRedirect('https://www.test.si/')
WebServer.AddHost(443, '', '', '', 'https').SetSecure(ProgramPath + 'Certifikat\')
WebServer.Start
...
EndSub</source>

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

== Osnovne nastavitve ==
Strežniku moramo podati ime, ki se prikaže kot naslov strani. Uporablja se tudi kot identifikacija strežnika, če je ta potrebna.
<source>WebServer.Name = 'TEST'</source>
Ob prijavi se uporabniku prikaže logotip velikosti 480x120 pik. Datoteko se shrani na mapo WebServer in takole poda njeno ime.
<source>WebServer.Logo = 'logo.png'</source>

Privzeto dopušča SDMS WebServer dostop samo SDMS uporabnikom. Če želimo dodati tudi možnost anonimnega dostopa, to storimo tako:
<source>WebServer.User = [Gost]</source>
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.
<source>WebServer.Window = '370000,25000,630000,200000'</source>

Določiti je treba tematiko, ki se bo uporabljala za izris.
<source>WebServer.DrawList = [Web Tematika]</source>

Dodati je treba plasti, po katerih za izvaja iskanje in izpis podatkov.
<source>WebServer.AddSearch([Plast A].Search('Default'))
WebServer.AddSearch([Plast B].Search('Default'))</source>

Dobro je dodati tudi seznam priljubljenih lokacij, ki so dostopne iz menija.
<source>WebServer.AddLocation('Slovenija', '370000,25000,630000,200000', '')
WebServer.AddLocation('Ljubljana', '370000,25000,630000,200000', '')
WebServer.AddLocation('Maribor', '370000,25000,630000,200000', '')</source>

Možno je dodati tudi seznam dodatnih povezav, ki so ravno tako dostopne iz menija.
<source>WebServer.AddLink('Softdata Home Page', 'http://www.softdata.si', '')</source>

Dodamo tudi seznam dodatnih izrisov za tiskanje.
<source>WebServer.AddLayout([A4 Pokončno], '')
WebServer.AddLayout([A4 Ležeče], '')</source>

== 2018: Splošno ==
2018/logo*
2018/custom.js

== 2018: Tematika ==
Tematika za novo aplikacijo se določa v modulu SDMSWSP v funkciji OnCreate z dodajanjem elementov tipa TWebItem.
<source>
Dim WI As TWebItem
WI = WebServer.AddWebItem(A, B, C, D, E, F, G, H)
</source>
Parametri funkcije AddWebItem:
A: (string) koda mape, na katero želimo vstaviti dani element, prazen string za root
B: (string) koda elementa, ki mora biti unikatna(!); za 'radio gumbe' se doda predpona xxx:, kjer je xxx ime skupine gumbov, vsaka grupa gumbov naj ima natanko en gump privzeto viden (E)
C: (string) ime elementa (napis)
D: (string) legenda za dani element, ki naj vsebuje tudi copyright informacijo, lahko v HTML obliki
E: (boolean) privzeta vidnost elementa
F: (double) transparentnost podlog, 0-1, privzeto 1, lahko se določi na mapah in kartah
G: (string) pravice za uporabo v online načinu: z vejico ločen seznam security tagov, vsi = '*', nihče = '-'; dodatne natančnejše pravice za prikaz pa so lahko nastavljene tudi v tematiki
H: (string) pravice za uporabo v offline načinu: velja enako kot pri (G)

Tako ustvarimo nov element (referenca nanj je v spremenljivki WI).

Če gre za element, ki predstavlja skupino elementov, ne potrebujemo narediti nič več.
Če gre za element, ki je povezan s piramido, to storimo z WI.SetPyramid('koda piramide')
<source>WI.SetPyramid('dof2018')</source>
Če gre za element, ki je povezan s spletnimi kartami, to storimo z WI.SetTms('koda spletnih kart')
<source>WI.SetTms('gm-s')</source>
Če gre za element, ki je povezan s temo/temami tematke, to storimo z WI.SetDrawItem('alias teme/tem')
<source>WI.SetDrawItem('parcele')</source>

== 2018: Offline podloge ==
Novost je možnost uporabe podlog (piramide) v offline načinu.

Za to je treba elementu piramide določiti:
pravico offline uporabe(parameter H), tudi za nadrejene skupine
relevantno območje, kar je izjemno pomembno narediti pravilno, da se čimbolj omeji količina potrebnih kart za prenos v cache

Definicija relevantnega območja se določa za vse offline elemente piramid enotno z ukazom WebServer.AddOfflineArea([plast], 'filter', offset, limit).
<source>
WebServer.AddOfflineArea([plast poligonov], 'filter', 0, 0)
WebServer.AddOfflineArea([plast linij], 'filter', 50, 0)
WebServer.AddOfflineArea([plast točk], 'filter', 200, 0)
</source>
Vsakič, ko se ta defincija spremeni, je potrebno izvesti preračun relevantnega območja klicom "povezave http://streznik/api/2018/prepareofflinemapsinfo"

== 2018: Offline podatki ==
Novost je možnost uporabe podatkov v offline načinu.

Za to je treba elementu teme določiti:
pravico offline uporabe(parameter H), tudi za nadrejene skupine
povezavo na dejanske podatke z ukazom WI.SetOfflineData([plast], 'iskanje')

<source>WI.SetOfflineData([parcele], 'Default')</source>

== Napredne nastavitve ==

Ob prijavi lahko določene nastavitve spremenimo glede na prijavljenega uporabnika. To storimo tako, da dodamo novo proceduro:
<source>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</source>

== Priprava tematike ==
Tematiko se pripravi kot sicer. Izjemnega pomena pa je, da se tematika v vseh merilih in z vsemi vključenimi temami vedno izriše hitro, torej v rangu recimo 3 sekund (kar je že precej). Optimalno bi bilo 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 ta tema vklopi/izklopi. Če tema nima oznake, se nikoli ne prikaže. Če želimo temo prikazati vedno, vnesemo za znak '''*'''.

==== Atribut: View tags ====
Namen tega atributa je omejevanje vpogleda v podatke glede na uporabnika.

==== Atribut: Web info ====
V tem atributu določimo prej omenjene skupine. To storimo večvrstično v naslednji obliki:
<source>item=karte
name=Pregledne karte
sort=1
show=1
hint=...
icon=a.gif</source>
Vsaka oznaka se mora pojaviti natanko v eni temi, ni pomembno kateri. Iz teh informacij se potem generira menu za vklop/izklop v spletni aplikaciji. Prve štiri vrstice so obvezne.

== Priprava iskanj in izpisov ==
Iskanje po poljubnih podatkih se pripravi v urejevalniku podatkovne plasti (Searches). V modulu SdmsWSP pa z ukazom AddSearch dodajamo le tiste, ki jih želimo uporabljati v spletni aplikaciji.
...

== Nastavljanje pravic ==
Pri spletni aplikaciji je možno nastaviti različne nivoje dostopa (izris na karti, iskanje, izpis podatkov) glede na prijavljenega uporabnika.

V ta namen se uporablja kratke oznake, ki jih umenujemo '''Security tags'''.

=== Dodeljevanje pravic===
Te oznake se za uporabnika določa v urejevalniku uporabnika oz. v urejevalniku skupine uporabnikov (možno je tudi v varnostnem središču).

Vsak uporabnik/skupina ima lahko določenih več oznak, ki so ločene z vejico.

Uporabnik poleg svojih oznak dobi tudi vse oznake vseh skupin, v katerih je član.

=== Omejevanje pravic===
Na splošno velja naslednje:
*za vpoglede (tematika, vpogled preko iskanja/klika) velja, da če oznaka ni določena, imajo vpogled vsi, sicer pa samo tisti z oznako,
*za urejanja (dodajanje, popravljanje, brisanje) velja, da če oznaka ni določena, ne more urejati nihče, sicer pa samo tisti z oznako.

Pravice se omejuje:
*v tematiki:
**v atributu teme View tags
**v atrubutu teme Web info, v vrstici view=

*pri definiciji iskanja v podatkovni plasti:
**View access
**Append access
**Update access
**Delete access
**View in Update access pri posameznih poljih

*v SDMS Basicu, ukaz je MatchSecurityTags.

Vedno lahko določimo tudi več oznak, ločenih z vejico.

== TODO ==
*SQL pogoj filtra, uporabljenega v searchu se ne upošteva pri kliku
*dvonivojski sistem pri vsebinah za izris
*multiple datasete pri maski (vsaj view)
*images naj dela tudi za spisek datotek (RO)

== 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.* ===
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.

=== SEARCH.DLL ===
Izvede splošno iskanje po (full text search) in vrne zadetke.
:query=KLJUČNE BESEDE
::seznam ključnih besed za iskanje, ločenih s presledki
:category=KAT1,KAT2,KAT3
::seznam kategorij, po katerih se vrši iskanje (če je prazen, se vrši po vseh)
:hits=10
::maksimalno število zadetkov
:template=JSON
::ime templata, ki opredeljuje obliko zadetkov
AddSearch ...
Pred iskanjem se zažene še OnWebSearch...

SDMS WebServer

2019-01-30T09:14:09Z

Janez Trtnik:

SDMS WebServer

2017-12-13T11:21:10Z

Janez Trtnik: /* Namestitev */

SDMS WebServer

2017-12-13T11:18:42Z

Janez Trtnik: /* Namestitev */

SDMS WebServer

2017-12-13T11:14:33Z

Janez Trtnik: /* Namestitev */

SDMS WebServer

2017-12-13T11:13:00Z

Janez Trtnik: /* Namestitev */

Struktura XML datotek

2015-11-12T13:13:28Z

Janez Trtnik: /* Primer grida za transformacijo koordinat */

Verzija 4.2.2

2015-06-17T12:26:24Z

Janez Trtnik: /* Basic */

<noinclude>[[Zgodovina verzij]]</noinclude>

=== Objava verzije ===

*'''Build 1''' 11 marec 2015
*'''Build 3''' 13 marec 2015
*'''Build 4''' 16 marec 2015
*'''Build 5''' 18 marec 2015
*'''Build 6''' 19 marec 2015
*'''Build 7''' 20 marec 2015
*'''Build 8''' 24 marec 2015
*'''Build 9''' 2 april 2015
*'''Build 10''' 7 april 2015
*'''Build 11''' 9 april 2015
*'''Build 12''' 13 april 2015
*'''Build 13''' 14 april 2015
*'''Build 14''' 20 april 2015
*'''Build 15''' 22 april 2015
*'''Build 16'''

=== Popravki avtomatsko sporočenih napak ===
*(Build 6) Access violation...00000004 v maski, če je bila entiteta krog ali lok in se je uporabljal prostorski lookup.
*(Build 9) Access violation...00000014 v raziskovalcu, če plast ni imela pravilno določenega indexa v navideznem nizu podatkov.
*(Build 9) Popravek napake TRecordList.GetRec: cannot unlock previous record v funkciji GroupByFormula.
*(Build 13) Gridi v maskah so povzročali napake. Napaka nastala v verziji 4.2.2.12.
*(Build 14) TPoligon: Indeks izven območja. V funkciji InputPolyLineNextPoint, če ni bilo točk. Popravljeno.

=== Razni popravki ===
*(Build 3) Pri tekst in simbol temah opcija Avtomatski centroid na ekranu ni upoštevala otokov. Popravljeno. Napaka nastala v verziji 4.2.2.1.
*(Build 3) Sistem logiranja spremenjen, da uporablja niti.
*(Build 4) Popravek pri kreiranju dokumenta.
*(Build 8) Odpravljen bug pri izvozu v Excel - Clipboard. Nastal v buildu 7.
*(Build 9) Pohitreni filtri in lookupi za filtre po polilinijah. Opazna razlika je pri večjih polilinijah (>50 točk) in so filtri 2-10x hitrejši.
*(Build 9) Urejevalniki navideznih nizov podatkov se niso pravilno inicializirali. Napaka nastala v verziji 4.2.2.4.
*(Build 9) V posebnih kombinacijah mask se je lahko zgodilo, da je maska izginila iz ekrana. Popravljeno.
*(Build 10) Če je plast brez mask, se ne preklopi samodejno v avtomatsko masko. Napaka nastala v verziji 4.2.2.9. Popravljeno.
*(Build 10) Hinti na maski niso delali. Napaka nastala v verziji 4.2.2.9. Popravljeno.
*(Build 10) Pri filtrih po večkratnih nizih podatkov ni pravilno filtriral, če je šele filter inicializiral plast.
*(Build 10) Izpis DumpPageCache in DumpAllRecords je sortiran po imenu.
*(Build 11) Form.EditRecord.Append na prazni maski.
*(Build 11) Dvignjena verzija layerja, zaradi uvedbe CRS pri layerju.
*(Build 12) Izvoz v Excel popravljen, da dela izvoze večvrstičnih tekstov.
*(Build 12) Izvoz v Excel popravljen, da dela izvoze večkratnih nizov podatkov.
*(Build 12) Malo skrajšani opisi v Log datotekah.
*(Build 13) Pri ukazih netMessage oziroma netCommand s prikazom okna, se niso prenašala obvestila o spremembah na plasteh. Popravljeno.
*(Build 15) Popravljeno sproščanje predpomnilnika ob low memory.

=== Grid ===
*(Build 9) Grid je doživel prenovo. SGR datoteke so s tem postale zastarele, a bodo do nadaljnega še delovale. Po novem je osnova XML datoteka, ki definira grid. Definicija XML datotake je točno opisana v [[Struktura_XML_datotek|XML_struktura_grida]]. Na isti mapi se ob uvozu naredi SDG datoteka, ki vsebuje vse podatke v eni datoteki in se tudi kasneje uporablja v programu.
*(Build 9) Ob tem se je star grid objekt TGrid preimenoval v [[TGridOld]], '''in je potrebno po basicu to popraviti'''. Je pa dodan nov objekt [[TGrid]], ki vsebuje rutine za delo z novim gridom.
*(Build 9) Dodani nove funkcije za {{EL|TGrid|GetPointArrayNodes}}, {{EL|TGrid|GetPointArrayContour}} in {{EL|TGrid|GetPointArrayContourVP}}, ki polilinijo napolnita z višinami iz grida.
*(Build 9) Za vizualizacijo gridov se uporabljajo piramide, in se kreirajo glede na [[Struktura XML datotek#CTR.XML (barvne transformacije)]].

=== Generiranje izrazov ===
*(Build 9) Preurejena struktura drevesa glede na uporabnost posameznih skupin.
*(Build 9) Dodano skrivanje nepotrebnih skupin povsod, kjer se uporablja generiranje izrazov.
*(Build 9) V Urejevalniku modula dodana zgodovina generiranih izrazov.
*(Build 9) V Konzoli dodana zgodovina ukazov v generator izrazov.
*(Build 9) Povsod drugje dodana zgodovina ukazov v generator izrazov in <ctrl> + <pgup>, <pgdown>.
*(Build 9) Shranjevanje zgodovine ukazov prestavljeno iz Registrija v profiles mapo.
*(Build 9) Dodana možnost klika na <Levi Alt> + klik na objektu [neka plast] in napolni vsa polja te plasti za izbiro.
*(Build 10) <Levi Alt> + klik na objektu [neka plast] ni povsem delalo. Popravljeno.
*(Build 10) Pri izbiri podatkovne plasti, se poleg polij izpišejo še dodatna imena, na koncu pa se dodajo še imena mask, indeksov,...
*(Build 12) Pri generirajnu formule za polje se ni pripravil seznam polj. Napaka nastala v verziji 4.2.2.9.
*(Build 13) CTRL+Click na menujih,... popravljen, da ne pregleda samo prvega ukaza ampak vse.
*(Build 13) CTRL+Click na shranjene objekte ni več delal. Napaka nastala v verziji 4.2.
*(Build 13) CTRL+Click na lastnostih tudi dela, če lete niso v modalnem oknu. Torej tudi v urejevalniku podatkovne plasti - maska.
*(Build 14) CTRL+Click na v modulu javi napako. Napaka nastala v verziji 4.2.2.13. Popravljeno.

=== Spletne karte ===
*(Build 1) Popravljeno nalaganje spletnih kart. Iz spleta se prenaša več kart naenkrat v ozadju, tako da prenos ne blokira več izrisa. Karte se rišejo od sredine navzven (boljši občutek za hitrost). Najprej se narišejo se vse karte, ki so na disku, potem pa še čaka do 5 sekund in riše, kar se je preneslo. Ostale karte se prenašajo v ozadju in so pripravljene za izris ob naslednjem risanju. Če je karta na disku starejša kot 1 teden, se bo ponovno prenesla v ozadju.
*(Build 7) Pohitreno nalaganje spletnih kart in tudi ostalih rastrov.

=== Buffer (Outline) ===
*(Build 1) Funkcija za izdelavo bufferja je popolnoma spremenjena in naredi sedaj topološko pravilen buffer. Naredi ga tudi veliko hitreje kot v verziji 4.1.
*(Build 1) Buffer lahko po novem naredimo za vse grafične tipe zapisov, tudi okoli točk in poligonov. Prej se ga je lahko naredilo le okoli polilinij.
*(Build 1) V urejevalniku geometrije je se buffer naredi različno, glede na dovoljene tipe topologije v podatkovni plasti. Če poligoni niso dovoljeni, bo naredil buffer kot polilinije, če pa plast dovoli poligone, pa ga bo naredil kot poligon.
*(Build 3) Izraz Outline spremenjen v Buffer
*(Build 3) V urejevalniku geometrije buffer prikaže masko, kjer določimo vse parametre za konstrukcijo, lahko pa tudi naredimo buffer iz poljubne plasti in v poljubno plast.
*(Build 14) Zamik linije je dodal srednjo točko tudi na topih korih. Napaka nastala v verziji 4.2.

=== Basic ===

*(Build 1) Popravljeni funkciji {{EL|TEditRecord|PointArray}} in {{EL|TRecord|PointArray}}, da za poligone vedno vrneta zaprt poligon (zadnja točke je ista kot prva). Napaka nastala v verziji 4.2.2.1.
*(Build 1) Nova zanka '''ForEach X In Y ... Next''', ki nastavi vrednost spremenljivke X na vse vrednosti iz seznama Y
** String / TStringList: ForEach S In SL
** TRecord / TRecordList: ForEach R In [Plast].FilteredRecords
** TEditRecord / TRecordList: ForEach ER In [Plast].FilteredRecords (ta naredi tudi L.Begin/L.EndMultipleUpdate, za vsak record pa ER.Edit in ER.Update)
** TDrawItem / TDrawList: ForEach DI In DrawList
** TPrintItem / TPrintLayout: ForEach P In [PredlogaIzrisa]
** TDialogControl / TDialog: ForEach DC In [Dialog]
** objekt(TLayer, TUser, ...) / TCollection: ForEach L In Layers, ForEach U In Users, ...
*(Build 8) Popravljeno izvajanje timerjev, da se ne izvajajo gnezdeno ampak sekvenčno.
*(Build 9) Dodani novi zagonski parametri: StartBefore, StartAfterCreate in StartAfterCreated. Opis: [[Zagonski_parametri|Zagon_basica]]
*(Build 15) Dodane lastnosti {{EL|TFormControl|Enabled}}, {{EL|TFormControl|GridOnBtnClick}} in {{EL|TFormControl|GridOnDblClick}}.
*(Build 16) Dodane možnosti za ForEach:
** objekt(TLayer, TUser, ...) / TFolder: ForEach L In Root, ForEach U In Root, ...
** TFolder / TFolder: ForEach F In Root
** TUser / TUserGroup: ForEach U In [Urejanje plasti]

*(Build X) Dodani ukazi za zapisovanje iz basica v poljubno log datoteko.
**CustomLogInit
**CustomLogDone
**CustomLogWrite