# CivisCloud
WEB alapú keretrendszer
Verzió: 4
**Felhasználói kézikönyv**
---
## 📋 Tartalomjegyzék
- [Bevezetés](#bevezetés)
- [Futtatási környezet](#futtatási-környezet)
- [Keretrendszer](#keretrendszer)
- [Bejelentkezés](#bejelentkezés)
- [Menüelemek](#menüelemek)
- [Listák (Csak bizonyos modulok esetében)](#listák)
- [Alaptörzs](#alaptörzs)
- [Felhasználók](#felhasználók)
- [Bejelentkezési szabály](#bejelentkezési-szabály)
- [Jelszó csere](#jelszó-csere)
- [Jogosultságok és szerepkörök](#jogosultságok-és-szerepkörök)
## Bevezetés
A CivisCloud keretrendszer azért készült, hogy a vállalkozások mindennapi munkájában hathatós segítséget nyújtó moduloknak biztonságos környezetet biztosítson.
Olyan WEB-es technológiákat alkalmaztunk, amelyek a felhasználók gyors és hatékony munkavégzését teszik lehetővé.
A WEB-es felület és a szerver-kliens technológia egyszerűen és biztonságosan teszi lehetővé a felhasználók részére a rendszer használatát a világ bármely tájáról.
## Futtatási környezet
A rendszer elérhető felhőben és saját gépre telepítve is. A rendszer futási környezete, sémája csak attól függ, hogy Ön hogyan ítéli meg a feldolgozás biztonságát, hasznosságát, melyik feldolgozási séma szolgálja leginkább az Ön érdekeit.
Alapvetően két eltérő működési séma közül választhat. A továbbiakban ezekről adunk tájékoztatást, bemutatjuk mindkét séma előnyeit és hátrányait. Reméljük, hogy ezek alapján egyértelműen ki tudja választani az Önnek megfelelő sémát.
**Működési séma - Belső erőforrások**
A belső erőforrások használata esetén minden működési feltételt a felhasználó szerverein kell biztosítani. Így telepíteni kell a megfelelő konfigurációval rendelkező WEB szervert. A felhasználók számától, valamint az adatbázis szerver tulajdonságaitól függ, hogy a WEB szerver és az adatbázis szerver lehet-e ugyanazon a gépen, vagy a WEB szervert új számítógépen kell létrehozni.
Ennek a sémának nagy előnye, hogy szükség esetén teljesen megtilthatjuk a külső internetről való hozzáférést és csak a belső hálózatot is használhatjuk az elemzések elvégzéséhez. Ezzel a tiltással csak akkor éljünk, ha az biztosan indokolt, hiszen így azt az előnyt veszíthetjük el, hogy a menedzsment bárhol a világban rá tudjon tekinteni a megfelelő kimutatásokra. Használjunk inkább más védekező eszközöket a biztonságos hozzáférés eléréséhez.
**Működési séma - Felhő architektúra**
A felhő architektúra használata lehetővé teszi a gyors és költséghatékony program elérést. Nem kell a telepítéssel bajlódnia, nincs szükség a WEB szerver finomhangolására. Mindezt a felhőben lévő WEB szervernél szakembereink már elvégezték Ön helyett. Önnek csak a kimutatásokra kell koncentrálnia, amely segíti az Ön munkáját.
Felhasználói oldalon az internetre/intranetre kapcsolódás után egy Web böngészőre van szükség függetlenül az alatta lévő operációs rendszertől. A rendszer az alábbi böngészőket támogatja: Firefox, Opera, Google Crome.
Támogatott felbontás: 1024x768 pixel.
Szerver oldalon az alábbi követelményeket kell a rendszer futásához biztosítani:
Operációs rendszer: Windows, Linux, Vagy Mac OSX
Java futtató környezet: Java7 és Tomcat7, vagy Tomcat8
Adatbázis szerver: Mariadb
## Keretrendszer
A keretrendszer állítja be a rendszer futtatási környezetét. Itt valósul meg minden funkció, amely rendszer teljes egészét áthatja.
A keretrendszer nélkül egyetlen modul sem képes a funkcióját megvalósítani, így azt is mondhatjuk, hogy a keretrendszer az az alap, amelyre minden modul épül.
## Bejelentkezés
A rendszert csak olyan felhasználók használhatják, akik erre a megfelelő jogosultsággal rendelkeznek. Az illetéktelen hozzáférést hívatott megakadályozni a bejelentkezési képernyő. Ezt kikerülni nem lehet, csak ezen keresztül lehet eljutni a program használatához.

Bejelentkezés esetén meg kell adnunk a felhasználó bejelentkezési nevét és jelszavát. Egy adott felhasználó több licenszhez is tartozhat. A licenszbe tartozást a felhasználó bejelentkezési neve és a jelszava közösen határozza meg.
Ha csak egy licenszhez tartozik a felhasználó, akkor a program
- „Bejelentkezés” gomb megnyomására, vagy a jelszó beírása után a „ENTER” megnyomására elindul egy ellenőrzési folyamat, és csak a sikeres ellenőrzés után engedi be a program bejelentkezésen túljutni a felhasználót és a program fő képernyőjét megnyitni.
Ha a felhasználó bejelentkezési neve és jelszava a szerveren lévő licenszek közül többen is előfordul, akkor a program a következő képernyőt jeleníti meg:

Ezen a képernyőn kattintsunk duplán arra a licenszre, amelyben dolgozni szeretnénk. A dupla kattintás után a program a megfelelő licensz fő képernyőjét jeleníti meg.
A bejelentkezés után a program a felhasználóhoz tartozó aktív fülek közül az utolsót nyitja meg automatikusan.
A fő képernyő alsó részében a program kijelzi a licensz nevét és a felhasználót:

## Menüelemek
A keretrendszer a bejelentkezés után az alábbi menürendszeren keresztül érhető el:

Ahhoz, hogy a menü működését megértsük, még egy fogalom tisztázása szükséges.
A fül egy olyan rész a képernyőn, amelyre kattintva egy programrész működését indíthatjuk el:

A fenti példán a programban 4 fül van használatban.
A „Kedvencek” mindig az első és nem törölhető a fülek közül.
Az „Állomány feltöltése” az aktív, mivel ez a sorban az utolsó fül.
Ha egy fülre rákattintunk, akkor aktiválja a program megfelelő részét és lehetővé teszi számunkra a feldolgozást.
Mi is az összefüggés a menü és a fül között?
Alapesetben, amikor először használjuk a programot, akkor csak a „Kedvencek” fül található a fülek számára fenntartott területen.
Ha rákattintunk a menü egy elemére (például a „Szerepkörök”-re), akkor a „Kedvencek” mellett megjelenik a „Szerepkörök” fül és egyből aktívvá is válik.
Ha egy olyan menüelemre kattintunk rá, amely esetén már a fülek között szerepel a menüelemhez tartozó fül, akkor azt még egyszer nem hozza létre, hanem megkeresi a fülek között és aktívvá teszi, mintha rákattintottunk volna.
Ha már nincs szükségünk egy adott fülre, akkor a fül jobb oldalán szereplő kis x-re kattintsunk rá. Így a kattintás után kikerül a fülek közül. Ilyenkor a fülön végzett munkát először menteni kell!
Csak azok a menüelemek és fülek jelennek meg bejelentkezés után a program fő képernyőjén, amelyre megfelelő jogosultságot kaptunk. Erről a későbbiekben lesz szó.
## Listák
A Menü mellett található a listák fül, amely a megfelelő modulhoz tartozó listákat tartalmazza:

A listák működése teljesen megegyezik a menüelemek működésével, füleken keresztül lehet azokat elérni.
Csak azok a listák és fülek jelennek meg bejelentkezés után a program fő képernyőjén, amelyre megfelelő jogosultságot kaptunk.
Most nézzük meg, hogyan épül fel egy lista.

**Vezérlő gombok:**
- Nyomtatás – A listát készíti el a beállított szűrőfeltételeknek megfelelően „pdf” formában.
- Export – A szűrőfeltételeknek megfelelő lista tartalmát teszi ki a kiválasztott típusú formátumban:

- A „Kedvencek” fül jobb oldali oszlopába teszi a listát a gyorsabb indítás kedvéért. A kedvencek használatáról a „Kedvencek” menüpontban találunk további információt.
**Szűrő feltételek:**
Minden listához tartoznak olyan mezők, amelyek kitöltésével a listán megjelenő adatok mennyisége és minősége meghatározható. Ezek a szűrő feltételek listánként más-más tartalommal bírnak a lista fajtájától függően.
## Alaptörzs
A menük nagy része teljesen hasonló elven működik, úgynevezett alaptörzs típusú törzs. Ezért itt írjuk le az alaptörzs működését és erre a működésre csak hívatkozunk majd a program leírás megfelelő részénél.
Az alatözs fő képernyőjét a következő ábra szemlélteti (a felhasználó törzs kezelésén keresztül mutatjuk meg az alaptörzs működését):

**Vezérlő gombok:**
- „Kedvencekhez ad” gomb az aktuális képernyőn látszó funkciót a felhasználó kedvenc menüpontjai közé teszi. Ennek az a jelentősége, hogy a sűrűn használt funkciókat ne kelljen újra és újra kikeresni a menürendszerből, hanem onnan kiemelve egy könnyen átlátható felületen helyezheti el a későbbi használathoz. A Kedvencek szerepének és kezelésének részletes magyarázatát a későbbiekben ismertetjük.
- „Frissítés” gomb az adathalmazt kéri le újból a szerverről. A megnyomásával a rekordok legfrissebb változatát látjuk. Ez a gomb nem csak itt, hanem a képernyő sok helyén is megjelenhet. Ahol megjelenik, ott mindig a mellette lévő kereső mező értékeinek a frissítését lehet a gomb megnyomásával kérni. Megnyomásra a szerverről a kereső értékeinek a legfrissebb változata lesz elérhető.
**Kereső sáv:**

Minden mező felett megjelenik egy írható kereső mező, ahova begépelhetjük a keresendő szöveget. Gépelés közben a program folyamatosan szűkíti a keresendő rekordokat. Ha több mezőnk van, akkor minden mező fölött megjelenik egy-egy kereső mező és ezek „ÉS” kapcsolattal kapcsolódnak össze a gyors és egyértelmű kereséséért.
Az adatokat tároló szerver beállítása miatt a program a keresésben nem tesz különbséges kis és nagybetű között. Így a „kerek” és a „Kerék” szöveg ugyanazt az eredményt adja.
Ugyancsak mindegy, hogy az alábbiaknál melyik betűt használjuk, mert mindegyikre ugyanaz az eredmény adódik:
• aá
• eé
• oóöő
• uúüű
**Új felvitel**
Az
- „Új felvitel” gomb megnyomásával hozhatunk létre új rekordot. Ekkor az alábbi képernyőt kapjuk:

Az azonosítót a rendszer automatikusan adja.
A *-al jelzett mezők kitöltése kötelező, erre a program figyelmeztet mentéskor. Többféle mező típus létezik:
• szöveg
• szám
• checkbox
• lenyíló
• kereső
Ezeknek a használatát a program megfelelő részén ismertetjük, ha az eltér a szokványos kitöltéstől.
A
- „Mentés” gomb az aktuális képernyő tartalmát leellenőrzi, és hibamentesség esetén elmenti, valamint bezárja.
A
- „Kilépés” gomb az aktuális képernyőt mentés nélkül bezárja.
**Módosítás**
Ha a fő képernyőn rákattintunk arra a sorra, amelyet módosítani szeretnénk és megnyomjuk a
- „Módosítás” gombot, vagy a sorra duplán kattintunk, akkor az adott sor adatlapja jön fel módosításra a következők szerint:

Ezen a képernyőn egy már felvitt adatot módosíthatunk, vagy egy eddig nem kitöltött adatot vihetünk fel.
A fenti kép alján látszik, hogy az adatlapot ki, mikor hozta létre, valamint az is, hogy utoljára ki, mikor és honnan módosította.
**Törlés**
Ha a fő képernyőn rákattintunk arra a sorra, amelyet törölni szeretnénk és megnyomjuk a
- „Törlés” gombot, akkor az adott sor törlése előtt egy figyelmeztető ablak jön fel:

Ha az „Igen”-t választjuk, akkor a törlés végrehajtódik és nem állítható helyre. A nem körültekintően elvégzett törlés a program kívánt működésébe nem várt eredményt okozhatnak.
**A törlés a sorhoz tartozó összes kapcsolatot törli, vagy figyelmeztet arra, hogy vannak olyan kapcsolatok, amelyeket a törlés előtt szintén törölni kell!**
A „Módosítás” és a „Törlés” funkció úgy is elindítható, hogy a megfelelő sorra jobb-clickkel kattintunk. Ekkor az alábbi ablakot kapjuk:

Ebben a felugró ablakban kattintsunk a megfelelő sorra a művelet elindításához.
Ha a főképernyőn leszűrt rekordokat ki szeretnénk nyomtatni, akkor kattintsunk a
- „Nyomtatás” gombra és az alábbi felugró ablak segíti a munkánkat:

Itt bejelölhetjük azokat a mezőket, amelyeket ki szeretnénk nyomtatni, megadhatjuk a nyomtatandó mező szélességét és meghatározhatjuk a nyomtatás tájolását (álló, vagy fekvő). Ha ezeket beállítottuk, akkor a „Nyomtatás” gombbal elindíthatjuk a tényleges nyomtatást.
**Figyeljünk rá, hogy a böngészőnk engedélyezi-e a felugró ablakokat. Ha nem, akkor legalább erről a helyről engedélyezzük!**
Ha engedélyeztük, akkor a nyomtatás elkészíti a listát pdf formátumban, amelyet lementhetünk tetszőleges helyre.
Ha a főképernyőn leszűrt rekordokat át szeretnénk adni más rendszereknek, akkor kattintsunk az
- „Exportálás” gombra és az alábbi felugró ablak segíti a munkánkat:

Itt bejelölhetjük azokat a mezőket, amelyeket át szeretnénk adni, megadhatjuk a mező szélességét és meghatározhatjuk az eredmény tájolását (álló, vagy fekvő).
Megadhatjuk az exportálás típusát:

Ha ezeket beállítottuk, akkor az „Exportálás” gombbal elindíthatjuk a tényleges átadást.
Nyomtatásnál és exportálásnál a
minden mezőt kijelöl, míg a
minden mező kijelölését törli.
## Felhasználók
A felhasználók programrész arra szolgál, hogy megadhassuk a programnak a programot használni akaró munkatársainkat. Az itt megadott információk alapján ellenőrzi le a program bejelentkezéskor, hogy használhatjuk-e a programot.
A felhasználók fő képernyőjét a következő ábra szemlélteti:

Ez a törzs kezelés szempontjából **Alaptörzs**, ezért csak a fontosabb mezőket nézzük meg közelebbről.

A felhasználó és a jelszó közösen határozza meg, hogy be tudunk jelentkezni a program használatához.
A jelszó mező értéke nem látszik és titkosított formában kerül tárolásra a programon belül.
A jelszó megadásánál figyeljünk a kis és nagybetűk használatára! A következő menüpontban írjuk le a rendszer beállítási lehetőségeit, amely befolyásolja a jelszó használatát, ezáltal a belépési eljárást.
Ha valakit bejelölünk, mint szuper felhasználót, akkor Ő minden menüponthoz és minden lehetőséghez **teljes jogkörrel** hozzáfér, függetlenül a neki adott jogokhoz. Figyeljünk rá, hogy kinek adjuk meg ezt a jogot.
Ha a felhasználók törzsben csak egy felhasználó szerepel, akkor az automatikusan megkapja a szuper felhasználó pipát. Ezt azért tesszük, nehogy előálljon az a nem kívánatos eset, hogy nem megfelelő törlések és beállítások miatt a jogosultság megakadályozza a felhasználó munkáját.
A nyelv-választó adja meg, hogy a belépés után a program milyen nyelven képes megjeleníteni a program feliratait. Az alapnyelv a magyar.
Az „Email cím” mező bármilyen értéket tartalmazhat. Ha a felhasználó email címét adjuk itt meg, akkor a program üzenetküldő szolgáltatása tud kommunikálni az itt megadott email címen keresztül a felhasználóval.
Az „Email küldése üzenet esetén” bekapcsolásával azt kérhetjük a rendszertől, hogy ha belső üzenetünk érkezik az üzenetküldő rendszeren keresztül, akkor az üzenet érkezéséről küldjön automatikus figyelmeztetést az „Email cím”-ben megadott címre.
A „Bejelentkezés típusa” mező egyelőre nem választható, ez a későbbi fejlesztések miatt került be.
A „Látható menü” mező bekapcsolásával látható a bal oldali menüsáv, míg kikapcsolva a menü eltűnik, és nagyobb felület marad a feladatok elvégzéséhez. Ugyanez a hatás elérhető, ha a menüt és a felhasználói felületet elválasztó vastag elválasztó vonal fölé visszük az egér kurzorját, amíg nem kapunk kurzor jelként egy négyágú nyilat. Ekkor a bal egérgombot duplán kattintva eltüntethetjük, majd visszavehetjük a menüt. A menü kikapcsolását és bekapcsolását a jobb felső menüsoron szereplő
- „Látható menü” gomb megnyomásával is elérhetjük.
Ha az "Aktív" mező nincs bejelölve (inaktív), akkor a bejelentkezés ezzel a felhasználónévvel nem lehetséges. A mezőt kézzel tehetjük inaktívvá, vagy bizonyos bejelentkezési probléma esetén a program teszi meg ezt automatikusan.
## Bejelentkezési szabály
Ez a törzs arra szolgál, hogy a felhasználók bejelentkezésével kapcsolatos biztonsági elvárások beállíthatók legyenek.

Törzs kezelés szempontjából **Alaptörzs**.

A bejelentkezés típusa határozza meg, hogy milyen karaktereket használhatunk a jelszó megadásához.
• Normál
• Kis-nagybetű-szám kombináció
• Kis-nagybetű-szám kombináció speciális karakter
A jelszó minimális hosszánál megadhatjuk a jelszó minimálisan elvárt hosszát.
A jelszó lejárata napokban: Az első bejelentkezés után hány napig használhatjuk a jelszót változtatás nélkül.
Jelszó ismétlődésének a száma: Itt adhatjuk meg egy már használt jelszó hányadik jelszó váltás után használható újra.
Felhasználó inaktívvá tételének napja: A program bejelentkezéskor megnézi, hogy mikor jelentkeztünk be utoljára és ha az itt megadott érték eltelt az utolsó bejelentkezés óta, akkor a felhasználó automatikusan inaktívvá válik. Ennek az a haszna, hogy a céget elhagyó felhasználó egy idő múlva rendszergazdai beavatkozás nélkül se tudjon bejelentkezni.
## Jelszó csere
A felhasználó a programba való sikeres belépés után megváltoztathatja a belépési jelszavát.
Az aktuális jelszó cseréjét a jobb felső menüsoron szereplő
- „Jelszó csere” gomb megnyomásával aktivizálhatjuk.

Az új jelszó mezőbe adjuk meg a bejelentkezési szabálynak megfelelő értéket és a
- „Mentés” gombbal tudjuk elmenteni. Ez a mentési eljárás ellenőrzi, hogy a megadott új jelszó megfelelő-e. Ha igen, akkor elmenti. Cégcsoportos működés esetén a jelszó cseréje a cégcsoportba tartozó összes adatbázison megtörténik.
A
- gombbal tudunk a bejelentkezési szabálynak megfelelő új (véletlenszerű) jelszót létrehozni.
## Jogosultságok és szerepkörök
Itt nem csak egy törzsadat kezeléséről lesz szó, hanem a program a belépést követő alapvető védelmi
mechanizmusát nézzük át. Az egész védelmi rendszer alappillére a szerepkörök törzs és most mi is
innen kezdjük a rendszer ismertetését.
Törzs kezelés szempontjából **Alaptörzs**, csak a törzs kezelése közben megnyílik néhány altörzs, amelyek szintén **Alaptörzs** típusúak.
