1. No category

Jantar V7 WEB v1.1
Navodila za Jantar WEB
© 2005 Jantar d.o.o.
All rights reserved. No parts of this work may be reproduced in any form or by any means - graphic, electronic, or
mechanical, including photocopying, recording, taping, or information storage and retrieval systems - without the
written permission of the publisher.
Products that are referred to in this document may be either trademarks and/or registered trademarks of the
respective owners. The publisher and the author make no claim to these trademarks.
While every precaution has been taken in the preparation of this document, the publisher and the author assume no
responsibility for errors or omissions, or for damages resulting from the use of information contained in this document
or from the use of programs and source code that may accompany it. In no event shall the publisher and the author be
liable for any loss of profit or any other commercial damage caused or alleged to have been caused directly or
indirectly by this document.
Printed: avgust 2007 in Naklo
Kazalo
I
Kazalo
Poglavje I Jantar WEB
2
Poglavje II Namestitev
4
1 Sistemske
...........................................................................................................
zahteve
4
Strežnik
.......................................................................................................................... 4
Odjemalec
.......................................................................................................................... 4
2 Namestitev
........................................................................................................... 4
3 Ročna
...........................................................................................................
nastavitev parametrov
5
4 Reševanje
...........................................................................................................
težav
6
Kako
..........................................................................................................................
naj ugotovim ime računalnika, na katerem je nameščen Jantar WEB 6
JantarV7
..........................................................................................................................
strežnik ni nameščen na istem imeniku, kot Jantar WEB
6
Program
..........................................................................................................................
se noče namestiti
7
Strežnik
..........................................................................................................................
se noče zagnati
7
HTTP
..........................................................................................................................
strežnik se ne odziva
7
V ..........................................................................................................................
brskalniku dobim napačno sliko
7
HTTP
..........................................................................................................................
strežnik vrne napako
7
Poglavje III Operacije
Uporabniki
............................................................................................................ 12
Skupine
............................................................................................................ 13
Dostop
..............................................................................................................
do podatkov
13
Dostop
............................................................................................................
do podatkov
13
Nastavitve
.......................................................................................................................... 13
Nastavitve
.............................................................................................................. 13
Nadgradnje
.......................................................................................................................... 14
Nadgradnje
.............................................................................................................. 14
Poglavje IV Tehnična zgradba programa
16
1 SOAP
...........................................................................................................
Strežnik
16
2 PHP
...........................................................................................................
izvajalec
16
3 HTTP
...........................................................................................................
Strežnik
16
4 Uporaba
...........................................................................................................
drugega HTTP strežnika
16
Poglavje V Sistem pravic
18
1 Splošno
........................................................................................................... 18
9 Poglavje VI JantarService.ini
20
1 Uvod
........................................................................................................... 9
1 Splošno
........................................................................................................... 20
2 Podatki
........................................................................................................... 9
2 [general]
........................................................................................................... 20
Podatki
.......................................................................................................................... 9
Registracija
..........................................................................................................................
časa
9
Splošno
.............................................................................................................. 9
Podroben
..............................................................................................................
izpis
9
Izpis
..............................................................................................................
statistik
10
Sumaren
..............................................................................................................
izpis statistik
10
Dnevno
..............................................................................................................
poročilo
10
Izpis
..............................................................................................................
prisotnosti
11
Urejevalnik
.............................................................................................................. 11
Dogodki
............................................................................................................ 12
3 [updater]
........................................................................................................... 20
4 [database]
........................................................................................................... 21
5 [SOAPServer]
........................................................................................................... 21
6 [HTTPServer]
........................................................................................................... 21
7 [Logging]
........................................................................................................... 21
Ključne besede
22
3 Sistem
........................................................................................................... 12
Sistem
.......................................................................................................................... 12
Gesla
.......................................................................................................................... 12
Splošno
.............................................................................................................. 12
Uporabniki
..............................................................................................................
in skupine
12
© 2005 Jantar d.o.o.
I
Jantar WEB
I
Jantar WEB
1
Jantar WEB
Dobrodošli v navodilih za Jantar WEB.
Jantar WEB je spletna aplikacija, namenjen vsem uporabnikom, ki želijo ne glede na
čas in prostor hitro in učinkovito dostopati do podatkov registacije delovnega časa.
Vpogled in tiskanje izpisov za posameznika ali skupino uporabnikov je tako še bolj
prilagojen Vašim potrebam in željam.
Z izbranim internetnim brskalnikom dostopate na server z bazo podatkov. Dostope
uporabnikov s podobnimi lastnostmi predhodno združimo v logične skupine
(Uporabniki, Izdelovalci poročil za skupine, Upravitelji), kar nam močno poenostavi
delo.
Ciljna skupina Jantar WEB so tako zaposleni, kot tudi vodje oddelkov in
računovodstvo.
© 2005 Jantar d.o.o.
2
Namestitev
II
Namestitev
2
Namestitev
2.1
Sistemske zahteve
2.1.1
Strežnik
4
Takoj nato se bo odprl Jantar manager.
Jantar WEB je potrebno namestiti na isti strežnik, na katerem teče JantarV7 strežnik.
Za zdaj je kot strežniški sistem podprt le Windows NT®, verzija 2000, 2003 ali
novejši.
Delovnega pomnilnika (RAM) mora biti vsaj 256 MB.
Dodatnih posebnih zahtev strežnik sicer nima, zna pa izkoristiti večje število
procesorjev, če so v strežniku nameščeni.
2.1.2
Odjemalec
Trenutno podprti odjemalci so:
 Microsoft Internet Explorer® (IE) verzija 6 ali novejši
 Firefox 1.x ali novejši
 Mozilla 1.6.x ali novejši
Odjemalec mora imeti tudi Adobe Acrobat® reader verzija 4 ali novejši, če bo
uporabnik poganjal izpise.
Brskalnik mora imeti aktiviran JavaScript in popup okna.
Posebnih zahtev po strojni opremi odjemalec nima.
2.2
Namestitev
Namestitev programa je kar najbolj poenostavljena. Namestitveni program sam nima
nobenih izbir, temveč le naloži program na trdi disk.
Privzeta pot namestitve je [ProgramFilesDir]Jantar\JantarService. Navadno je to C:
\Program Files\Jantar\JantarService.
V primeru, da je JantarV7 strežnik nameščen drugam, si najprej oglejte reševanje
tega problema.
Pomembno je, da na zadnjem oknu namestitve označite izbiro "Launch Application".
© 2005 Jantar d.o.o.
Jantar WEB poženemo s klikom na spodnji "Start" gumb, desno od teksta "WEB
Server is currently not running".
Takoj, ko se pojavi obvestilo, da strežnik deluje, lahko že poženemo brskalnik in
preverimo delovanje sistema tako, da v naslovno vrstico vtipkamo "http://(ime
računalnika)" (brez oklepajev).
V brskalniku se mora pokazati naslednja slika:
5
Navodila za Jantar WEB
V primeru, da se ne pokaže ta slika, potem je pri namestitvi prišlo do napake in si
oglejte poglavje o reševanju težav.
Če je uporabljen jezik napačen, potem ga popravite v nastavitveni datoteki.
Sedaj moramo le še nastaviti administratorske uporabnike in že lahko pričnemo z
rednim delom.
2.3
Ročna nastavitev parametrov
Pri namestitvi programa se lahko zgodi, da se vse nastavitve ne nastavijo pravilno,
ali pa se odločimo, da bomo uporabili drugačne nastavitve.
Jantar WEB), v tem primeru pa mora biti ta nastavitev "/Jantar WEB/". Ne pozabite
na prvi in zadnji "/".
<php.ini>
Datoteko najdemo v imeniku [ProgramFilesDir]Jantar\JantarService\php.
V njej nas zanimajo naslednje nastavitve:
zlib.output_compression = Off
Če uporabljamo drugeg HTTP strežnik, potem je to nastavitev smiselno postaviti na
"Yes". S tem povzročimo, da bodo datoteke z vsebino, ki jih strežnik pošilja
odjemalcu mnogo krajše (4x - 8x), kar je še posebno pomembno pri dostopu preko
modema. Če za HTTP strežnik uporabljamo Jantar WEB strežnik, potem to
nastavitev pustimo na "Off", saj delo stiskanja podatkov opravlja že strežnik.
error_log = c:/php.log
Ta nastavitev pove, kam naj PHP shranjuje sporočila o napakah, kadar se pojavijo.
Če vam privzeta pot ne ustreza, jo spremenite v drugo, ali pa je sploh ne izpolnite, s
čimer povzročite, da PHP ne bo zapisoval sporočil o napakah v datoteko.
extension_dir = "C:/Program files/php/ext"
<settings.php>
Ta nastavitev pove, kje PHP lahko najde dodatke za svoje delovanje. Imenik ext
Datoteko najdemo v imeniku [ProgramFilesDir]Jantar\JantarService\WebRoot\inc.
najdete pod imenikom php ([ProgramFilesDir]Jantar\JantarService\php). Če selite
V datoteki sta dve nastavitvi:
PHP, potem morate spremeniti to pot v php.ini.
<?php
define("SOAPServer", "http://veliswork:1974/wsdl/IJantar");
session.save_path = "0;c:/temp"
define("DisplayNCTrans", true);
Nastavitev določa, kje si php zapomni potatke o prijavljenih uporabnikih. Če vam
define("baseWEBPath", "/");
privzeta pot ne ustreza, jo spremenite.
?>
soap.wsdl_cache_enabled=1
Pomembno je, da ne spreminjate prve in zadnje vrstice, v nasprotnem primeru se
Določa, ali naj si SOAP odjemalec v php zapomni vmesnik do SOAP strežnika. Če je
lahko zgodi, da Jantar WEB ne bo deloval.
vključeno, pridobimo na hitrosti, saj mu ni potrebno za vsak klic spraševati strežnika,
Prva nastavitev - SOAPServer - pove, na katerem računalniku je nameščen strežnik kakšen vmesnik ima.
za SOAP. Tipično je to isti računalnik, če pa se odločimo za uporabo drugega HTTP soap.wsdl_cache_dir="c:/temp"
Ta nastavitev pove, kam si bo PHP zapomnil vmesnik do SOAP strežnika.
strežnika, potem je potrebno spremeniti nastavitev.
V primeru spremembe je niz "veliswork" oz. ime računalnika, na katerega ste
<registry / sistemski register>
namestili Jantar WEB, potrebno spremeniti v ime računalnika, na katerega ste
preselili strežnik.
Urejamo ga s programom regedit.
Niz "1974" je potrebno spremeniti le, če ste spremenili tudi vrata SOAP strežnika.
Zanima nas le ključ HKEY_LOCAL_MACHINE\SOFTWARE\php:
V njem najdemo nastavitev "IniFilePath", ki php-ju pove, kje lahko najde svojo
Druga nastavitev - DisplayNCTrans - je namenjena razvijalcem. Vrednost "true"
nastavitveno datoteko. Ta je tipično na istem imeniku, kot php sam.
povzroči, da strežnik izpiše vse prevode, ki jih je razvijalec pozabil prednaložiti v
program. Možni vrednosti sta le "true" ali "false". Nastavitve vam ni potrebno
spreminjati, oz. to nima nobenega funkcionalnega učinka na program.
Nastavljanje Jantar WEB strežnika si oglejte v opisu JantarService.ini.
V primeru napačnega delovanja Jantar WEBa, si poglejte vse omenjene nastavitve,
če imajo vpisane pravilne vrednosti.
Tretja nastavitev - baseWEBPath - določa osnovni imenik na web strežniku, kamor
smo naložili datoteke v poddirektoriju WEBroot. Tipično je ta nastavitev "/", kar
pomeni, da je program nameščen na osnovni WEB imenik, torej http://www.
vašadomena.si/. Lahko pa se odločite, da program prestavite na podimenik (npr.
© 2005 Jantar d.o.o.
Namestitev
2.4
Reševanje težav
2.4.1
Kako naj ugotovim ime računalnika, na katerem je
nameščen Jantar WEB
6
2) Poženemo ukazno vrstico (Start / All programs / Accessories / Command Prompt
ali Start / run / cmd.exe)
vtipkamo "set computername" in pritisnemo <ENTER>
Ime računalnika ugotovimo na več načinov:
1) V Nadzorni plošči izberemo "System / Sistem" in v njem zavihek "Computer
name / Ime računalnika"
Rezultat, ki ga bo ukaz vrnil, nam prav tako pove ime računalnika.
2.4.2
JantarV7 strežnik ni nameščen na istem imeniku, kot
Jantar WEB
V primeru, da JantarV7 strežnik ni nameščen na privzetem imeniku, to je
[ProgramFilesDir]Jantar, je potrebno nekaj ročnega dela, da se Jantar WEB ustrezno
namesti:
 Na zadnjem oknu namestitve izbira "Launch application" ne sme biti označena.
 Po namestitvi premaknite celoten [ProgramFilesDir]Jantar imenik v imenik, kjer je
JantarV7 strežnik dejansko inštaliran.
 Pri tem boste prepisali JantarManager.exe z novejšo verzijo. Če ne dobite
nobenega opozorila o prepisu, potem ste najverjetneje zgrešili imenik.
 Odprite pozivno vrstico (Start / All programs / Accessories / Command Prompt ali
Start / run / cmd.exe)
 Pojdite na imenik Jantar\JantarServiceV7
 poženite "JantarManager -initialconfig"
Ime računalnika je navedeno desno od teksta "Full computer name / Polno ime
računalnika". Zadnje pike ne smete upoštevati. Na primeru iz te slike je ime
računalnika npr. "veliswork".
© 2005 Jantar d.o.o.
7
2.4.3
Navodila za Jantar WEB
Program se noče namestiti
Pri namestitvi lahko vidite tole sporočilo:
4) Strežnik deluje na drugih vratih, kot pa jih uporabljete v brskalniku.
Strežniku ste spremenili HTTP vrata, zato to morate narediti tudi v brskalniku.
Primer naslovne vrstice s spremenjenimi vrati: http://streznik:81/
2.4.6
V brskalniku dobim napačno sliko
Lahko se zgodi, da imate na strežniku že nameščen drug HTTP strežnik (Apache,
IIS, PWS...).
V takem primeru bo v log datoteki pisalo, da se HTTP strežnik ni mogel zagnati,
brskalnik pa vam bo pokazal stran, kot jo streže že nameščeni strežnik (npr. domača
stran vašega podjetja ali stran internega WEB portala).
Če tega strežnika ne potrebujete, potem ga lahko odstranite z uporabo Nadzorne
plošče, v nasprotnem primeru pa zamenjajte HTTP vrata, ki jih uporablja Jantar
V tem primeru je namestitveni program ugotovil, da ste Jantar WEB na ta računalnik
WEB.
že namestili.
V takem primeru vam namestitve ni potrebno poganjati, če pa to vseeno želite,
potem pojdite najprej v nadzorno ploščo in odstranite obstoječo namestitev z
2.4.7 HTTP strežnik vrne napako
računalnika.
Med napakami, ki so se pojavile do sedaj, smo zasledili naslednje:
2.4.4
Strežnik se noče zagnati
V primeru, da se strežnik noče pognati, si najprej oglejte log datoteko.
V njej je najverjetneje zapisan razlog za neuspešno poganjanje strežnika.
V primeru, da razloga ni, ali ga ne razumete, stopite v stik z vašim distributerjem
Jantar opreme.
2.4.5
HTTP strežnik se ne odziva
1) Fatal error: Class 'SoapClient' not found in C:\Program Files\Jantar\JantarService
\webroot\inc\jantarSOAP.php on line 260
Ta napaka pomeni, da se avtomatska nastavitev parametrov ni izvedla. Oglejte si
poglavje o ročni nastavitvi parametrov delovanja.
2) #SOAP fault: code: WSDL string:SOAP-ERROR: Parsing WSDL: Couldn't load
from 'http://(ime strežnika):1974/wsdl/IJantar'
Ta napaka pomeni, da se avtomatska nastavitev parametrov ni izvedla. Oglejte si
poglavje o ročni nastavitvi parametrov delovanja.
Razlogov za neodzivanje HTTP strežnika je lahko več:
1) Na računalniku je že nameščen program, ki uporablja IP vrata 80 (HTTP protokol).
Primer so HTTP strežniki (Apache, IIS, PWS...), skype, P2P programi, ipd.
V takem primeru je potrebno odstraniti obstoječ program, ali pa zamenjati vrata za
HTTP v Jantar WEB.
2) Pri poganjanju strežnika je prišlo do napake
Najprej poglejte log datoteko. V njej bo najverjetneje pisalo, v čem je vzrok za (ne)
zagon HTTP strežnika.
3) Strežnik ni pognan
V Jantar manager ali "Services MMC" preverite, če je strežnik dejansko pognan.
© 2005 Jantar d.o.o.
Operacije
III
9
Navodila za Jantar WEB
3
Operacije
3.1
Uvod
To poglavje opisuje postopke, ki jih opravlja Jantar WEB, urejeno po strukturi
menijev.
3.2
Podatki
3.2.1
Podatki
V tem meniju so vam na voljo podatki o registraciji in pristopni kontroli.
Podatke lahko pregledujete, izpisujete na razne načine in seveda tudi popravljate.
3.2.2
Registracija časa
3.2.2.1
Splošno
Tu boste našli vse postopke za izpis in urejanje podatkov o časovni registraciji
uporabnikov.
3.2.2.2
Podroben izpis
Podroben izpis registracije prikaže vse podatke o registraciji za izbrane uporabnike v
izbranem mesecu.
Na koncu dnevnih podatkov so tudi sumarni podatki za celoten izbrani mesec.
© 2005 Jantar d.o.o.
Operacije
3.2.2.4
10
Sumaren izpis statistik
Ta izpis je primeren za knjiženje podatkov o prisotnosti za npr. obračun plač.
Na njem so vsi podatki izpisani v zgoščeni obliki, združeni po statistikah. Prav tako
so navedeni tudi seštevki.
3.2.2.5
3.2.2.3
Izpis statistik
Izpis statistik je kompakten pregled meseca z dnevnimi statistikami, prikazanimi v
obliki ikon.
Primeren je za hiter pregled registracije zaposlenih ter tudi za preverjanje, ali ima več
ljudi dopust na iste dneve.
© 2005 Jantar d.o.o.
Dnevno poročilo
Ta izpis prikaže podatke o registraciji za izbrane uporabnike na določen dan.
11
3.2.2.6
Navodila za Jantar WEB
Izpis prisotnosti
Ta izpis prikaže, kateri uporabniki so trenutno na delu in katerih ni.
3.2.2.7
Urejevalnik
Urejavalnik registracije časa vam omogoča urejanje vseh dogodkov registracije časa,
ki so nujno potrebni pri uporabi.
Poravite lahko manjkajoče prihode ali odhode, urejate izredne odsotnosti, kot so
dopusti, bolniške, itd. Upravljanje je enostavno, primerno je tudi za manj vešče
uporabnike.
© 2005 Jantar d.o.o.
Operacije
3.2.2.7.1 Dogodki
Izpis dogodkov, ki so bili dejansko registrirani na čitalcih za registracijo časa.
12
Splošno":
 Uporabniško ime - Ime, ki ga uporabnik vpiše, ko se prijavlja v sistem
 Polno ime - Pravo ime uporabnika
 Opis - Dodatni opis uporabnika. Pomembno predvsem za upravljalce sistema
 Geslo - Geslo uporabnika
 Ponovi geslo - Še enkrat ponovljeno geslo, da zmanjšamo možnost napačno
vpisanega gesla
 Uporabnik je onemogočen - Če je ta izbira označena, potem se uporabnik ne more
prijaviti v sistem
 Uporabnik je zaklenjen - Če je ta izbira označena, potem je uporabnik pri
prijavljanju tri krat napačno vtipkal geslo
 Povezan uporabnik časovne ragistracije - Uporabnik časovne registracije, ki je
povezan s tem uporabnikom. Izbira je pomembna za izpise, da sistem ve, katere
podatke mora uporabniku prikazovati.
Zavihek "Član" omogoča razporejanje posameznega uporabnika v skupine.
Leva tabela vsebuje vse skupine, katerim uporabnik pripada, desna pa vse
razpoložljive skupine.
V levi tabeli so navedene tudi vse povezane skupine, ne le tiste, katere smo ročno
določili.
3.3
Sistem
3.3.1
Sistem
V tem meniju so operacije, ki omogočajo nastavljanje sistemskih parametrov
programa.
3.3.2
Gesla
3.3.2.1
Splošno
Ta obdelava je dostopna le upravljalcem sistema.
V njej lahko urejamo podatke uporabnikov, skupin in določamo dostopne pravice za
poročila posameznim uporabnikom ali skupinam.
3.3.2.2 Uporabniki in skupine
3.3.2.2.1 Uporabniki
Tu lahko urejamo podatke o uporabnikih, ki imajo dostop do Jantar WEBa.
Na vrhu ekrana sta na voljo zavihka "Uporabniki" za urejanje uporabnikov in
"Skupine" za urejanje skupin. Za urejanje uporabnikov mora biti izbran zavihek
"Uporabniki".
Na levi strani je tabela s seznamom vseh uporabnikov. Ko v njej izberemo
posameznega uporabnika, se njegovi podatki prikažejo v desnem delu, v zavihku "
© 2005 Jantar d.o.o.
13
Navodila za Jantar WEB
Gumbi:
 Nov uporabnik - Izprazni vsa polja in pripravi obrazec za vnos novega uporabnika
 Shrani podatke - Shrani spremembe v podatkih. Če smo pred tem kliknili "Nov
uporabnik", potem se v sistem shrani nov uporabnik.
 Zavrzi spremembe - Ponovno naloži podatke o uporabniku
3.3.2.2.2 Skupine
Omogoča urejanje skupin uporabnikov.
Na vrhu ekrana sta na voljo zavihka "Uporabniki" za urejanje uporabnikov in
"Skupine" za urejanje skupin. Za urejanje skupin mora biti izbran zavihek "Skupine".
3.3.2.3
Dostop do podatkov
3.3.2.3.1 Dostop do podatkov
V obeh postopkih za določanje dostopa do podatkov posameznemu uporabniku ali
skupini natančno določamo, do katerih podatkov ima dostop.
Možne skupine so štiri in predstavljajo:
Skupine - Skupine uporabnikov, kot ste jih določili v nastavljanju skupin.
Oddelki - Oddelki, katerim pripadajo uporabniki časovne ragistracije.
Uporabniki - Uporabniki, kot ste jih določili v nastavljanju uporabnikov.
JantarV7 uporabniki - Uporabniki, kot so vpisani v tabelo časovne ragistracije in
pristopne kontrole.
Nastavljamo lahko, kaj posamezen uporabnik / skupina lahko vidi, in česa ne sme.
Prepoved ima prednost pred dovoljenjem pri ugotavljanju, ali uporabnik do določenih
podatkov ima pravico, ali ne.
Nastavljanje teh pravic je uporabno, če želimo pravice za posameznega uporabnika
določiti na način JantarV7 prejšnjih verzij (oddelki) ali pa, da uporabniku dodamo še
ostale zapise njegovih sekundarnih kartic, npr. daljinskega upravljalca, ipd.
3.3.3
Nastavitve
3.3.3.1
Nastavitve
Tu lahko uporabniki spreminjajo nastavitve svojega uporabniškega računa.
Na levi strani je tabela s seznamom vseh skupin, ki so na voljo. Z izbiro posamezne
skupine se v desnem delu prikažejo njeni podatki:
 Ime: Ime skupine, kot ga uporabljamo pri delu s skupinami
 Opis: Opis skupine, čemu je namenjena, kaj omogoča
 Član: Katerim ostalim skupinam ta skupina pripada. Za natančnejšo razlago glej
Sistem pravic.
Vsak uporabnik lahko popravi svoje polno ime, geslo ter izbere jezik, s katerim bo
© 2005 Jantar d.o.o.
Operacije
Jantar WEB komuniciral z njim.
Zaradi varnosti mora uporabnik vedno vpisati obstoječe geslo, preden lahko popravi
svoje podatke.
Spremembe shranimo s pritiskom gumba "Shrani", ki ima takojšen učinek. V
primeru, da smo spremenili jezik, se lahko zgodi, da se sprememba ne bo takoj
videla. V takih primerih je potrebno klikniti gumb "Osveži" / "Refresh" v brskalniku.
3.3.4
Nadgradnje
3.3.4.1
Nadgradnje
Jantar WEB ima vgrajeno funkcionalnost za avtomatske nadgradnje programa.
Glede na nastavitve bo program vsak dan preveril, če so morda na voljo nadgradnje
programa in v primeru obstoja nadgradenj obvestil upravitelje o tem.
V tem postopku lahko upravljate z nadgradnjami. V primeru, da jih je program že
naložil, je na voljo seznam spremenjenih datotek z opisom sprememb glede na vašo
verzijo.
Na voljo so tudi štirje gumbi, ki se pojavljajo glede na stanje:
Nadgradi - Začne postopek nadgradnje. Jantar WEB bo nadgradil datoteke z novimi.
V primeru, da to ne bo mogoče (če je bila spremenjena katera od kritičnih datotek,
npr. JantarService.exe), se bo strežnik zaustavil, izvedel nadgradnjo in se ponovno
pognal. To seveda pomeni, da se bodo morali vsi trenutno prijavljeni uporabniki še
enkrat prijaviti, da bodo lahko nadaljevali z delom. Pred poganjanjem tega postopka
je smiselno zagotoviti, da na sistemu nihče ne dela. Tudi upravitelj, ki je pritisnil
gumb, se mora po nekaj minutah (ko je nadgradnja izvedena) spet prijaviti.
Preveri nadgradnje - Takoj preveri, če so morda na voljo popravki programa.
Postopek se sicer izvede vsak dan, vendar je včasih zaželeno, da pridete do
popravka takoj.
Naloži vse datoteke - Povzroči, da se z Jantarjevega strežnika naložijo vse
datoteke. Postopek je koristen v primeru, da veste, da je vaša namestitev nekako
© 2005 Jantar d.o.o.
14
pokvarjena (virusi, ipd.), "Preveri nadgradnje" pa vam ne prikaže nobenih novih
datotek.
Osveži - Prikaže se le v primeru, če se postopek za nalaganje novih nadgradenj
pravkar izvaja. Gumb omogoči, da osvežimo prikaz poteka nadgradenj.
Tehnična zgradba programa
IV
Tehnična zgradba programa
4
16
Tehnična zgradba programa
Sledi kratek opis tehnične zgradbe programa.
4.3
HTTP Strežnik
Jantar WEB vsebuje tudi preprost HTTP strežnik, ki igra vlogo posrednika med php
in končnim uporabnikom.
4.4
Uporaba drugega HTTP strežnika
V primeru, da se odločite za uporabo polno funkcionalnega HTTP strežnika (Apache,
MS IIS...), morate zagotoviti, da bo kot dodatek strežniku nameščen tudi PHP verzija
5.0.5.
Poskrbeti je potrebno, da ne pride do podvajanja datotek med Jantar WEBom in
vašo domačo stranjo, ter da se index.php ne izvaja kot privzeti dokument na
osnovnem imeniku. Lahko tudi prestavite datoteke Jantar WEBa na podimenik
strežnika. V takem primeru morate popraviti settings.php. Na imenikih, ki pripadajo
Jantar WEBu se index.php mora izvajati kot privzeti dokument. Uporabniki potem za
dostop do Jantar WEBa v naslovno vrstico brskalnika vpišejo naslov domače strani +
"/index.php" (če ste program namestili v osnovni imenik) oziroma naslov domače
strani + podimenik, če ste program namestili na podimenik. Za lažji dostop je morda
še bolje, če dodate povezavo kar na domačo stran.
4.1
SOAP Strežnik
Osnova Jantar WEBa je SOAP strežnik, ki s svojimi funkcijami zagotavlja celotno
delovanje aplikacije.
Seznam objavljenih funkcij SOAP strežnika si lahko ogledate, če v brskalniku v
naslovno vrstico vtipkate "http://ime_računalnika:1974".
Polno dokumentacijo z razlago parametrov lahko dobite v Jantarju.
4.2
PHP izvajalec
Program sam je pisan v skriptnem jeziku PHP verzija 5.
PHP zagotavlja, da se podatki, ki jih vrnejo funkcije SOAP strežnika, preoblikujejo v
človeku berljivo obliko in preko HTTP strežnika potem pošljejo k odjemalcu.
© 2005 Jantar d.o.o.
Sistem pravic
V
Sistem pravic
5
Sistem pravic
5.1
Splošno
Sistem pravic v Jantar WEBu je zelo podoben sistemu pravic v Windows NT®.
Skupine
Skupine omogočajo, da več uporabnikov s podobnimi lastnostmi združimo v skupino,
s katero lahko v nadaljnjih obdelavah laže delamo, saj si nam ni potrebno zapomniti
vseh uporabnikov, ki v posamezno skupino spadajo.
Jantar WEB vsebuje 6 sistemskih skupin:
Vsakdo
Predstavlja vse uporabnike sistema. Vsak uporabnik,
prijavljen v sistem ima zagotovljene pravice, ki imajo
določeno to skupino.
Uporabniki
Predstavlja navadne uporabnike sistema. Uporabno,
kadar omogočate vplogled v podatke začasnim
uporabnikom. Rednim uporabnikom tako določite
drugačne (večje) pravice, kot pa gostom.
Izdelovalci poročil
Uporabniki, ki imajo pravico izdelovati poročila za
VSE uporabnike.
Izdelovalci poročil za skupine Uporabniki, ki imajo pravico izdelovati poročila za
uporabnike, ki pripadajo istim nesistemskim
skupinam. Primer: v podjetju imate oddelek
"računovodstvo". Zanj odprete novo skupino
"Računovodstvo", ter vse uporabnike iz tega oddelka
določite v to skupino. Neki osebi (iz tega oddelka)
potem določite, da je tudi Izdelovalec poročil za
skupine, kar pomeni, da bo ta oseba pri izpisih videla
tabelo s seznamom vseh uporabnikov, ki spadajo v
skupino "Računovodstvo".
Upravitelji
To so upravitelji sistema. Ti uporabniki imajo vse
pravice, tudi za spreminjanje podatkov ostalih
uporabnikov.
Upravitelji skupin
Ti uporabniki imajo pravice, da izdelujejo poročila,
popravljajo podatke ter urejajo podatke o
uporabnikih, ki pripadajo istim nesistemskim
skupinam, kot oni sami. Glej "Izdelovalci poročil za
skupine" za natančnejšo razlago.
Te skupine imajo poseben pomen in jih ne morete izbrisati.
Skupine lahko pripadajo drugim skupinam. Primer: Proizvodnjo imate razdeljeno na
tri oddelke: ulivanje, brušenje, sestavljanje. Naredite torej štiri skupine: "proizvodnja",
© 2005 Jantar d.o.o.
18
"ulivanje", "brušenje", "sestavljanje". Zadnjim trem skupinam določite, da pripadajo
skupini "proizvodnja". Sedaj lahko v določanju pravic za menije ali druge postopke
določate pravice za skupino "proizvodnja", kar bo dejansko pomenilo, da imajo vsi
ljudje, ki pripadajo kateri koli od štirih navedenih skupin, pravice, kot ste jih nastavili
za skupino "proizvodnja".
Uporabniki
Posamezen uporabnik predstavlja osebo, ki lahko dela z Jantar WEBom.
JantarService.ini
VI
JantarService.ini
6
JantarService.ini
employeePics
6.1
n/a
Splošno
Ta datoteka vsebuje sistemske nastavitve za strežnik programa Jantar WEB.
Najdemo jo na [ProgramFilesDir]Jantar\JantarService.
6.3
6.2
[general]
Ta sekcija vsebuje splošne sistemske nastavitve:
Nastavitev
Privzeto Opis
company
Ime vašega podjetja
system_language sl
Sistemski jezik. Pomeni isto, kot nastavitev jezika v
JantarV7. Jeziki, ki so na voljo, so navedeni na začetku
datoteke languages.xml v istem imeniku.
UserSessionLife 15
Koliko časa je lahko uporabnik neaktiven, preden ga
sistem samodejno odstrani iz seznama prijavljenih
uporabnikov. Čas je v minutah.
forceTablesBuild No
Nastavitev zahteva od strežnika, da pri naslednjem
zagonu poizkusi ponovno kreirati tabele, potrebne za
delovanje Jantar WEBa. Če program ugotovi, da ne
obstajajo, jih bo v vsakem primeru poizkusil kreirati.
forceACLBuild
No
Če je postavljen na "Yes", potem strežnik ob naslednjem
zagonu na novo zgradi uporabnike in pravice za Jantar
WEB. Postopek uniči vse obstoječe nastavljene pravice
in dodatno vpisane uporabnike, ter izdela nov seznam
uporabnikov iz seznama uporabnikov časovne
registracije. Po uspešnem zagonu je potrebno nastavitev
spet postaviti na "No". Možnost uporabite le v primeru,
če so podatki o pravicah nepopravljivo pokvarjeni
(logično). Za reševanje problema pokvarjene baze kot
take, ta opcija ni ustrezna.
WorkerThreads
8
Določa, koliko delovnih niti bo program največ odprl za
obdelovanje zahtev uporabnikov. Nastavitev velja za
SOAP in HTTP strežnik. Priporočljive vrednosti so 4 - 8
za eno in dvoprocesorske računalnike ter 16 za
večprocesorske. Večjega števila niti ne priporočamo, saj
Jantar WEB niti nima toliko zahtev niti na največjih
sistemih, preveliko število niti pa lahko zmanjšuje
odzivnost celotnega računalnika.
allowSystemAccount yes Ali sistem dovoli prijavo s sistemskim uporabnikom
(System). Ta možnost predstavlja veliko varnostno
© 2005 Jantar d.o.o.
20
tveganje, zato jo je smiselno izklopiti takoj, ko opravimo
začetno nastavitev upraviteljskih uporabnikov.
Imenik, kjer strežnik lahko najde slike zaposlenih za
prikaz v dogodkovnem urejevalniku. Imenik mora biti na
istem računalniku, kjer je nameščen strežnik, saj strežnik
nima pravice do omrežnega pogona.
[updater]
Ta sekcija vsebuje nastavitve, potrebne za nadgradnje programa.
Nastavitev
AutoUpdate
Upgrading
ArchivePath
UpdatePath
KeepNPrevious
AutoExecute
Privzeto Opis
03:00 Čas dneva, ob katerem strežnik preveri, če so na voljo
izboljšave programa. Ob tem času bo strežnik
avtomatsko vzpostavil povezavo z Jantarjevim
strežnikom in preveril, če so na voljo novejše datoteke,
kot jih ima sam. Morebitne nove datoteke se bodo
shranile na UpdatePath.
off
Pove, ali se program v tem trenutku nadgrajuje. "On"
pove strežniku, naj ob zagonu naredi arhiv svojih
datotek, kopira datoteke iz update imenika ter na novo
zgradi seznam datotek, ki jih ima na voljo. Nastavitev je
avtomatsko nadzorovana in je ni smiselno spreminjati.
osnovni Nastavitev določa osnovno pot do imenika z arhivom
prejšnjih verzij. Privzeto je to kar imenik, na katerem je
nameščen strežnik. Pod tem imenikom se bo zgradil
imenik "archive", pod katerim bodo imeniki posameznih
arhivov. Imena teh imenikov so v obliki yyyymmdd[_x],
kjer y predstavlja leto, m mesec, d dan, _x pa zaporedno
številko arhiva v dnevu, če je bila nadgradnja izvedena
večkrat v istem dnevu.
osnovni Nastavitev določa osnovno pot do imenika z novimi
nadgradnjami. Privzeto je to kar imenik, na katerem je
nameščen strežnik. Pod tem imenikom se bo zgradil
imenik "update", v katerega se bodo shranjevale
nadgradnje datotek.
5
Število arhivov, ki naj jih strežnik zadržuje v ArchivePath.
Če pri nadgradnji presežemo to število, se brišejo
najstarejši imeniki z arhivi, tako da jih ostane največ
navedeno število (skupaj z najnovejšim arhivom).
yes
Avtomatsko požene nadgradnjo, če je le-ta na voljo.
Nadgradnja se izvede takoj po uspešnem nalaganju
novih datotek.
Navodila za Jantar WEB
21
6.4
[database]
port
80
Vsebuje nastavitve za dostop do baze podatkov.
Nastavitev
driver
connect_string
username
password
server
Privzeto Opis
bde
Gonilnik za dostop do baze, ki naj ga strežnik uporabi.
Za zdaj so podprti BDE, ODBC in Interbase.
(tiran) Ime baze podatkov
(tiran) Uporabniško ime za dostop do baze podatkov. Vrednost
se ob namestitvi programa prepiše iz nastavitev
JantarV7.
(tiran) Geslo za dostop do baze podatkov. Vrednost se ob
namestitvi programa prepiše iz nastavitev JantarV7.
Geslo je kodirano z močnim algoritmom za kodiranje
podatkov.
ib
Tip strežnika podatkov. Nastavitev je zelo pomembna za
BDE in ODBC gonilnik, ko program ne ve dejanskega
strežnika, ki teče za gonilniki. Nastavitev strežniku pove,
kakšno različico SQL stavkov lahko uporablja. Podprti
nastavitvi sta ib (interbase / firebird) in ms (Microsoft
SQL)
WEB_root
PHP_path
6.7
Nekaterih tipov ni mogoče nastavljati in jih program vedno zapiše v LOG. Primer
takih zapisov so napake, ki jih program odkrije in tako tudi zapiše.
Nastavitev
logFName
[SOAPServer]
Vsebuje nastavitve za SOAP strežnik.
Nastavitev
enabled
port
6.6
Privzeto Opis
Yes
Določa, ali naj strežnik aktivira tudi SOAP strežnik, ali
ne. Nastavitve ni smiselno spreminjati.
1974
IP Vrata, preko katerih deluje SOAP strežnik.
Spreminjajte le v primeru, če na računalniku že teče drug
strežnik, ki zaseda ta vrata. Če spreminjate to nastavitev,
logSOAP
morate popraviti tudi settings.php.
[HTTPServer]
V tej sekciji nastavljamo delovanje HTTP strežnika.
Nastavitev
enabled
Privzeto Opis
Yes
Določa, ali naj strežnik aktivira tudi HTTP strežnik, ali ne.
Če nameravamo uporabiti drug HTTP strežnik, potem
[Logging]
V tej sekciji določimo, kaj se bo zapisovalo v log datoteko.
logHTTP
6.5
postavimo to nastavitev na "No".
IP Vrata, preko katerih deluje HTTP strežnik. Če
nameravate uporabljati Jantar WEB ločeno ob drugem
HTTP strežniku, potem to nastavitev popravite na npr.
81, 88 ali kaka druga vrata, ki v sistemu še niso
zasedena. Seveda potem morajo uporabniki ustrezno
spremeniti tudi naslov za dostop do Jantar WEBa. Npr.
http://(ime računalnika):vrata - http://veliswork:81
Pove HTTP strežniku, kje je začetni imenik php
programa.
Pove HTTP strežniku, kje lahko najde php izvajalca.
logInit
Privzeto Opis
Ime datoteke (polna pot), kamor se bodo zapisovali
dogodki strežnika. Obvezen parameter.
Kaj od HTTP zahtev naj se zapisuje. Navedemo
kombinacijo štirih možnosti, ločenih z vejico: request,
response, content, headers.
request: izpiše osnovne informacije o HTTP zahtevi
response: izpiše osnovne informacije o poslanem
odgovoru
content (velja le, če smo določili tudi request ali
response): k osnovni informaciji doda še vsebino
zahteve
headers (velja le, če smo določili tudi request ali
response): k osnovni informaciji doda še headerje
Kaj od SOAP zahtev naj se zapisuje. Navedemo
kombinacijo treh možnosti, ločenih z vejico: request,
response, content.
request: izpiše osnovne informacije o zahtevi
response: izpiše osnovne informacije o odgovoru
content: doda tudi vsebino dolgih parametrov.
V log datoteko zapisuje posamezne dogodke med
zaganjanjem in ustavljanjem strežnika.
© 2005 Jantar d.o.o.
22
Ključne besede
Log datoteka
-BBaza podatkov
21
-DDnevno poročilo 10
Dostop do podatkov 13
-GGesla 12
Dostop do podatkov 13
Skupine 13
Uporabniki 12
Uporabniki in skupine 12, 13
-HHTTP Strežnik
21
-IIzdelovalci poročil 18
Izpis prisotnosti 11
Izpis statistik 10
-JJantarService.ini
-L-
20
-MMeni 9
Gesla 12
Nadgradnje 14
Nastavitve 13
Podatki 9
Registracija časa
Sistem 12
9
-NNadgradnje 14
Namestitev 4
Nastavitve 13
Neaktivni uporabniki
20
-OOperacije 9
Gesla 12
Nadgradnje 14
Nastavitve 13
Podatki 9
Registracija časa
Sistem 12
-PParametri
© 2005 Jantar d.o.o.
21
5
9
23
Navodila za Jantar WEB
Podroben izpis 9
Pravice 18
Preverjanje delovanja strežnika
4
Tehnična zgradba programa
HTTP strežnik 16
PHP strežnik 16
SOAP strežnik 16
Uporaba drugega HTTP strežnika
-RRegistracija časa 9
Dnevno poročilo 10
Izpis prisotnosti 11
Izpis statistik 10
Podroben izpis 9
Sumaren izpis statistik 10
Reševanje težav
HTTP strežnik se ne odziva
HTTP strežnik vrne napako
Ime računalnika 6
Napačna slika v brskalniku
Program se noče namestiti
Različni imeniki 6
Strežnik se noče zagnati 7
-S-
-T-
16
-U7
7
7
7
Uporaba drugega HTTP strežnika
Uporabniki 18
Uporabniki in skupine 12, 13
Upravitelji 18
Urejanje skupin 13
Urejanje uporabnikov 12
16
-VVsakdo
18
Sistem 12
Sistem pravic 18
Sistemske nastavitve 20
Sistemske skupine 18
Sistemske zahteve
Odjemalec 4
Strežnik 4
Sistemski jezik 20
Skupine 18
SOAP Strežnik 21
Sumaren izpis statistik 10
© 2005 Jantar d.o.o.