Algoritmus terv. 1. Algoritmus általános áttekintése. 2. Inputok és outputok definiálása. 3. Folyamatok meghatározása. 4. Programozási utasítások

Átírás

1 Ez a kép most nem jeleníthető meg. Algoritmus terv 1. Algoritmus általános áttekintése 2. Inputok és outputok definiálása 3. Folyamatok meghatározása 4. Programozási utasítások Készült az Agora Alapítvány és az IT Carei Egyesület részére TeTT Consult

2 Az algoritmus terv az The Creation of the Elastic Survey Editor c. projekt keretében készült. Az algoritmus terv első három fejezet a Vezető Patner, az utolsó fejezet a Projekt Partner megbízásából készült. Az Elastic Survey projekt a Magyarország-Románia Határon Átnyúló Együttműködési Program keretében valósul meg ( az Európai Unió támogatásával, az Európai Regionális Fejlesztési Alap valamint a Magyar Köztársaság és Románia társfinanszírozásával. A program célja közelebb hozni egymáshoz a határmenti térségben élő embereket, közösségeket és gazdasági szereplőket az együttműködésbe bevont térség közös fejlesztésének elősegítése érdekében, a határmenti térség alapvető erősségeire építve. Vezető Partner: Agora Alapítvány a Társadalomkutatásért Projekt Partner: Asociația IT Carei (Asociația Infotour Carei) Projekt teljes költségvetése: Euro ERFA támogatás: ,60 Euro A jelen tanulmány nem feltétlenül tükrözi az Európai Unió hivatalos álláspontját. 2

3 Tartalomjegyzék IV. Programozási utasítások Értelmezési irányvonal A weblap alapértelmezett oldala (Html-ben) Az adatbázis szerkezete Az Elastic Survey alkalmazás funkciói A felhasználói felület és a backend közötti kommunikáció A regisztrációs folyamat A kérdőívkésztés folyamata A Html szegmens generálási folyamata A kérdőívkitöltési eljárás

4 IV. Programozási utasítások 1. Értelmezési irányvonal Ezt a pszeudo kódban létrehozott algoritmus tervet az Elastic Survey alkalmazás az Elastic Survey: The Creation of the Elastic Survey editor című projekt keretén belül leírt működése alapján került kidolgozásra. Ez az algoritmus terv az Elastic Survey algoritmus két leírási stílusát tartalmazza. Vannak olyan pszeudo kód elemek, amelyek bármilyen modern programozási nyelvre átírhatóak, továbbá létezik még a bizonyos funkciók lerását, illetve bizonyos pszeudo kód szegmensek pontosítására szolgáló román nyelven írt kapcsolódó megjegyzés. Ezek a pontosítások két dőlt vonallal // vannak jelölve, ami azt jelenti, hogy ezen szegmensek nem részei a pszeudo kódnak, így a statisztika összeállítók ezeket nem veszik majd figyelembe. Mivel ez egy weboldal mögött futó alkalmazás, a Html része is le van írva, viszont ez már csak egy egyszerű útmutató, mely kontextust teremt az alkalmazás köré, az interfészhez és a grafikai tervezéshez kapcsolódó egyértelmű részek pedig nincsenek leírva. Az algoritmus terv pszeudo kódban írja le az Elastic Survey alkalmazás back-end (programozási rész) részében végbemenő folyamatokat. 19

5 2. A weblap alapértelmezett oldala (Html-ben) <!DOCTYPE html> <html xmlns=" <head> <meta content="text/html; charset=utf-8" http-equiv="content- Type" /> <title>elastic Survey</title> <link href="css/style.css" rel="stylesheet" type="text/css" /> </head> <body> <div id="wrap"> <img src="img/header.jpg" /> <nav id="mainmenu"> <ul> <li><a class="thislink" href="default.html">kezdőlap</a> </li><li><a href="chestflex.html">rugalmas kérdőív</a> </li><li><a href="bemutatas.html">bemutatás</a> </li><li><a href="ujkerdoiv.html">új kérdőív</a> </li><li><a href="kerdoivek.html">kérdőveim</a> </li><li><a href="kapcsolat.html">kapcsolat</a> </ul> <a class="langlink" href="default.html">ro</a> <a class="langlink" href="hu/default.html">hu</a> </nav> <div class="content"> // Ide jön a tartalom </div> </div> </body> </html> 20

6 Ez az Elastic Survey alkalmazás honlapja szerkezeti leírása Html-ben, mely egy, a tervezők igényei alapján módosítható és bővíthető alapszerkezet. Az oldal minimális stilizálásának leírása a következő CSS (cascading style sheet) szegmensben található. * { margin:0; padding:0; body { background-color:#756f39;.langlink{ font-family:"trebuchet MS", "Lucida Sans Unicode", "Lucida Grande", "Lucida Sans", Arial, sans-serif; text-decoration:none; font-weight:bold; color:#ffffff; padding:3px 10px; background-color:#ff9933; -moz-border-radius: 5px; -webkit-border-radius: 5px; border-radius: 5px; float:right; margin:6px 6px 0px 0px;.langlink:hover{ background-color:#993300; color:#ffffff; 21

7 #wrap { margin:15px auto; background-color:white; width:790px; -moz-box-shadow: 0 0 2px 2px #000; -webkit-box-shadow: 0 0 2px 2px #000; box-shadow: 0 0 2px 2px #000; #mainmenu { background-color:aqua; border-bottom-color:black; border-bottom-style:solid; border-bottom-width:1px; #mainmenu ul{ list-style-type: none; display:inline-block; #mainmenu ul li{ display:inline-block; margin:0; padding:0; #mainmenu ul li a{ text-decoration:none; color:#808080; font-family:"trebuchet MS", "Lucida Sans Unicode", "Lucida Grande", "Lucida Sans", Arial, sans-serif; font-size:large; display:block; 22

8 padding:8px; #mainmenu ul li a:hover{ background-color:#0066cc; color:#ccffff; #mainmenu.thislink { background-color:blue; color:#ccffff 23

9 3. Az adatbázis szerkezete Az Elastic Survey alkalmazás egy szilárd és világos szerkezetű adatbázison alapszik. Az Elastic Survey program valamennyi adatot ebbe az adatbázisba menti el (a felhasználókkal, kérdőívekkel és a válaszokkal kapcsolatos adatok). Az adatbázis kialakításának legfőbb célja az, hogy a lehető legkevesebbet használjon el azon szerver erőforrásaiból, amelyen az alkalmazás fut, azaz hogy a merevlemezen és a RAM-ban minimális helyet foglaljon. Egy másik alapvető célkítűzés az, hogy az adatbázis felépítése lehetővé tegye az alkalmazás egyazon időben több száz felhasználó által történő hibamentes, adatvesztés, illetve adatfelülírás nélküli használatát. Ami a felhasználókat illeti, fontos az, hogy a kérdőívekre adott válaszokkal kapcsolatos adatok úgy legyenek csoportosítva, hogy azok fájlokba való exportálása Excelben vagy SPSS-ben történő feldolgozás érdekében könnyen és egyszerűen menjen. Az algoritmustervben az adatbázis neve esdb, és kétféle táblázatból tevődik össze: esdb.felhasználók, egy a honlapon regisztrált felhasználók adatait, valamint az általuk készített valamennyi kérdőív linkjeit tartalmazó táblázat; és az esdb.kérdőív, mely egy, a kérdőívek kérdéseit és azok válaszlehetőségeit, valamint a válaszolók által az illető kérdőívre adott válaszokat is tartalmazza. Az esdb.felhasználók táblázattípus egyetlen részből tevődik össze, míg az esdb.kérdőív táblázat külön felületet hoz létre minden egyes, az Elastic Survey alkalmazással készített kérdőív esetén. A táblázatok meghatározása az adatbázisban: esdb.felhasználók //a táblázat oszlopai string Usarname //felhasználónév string Password //a felhasználó jelszava string Mail int Kerdsz. //kérdőívek száma (kezdetben 0) record[] Kérdőívek string KerdNev //kérdőív címe table KerdPoint //pointer a kérdőív táblázatához end //a kérdőív adatait tartalmazza egy sor nyilvántartásban Az esdb.felhasznalok valamennyi sora egyetlen felhasználó adatait tartalmazza. esdb.kerdoiv //a tablazat oszlopai 24

10 string valaszok Az esdb.kerdoiv egyetlen oszlopból áll. Ezen oszlop első sora egy string típusú változó, mely több sorból tevődik össze. A string első sora a kérdőív kérdése (a nap kérdése). A string következő sorai a lehetséges válaszok. A táblázat többi sora pedig a válaszadók a nap kérdésére adott válaszait tartalmazzák. 25

11 4. Az Elastic Survey alkalmazás funkciói A felhasználói felület és a backend közötti kommunikáció Az egyszerűség kedvéért ebben az algoritmus tervben az Elastic Survey webhely és a szerveren futó program közötti kommunikáció két objektumon keresztül megy végbe: az infobagin-en és az infobagout-on. Az infobagin-t program funkciói paraméterként értelmezik, mely tartalmazni fogja a felhasználó által megadott adatokat (például a nap kérdése, illetve az ezzel kapcsolatos lehetséges válaszok). Az infobagout pedig a felhasználó kérésének az eredményét képezi, olyan információkat tartalmaz, melyek a műveletet követően jelenítődnek meg (például az exportált file linkje). Az infobagout-ból származó adatok Html-ben a CSS content osztály <div>-jébe kerülnek elhelyezésre. A regisztrációs folyamat Az infobagin objektum meghatározása infobagin string Username string Password string Mail Regisztrációs funkció Azt követően, hogy a felhasználó megadta regisztrációs adatait a webhelyen, illetve megnyomta a Küldés opciót, a webhely elküldi a programnak az infobagin objektumot. function NewUser (infobagin) if (infobagin.username.length!= 0) & (infobagin.password.length >= 8) & (infobagin.mail.length!= 0) { Felhasznalo newreg = new Felhasznalo newreg.username = infobagin.username newreg.password = infobagin.password 26

12 newreg.mail = infobagin.mail newreg.nrchest = 0 esdb.felhasznalok.insert(newreg) infobagout.message = Ön sikeresen regisztrált. Üdvözöljük! infobagout.url = default.html else { infobagout.message = Kérjük, adatait a meghatározott formátumban adja meg! return infobagout end A kérdőívkésztés folyamata Az infobagin objektum meghatározása infobagin string KerdNev string Kerdes string Valaszok felhasznalo User Kérdőívszerkesztési funkció Azt követően, hogy a felhasználó megnyomja a nap kérdése típusú új kérdőív készítésére vonatkozó gombot, megjelenik a kérdőívszerkesztő oldal, ahol a felhasználó maga határozza meg a kérdést, illetve a kapcsolódó válaszlehetőségeket. A Küldés parancs megnyomásával a webhely elküldi a programnak az infobagin objektumot. function createkerd (infobagin) if (infobagin.kerdnev.length = 0) 27

13 infobagout.message = Kérjük, adjon nevet a kérdőívnek! elseif (infobagin.kerdes.length = 0) infobagout.message = Kérjük, adjon meg egy kérdést! elseif (infobagin.valaszok.lines <=2) infobagout.message = Adjon meg legalább 2 lehetséges választ. else { table ujkerd = new table string valaszok end infobagin.user.kerdsz. += 1 infobagin.user.kerdpoint[infobagin.user.kerdsz.] = ujkerd infobagin.user.kerdpoint[infobagin.user.kerdsz.] = infobagin.kerdnev ujkerd firstline = new ujkerd firstline.valaszok = infobagin.kerdes + \n foreach (string line in infobagin.valaszok) firstline.valaszok += line + \n end ujkerd.insert(firstline) esdb.insert(ujkerd) infobagout.message = A kérdőív ezennel elkészült! infobagout.url = default.html Return infobagout end A Html szegmens generálási folyamata Az infobagin objektum meghatározása 28

14 infobagin felhasznalo User string KerdNev Miután a felhasználó megnyomja a Kérdőíveim gombot, kijelölhet és közzétehet egy kérdőívet (azaz létrehoz egy Html elemet). Amikor pedig elküldi a Közzétesz parancsot, a webhely elküldi a programnak az infobagin objektumot az illető elemmel kapcsolatos adatokkal együtt. Html-elem-generáló funkció function HtmlGenerate (infobagin) string htmlelm table q = from k in infobagin.user.kerdoivek where k.kerdnev = infobagin.kerdnev select k.kerdpoint htmlelm += <div class= question > <p> +q[0].valaszok.line[0]+ </p></div> htmlelm += <form class= inputform > foreach (string line in q[0].valaszok) if (line!= q[0].valaszok.line[0]) htmlelm += < input type="checkbox" name="grp" value="+line+">+line+<br> end htmlelm += </form> infobagout = htmlelm return infobagout end A kérdőívkitöltési eljárás Az infobagin objektum meghatározása infobagin table KerdEz 29

15 bool UjValasz string Val Valamennyi válaszadó nemcsak a kutató (a kérdőív készítője) által meghatározott válaszok közül választhat, hanem lehetősége van egy új választ hozzáadni a válaszlistához. Az infobagin objektum a válaszadó által megadott választ tartalmazza, valamint arról is információt ad, hogy a válaszadó adott-e új választ. A válaszok összegyűjtésére irányuló funkció function fill (infobagin) if!ujvalasz { infobagin.kerdez valasz = new infobagin. KerdEz valasz.valaszok = infobagin.val infobagin.kerdez.insert(valasz) else { infobagin. KerdEz[0].valaszok[0] += \n +infobagin.val infobagin.kerdez valasz = new infobagin.kerdez valasz.valaszok = infobagin.valp infobagin.kerdez.insert(valasz) regeneratehtml() //ez a funkció újraképezi //a Html elemet az új válaszlehetőséggel, amely éppen úgy fog megjelenni //mintha azt a kutató tette volna End 30