Руководство пользователя

Б.1 Введение

Для запуска серверной части необходимо иметь установленный вебсервер с поддержкой технологии CGI и запущенный MySQL server. Также необходимо иметь сетевой доступ к клиентским машинам.

Для использования приложения необходимо открыть браузер, в строке адреса прописать адрес машины с работающим сервером и нажать Enter. После запуска появляется страница авторизации, часть которой представленно на рисунке Б.1.

Рисунок Б.1 - Страница авторизации

Б.2 Необходимые условия применения

– IBM PC - совместимый компьютер с тактовой частотой процессора не ниже 500 МГц;

– манипулятор типа «мышь».

ЭВМ сервера:

– веб-сервер с поддержкой CGI(версии стандарта 1.1 или выше) ;

– СУБД MySQL версии 5.0 или выше;

– OS Windows.

ЭВМ клиента:

– веб-браузер;

– OS Windows, Unix.

Б.3 Описание основных функций системы

Б.3.1 Авторизация

Для работы с приложением необходима авторизация. Форма авторизации является первой формой которое открывается после запуска приложения. Для прохождения данной операции необходимо заполнить поля "Имя пользователя", "Пароль" и нажать кнопку "Войти"

Рисунок Б.2 - Форма авторизации

Если пользователь не зарегистрирован или пароль неверен система выдаст предупреждение (Рисунок Б.3)

Рисунок Б.3 - Ошибка входа

Б.3.2 Просмотр отчетов

После удачной авторизации система откроет форму просмотра отчетов(рисунок Б.4).

Кнопка "Выход" на данной форме необходима для выхода из сеанса текущего пользователя. После выхода система перейдет в свое первоначальное состояние и отобразит окно авторизации.

Рисунок Б.4 - Часть формы просмотра отчетов.

Чтобы просмотреть отчет об успеваемости, необходимо выбрать желаемый период обучения, которому соответствует год и полугодие(рисунок Б.5). После этого произойдет заполнение списка групп актуальными данными для выбранного семестра.

Рисунок Б.5 - Выбор периода обучения

Б.3.2.1 Просмотр отчетов для группы

Если необходим отчет для группы пользователь должен выбрать группа из приведенного списка(рисунок Б.6).

Рисунок Б.5 - Выбор периода обучения

Для формирования отчета необходимо нажать кнопку "Отчет для группы".

После этого система выдаст на экран сформированный график успеваемости(рисунок Б.6).

Рисунок Б.6 - Выбор периода обучения

На данном графике отображены успеваемости студентов в виде комплексного рейтинга полученная с базы данных факультета. По оси абсцисс приведены номер недель с момента начала семестра. По оси ординат отображается комплексный рейтинг студентов.

Для детализации, каждый график может быть выбран в любой точки и будет отображено его точное значение (рисунок Б.7).

Рисунок Б.7 - Выбор периода обучения

Б.3.2.1 Просмотр отчетов для студента

Для просмотра отчета для студента, необходимо выбрать из выпадающего списка интересующего студента(рисунок Б.8).

После чего нажать кнопку "Отчет для студента".

Система выдаст график успеваемости студента по неделям обучения, начиная с начала семестра. На полученном графике успеваемости можно просмотреть реальные данные комплексного рейтинга студента, за имеющиеся периоды обучения. Так же как и остальные графические отчеты, для детализации можно просмотреть конкретное значения, при указании желаемой точки на графике.

Рисунок Б.8 - Выбор студента для формирования отчета

ПРИЛОЖЕНИЕ В

Листинг основного программного модуля

Листинг программного модуля "project.cpp"

#include <vcl.h>

#include <windows.h>

#include <Winsock2.h>

#include <stdio.h>

#include <io.h>

#include <iostreams>

#include <ComObj.hpp>

#include <sqlext.h>

#include <sql.h>

#include <odbcinst.h>

#include <regex>

#include <direct.h>

#pragma hdrstop

#include <tchar.h>

//--------------------------------------------------------------------

SQLHENV henv =SQL_NULL_HENV;

SQLHDBC hdbc = SQL_NULL_HDBC;

SQLHSTMT hstmt=SQL_NULL_HSTMT, hstmt2=SQL_NULL_HSTMT;

struct UserType

{

int id;

SQLCHAR* name;

SQLCHAR* type;

SQLCHAR* pass;

SQLCHAR* ip;

};

struct RatingType

{

int week;

float value;

int userId;

SQLCHAR* userName;

};

struct StudentType

{

int id;

SQLCHAR* name;

};

struct GroupType

{

int id;

SQLCHAR* name;

};

struct TrackType

{

int id;

int year;

int half_year;

};

UserType DaoPutUser(const char * name,const char * pass,const char * type,long studId);

UserType DaoGetUser(const char * name,const char * pass);

int DaoGetGroupList(GroupType ** groupArr);

long DaoGetGroupIdByName(const char * name);

long DaoPutGroup(const char * name);

long DaoGetStudentId(const char * name,long groupId);

long DaoPutStudent(const char * name,long groupId);

int DaoCloseBase();

int DaoOpenBase();

long GetCount(char* query);

long GetCount(char* query)

{

long Count=0,realsize=0;

SQLCloseCursor(hstmt2);

int err=SQLExecDirect(hstmt2,(SQLCHAR*)query,SQL_NTS);

if (err==SQL_ERROR) return -1;

if (SQLFetch(hstmt2)!=SQL_NO_DATA) SQLGetData(hstmt2,1,SQL_INTEGER,&Count, 0,&realsize);

return Count;

}

int DaoGetTrackList(TrackType ** trackArr)

{

char query[2000];

long realsize=0;

long count;

long i;

count=GetCount("SELECT Count(*) FROM Track");

TrackType* g=new TrackType[count];

*trackArr=g;

SQLCloseCursor(hstmt);

sprintf(query,"SELECT id,year,half_year FROM Track");

if(SQLExecDirect(hstmt,(SQLCHAR*)query,SQL_NTS)==SQL_ERROR)

return -1;

i=0;

while(SQLFetch(hstmt)==SQL_SUCCESS)

{

SQLGetData(hstmt,1,SQL_INTEGER,&g[i].id, 0,&realsize);

SQLGetData(hstmt,2,SQL_INTEGER,&g[i].year, 0,&realsize);

SQLGetData(hstmt,3,SQL_INTEGER,&g[i].half_year, 0,&realsize);

i++;

}

return count;

}

/*int DaoGetRatingGroupList(RatingType ** trackArr,long groupId,long trackId)

{

char query[2000];

long realsize=0;

long count;

long i;

sprintf(query,"SELECT Count(*) FROM Rating WHERE id_student=%i AND id_track=%i",studId,trackId);

count=GetCount(query);

RatingType* g=new RatingType[count];

*trackArr=g;

SQLCloseCursor(hstmt);

sprintf(query,"SELECT week,value FROM Rating WHERE id_student=%i AND id_track=%i",studId,trackId);

if(SQLExecDirect(hstmt,(SQLCHAR*)query,SQL_NTS)==SQL_ERROR)

return -1;

i=0;

while(SQLFetch(hstmt)==SQL_SUCCESS)

{

SQLGetData(hstmt,1,SQL_INTEGER,&g[i].week, 0,&realsize);

SQLGetData(hstmt,2,SQL_REAL,&g[i].value, 0,&realsize);

i++;

}

return count;

} */

int DaoGetStudentList(StudentType ** studArr,long groupId)

{

char query[2000];

long realsize=0;

long count;

long i;

sprintf(query,"SELECT Count(*) FROM Students WHERE id_group=%i",groupId);

count=GetCount(query);

StudentType* g=new StudentType[count];

*studArr=g;

SQLCloseCursor(hstmt);

sprintf(query,"SELECT id,fio FROM Students WHERE id_group=%i",groupId);

if(SQLExecDirect(hstmt,(SQLCHAR*)query,SQL_NTS)==SQL_ERROR)

return -1;

i=0;

while(SQLFetch(hstmt)==SQL_SUCCESS)

{

g[i].name=new char[2000];

SQLGetData(hstmt,1,SQL_INTEGER,&g[i].id, 0,&realsize);

SQLGetData(hstmt,2,SQL_CHAR,g[i].name, 2000,&realsize);

i++;

}

return count;

}

UserType DaoGetUser(const char * name,const char * pass)

{

char query[2000];

long realsize=0;

UserType u;

u.id=-1;

SQLCloseCursor(hstmt);

sprintf(query,"SELECT id,userName,password,[type],sessionIp FROM users WHERE userName='%s' AND password='%s'",name,pass);

if(SQLExecDirect(hstmt,(SQLCHAR*)query,SQL_NTS)==SQL_ERROR)

return u;

if(SQLFetch(hstmt)==SQL_SUCCESS)

{

u.type=new char[2000];

u.ip=new char[2000];

u.name=new char[2000];

u.pass=new char[2000];

SQLGetData(hstmt,1,SQL_INTEGER,&u.id, 0,&realsize);

SQLGetData(hstmt,2,SQL_CHAR,u.name, 2000,&realsize);

SQLGetData(hstmt,3,SQL_CHAR,u.pass, 2000,&realsize);

SQLGetData(hstmt,4,SQL_CHAR,u.type, 2000,&realsize);

SQLGetData(hstmt,5,SQL_CHAR,u.ip, 2000,&realsize);

}

return u;

}

long DaoPutGroup(const char * name)

{

char query[2000];

long realsize=0;

long id;

id=DaoGetGroupIdByName(name);

if(id>0) return id;

SQLCloseCursor(hstmt);

sprintf(query,"INSERT INTO [Groups](name) VALUES ('%s')",name);

if(SQLExecDirect(hstmt,(SQLCHAR*)query,SQL_NTS)==SQL_ERROR)

return -1;

return DaoGetGroupIdByName(name);

}

bool DaoGetRating(long studId,long track_id,int week,double * value)

{

char query[2000];

long realsize=0;

SQLCloseCursor(hstmt);

sprintf(query,"SELECT [value] FROM Rating WHERE id_student=%i AND id_track=%i AND week=%i",studId,track_id,week);

if(SQLExecDirect(hstmt,(SQLCHAR*)query,SQL_NTS)==SQL_ERROR) return false;

if(SQLFetch(hstmt)==SQL_SUCCESS)

{

SQLGetData(hstmt,1,SQL_FLOAT,value, 0,&realsize);

return true;

}

return false;

}

bool DaoPutRating(long studId,long track_id,int week, double value)

{

char query[2000];

long realsize=0;

bool result;

result=DaoGetRating(studId,track_id,week,&value);

if(!result)

{

sprintf(query,"INSERT INTO Rating(id_student,id_track,week,[value]) VALUES (%i,%i,%i,%f)",studId,track_id,week,value);

}

else

{

sprintf(query,"UPDATE Rating SET [value]=%f WHERE id_student=%i AND id_track=%i AND week=%i",studId,track_id,week);

}

SQLCloseCursor(hstmt);

if(SQLExecDirect(hstmt,(SQLCHAR*)query,SQL_NTS)==SQL_ERROR)

return false;

return true;

}

long DaoGetTrack(int year,int half_year)

{

char query[2000];

long realsize=0;

long id=-1;

SQLCloseCursor(hstmt);

sprintf(query,"SELECT id FROM Track WHERE year=%i AND half_year=%i",year,half_year);

if(SQLExecDirect(hstmt,(SQLCHAR*)query,SQL_NTS)==SQL_ERROR)

return -1;

if(SQLFetch(hstmt)==SQL_SUCCESS)

{

SQLGetData(hstmt,1,SQL_INTEGER,&id, 0,&realsize);

}

return id;

}

long DaoPutTrack(int year,int half_year)

{

char query[2000];

long realsize=0;

long id=-1;

id=DaoGetTrack(year,half_year);

if(id>0)

return id;

SQLCloseCursor(hstmt);

sprintf(query,"INSERT INTO Track(year,half_year) VALUES (%i,%i)",year,half_year);

if(SQLExecDirect(hstmt,(SQLCHAR*)query,SQL_NTS)==SQL_ERROR)

return -1;

return DaoGetTrack(year,half_year);

}

int DaoCloseBase()

{

SQLCloseCursor( hstmt );

SQLCloseCursor( hstmt2 );

SQLFreeHandle(SQL_HANDLE_STMT,hstmt);

SQLFreeHandle(SQL_HANDLE_STMT,hstmt2);

SQLDisconnect(hdbc);

SQLFreeHandle(SQL_HANDLE_DBC,hdbc);

SQLFreeHandle(SQL_HANDLE_ENV,henv);

return 0;

}

int DaoOpenBase()

{

if (SQLAllocHandle(SQL_HANDLE_ENV, NULL, &henv) == SQL_ERROR) return -1;

SQLSetEnvAttr(henv, SQL_ATTR_ODBC_VERSION,(void*) SQL_OV_ODBC3, SQL_IS_INTEGER);

if (SQLAllocHandle(SQL_HANDLE_DBC, henv, &hdbc) == SQL_ERROR) return -1;

if (SQLConnect(hdbc, (SQLCHAR*)"db1", SQL_NTS,(SQLCHAR*)"",SQL_NTS,(SQLCHAR*)"",SQL_NTS)==SQL_ERROR)

{

SQLCHAR sqlstate[32];

SQLCHAR message[256];

SQLINTEGER nativeerror=0;

SQLSMALLINT textlen=0;

SQLRETURN r=SQLGetDiagRec(SQL_HANDLE_DBC,hdbc,1,sqlstate, &nativeerror,message,256,&textlen);

printf("%s=%s\n", (SQLCHAR*)sqlstate, (SQLCHAR*)message);

return -1;

}

if (SQLAllocHandle(SQL_HANDLE_STMT, hdbc, &hstmt) == SQL_ERROR) return -1;

if (SQLAllocHandle(SQL_HANDLE_STMT, hdbc, &hstmt2) == SQL_ERROR) return -1;

return 0;

}

#include "NetUtils.cpp"

#include "Parser.cpp"

char *userIp;

UserType curUser;

const char rusChar[]={"АБВГДЕЁЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯабвгдеёжзийклмнопрстуфхцчшщъыьэюя "};

const char uriChar[]={"C0C1C2C3C4C5A8C6C7C8C9CACBCCCDCECFD0D1D2D3D4D5D6D7D8D9DADBDCDDDEDFE0E1E2E3E4E5B8E6E7E8E9EAEBECEDEEEFF0F1F2F3F4F5F6F7F8F9FAFBFCFDFEFF20"};

char** ParList=new char*[16536];

unsigned int ParCount=0;

int ShowData()

{

}

int SyncData()

{

printf("1! SyncData<br/>");

int fileArrCount=1;

fileExcelStruct fileArr[1];

getFileList(fileArr);

for(int i=0;i<fileArrCount;i++)

{

char query[2048];

memset((char *)&query, 0, sizeof(query));

sprintf(query,"GET %s HTTP/1.1\r\nHost:sciyouth.ru\r\nAccept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8\r\n\r\n",fileArr[i].fileUrl);

char filePath[2000];

LoadFile("85.113.47.54",query,filePath);

if(filePath==NULL)

{

continue;

}

ImportFile(fileArr[i],filePath);

}

printf("Sync complete<br/>");

return 1;

}

int getRatingList()

{

long studId=atoi(ParList[1]);

int trackId=atoi(ParList[2]);

if(studId<=0 || trackId<=0)

{

printf("-1!getRatingList");

return -1;

}

RatingType * ratingArr=NULL;

int count=DaoGetRatingList(&ratingArr,studId,trackId);

printf("1!");

for(int i=0;i<count-1;i++)

{

printf("%i;%f\r",ratingArr[i].week,ratingArr[i].value);

}

printf("%i;%f\r",ratingArr[count-1].week,ratingArr[count-1].value);

return 1;

}

int getRatingGroupList()

{

/* long groupId=atoi(ParList[1]);

int trackId=atoi(ParList[2]);

if(groupId<=0 || trackId<=0)

{

printf("-1!getRatingGroupList");

return -1;

}

RatingType * ratingArr=NULL;

int count=DaoGetRatingGroupList(&ratingArr,groupId,week);

printf("1!");

for(int i=0;i<count-1;i++)

{

printf("%i;%f\r",ratingArr[i].week,ratingArr[i].value);

}

printf("%i;%f\r",ratingArr[count-1].week,ratingArr[count-1].value);

return 1; */

}

int getStudentList()

{

long groupId=atoi(ParList[1]);

if(groupId<=0)

{

printf("-1!getStudList");

return -1;

}

StudentType * studArr=NULL;

int count=DaoGetStudentList(&studArr,groupId);

printf("1!");

for(int i=0;i<count-1;i++)

{

printf("%i;%s\r",studArr[i].id,studArr[i].name);

}

printf("%i;%s",studArr[count-1].id,studArr[count-1].name);

return 1;

}

int getGroupList()

{

GroupType * groupArr=NULL;

int count=DaoGetGroupList(&groupArr);

printf("1!");

for(int i=0;i<count-1;i++)

{

printf("%i;%s\r",groupArr[i].id,groupArr[i].name);

}

printf("%i;%s",groupArr[count-1].id,groupArr[count-1].name);

return 1;

}

int getTrackList()

{

TrackType * trackArr=NULL;

int count=DaoGetTrackList(&trackArr);

printf("1!");

for(int i=0;i<count-1;i++)

{

printf("%i;%i;%i\r",trackArr[i].id,trackArr[i].year,trackArr[i].half_year);

}

printf("%i;%i;%i\r",trackArr[count-1].id,trackArr[count-1].year,trackArr[count-1].half_year);

return 1;

}

int CheckFunc()

{

char * lastChar=ParList[0]+strlen(ParList[0])-1;

if(*lastChar=='=') *lastChar=0;

if (strcmp(ParList[0],"ShowData")==0) return ShowData();

else if (strcmp(ParList[0],"Main")==0) return Main();

else if (strcmp(ParList[0],"SyncData")==0) return SyncData();

else if (strcmp(ParList[0],"Login")==0) return Login();

else if (strcmp(ParList[0],"Reg")==0) return Reg();

else if (strcmp(ParList[0],"Exit")==0) return Exit();

else if (strcmp(ParList[0],"checkSession")==0) return checkSession();

else if (strcmp(ParList[0],"getGroupList")==0) return getGroupList();

else if (strcmp(ParList[0],"getTrackList")==0) return getTrackList();

else if (strcmp(ParList[0],"getStudentList")==0) return getStudentList();

else if (strcmp(ParList[0],"getRatingList")==0) return getRatingList();

else if (strcmp(ParList[0],"getRatingGroupList")==0) return getRatingGroupList();

else printf("-1! Неизвестная функция");

return 0;

}

#pragma argsused

int _tmain(int argc, _TCHAR* argv[])

{

char *ReqM=getenv("REQUEST_METHOD");

char * buf;

unsigned int len;

#ifndef Loc

if(ReqM==NULL) return 0;

if(strcmp(ReqM,"POST")==0)

{

len=atoi(getenv("CONTENT_LENGTH"));

if (len<=0) return 0;

buf=new char[len+1];

if (fread(buf,len,1,stdin)!=1) return 0;

buf[len+1]=0;

} else

if(strcmp(ReqM,"GET")==0)

{

char *temp=getenv("QUERY_STRING");

len=strlen(temp);

buf=new char[len+1];

for (int i=0;i<len;i++) *(buf+i)=*(temp+i);

} /**/

#else

buf=TEMPBUF;

len=strlen(buf); /**/

#endif

unsigned int i=0,st=0,j=0,ii=0; //convert to rus char

char *buf2=new char[len];

for (i=0;i<len;i++)

{

if (*(buf+i)=='%')

for(ii=0;ii<strlen(uriChar);ii=ii+2) if ((*(buf+i+1)==*(uriChar+ii))&&(*(buf+i+2)==*(uriChar+ii+1)))

{

i=i+2;

*(buf+i)=rusChar[ii/2];

break;

}

*(buf2+j)=*(buf+i);

j++;

}

ParCount=0; //parse

i=0;

while(i<len)

{

st=i;

while ((buf2[i]!='&')&&(i<len)) i++;

buf2[i]=0;

if (st==i) continue;

ParList[ParCount]=new char[i-st+3+2]; //"+3" compiler's error; +2 for ''

strcpy(ParList[ParCount],buf2+st);

i++;

ParCount++;

}

#ifdef Loc

userIp="127.0.0.1";

#else

userIp=getenv("REMOTE_ADDR");

#endif

setmode(fileno(stdout),0x8000); //#define O_BINARY 0x8000

printf("Content-Type: text/html; charset=windows-1251\n\n");

int err=DaoOpenBase();

CheckFunc();

DaoCloseBase();

delete[]ParList;

return 0;

}

Размещено на Allbest.ru