CRM SYSTE´M KORMORA´N PRˇI´RUCˇKA ADMINISTRA´TORA
Obsah . . . . . .
3 3 3 3 4 4 4
2
Instalace syste´mu 2.1 Instalace serveru˚ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.2 Instalace aplikace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.3 Vytvorˇenı´ databa´ze a prˇipojenı´ do databa´ze . . . . . . . . . . . . . . . . . .
5 5 5 5
3
Typicke´ u´lohy 3.1 Prˇida´nı´ nove´ho typu za´znamu˚ . . . . . . . . . . . . . . . . . . . . . . . . .
7 7
1
Administrace syste´mu 1.1 Uzˇivatelske´ u´cˇty . 1.2 Prˇ´ıstupova´ pra´va 1.3 Moduly . . . . . . 1.4 Skupiny atributu˚ 1.5 Atributy . . . . . 1.6 Hodnoty atributu˚
. . . . . .
. . . . . .
. . . . . .
. . . . . .
. . . . . .
. . . . . .
. . . . . .
. . . . . .
. . . . . .
. . . . . .
2
. . . . . .
. . . . . .
. . . . . .
. . . . . .
. . . . . .
. . . . . .
. . . . . .
. . . . . .
. . . . . .
. . . . . .
. . . . . .
. . . . . .
. . . . . .
. . . . . .
. . . . . .
. . . . . .
. . . . . .
. . . . . .
. . . . . .
. . . . . .
. . . . . .
. . . . . .
Kapitola 1
Administrace syste´mu Pokud prˇihla´sˇeny´ uzˇivatel patrˇ´ı do skupiny administra´toru˚, jako poslednı´ polozˇka v menu se mu zobrazı´ odkaz uzˇivatel. Po kliknutı´ na tuto polozˇku zmeˇnı´ polozˇky menu na Uzˇivatele´, Pra´va, Moduly, Skupiny, Atributy, Hodnoty, ktere´ uzˇivateli umozˇnı´ spravovat instalaci syste´mu.
1.1
Uzˇivatelske´ u´cˇty
V modulu Uzˇivatele´ lze prove´st zrˇ´ızenı´ nove´ho u´cˇtu pro prˇ´ıstup do syste´mu. Login a heslo slouzˇ´ı jako prˇihlasˇovacı´ u´daje, pod nimizˇ se uzˇivatel prˇihlasˇuje do syste´mu. Jako login i heslo musı´ by´t uveden rˇeteˇzec znaku˚ maxima´lnı´ de´lky 20. Skupiny slouzˇ´ı jako seznam skupin, do nichzˇ uzˇivatel patrˇ´ı. Na´zvy skupin musı´ by´t oddeˇleny cˇa´rkou a mezerou. Standardneˇ pouzˇ´ıvane´ skupiny v syste´mu jsou users pro obycˇejne´ uzˇivatele a admin pro administra´tory. Jako jme´no mu˚zˇe by´t uvedeno naprˇ. prˇ´ıjmenı´ uzˇivatele, poprˇ. na´zev oddeˇlenı´ cˇi pozice, pokud se jedna´ o u´cˇet pro urcˇite´ oddeˇlenı´ ve firmeˇ cˇi pozici.
1.2
Prˇı´stupova´ pra´va
Prˇ´ıstupova´ pra´va slouzˇ´ı pro definici prˇ´ıstupovy´ch pra´v pro jednotlive´ moduly cˇi konkre´tnı´ za´znamy a skupiny uzˇivatelu˚ cˇi konkre´tnı´ uzˇivatele. Jako modul musı´ by´t uvedeno jme´no modulu, k neˇmuzˇ se ma´ prˇ´ıstupove´ pra´vo vztahovat. Jako atribut mu˚zˇe by´t uden na´zev atributu, k neˇmuzˇ se ma´ prˇ´ıstupove´ pra´vo vztahovat. Nenı´-li uveden, prˇ´ıstupove´ pra´vo se vztahuje na vsˇechny za´znamy dane´ho modulu. Podmı´nka poma´ha´ specifikovat, na ktere´ za´znamy se ma´ pra´vo vztahovat tı´m, zˇe definuje hodnoty, ktere´ mu˚zˇe mı´t za´znam na uvedene´m atributu. Rozlisˇujı´ se trˇi u´rovneˇ prˇ´ıstupu. Da´le musı´ by´t vyplneˇn atribut Skupina, nebo Uzˇivatel. Tyto atributy specifikujı´, pro ktere´ skupiny uzˇivatelu˚ nebo uzˇivatele se dane´ pra´vo vztahuje.
1.3
Moduly
Moduly slouzˇ´ı pro vytva´rˇenı´ a spra´vu typu˚ za´znamu˚, ktere´ majı´ by´t v syste´mu prˇ´ıstupne´. Zkratka definuje jme´no modulu v databa´zi a mu˚zˇe proto obsahovat pouze znaky a-z a A-Z bez diakritiky. Na´zev slouzˇ´ı jako na´zev modulu. Na´zev pro menu jako na´zev modulu, ktery´ se bude zobrazovat v menu. Meˇl by by´t proto nejle´pe jednoslovny´. Pozice urcˇuje porˇadı´ v jake´m se ma´ zobrazovat odkaz na modul v menu. Zatrzˇ´ıtko Admin menu urcˇuje, ma´-li by´t odkaz na modul zobrazova´n v menu pro obycˇejne´ho uzˇivatele nebo administra´tora.
3
KAPITOLA 1. ADMINISTRACE SYSTE´MU
˚ 1.4. SKUPINY ATRIBUTU
1.4
Skupiny atributu˚
Skupiny atributu˚ slouzˇ´ı ve formula´rˇ´ıch ke zlepsˇenı´ orientace a zprˇehledneˇnı´. Vytva´rˇejı´ pojmenovanou skupinu atributu˚. Na´zev definuje pojmenova´nı´ skupiny a zobrazuje se tucˇneˇ a kapita´lkami nad danou skupinou. Modul urcˇuje jme´no modulu, ke ktere´mu skupina patrˇ´ı. Pozice slouzˇ´ı k urcˇenı´ pozice skupiny ve formula´rˇi. Prvnı´ pozice je v leve´m sloupci nahorˇe, druha´ je v prave´m sloupci nahorˇe, trˇetı´ opeˇt v leve´m sloupci pod prvnı´ atd.
1.5
Atributy
Atributy jsou vlastnosti jednotlivy´ch polozˇek v modulu. Naprˇ. jme´no a prˇ´ıjmenı´ u osoby cˇi na´zev u firmy. Zobrazujı´ se jako jednotlive´ polozˇky v editacˇnı´m formula´rˇi. Na´zev urcˇuje pojmenova´nı´ atributu, ktere´ se bude zobrazovat ve formula´rˇ´ıch, prˇehledech, filtrech atd. Typ urcˇuje typ atributu. Modul je jme´no modulu, ke ktere´mu se atribut vztahuje. Atribut je na´zev atributu pro databa´zi a nesmı´ tedy obsahovat znaky s diakritikou. Implicitnı´ je hodnota, ktera´ bude prˇedvyplneˇna u dane´ho atributu prˇi zakla´da´nı´ nove´ho za´znamu. Naprˇ. u www adresy by zde mohlo by´t http://. U atributu˚ typu datum zde mu˚zˇe by´t prˇirozene´ cˇ´ıslo, ktere´ oznacˇuje pocˇet hodin a prˇida´va´ se k aktua´lnı´mu cˇasu. U atributu˚ typu vazba 1:N odkazujı´cı´ch na uzˇivatele zde mu˚zˇe by´t rˇeteˇzec user, ktery´ oznacˇuje aktua´lneˇ prˇihla´sˇene´ho uzˇivatele. Je-li zasˇkrtnuto polı´cˇko Povinny´, bude prˇi vyplnˇova´nı´ formula´rˇe vzˇdy vyzˇadova´no zada´nı´ hodnoty atributu. Je-li zasˇkrtnuto polı´cˇko Fokus, skocˇ´ı kurzor prˇi zobrazenı´ formula´rˇe do polı´cˇka odpovı´dajı´cı´ho dane´mu atributu. Skupina oznacˇuje skupinu atributu˚, do ktere´ atribut patrˇ´ı. Porˇadı´ urcˇuje implicitnı´ porˇadı´ atributu v prˇehledu za´znamu˚, tj. na ktere´m mı´steˇ se dany´ atribut zobrazı´ uzˇivateli v prˇehledu za´znamu˚ prˇi prvnı´m prˇihla´sˇenı´ do syste´mu. Setrˇ´ıdeˇnı´ urcˇuje, ma´-li by´t atribut setrˇ´ıdeˇn. Hodnoty ve skupineˇ Odkazy slouzˇ´ı pro prˇ´ıpad, zˇe atribut ma´ by´t vazbou do jine´ho modulu. Odkaz na modul slouzˇ´ı pro urcˇenı´ jme´na modulu, na ktery´ atribut odkazuje. Odkaz na atribut slouzˇ´ı pro urcˇenı´ jme´na atributu, z neˇhozˇ se majı´ zobrazovat hodnoty prˇi vybı´ra´nı´ vazebnı´ch polozˇek. Asociativnı´ tab. slouzˇ´ı v prˇ´ıpadeˇ, zˇe jde o vazbu M:N, pro definici jme´na tabulky, ktera´ se ma´ pouzˇ´ıt pro ukla´da´nı´ vztahu˚.
1.6
Hodnoty atributu˚
Hodnoty atributu˚ slouzˇ´ı pro definici polozˇek pro atributy typu vy´beˇr z vı´ce mozˇnostı´. Atribut je odkaz na atribut, ke ktere´mu se hodnota vztahuje. Hodnota je prˇirozene´ cˇ´ıslo, ktere´ se ukla´da´ v databa´zi do sloupce odpovı´dajı´cı´ dane´mu atributu. Na´zev je jme´no hodnoty, ktere´ se zobrazuje ve formula´rˇ´ıch, prˇehledech atd.
4
Kapitola 2
Instalace syste´mu Instalace syste´mu lze snadno prove´st podle na´sledujı´cı´ho postupu. Kompletnı´ instalace zabere zkusˇene´mu administra´torovi jen pa´r hodin. Pokud je jizˇ nainstalova´n aplikacˇnı´ i databa´zovy´ server, instalace mu˚zˇe trvat pouze neˇkolik desı´tek minut.
2.1
Instalace serveru˚
Aplikacˇnı´ server Syste´m vyzˇaduje aplikacˇnı´ server Sun Java System Application Server Platform Edition 9. Instalacˇnı´ program serveru lze sta´hnout z adresy java.sun.com v balı´ku Java EE 5 SDK (doporucˇeno) spolecˇneˇ s Java SE 5 Update 6, ktera´ je potrˇebna´ pro instalaci a spusˇteˇnı´ aplikacˇnı´ho serveru. Druhou mozˇnostı´ je sta´hnout Java SE 5 Update 6 a Sun Java System Application Server Platform Edition 9 oddeˇleneˇ a nainstalovat je postupneˇ. Dome´na musı´ by´t nainstalova´na na portu 8282 (na tomto portu totizˇ ocˇeka´va´ webovy´ modul modul s webovy´mi sluzˇbami). HTTPS se doporucˇuje nainstalovat na port 8383. O u´speˇsˇne´ instalaci serveru a dome´ny se lze prˇesveˇdcˇit prˇihla´sˇenı´m do administrativnı´ho webove´ho rozhranı´ serveru, ktere´ se nacha´zı´ na portu, ktery´ byl zvolen.
Databa´zovy´ server Pokud na serveru nenı´ nainstalova´n zˇa´dny´ databa´zovy´ server, lze sta´hnout naprˇ. instalacˇnı´ program databa´ze MySQL 5 z adresy www.mysql.com (doporucˇeno). Jiny´ databa´zovy´ server nenı´ momenta´lneˇ podporova´n. O u´speˇsˇne´ instalaci databa´zove´ho serveru se lze prˇesveˇdcˇit prˇihla´sˇenı´m na jeho prˇ´ıkazovou rˇa´dku.
2.2
Instalace aplikace
Nahra´nı´ modulu pro vytvorˇenı´ databa´ze ze souboru KormoranInfo.war, webove´ho modulu ze souboru KormoranWebModule.war a modulu s webovy´mi sluzˇbami ze souboru KormoranWSModule.war lze prove´st prˇes administrativnı´ webove´ rozhranı´ serveru v menu Applications, Web Applications nebo prˇekopı´rova´nı´m teˇchto souboru˚ prˇ´ımo do autodeploy adresa´rˇe dome´ny serveru.
2.3
Vytvorˇenı´ databa´ze a prˇipojenı´ do databa´ze
JDBC ovladacˇ Aby server mohl komunikovat s databa´zı´, je potrˇeba nahra´t JDBC ovladacˇ zvolene´ databa´ze do adresa´rˇe lib serveru. MySQL JDBC olvladacˇ lze sta´hnout na adrese dev.mysql.com.
5
´ ZE 2. INSTALACE SYSTE´MU 2.3. VYTVORˇENI´ DATABA´ZE A PRˇIPOJENI´ DO DATABA KAPITOLA
Connection pool Vytvorˇenı´ connection pool naprˇ. prˇes administrativnı´ webove´ rozhranı´ serveru v menu Resources, JDBC, Connection Pools s na´sledujı´cı´mi parametry: Name Resource Type Datasource Classname
KormoranPool javax.sql.DataSource com.mysql.jdbc.jdbc2.optional.MysqlConnectionPoolDataSource
Na´sleduje vy´cˇet vlastnostı´ pro kategorii Properties: URL User Password characterEncoding
jdbc:mysql://localhost:3306/ root heslo UTF-8
O u´speˇsˇne´m nastavenı´ connection poolu se lze prˇesveˇdcˇit stisknutı´m tlacˇ´ıtka Ping v zobrazenı´ poolu.
JDBC Resource Vytvorˇenı´ JDBC Resource naprˇ. prˇes administrativnı´ webove´ rozhranı´ serveru v menu Resources, JDBC, JDBC Resources s na´sledujı´cı´mi parametry: JNDI Name Pool Name
jdbc/KormoranPool KormoranPool
Vytvorˇenı´ databa´ze Pro vytvorˇenı´ sche´matu databa´ze slouzˇ´ı modul KormoranInfo. Aplikaci spustı´me naprˇ. z prˇehledu aplikacı´ v administrativnı´m rozhranı´, pokud se na´m nechce adresu vypisovat do prohlı´zˇecˇe rucˇneˇ. Vybereme vhodny´ na´zev pro firemnı´ u´cˇet a vytvorˇ´ıme databa´zi. Do databa´ze je vlozˇen uzˇivatel s loginem admin a heslem adminadmin, aby bylo mozˇne´ se do syste´mu poprve´ prˇihla´sit. Tento u´cˇet je z bezpecˇnostnı´ch du˚vodu doporucˇeno prˇi prvnı´m prˇihla´sˇenı´ odstranit na´sl. zpu˚sobem: Nejprve vytvorˇ´ıme novy´ administra´torsky´ u´cˇet, odha´sı´me se z aplikace, prˇihla´sı´me se pod novy´m u´cˇtem a pu˚vodnı´ u´cˇet smazˇeme.
Automaticka´ kontrola prˇipojenı´ k databa´zi Pro prˇ´ıpad, zˇe chceme, aby sever prova´deˇl automatickou kontrolu a obnovenı´ prˇipojenı´ k databa´zi. Vhodne´ prˇedevsˇ´ım u MySQL, protozˇe MySQL prˇerusˇ´ı neaktivnı´ spojenı´ jizˇ po neˇkolika hodina´ch. V nastavenı´ pool zmeˇnı´me vlastnost URL na hodnotu jdbc:mysql://localhost:3306/fid, kde fid je na´zev, ktery´ jsme drˇ´ıve vybrali pro firemnı´ u´cˇet a prˇida´me: Connection Validation Validation Method Table Name
Required table connectionvalidation
6
Kapitola 3
Typicke´ u´lohy 3.1
Prˇida´nı´ nove´ho typu za´znamu˚
Pokud se firma rozhodne prˇidat novy´ typ za´znamu˚, administra´tor v syste´mu vytvorˇ´ı za´znam pro novy´ modul. Da´le vytvorˇ´ı skupiny atributu˚, ktere´ se budou vyskytovat ve formula´rˇi dane´ho modulu. Pak vytvorˇ´ı atributy, ktere´ se majı´ v dane´m modulu evidovat, definuje prˇedevsˇ´ım jejich jme´na, na´zvy, typy, majı´-li by´t povinne´, ktery´ ma´ by´t aktivnı´ prˇi zobrazenı´ formula´rˇe. Nakonec jesˇteˇ musı´ vytvorˇit nova´ prˇ´ıstupova´ pra´va pro dany´ modul, jinak se nikomu nebudou za´znamy nove´ho modulu zobrazovat. Po opeˇtovne´m prˇihla´sˇenı´ do syste´mu, mohou uzˇivatele´ zacˇ´ıt vyuzˇ´ıvat modul pro vkla´da´nı´ editaci a maza´nı´ za´znamu˚ nove´ho typu.
7
