Оглавление (стр. 20 )

10.1.3 Элемент <format>

Необязательный элемент

Задаёт формат вывода таймера на экран (в случае если таймер отображается на экране).

Данный элемент был введен вместо атрибута format элемента <param> с целью расширения функциональных возможностей.

Общая структура

<format>

[%elapsed% | %total% | %remaining%]

</format>

Содержимое

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

%elapsed% - заменяется номером шага %remaining% - заменяется названием шага % total% - заменяется временем начала работы в шаге

События, порождаемые объектом таймер

Событие	Описание	Параметры
onStartTimer	возникает при старте (возобновлении таймера)	-
onTimeOut	возникает в момент истечения временного интервала таймера, установленного в атрибуте timeout	-

Пример:

<timer id="timer01" playing="true">

<param .../>

<actions>

<action event="onStartTimer"> </action>

<action event="onTimeOut"> </action>

</actions>

</timer>

10.1.4 Действия, применимые к объекту «Таймер»

playObject	Запускает (возобновляет таймер)	id объекта
stopObject	Останавливает таймер	id объекта

Пример 1: Выполнение действий по истечении интервала времени

В данном примере задан таймер, стартующий при входе в шаг и отображаемый в правом верхнем углу экрана. По истечению интервала времени (в данном случае 5 секунд) выполняется показ изображения с идентификатором "01" (изначально скрытое).

<?xml version="1.0" encoding="windows-1251" ?>

<step>

<settings>

<name>Таймеры</name>

</settings>

<timer id="timer01" playing="true">

<param countdown="true" timeout="5" display="true" x="900" y="20" depth="-1000" style="Verdana_15_Bold" timeFormat="HH:MM:SS"/>

<format>%elapsed%"</format>

<actions>

<action event="onTimeOut">showObject:01</action>

</actions>

</timer>

<image id="01" visible="false">

<param src="/DATA/components/timers/01.jpg" x="40" y="40" width="200" height="200" />

</image>

</step>

Пример 2:

Ограничение времени работы в шаге

<?xml version="1.0" encoding="windows-1251" ?>

<step>

<settings>

<name>Ограничение времени работы в шаге</name>

</settings>

<actions>

<action event="onStartStep">playObject:timer01</action>

</actions>

<timer id="timer01" playing="false">

<param countdown="true" timeout="300" display="true" x="900" y="20" depth="-1000" style="Verdana_15_Bold" timeFormat="HH:MM:SS"/>

<format>%elapsed%"</format>

<actions>

<action event="onTimeOut">goNextStep</action>

</actions>

</timer>

</step>

В данном примере задан таймер, отображаемый в правом верхнем углу экрана. При входе в шаг он запускается путём выполнения действия playObject. По истечению интервала времени (в данном случае 5 минут = 5*60сек) выполняется переход к следующему шагу.

10.2  Задание интервала времени для выполнения сцены (шага).

Для задания интервала времени, ограничивающего продолжительность выполнения сцены (шага) следует создать таймер (см. описание таймера).

Пример: запускается таймер, он сработает через 100 секунд (1 минута 40 секунд)

<timer id="timer01" playing="false">

<param timeout="100" display="true"

x="900" y="20" depth="-1000" style="Verdana_15_Bold"

timeFormat="HH:MM:SS"/>

<format>%elapsed%"</format>

</timer>

Что бы объект типа шаблон (т. е. «кроссворд», «перетаскивание» и т. д.) смог получить сообщение, у него следует установить обработку сообщения «onTimeOut». В данном обработчике можно сказать объекту, что бы он смог посчитать свои результаты (checkObject:имя_объекта). Так же, можно получать сообщение о сработавшем таймере только от определенного таймера. Для этого надо в параметрах сообщения указать идентификатор таймера, от которого следует получить сообщение (eventParam="timer01").

Пример: шаблон input_ex получит сообщение onTimeOut от любого сработавшего таймера.

<input_ex id="IBE_1" visible="true">

<param x="190" y="170" width="100" height="30" depth="-200"

check_text="проверка"

bgcolor="#FFFFFF" bgcolor_active="#FFFFFF"

bgcolor_disable="#FFFFFF" multi_line="true">

<style styleNormal="Verdana_16" styleActive="Verdana_16"

styleDisable="Verdana_16" styleError="Verdana_16"/>

<border clrNormal="#000000" clrActive="#000000"

clrError="#000000"

sizeNormal="2" sizeActive="3" sizeError="2"/>

<caretka src="/DATA/skin/edit_cursor. png"/>

<resultof type="smooth_err"/>

</param>

<actions>

<action event="onInputBoxComplete">

showObject:ibe1_eror</action>

<action event="onInputBoxWrong">

showObject:ibe1_eror_1</action>

<action event="onTimeOut">showObject:to;goToSummary</action>

</actions>

</input_ex>

Пример: шаблон input_ex получит сообщение onTimeOut только от таймера с идентификатором «timer01».

<input_ex id="IBE_1" visible="true">

<param x="190" y="170" width="100" height="30" depth="-200"

check_text="проверка"

bgcolor="#FFFFFF" bgcolor_active="#FFFFFF"

bgcolor_disable="#FFFFFF" multi_line="true">

<style styleNormal="Verdana_16" styleActive="Verdana_16"

styleDisable="Verdana_16" styleError="Verdana_16"/>

<border clrNormal="#000000" clrActive="#000000"

clrError="#000000"

sizeNormal="2" sizeActive="3" sizeError="2"/>

<caretka src="/DATA/skin/edit_cursor. png"/>

<resultof type="smooth_err"/>

</param>

<actions>

<action event="onInputBoxComplete">

showObject:ibe1_eror</action>

<action event="onInputBoxWrong">

showObject:ibe1_eror_1</action>

<action event="onTimeOut" eventParam="timer01">

showObject:to;goToSummary</action>

</actions>

</input_ex>

10.3  Задание интервала времени для выполнения ЭУМ в целом (Элемент <timer>).

Время работы с ЭУМ может быть ограничено (согласно учебному сценарию) временным интервалом. Для установки временного интервала следует в файле описания списка шагов (см. раздел «Файл описания списка сцен (шагов) (/DATA/scene/lab. xml)») разместить объект <timer> и настроить соответствующие параметры данного объекта.

Для задания интервала времени выполнения ЭУМ следует создать таймер в файле lab. xml. (см. раздел 'Объект «Таймер»')

Пример: запускается таймер, он сработает через 100 секунд (1 минута 40 секунд)

<timer id="timerLab" playing="false">

<param timeout="100" display="true"

x="900" y="20" depth="-1000" style="Verdana_15_Bold"

format="%elapsed%" timeFormat="HH:MM:SS"/>

<actions>

<action event="onTimeOut">timeOutObject:LABWORK</action>

</actions>

</timer>

В событиях таймера надо вызвать действие timeOutObject:LABWORK (оно говорит модулю, что сработал таймер и следует сказать об этом всем живым объектам). Тут так же можно сделать переход в сцену (шаг) с результатами (goToStepWithId:summary или goToSummary).

После срабатывание таймера, все объекты, которые сейчас работают, получат сообщение о сработавшем таймере.

Что бы объект типа шаблон (т. е. «кроссворд», «перетаскивание» и т. д.) смог получить сообщение, у него следует установить обработку сообщения «onTimeOut». В данном обработчике можно сказать объекту, что бы он смог посчитать свои результаты (checkObject:имя_объекта) и перейти на сцену с результатами выполнение ЭУМ (goToSummary).

<input_ex id="IBE_1" visible="true">

<param x="190" y="170" width="100" height="30" depth="-200"

check_text="проверка"

bgcolor="#FFFFFF" bgcolor_active="#FFFFFF"

bgcolor_disable="#FFFFFF" multi_line="true">

<style styleNormal="Verdana_16" styleActive="Verdana_16"

styleDisable="Verdana_16" styleError="Verdana_16"/>

<border clrNormal="#000000" clrActive="#000000"

clrError="#000000"

sizeNormal="2" sizeActive="3" sizeError="2"/>

<caretka src="/DATA/skin/edit_cursor. png"/>

<resultof type="smooth_err"/>

</param>

<actions>

<action event="onInputBoxComplete">

showObject:ibe1_eror</action>

<action event="onInputBoxWrong">

showObject:ibe1_eror_1</action>

<action event="onTimeOut">showObject:to;goToSummary</action>

</actions>

</input_ex>

11  Статистический учет действий пользователя при работе с модулем

Современные электронные системы учебного назначения должны обладать функционалом, позволяющим отслеживать определенные действия пользователя, совершаемые в процессе работы с учебным материалом. Данный раздел содержит справочную информацию о настройке функциональных структур, ответственных за сбор статистических данных о действиях пользователя в впроцессе работы с ЭУМ.

11.1  Сопроводительный комментарий к учебной сцене

Разработчик содержательной части ЭУМ волен планировать назначение определенного статуса учебной сцене в процессе «прохождения» ее пользователем (в зависимости от тех или иных действий пользователя). В дальнейшем пользователь может просмотреть статус выполнения сцены на странице отчета. Данная возможность реализуется посредством «действий» (<actions>), назначаемых активным элементам сцены (например, кнопкам)

Если требуется установить статус выполнения шага отличный от «выполнил/не выполнил», следует выполнить действие (action) «setStepStatus», указав (в параметре) значение статуса выполнения сцены. Статусы выполнения следует описать в строковых ресурсах. Путь к файлу описания статусов выполнения сцены определен в следующих файлах:

·  В файле DATA\skin\config. xml контейнер <setting element="languages"> содержит путь к файлу языковых настроек модуля, например, к файлу \DATA\skin\languagesDef. xml.

·  В файле языковых настроек модуля (например, \DATA\skin\languagesDef. xml) содержится ссылка на ресурс (папку), содержащий файл описания языковых терминов – <language default="ru" directory="\DATA\skin\languages\"/>.

·  Папка \DATA\skin\languages\ содержит файл ru_strings. xml с перечнем статусов выполнения сцен (файл ru_strings. xml).

Содержимое файла ru_strings. xml может быть представлено следующим образом:

<strings>

<string id="result_served">выполнял</string>

<string id="result_not_served">не выполнял</string>

<string id="result_failed">прервал</string>

...

</strings>

Подробно о настройке строковых ресурсов следует читать в соответствующем разделеданного руководства (см. Описание строковых ресурсов ЭУМ (element="languages")).

Пример:

«щелчком» по кнопке назначить статус выполнения текущей сцены – «прервано».

<button id="btn_failed" visible="true">

<param textValue="Прерывание шага" type="TEXT" x="100" y="530"

height="30" depth="3" styleNormal="Verdana_17_grey"

styleActive="Verdana_17_grey"

stylePressed="Verdana_17_grey"/>

<actions>

<action event="onPress">setStepStatus:result_failed</action>

</actions>

</button>

11.2  Сохранение результатов в файл

Для сохранения результатов необходимо задать файл настроек экспорта

<exportformat>

<header><![CDATA[

<html>

<body>

<table width="100%">]]>

</header>

<step index="even"><![CDATA[

<tr bgcolor="#DDDDDD">

<td width="40%">%StepIndex%. %StepName%</td>

<td>%StartTime%</td>

<td>%Duration%</td>

<td>%Errors%</td>

<td>%Helps%</td>

<td>%Result%</td>

</tr>

]]></step>

<step index="odd"><![CDATA[ <tr bgcolor="#EEEEEE"><td width="40%">%StepIndex%. %StepName%</td><td>%StartTime%</td><td>%Duration%</td><td>%Errors%</td><td>%Helps%</td><td>%Result%</td></tr>]]></step>

<step index="summary"><![CDATA[<tr bgcolor="#999999"><td width="40%">%StepName%</td><td>%StartTime%</td><td>%Duration%</td><td>%Errors%</td><td>%Helps%</td><td>%Result%</td></tr>]]></step>

<footer><![CDATA[

</table></body></html>]]></footer>

</exportformat>

Подробно о настройке файла экспорта результатов работы следует читать в соответствующем разделеданного руководства (Описание свойств таблицы файла экспорта результатов выполнения ЭУМ (element="resultExport")).

11.3  Управление сбором результатов постерством событий и действий (event and actions)

Сбор статистики и подсчет результатов происходит в автоматическом режиме. Если требуется обеспечить метод представления результатов, отличный от «стандартного» (программно заданного), следует перейти на режим управления сбором статистики посредством организации «действий» на заданные события. Для установки событийного режима сбора статистики следует воспользоваться действием (action) с названием setParam, manually, true. Данное действие позволяет перевести систему обработки статистики в режим «ручного управления». В данном режиме система сбора статистики «ожидает» команды (действия - action) setParam, sceneCompleted, true,- указывающей, что пользователь выполнил необходимые операция и системе оработки статистики разрешено предоставить учебные достижения пользователя. Так как смена режимов зависит от действий (action), то смена параметров может быть определена любым событием, которому может соответствовать указанное действие.

Варианты использования:

setParam, manually, false – Включен стандартный режим.

setParam, manually, true – Включен управляемый - пользовательский режим.

setParam, sceneCompleted, true – Учебная сцена завершена стандартный вывод информации.

Примечание:

По умолчаению (стандартный режим) setParam, manually, false – Включен стандартный режим.

По умолчаению значение параметра sceneCompleted определено, как false – учебная сцена не завершена (ошибки, подсказки, и результат не выводятся; выводятся: число попыток и время работы).

Пример:

<actions>

<action event="onStartStep">

setParam, manually, true

</action>

</actions>

11.4  Варианты управления способом оценки результатов работы посредством событий и действий (event and actions)

Если рассматривать учебный модуль как систему, то атомарным элементом, способным вести подсчет результатов работы, является шаблон; несколько шаблонов могу быть объединены в группу, или находиться в составе шаблона «Последовательность» (Train); и наконец, один шаблон или группа шаблонов обязаны входить в состав «Сцены». Результаты, отображаемые в итоговой сцене, соответствуют результатам пройденных учебных сцен; следовательно, если сцена содержит несколько шаблонов, способных вести подсчет результатов, то результат для данной сцены является усредненным значением. В процессе организации плана (схемы) прохождения заданий учебного модуля, может возникнуть потребность в наличии условных переходов, или необходимость включения контекстного информационного сопровождения, в зависимости от величин результатов работы пользователя. В случае, когда ход развития сценария должен зависеть от величины результата, полученного пользователем при решении заданий, модель управления должна содержать следующие элементы: контрольное значение, с которым программа будет сопоставлять полученный результат; условия, согласно которым будет производиться оценка результата и инструкция (или набор инструкций), которые будут выполнены, если значение результата будет удовлетворять (не удовлетворять) заданным условиям. Следует также предусмотреть пусковой механизм, инициализирующий процесс сравнения (оценки) результата, и условия его активации. Данная задача может быть решена посредством включения в состав сценария определенных управляющих событий и действий (event and actions).

Для активации «пускового механизма» следует использовать действие (action) compareResult:Id, где Id – идентификатор объекта (шаблона, группы шаблонов). Данное действие может быть назначено различным событиям шаблона *.

Для определения условий проверки результата и объявления инструкций (действий), следует использовать события: onResultBelow, onResultAbove, onResultBetween. Данные события должны иметь контекстное назначение и располагаться в пределах шаблона, группы или сцены.

Пример

<actions>

<action event="onResultBetween"
eventParam="10;70">
showObject:ifBetweenAnswer

</action>

</actions>

11.4.1 События, определяющие условия проверки результата

Событие	Описание	Параметры
onResultBelow	событие возникает, если текущий результат ниже установленного значения (задается для всего шаблона).	значение (натуральное число), с которым сравнивается текущий результат
onResultAbove	событие возникает, если текущий результат выше установленного значения (задается для всего шаблона).	значение (натуральное число), с которым сравнивается текущий результат
onResultBetween	событие возникает, если текущий результат находится между двумя значениями интервала (задается для всего шаблона)	min;max (натуральные числа) - интервал, с которым сравнивается текущий результат

* Следует иметь в виду, что срабатывание событий, инициируемых действием compareResult:Id, не распространяется на дочерние элементы объекта с заданным Id.

11.5  Оценка общего результата прохождения заданий ЭУМ

Общий результат работы в ЭУМ считается только по оцениваемым заданиям (т. е. для сцен (<step>) с resultCount="true" ).

Параметры resultCount (ведётся ли подсчёт результатов в шаге) и complexity (значимость (вес) задания данной учебной сцены (шага) по отношению к упражнениям других сцен (шагов) ЭУМ) определяются в файле описания списка шагов (раздел данного руководств «Файл описания списка шагов»).

Общий результат вычисляется как среднеарифметическое результатов всех оцениваемых заданий с учётом коэффициентов их сложности по формуле:

z z (åki*ri / åki) i=1 i=1

или (k1*r1+…+kz*rz)/(k1+…+kz)

где: z - число заданий в ЭУМ,

r – результаты заданий,

k – коэффициенты сложности.

11.6  Шаблон «Результаты работы» (summary)

Вывод результатов работы

Путь к объекту summary задается в настроечном разделе "steps" (путь к которуму задается в конфигурационном файле config. xml)

Возможности шаблона:

вывод результатов в виде таблицы со скроллингом сохранение результатов в файл

Общая структура шаблона

<step>

<settings>

<name>Отчёт</name>

<table>

<param visible="true" x="" y="" width=""

height="" totalBgColor="#000000"/>

<step id=["even"|"odd"|"total"]>

<item width="" style="" bgColor="">

%ШаблонВыражения%

</item>

</step>

</table>

</settings>

<actions>

<action event="onLabworkResultBelowValue"></action>

<action event="onLabworkResultAboveValue"></action>

<action event="onLabworkResultBetweenValues"></action>

</actions>

<image.../>

<text.../>

<audio.../>

<video.../>

<flash.../>

<quicktime/>

<group.../>

</step>

11.6.1 Элемент <settings><table>

Определяет параметры вывода таблицы результатов.

Может содержать единственный элемент <param> и от одного до трёх элементов <step>.

Общая структура

<table>

<param.../>

<step id="even">

...

</step>

</table>

11.6.2 Элемент <settings><table><param>

Определяет положение и размеры таблицы вывода результатов.

Общая структура

<param

x="0"

y="0"

width="0"

height="0"

depth="0"

visible="true"

totalBgColor="#000000"

/>

Атрибуты

x	Необязательный атрибут. Координата таблицы результатов по горизонтальной оси в пикселях Значение по умолчанию: 0.
y	Необязательный атрибут. Координата таблицы результатов по горизонтальной оси в пикселях Значение по умолчанию: 0.
width	Необязательный атрибут. Ширина таблицы результатов на экране. Значение по умолчанию: 0.
height	Необязательный атрибут. Высота таблицы результатов на экране. Значение по умолчанию: 0.
depth	Необязательный атрибут. Глубина расположения таблицы результатов на экране. Значение по умолчанию: 0.
visible	Необязательный атрибут. Видимость таблицы результатов на экране. Значение по умолчанию: true (таблица результатов видна). Возможные значения: ·  true – таблица результатов видна ·  false – таблица результатов не видна
totalBgColor	Необязательный атрибут. Фоновый цвет таблицы. Значение по умолчанию: Если значение не указано, цвет отсутствует.

11.6.3 Элемент <settings><table><step>

Определяет описание строки таблицы результатов. При этом описания для чётных и нечётных строк таблицы, а также для строки с итоговым результатом задаются отдельно. Это позволяет, например, по-разному выделять цветом фона, шрифтом отдельные строки таблицы. Элемент содержит один или несколько элементов <step>.

Общая структура

<step id="even">

<item>…</item>

</step>

Атрибуты

id	Обязательный атрибут. Определяет, вид какой строки задан в элементе. Возможные значения: ·  even – чётная строка таблицы результатов ·  odd – нечётная строка таблицы результатов ·  total – строка итогового результата

11.6.4 Элемент <settings><table><step><item>

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

Общая структура

<item

width="0"

style="0"

bgColor="0"

> 

%StepIndex%

%StepName%

%StartTime%

%Duration%

%Coefficient%

%Attempts%

%Errors%

%Helps%

%Result%

%SelectRule%

%State%

</item>

Атрибуты

width	Необязательный атрибут. Ширина ячейки. Значение по умолчанию: 0.
style	Необязательный атрибут. Стиль текста. Значение по умолчанию: 0.
bgColor	Необязательный атрибут. Цвет фона ячейки. Возможные значения: #000000-#FFFFFF или # - #FFFFFFFF Примечание: Значение цвета может задаваться в одном из двух видов: #RRGGBB – в шестнадцатеричной системе в формате RGB, прозрачность при этом не учитывается #AARRGGBB – в шестнадцатеричном формате ARGB, при этом существует возможность указать полупрозрачный цвет фона

Содержимое

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

%StepIndex% - заменяется номером шага %StepName% - заменяется названием шага %StartTime% - заменяется временем начала работы в шаге %Duration% - заменяется суммарным временем работы в шаге (учитывается суммарное время по всем попыткам) %Coefficient% - заменяется коэффициентом значимости (веса) конкретной учебной сцены (шага). Величина выражает относительную сложность данного задания в сравнении с сложностью упражнений других сцен (шагов) ЭУМ %Attempts% - заменяется количеством попыток выполнения задания (шага) %Errors% - заменяется суммарным количеством ошибок в шаге %Helps% - заменяется суммарным количеством подсказок в шаге %Result% - заменяется результатом шага. Результат отдельного шага выбирается в соответствии с правилами отбора (последний, лучший, средний) результата для данного шага. Если правило не указано для данного шага в отдельности, то применяется правило отбора (последний, лучший, средний), определённое для всей работы. Если подсчет результата в шаге не ведётся, то ключевое слово %Result% удаляется из строки %SelectRule% - заменяется типом выборкой результата шага из нескольких значений (если подсчёт результата включен) %State% - заменяется статусом выполнения учебной сцены

Пример

Пример задания шага "Результаты работы"

<step>

<settings>

<name>Результаты работы</name>

<table>

<param x="75" y="130" height="430" visible="true"

totalBgColor="#e5a05b"/>

<step id="Even">

<item width="300"

style="nameFont">%StepIndex%. %StepName%</item>

<item width="190" style="starttimeFont">%StartTime%</item>

<item width="195" style="durationFont">%Duration%</item>

<item width="195" style="resultFont">%Result%</item>

</step>

<step id="Odd">

<item width="300" style="nameFont">%StepIndex%. %StepName%</item>

<item width="190" style="starttimeFont">%StartTime%</item>

<item width="195" style="durationFont">%Duration%</item>

<item width="195" style="resultFont">%Result%</item>

</step>

<step id="Total">

<item width="300" style="totalnameFont">%StepName%</item>

<item width="190" style="totalstarttimeFont">%StartTime%</item>

<item width="190" style="totaldurationFont">%Duration%</item>

<item width="190" style="totalresultFont">%Result%</item>

</step>

</table>

</settings>

<image id="background" visible="true">

<param src="/DATA/skin/summary/bkg_lect. jpg" depth="1000"/>

</image>

<image id="background" visible="true">

<param src="/DATA/skin/summary/table_lect. png" depth="1000"/>

</image>

<button id="saveToFile" visible="true">

<param type="IMAGE" sticky="false" x="955" y="570" srcNormal="/DATA/skin/summary/b_save_norm. png" srcActive="/DATA/skin/summary/b_save_over. png" srcPressed="/DATA/skin/summary/b_save_down. png" depth="-1005"/>