subversion://[vpntest]/release/2.2/manual.txt Log in
ViewVC logotype

Annotate of /release/2.2/manual.txt

Parent Directory Parent Directory | Revision Log Revision Log

Revision 16 - (show annotations) (download) (as text)
Sun Feb 17 17:44:13 2008 MSK (12 years, 11 months ago) by vitalif
File MIME type: text/plain; charset=windows-1251
File size: 31786 byte(s)
Release 2.2

1 --------------------------------------------------------------
2 -- ИНСТРУКЦИЯ ПО ЭКСПЛУАТАЦИИ СИСТЕМЫ ТЕСТИРОВАНИЯ СЛУШАТЕЛЕЙ --
3 --------------------------------------------------------------
4 Copyright (c) 2006, Виталий Филиппов [VMX]
5
6 *************************************************
7 *************** 1. Общая информация ***************
8 *************************************************
9
10 Назначение системы: тестирование слушателей и хранение архива их результатов
11 Текущая версия: 2.2
12 Список изменений: см. changelog.txt
13
14 Скачать новую версию системы и руководство по её использованию вы всегда можете с сайта http://vmx.yourcmc.ru.
15
16 ******************************************************
17 *************** 2. Структура руководства ***************
18 ******************************************************
19
20 1. Общая информация
21 2. Структура руководства
22 3. Установка системы
23 3.1. Установка с нуля
24 3.2. Обновление системы
25 3.3. Установка на реальный сервер
26 4. Процесс тестирования
27 5. Сама система
28 6. Файлы, относящиеся к системе
29 7. Способ вывода информации
30 8. Система хранения информации
31 9. Формат файла с вопросами
32 10. Конфигурирование системы
33 10.1. Конфигурационные переменные
34 10.2. Что вы ДОЛЖНЫ поменять после установки
35 11. Администрирование системы
36 11.1. Вывод информации о пользователях.
37 11.2. Просмотр списка вопросов в БД.
38 11.3. Загрузка вопросов из текстового файла.
39 11.4. Инициализация БД.
40 12. Работа с архивом результатов
41 13. Координаты автора
42
43 **************************************************
44 *************** 3. Установка системы ***************
45 **************************************************
46
47 Здесь приведены пошаговые инструкции для установки и обновления системы. Если вашей версии нет в списке инструкций к обновлению - воспользуйтесь ближайшими версиями.
48
49 ***************************************************
50 *************** 3.1. Установка с нуля ***************
51 ***************************************************
52
53 3.1.1. Выделить компьютер администратора, этот компьютер будет выступать сервером для остальных. Выбрать имя для виртуального "сайта" с тестами (по умолчанию "vpntest.ru" - в инструкции по установке везде прописано оно, если хотим другое, везде меняем)
54
55 3.1.2. Поставить на админский комп Денвер (Д.н.w.р) - Джентльменский Набор Web-разработчика.
56 Дистрибутив Денвера, с которым проводилась проверка системы, можно скачать здесь:
57 http://www.denwer.ru/dis/Base/Base_2005-10-07_a1.3.31_p4.4.0_m4.1.8_pma2.6.1.exe.
58 Если на админском компе уже установлены Apache, PHP, и MySQL, то используйте их, но если они у вас установлены не в составе чего-нибудь типа Денвера, то вы, скорее всего, продвинутый пользователь и настроите всё сами.
59 Если чего-то нету (например, установлен только Apache) - то проще всего удалить его и поставить Денвер.
60
61 Иногда бывает, что Денвер по каким-то причинам не в состоянии ни создать ярлыки, ни прописать в автозагрузке монтирование виртуального диска. Если ярлыки не появятся, тогда создать их вручную - на рабочем столе - ярлыки на <ПАПКА_С_ДЕНВЕРОМ>\etc\Run.exe (запуск серверов), <ПАПКА_С_ДЕНВЕРОМ>\etc\Restart.exe (перезапуск серверов) и <ПАПКА_С_ДЕНВЕРОМ>\etc\Stop.exe (остановка серверов). Виртуальный диск создаётся консольной утилитой subst командой вида "subst Z: <ПАПКА_С_ДЕНВЕРОМ>". Чтобы прописать в автозагрузку создание виртуального диска - создайте ярлык, ссылающийся на команду, указанную выше, в папке "Автозагрузка" меню "Пуск".
62
63 3.1.3. Запускаем Денвер. ("Start Servers")
64
65 3.1.4. Чтобы поменять пароль root'а на базу данных:
66 - зайти в броузере на http://localhost/Tools/phpMyAdmin/,
67 - выбрать "Привилегии",
68 - кликнуть по иконке "Редактирование привилегий" справа от строки с пользователем "root",
69 - там установить Пароль и Подтверждение пароля,
70 - выбрать радиокнопку рядом со словом "Пароль",
71 - нажать "Пошёл".
72
73 3.1.5. Останавливаем Денвер. ("Stop Servers")
74
75 3.1.6. Пусть Z:\ - виртуальный диск, созданный Денвером:
76 - из папки Z:\home удаляем всё, что там есть, КРОМЕ:
77 - папку "localhost" можно оставить, но лучше тоже убрать, однако не полностью - просто возьмите и переместите её куда-нибудь себе, иначе потом не сможете пользоваться phpMyAdmin (что, правда, при нормальной работе системы и не требуется)
78
79 3.1.7. Создать в Z:\home папку с именем хоста (vpntest.ru) и распаковать в неё архив с дистрибутивом системы.
80
81 3.1.8. Конфигурируем систему тестирования, изменяя Z:\home\vpntest.ru\WWW\lib\config.php. (см. секцию "10. Конфигурирование")
82
83 3.1.9. Устанавливаем пароль администратора:
84 - набираем в командной строке "Z:\usr\local\apache\bin\htpasswd -с Z:\home\vpntest.ru\passwords ЛОГИН_АДМИНА"
85 - дважды вводим пароль, который станет паролем администратора
86
87 Потом, чтобы всё-таки можно было зайти в папку /admin/:
88 - в файлах "Z:\home\vpntest.ru\WWW\admin\.htaccess" и "Z:\home\vpntest.ru\WWW\lib\.htaccess"
89 меняем строчку "Require user vmx" на "Require user ЛОГИН_АДМИНА",
90 где ЛОГИН_АДМИНА - желаемый логин для администратора.
91 - если меняли vpntest.ru или имя диска, то в этих же файлах .htaccess надо в строчке
92 "AuthUserFile Z:\home\vpntest.ru\passwords" вместо Z:\home\vpntest.ru\passwords
93 прописать полный путь к файлу с паролями (по умолчанию - не надо)
94 - если поддаться соблазну и скопировать строчку из этого файла в командную строку через буфер обмена,
95 то htpasswd работать ОТКАЗЫВАЕТСЯ. Почему - непонятно. В общем, не поддавайтесь соблазну - вводите ручками :)
96
97 3.1.10. Вписать в Z:\usr\local\apache\conf\httpd.conf строчку "Listen *:80" - чтобы можно было заходить в систему тестирования с других компьютеров.
98
99 3.1.11. Если хотим, чтобы другие компы видели систему как домен, именем, то вписываем на всех компах локальной сети, кроме админского (тут Денвер сам разберётся) в файл C:\WINDOWS\SYSTEM32\DRIVERS\ETC\hosts (для Windows 9x C:\WINDOWS\hosts.sam) строчку вида "192.168.0.10 vpntest.ru", где 192.168.0.10 заменить на IP админского компа, а vpntest.ru - на установленное имя виртуального домена.
100
101 3.1.12. Запускаем Денвер. ("Start Servers")
102
103 3.1.13. В браузере зайдите на http://vpntest.ru/admin/:
104 - вводим ЛОГИН_АДМИНА и соответствующий пароль в высвечивающееся окошко аутентификации;
105 - жмём "Инициализировать БД".
106
107 3.1.14. В браузере же зайдите на кликните по ссылке под названием страницы: "к архиву" и произведите его инициализацию кликом по предлагаемой ссылке.
108
109 3.1.15. Загружаем вопросы, выбирая подготовленный заранее текстовый файл и нажимая "Загрузить". (см. секцию "9. Формат файла с вопросами")
110
111 3.1.16. Если в броузере установлена работа через прокси-сервер, то виртуальный "домен" открываться не будет. Прокси надо везде отключить. На всех компьютерах.
112
113 3.1.17. Поздравляю! Система готова к работе.
114
115 *****************************************************
116 *************** 3.2. Обновление системы ***************
117 *****************************************************
118
119 Если обновляем, например, с 1.0 на 2.0, то надо сначала сделать обновление с 1.0 на 1.1, потом с 1.1 на 2.0. То есть, обновления "накапливаются".
120
121 3.2.1. Обновление с 1.0 на 1.1:
122 3.2.1.1. копируем всё из архива vpntest_11.rar, заменяя всё, кроме .htaccess-ов и config.php
123 3.2.1.2. заходим на http://www.vpntest.ru/admin/update.php
124
125 3.2.2. Обновление с 1.1 на 2.x:
126 3.2.2.1. копируем всё из архива vpntest_21.rar, заменяя всё, кроме .htaccess-ов
127 3.2.2.2. config.php берём из архива и конфигурируем заново.
128 3.2.2.3. инициализируем архив: заходим в него - сначала на http://www.vpntest.ru/admin/, там ссылку "к архиву", там выбираем инициализацию.
129
130 3.2.3. Обновление с 2.1x на 2.2:
131 3.2.2.1. копируем всё из архива vpntest_22.rar, заменяя всё, кроме .htaccess-ов
132 3.2.2.2. config.php берём из архива и конфигурируем заново.
133
134 ***************************************************************
135 *************** 3.3. Установка на реальный сервер ***************
136 ***************************************************************
137
138 Систему можно поставить на "реальный" веб-сервер, т.е отдельную машину, имеющую выделенный IP-адрес в интернете, с установленными на ней веб-сервером, сервером MySQL и модулем PHP; или на хостинг - любой, можно платный, можно бесплатный, главное это веб-сервер+PHP+MySQL.
139 Для установки на реальный веб-сервер:
140 3.3.1. Убедитесь, что на этом сервере (или хостинге) есть PHP и MySQL. Если сервер и нету, установите, но в данном случае Денвером, конечно, пользоваться не надо.
141 3.3.2. Вы должны получить в своё использование одну базу данных MySQL: "vpntest", а также имя пользователя MySQL и пароль. Скорее всего, Вам понадобится вручную создать БД, так как привилегий на программный запрос создания базы данных у Вас, скорее всего, не будет.
142 3.3.3. Также узнайте имя хоста, на котором запущен сервер MySQL. Для хостингов эту информацию Вам сообщит хостинг-провайдер, для сервера - администратор.
143 3.3.4. Далее вы должны установить систему в предоставленный вам HTTP каталог сервера. Это НЕ ЗНАЧИТ распаковать туда архив. HTTP каталог - это папка "WWW", в архиве она есть, и вы должны её содержимое залить в HTTP каталог сервера.
144 3.3.5. Теперь отконфигурируйте систему: в config.php вы должны прописать правильные значения переменных $dbhost, $dbuser, $dbpwd, $Domain (см. config.php и комментарии в нём, а также секцию "10. Конфигурирование системы").
145 3.3.6. Установка пароля администратора происходит так же, как и обычно. Утилитой htpasswd создаётся файл паролей, который кладётся желательно в недоступный по HTTP каталог (т.е НЕ в папку WWW), в .htaccess прописывается полный путь к этому файлу.
146 3.3.7. Зайдите на сайт, который вы только что создали, на http://www.site.ru/admin/, введите имя и пароль администратора, "инициализируйте БД", потом зайдите в архив и инициализируйте его.
147
148 *****************************************************
149 *************** 4. Процесс тестирования ***************
150 *****************************************************
151
152 Система предназначена для тестирования слушателей. Тестирование в данном случае означает, что есть набор или несколько наборов вопросов, на каждый из которых есть 4 ответа, из которых можно выбирать правильный. Правильный ответ ТОЛЬКО один. Если слушатель не отвечает на вопрос - это приравнивается к неправильному ответу. Каждый "набор" вопросов - это вариант теста. Вариант при тестировании выбирается СЛУЧАЙНО; вопросы внутри него СЛУЧАЙНЫМ образом перемешиваются. Результаты тестирования сохраняются ТОЛЬКО после того, как пользователь нажмёт кнопку "Закончить тестирование". Потом администратор, естественно, сможет посмотреть ответы слушателей в правильном порядке.
153 Существует возможность ограничить время прохождения теста - за это отвечает конфигурационная переменная $TimeLimit; ограничить количество раз, сколько ещё пользователь сможет НАЧАТЬ тестирование; ограничить количество раз, сколько пользователь сможет менять свой ответ на один и тот же вопрос. Смотрите секцию "Конфигурирование".
154 Чтобы пройти тест, каждый слушатель сначала будет должен зарегистрироваться в системе, кликнув по ссылке "Зарегистрироваться" на главной странице системы тестирования. При этом он будет ДОЛЖЕН заполнить анкету. Далее администратор сможет просматривать информацию обо ВСЕХ слушателях, а каждый из них - ТОЛЬКО о себе и своих результатах. Также каждый пользователь может править свою анкету и менять пароль. Для этого ему надо выбрать "Править анкету..." на странице просмотра анкеты и результатов (на главной странице).
155 Пользователь НЕ СМОЖЕТ проходить тесты, если администратор не добавит ему одну или несколько возможных попыток, используя систему администрирования. (см. секцию "11. Администрирование")
156 Пользователь также НЕ СМОЖЕТ проходить тесты, если база данных вопросов пуста. Информация о формате файла с вопросами - смотрите секцию "Формат файла с вопросами".
157
158 *********************************************
159 *************** 5. Сама система ***************
160 *********************************************
161
162 Сама система написана на веб-языке программирования PHP (требуется версия PHP не ниже 4.3.10), что делает её независимой от операционной системы - главное, что ей требуется - это подходящая программа-WWW-сервер (например, Apache), интерпретатор PHP >= 4.3.10, подключённый к WWW-серверу, и СУБД MySQL. Другие СУБД пока НЕ поддерживаются.
163 Для начала работы с системой наберите в адресной строке браузера http://www.vpntest.ru или другое заданное вами при установке доменное имя. Чтобы перейти в администраторский раздел, вы ДОЛЖНЫ знать логин и пароль админстратора, с которыми вы будете заходить на http://www.vpntest.ru/admin/.
164
165 *************************************************************
166 *************** 6. Файлы, относящиеся к системе ***************
167 *************************************************************
168
169 Директорией, в которую устанавливается система, является Z:\home\vpntest.ru, где Z - имя виртуального диска, создаваемого Денвером, а vpntest.ru - желаемое имя виртуального домена, на котором будет расположена система тестирования. Внимание! Когда сервера Денвера уже запущены, вы НЕ ДОЛЖНЫ менять имя этой папки.
170 Внутрь этой директории вы распаковываете архив с дистрибутивом системы. После установки подпапка WWW эквивалентна корню сайта vpntest.ru. В самой папке WWW расположены файлы, отвечающие за пользовательскую часть системы - часть, отвечающую за регистрацию и тестирование. В WWW/admin/ расположена администраторская часть системы. В WWW/lib/ расположены библиотеки функций, используемые системой при работе, а также config.php - конфигурационный файл. (см. секцию "10. Конфигурирование")
171 Доступ ко всем директориям, кроме WWW/, должен быть закрыт для простых пользователей, для этого рекомендуется использовать HTTP-метод аутентификации (посредством .htaccess).
172
173 *********************************************************
174 *************** 7. Способ вывода информации ***************
175 *********************************************************
176
177 Вся информация, выводимая данной системой, представляется в формате HTML и выводится на экран через обычный WEB-браузер. Вы можете установить систему на своём компьютере и проверять себя; вы можете установить её на выделенный компьютер локальной сети, чтобы тестирование проходить могли пользователи со всех компьютеров локальной сети; вы можете установить её даже на веб-сайт и тогда пользователи со всего интернета смогут заходить к вам и проходить тестирование. Соответственно, при просмотре ЛЮБОЙ страницы вы можете воспользоваться командой браузера "Сохранить страницу", а дальше сможете, например, открывать её в текстовых процессорах, которые поддерживают работу с HTML.
178
179 ************************************************************
180 *************** 8. Система хранения информации ***************
181 ************************************************************
182
183 ВСЕ данные, которые система использует при работе, хранятся в базе данных. Для работы с базой данных система использует СУБД MySQL. Сервер MySQL устанавливается тогда, когда вы устанавливаете Денвер. Он, конечно, может быть установлен и отдельно. За хранение базы данных отвечает MySQL! Данная система об этом не задумывается. Обычно (если вы не меняли это название) база данных, относящаяся к системе тестирования слушателей, называется vpntest и хранится в Z:/usr/local/mysql4/data/vpntest. Файлы, которые находятся в этой директории, трогать НЕ НАДО. Если вы хотите сделать резервную копию базы данных - вы всегда можете воспользоваться phpMyAdmin; в следующих версиях планируется добавить возможность резервного копирования и восстановления базы данных целиком.
184 В данном руководстве используются термины "рабочая база данных" и "архивная база данных". На самом деле - БД одна, но состоит из двух частей: рабочих таблиц (по умолчанию users, results, questions) и архивных таблиц (по умолчанию snapshots, snapshots_users, snapshots_results, snapshots_questions). Идея в том, что архивные таблицы затрагиваются при работе ТОЛЬКО с архивом. Ни "Инициализация БД", ни другие команды администрирования, ни система прохождения тестов НЕ ЗАТРАГИВАЮТ архив. То есть, будьте спокойны: при выборе "Инициализации БД" архив останется жив :)
185
186 *********************************************************
187 *************** 9. Формат файла с вопросами ***************
188 *********************************************************
189
190 Файл с вопросами - это файл формата PLAIN TEXT - "чистый текст" - *.txt.
191 В файле с вопросами записана последовательность вопросов. Каждый вопрос относится к некоторому варианту; вариант задаётся при загрузке файла в базу данных сразу для ВСЕХ вопросов из этого файла, по умолчанию - вариант 1.
192 Вопрос - это 5 строк: на первой записаны номер вопроса и его текст, на следующих четырёх - четыре варианта возможных ответов на этот вопрос. ВСЕ вопросы должны быть пронумерованы: первая строка ДОЛЖНА выглядеть как "ЧИСЛО. ТЕКСТ ВОПРОСА" - после числа (номера вопроса) ДОЛЖНА стоять точка и пробел.
193 Тот вариант ответа, перед которым в начале строки написан символ *, считается правильным. Правильный вариант ответа ТОЛЬКО один. Если звёздочкой отмечено несколько вариантов - последний из них будет выбран как правильный.
194 Между вопросами МОЖЕТ быть произвольное число пустых или состоящих только из пробелов и символов табуляции строк. Между вопросом и его ответами пустых строк быть НЕ ДОЛЖНО.
195 ВСЕ строки файла перед обработкой подвергаются trim'у, то есть удалению пробелов и табуляций из начала и конца строки. То есть, отступы у каждой строки вы МОЖЕТЕ делать произвольные - на загрузку вопросов это не влияет.
196 И вопросы, И ответы - это не просто текст: позволяется HTML-код. Например, чтобы вставить в текст вопроса или ответа перевод строки, вы должны написать "<br>" (без кавычек). Чтобы вставить в текст вопроса или ответа картинку - вы должны написать <img src="путь_к_картинке">. Путь к картинке задаётся относительно корня директории WWW. РЕКОМЕНДУЕТСЯ писать пути в стиле <img src="/dir1/dir2/.../img.png"> - тогда вы будете абсолютно уверены в том, что картинки везде отобразятся корректно и возьмутся из /home/vpntest.ru/WWW/dir1/dir2/.../img.png (или, если вы меняли имя домена - вместо vpntest.ru будет оно).
197 В качестве корневого каталога "/" в этом файле везде, кроме ссылок и картинок, скорее всего имеется ввиду корень виртуального диска, создаваемого Денвером (по умолчанию это "Z:\").
198 Пример файла с вопросами вы можете посмотреть в файле testq.txt из архива.
199
200 **********************************************************
201 *************** 10. Конфигурирование системы ***************
202 **********************************************************
203
204 Система нуждается в конфигурировании - особенно сразу после установки. Конфигурирование осуществляется путём редактирования файла WWW/lib/config.php. В начале этого файла расположены конфигурационные переменные с комментариями к ним. В этой секции руководства приведены комментарии ко всем конфигурационным переменным, а также стандартная последовательность действий при начальном конфигурировании системы.
205
206 ***************************************************************
207 *************** 10.1. Конфигурационные переменные ***************
208 ***************************************************************
209
210 Значение каждой переменной задаётся как строка: "$переменная = значение;"
211
212 Переменная $dbhost: адрес (или IP) хоста, на котором запущен сервер СУБД MySQL.
213 Значение по умолчанию: "localhost"
214 Менять: обычно не требуется.
215
216 Переменная $dbuser: имя пользователя MySQL.
217 Значение по умолчанию: "root"
218 Менять: по умолчанию - не требуется; однако создав нового пользователя с меньшими, чем у root, привилегиями может немного поднять уровень безопасности.
219
220 Переменная $dbpwd: пароль пользователя MySQL.
221 Значение по умолчанию: "" (пустой пароль)
222 Менять: требуется сразу после установки и при смене пароля на доступ к БД.
223 Замечание: да, пароль к БД хранится в открытом виде в конфигурационном файле. Однако, даже если убрать .htaccess, доступ к нему пользователи не получат, т.к config.php лишь проинтерпретируется PHP и ничего не выдаст на экран.
224
225 Переменная $db: имя базы данных, используемой для хранения информации системой.
226 Значение по умолчанию: "vpntest"
227 Менять: обычно не требуется. Требуется только в том случае, если у вас уже есть БД "vpntest", не относящаяся к данной системе тестирования.
228
229 Переменная $UsersTable: имя таблицы, используемой для хранения рабочей информации о слушателях.
230 Значение по умолчанию: "users"
231 Менять: обычно не требуется.
232
233 Переменная $ResultsTable: имя таблицы, используемой для хранения рабочей информации о результатах тестирований слушателей.
234 Значение по умолчанию: "results"
235 Менять: обычно не требуется.
236
237 Переменная $QuestionsTable: имя таблицы, используемой для хранения рабочих вопросов.
238 Значение по умолчанию: "questions"
239 Менять: обычно не требуется.
240
241 Переменная $SnapshotsTable: имя таблицы, используемой для хранения списка снимков (см. секцию "12. Работа с архивом результатов")
242 Значение по умолчанию: "snapshots"
243 Менять: обычно не требуется.
244
245 Переменная $VLoginSession: имя HTTP-сессии, используемой для обозначения аутентификации пользователя.
246 Значение по умолчанию: "vmxlsess"
247 Менять: обычно не требуется.
248
249 Переменная $Domain: имя домена (в нашем случае обычно виртуального), на котором установлена система.
250 Значение по умолчанию: "vpntest.ru"
251 Менять: требуется после установки, если вы выбрали другое имя виртуального домена.
252
253 Переменная $MatrixWidth: ширина матрицы с номерами вопросов, которую увидят пользователи при прохождении теста.
254 Значение по умолчанию: 10
255 Менять: можно.
256
257 Переменная $TriesCount: количество попыток ответа на один вопрос. Больше, чем это число раз, поменять выбранный ответ на другой слушатель не сможет (первая попытка ответа включается).
258 Значение по умолчанию: 3
259 Менять: можно.
260
261 Переменная $TimeLimit: временной лимит прохождения теста в секундах. Если значение меньше или равно 0, временной лимит отключён. Если строка с этой переменной закомментирована - временной лимит отключён.
262 Значение по умолчанию: 60*90 (то есть полтора часа)
263 Менять: можно.
264
265 Переменная $ElementsPerPage: количество записей на одной странице при постраничном просмотре больших объёмов данных.
266 Значение по умолчанию: 20
267 Менять: можно.
268
269 **************************************************************************
270 *************** 10.2. Что вы ДОЛЖНЫ поменять после установки ***************
271 **************************************************************************
272
273 После установки системы, если все настройки, кроме пароля на БД, вы оставили равными значениями по умолчанию - вы ДОЛЖНЫ установить лишь правильное значение переменной $dbpwd.
274
275 ***********************************************************
276 *************** 11. Администрирование системы ***************
277 ***********************************************************
278
279 Администрирование системы производится с помощью http://www.vpntest.ru/admin/. Первым, что вы увидите, когда введёте логин и пароль администратора, будет список возможных операций, состоящий из операций, перечисленных ниже. При клике "Версия для печати" на любой странице - система постарается выдать наиболее удобную для печати или сохранения в HTML-файл страницу. С версии для печати всегда можно вернуться кликом по ссылке "Назад" внизу страницы.
280
281 11.1. Вывод информации о пользователях. Вы задаёте подстроку, содержащуюся в логине требуемых пользователей либо дату, после или в которую они зарегистрировались, и нажимаете кнопку "Искать пользователей". После этого система выдаст вам табличку с информацией о найденных пользователях, соответствовавших заданному критерию поиска. Внимание! Если задана дата, позже которой регистрировались требуемые пользователи - поле "логин" игнорируется.
282 В таблице будут перечислены пользователи и информация о них. Если кликнете по логину - логин попадёт в поле "Логин" команды "Вывод информации о пользователях". Справа, в колонке "Результат", отображается ПОСЛЕДНИЙ результат прохождения теста пользователем и ссылка "...", при клике по которой вы попадёте на страницу с информацией о пользователе и кратко - всех его результатах.
283 Флажки рядом с логинами пользователей служат для выбора лишь некоторых пользователей из списка.
284 Кроме того, под таблицей будет отображён список действий, которые в данный момент возможно применить к выбранным пользователям. Это команды:
285 Следующие действия влияют ТОЛЬКО на отмеченных флажками пользователей.
286 - "+1 тест" - при нажатии на эту кнопку отмеченным флажками пользователям будет разрешено пройти ещё один тест.
287 - "-1 тест" - при нажатии на эту кнопку у тех отмеченных флажками пользователей, кто ещё может проходить тесты, отберётся одна возможность пройти тест.
288 - "Обнулить тесты" - после нажатия на эту кнопку отмеченные флажками пользователи не смогут проходить тесты до следующего разрешения.
289 - "Удалить слушателей" - после подтверждения ПОЛНОСТЬЮ удалить отмеченных флажками пользователей вместе с их результатами. Операцию отменить невозможно.
290 Следующие два действия отображаются как ссылки, а не кнопки, и действуют на ВСЕХ выведенных в таблице слушателей, а не только на отмеченных флажками.
291 - "Версия для печати" - отобразить наиболее дружелюбную для принтера версию текущей таблицы.
292 - "Тесты подробно" - отобразить подробную информацию о всех результатах прохождения тестов выбранными пользователями. Для корректного вывода информации загруженные в БД вопросы должны соответствовать тем, на которые тогда отвечали пользователи.
293
294 11.2. Просмотр списка вопросов в БД. Вы можете посмотреть постраничный список ВСЕХ вопросов, на данный момент загруженных в БД. Для этого перейдите по ссылке "нажмите СЮДА". На странице выводится $ElementsPerPage вопросов (см. секцию "10. Конфигурирование системы"). При выводе версии списка вопросов, предназначенной для печати - выведутся ВСЕ вопросы на одной странице - для удобства. Вывод списка вопросов из рабочей БД и вывод списка вопросов из одного из снимков, находящихся в архиве, принципиально эквивалентны (см. секцию "12. Работа с архивом результатов").
295
296 11.3. Загрузка вопросов из текстового файла. Вы выбираете любой файл со своего компьютера (см. секцию "9. Формат файла с вопросами"); задаёте вариант вопросов загружаемого файла - или оставляете его равным 1 - значению по умолчанию; если хотите сначала стереть всё содержимое рабочей БД с вопросами - устанавливаете флажок "Перезаписать БД вопросов"; и нажимаете кнопку "Загрузить вопросы в БД". После этого вопросы будут загружены в БД, а вам будет показан результат операции загрузки вопросов (были ошибки или нет).
297
298 11.4. Инициализация БД. Инициализация означает уничтожение и создание заново ВСЕЙ рабочей базы данных. Архивную базу данных эта команда не затрагивает. Инициализация архива производится отдельно, на странице работы с архивом. Таким образом, обычно работа с системой выглядит так: протестировать группу слушателей, отпустить их, архивировать результаты (см. секцию "12. Работа с архивом результатов"), инициализировать рабочую БД заново, повторить всё заново :)
299
300 **************************************************************
301 *************** 12. Работа с архивом результатов ***************
302 **************************************************************
303
304 Чтобы попасть в архив, вы можете либо набрать http://www.vpntest.ru/admin/archive.php, либо нажать на ссылку "к архиву" вверху на странице администрирования системы. Точно так же из архива вы можете вернуться обратно к администрированию, нажав на ссылку "к администрированию" вверху на странице с архивом.
305 Архив устроен как множество снимков рабочей базы данных. Каждый снимок включает в себя и информацию о пользователях, и их результатах, и вопросах тестов, которые они проходили, то есть по сути является просто копией рабочей БД, с которой можно работать абсолютно так же, как и с рабочей, за тем исключением, что пользователи, "сданные в архив", уже не могут проходить тесты, хотя вся информация о них и остаётся. Соответственно, команд "Дать +1 тест", "Отнять 1 тест", "Убрать тесты" здесь нету.
306 Если архив ещё не был инициализирован - выведется только одна команда, отвечающая за его инициализацию. Естественно, для работы с архивом вы должны его инициализировать.
307 Вы можете просматривать список снимков: выведите его, используя кнопку "Показать список снимков" и поля ввода выше неё (ограничения на снимки задаются по абсолютно тем же правилам, что и ограничения для вывода списка пользователей на странице администрирования, только вместо логина здесь используется имя снимка); список снимков выводится постранично. Кликая по кнопкам "<<" (переход к первой странице), "<" (переход к предыдущей странице), ">" (переход к следующей странице), и ">>" (переход к последней странице), вы осуществляете навигацию по страницам списка. На одной странице выводится $ElementsPerPage снимков (см. секцию "10. Конфигурирование").
308 Далее, выбирая снимок из списка, вы можете просматривать данные, сохранённые в этом снимке. Когда снимок уже выбран, над списком команд отобразится табличка с информацией о снимке (его именем и датой-временем снятия) в заголовке, командами для просмотра данных снимка в центре и командой удаления списка внизу. Удаление производится после подтверждения, выдаваемого при нажатии на ссылку "Удалить снимок".
309 Кликнув по пункту "Список пользователей", вы выведете список ВСЕХ пользователей, сохранённых в снимке, в виде таблички, аналогичной табличке вывода информации о пользователей из рабочей базы данных. При клике по ссылке "..." в скобках рядом с пунктом "Список пользователей" выведется форма задания ограничений на поиск пользователей, аналогичная таковой на странице администрирования. Вся разница только в том, что здесь вы работаете со снимком, находящимся в архиве.
310 После показа списка пользователей вы точно так же, как и при администрировании, можете вывести версию для печати, или подробную информацию о всех результатах выбранных пользователей. Команды разрешения/запрещения прохождения тестов, естественно, запрещены, так как пользователи уже "сданы в архив", как было уже сказано выше.
311 Кликнув по пункту "Список вопросов", вы выведете постраничный список всех вопросов, сохранённых в снимке, отсортированный по номеру варианта и номеру вопроса. На странице выводится $ElementsPerPage вопросов. Вопросы выводятся списком, под каждым вопросом выдаются его варианты ответа, правильный из которых отмечается более тёмным рыжим фоном. Постраничная навигация осуществляется так же, как и в списке снимков. При выборе "Версии для печати" списка вопросов - отобразятся сразу все вопросы на одной странице в удобном для печати / сохранения виде.
312 При клике по пункту "Скрыть списки" все выведенные списки будут скрыты.
313 Другими командами работы с инициализированным архивом будут: создание нового снимка и уничтожение архива.
314 Чтобы создать новый снимок, вы должны вписать имя для нового снимка в поле "Имя снимка" и нажать либо Enter, либо кнопку "Сделать снимок". После отработки программы у вас появится новый снимок базы данных, являющийся практически точной её копией. Практически - потому что ID'ы пользователей при создании снимка не сохраняются во избежание дублированных индексов в таблице.
315 Чтобы уничтожить архив, вам придётся сначала подтвердить свои действия в появляющемся на экране после клика на кнопке "Уничтожить архив" окне.
316
317 ***************************************************
318 *************** 13. Координаты автора ***************
319 ***************************************************
320
321 Автор: Виталий Филиппов [VMX]
322 ICQ # 278245320
323 vitalif@mail.ru
324 http://vmx.yourcmc.ru