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

Annotate of /release/2.11/manual.txt

Parent Directory Parent Directory | Revision Log Revision Log

Revision 14 - (show annotations) (download) (as text)
Sun Feb 17 17:43:01 2008 MSK (12 years, 11 months ago) by vitalif
File MIME type: text/plain; charset=windows-1251
File size: 29393 byte(s)
Release 2.11

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