Формат записи вариантов ответов

Варианты ответов описываются при помощи специального XML-текста.

Вам следует всегда помнить, что вводимый Вами XML-текст не хранится в базе данных. Перед показом этот текст генерируется для Вас на основании существующих данных. При сохранении этот текст разбирается, проверяется на валидность и на наличие у Вас привилегий на внесение изменений и сохраняется в таблицах так, как если бы Вы последовательно сохранили несколько форм, каждая из которых описывала бы один из вариантов ответа.

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

XML-тексте с описанием вариантов ответов допустимы следующие теги:

variant

Определяет один из вариантов ответа. Для этого тега могут быть заданы следующие атрибуты:

Внутри этого тега могут содержаться следующие теги: param, title, comment.

При генерации XML-текста система вставляет внутрь этого тега комментарии с указанием того, кто и когда создал и последним модифицировал этот вариант ответа.

У этого тега разрешены следующие атрибуты:

• id - внутренний идентификатор варианта ответа.

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

  Этот идентификатор генерируется автоматически и является уникальным идентификатором среди всех вариантов ответов всех вопросов в системе во всех каталогах.

  Нельзя указывать идентификатор, сгенерированный для одного из вопроса в варианте ответа для другого вопроса.

  Чтобы добавить новый вариант ответа, не задавайте этот атрибут.

  Чтобы отредактировать существующий вариант ответа, оставьте этот атрибут таким, как его сгенерировала для Вас система.

• type - тип варианта ответа.

  Допустимы следующие значения этого атрибута:

  radio - радиокнопка. Для всего вопроса может быть выбран только один вариант ответа с типом радиокнопка.

  checkbox - галочка. Для всего вопроса может быть выбрана любая комбинация таких вариантов ответов.

  combobox - выпадающий список. Для всего вопроса может быть выбран только один вариант ответа с типом радиокнопка. От радиокнопки отличается только формой представления.

  integer - целое значение. При использовании этого типа варианта ответа обязательно следует указывать атрибуты max и min.

  float - число с плавающей точкой. При использовании этого типа варианта ответа обязательно следует указывать атрибуты max и min.

  text - текстовое поле.

  textarea - многострочное текстовое поле.

• mark - вес варианта ответа.

  Если выбран этот вариант ответа, то это число прибавляется к общему весу вопроса.

  Используется, например, в учебных тестах, когда Вы хотите указать, какие варианты ответов - правильные, а какие - не правильные.

• min - минимальное значение числа.

  Используется только если атрибут type равен одному из двух значений: integer или float.

• max - минимальное значение числа.

  Используется только если атрибут type равен одному из двух значений: integer или float.

• remove - удалить этот вариант ответа.

  Для удаления варианта ответа в качестве значения следует передать 1 или любое значение, отличное от 0 и пустой строки.

  При указании этого атрибута, атрибут id является обязательным.

  Для удаления вариантов ответа требуется привилегия vote.variant.remove.*

  Пример удаления варианта ответа:

  <variant id="123" remove="1" />           

param

Определяет параметры, действующие локально для этого варианта ответа.

Этот тег не является обязательным.

Эти параметры наследуют параметры вопроса, которому принадлежит этот вариант ответа.

Этот тег допустим только внутри тега variant.

Внутри этого тега не могут содержаться другие теги.

У этого тега нет разрешённых атрибутов.

title

Определяет заголовок варианта ответа.

Этот тег не является обязательным.

Этот тег допустим только внутри тега variant.

Внутри этого тега не могут содержаться другие теги.

У этого тега разрешены следующие атрибуты:

• lang - код языка, в котором записан заголовок.

  В качестве значения передаётся код одного из зарегистрированных в системе языков.

  При генерации XML-текста в качестве значения подставляется код того языка, в котором записан заголовок.

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

comment

Определяет комментарий варианта ответа.

Этот тег не является обязательным.

Этот тег допустим только внутри тега variant.

Внутри этого тега не могут содержаться другие теги.

У этого тега разрешены следующие атрибуты:

• lang - код языка, в котором записан комментарий.

  В качестве значения передаётся код одного из зарегистрированных в системе языков.

  При генерации XML-текста в качестве значения подставляется код того языка, в котором записан комментарий.

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

open

Правильный ответ для открытого вопроса.

Этот тег не является обязательным.

Этот тег допустим только внутри тега variant.

Внутри этого тега не могут содержаться другие теги.

У этого тега разрешены следующие атрибуты:

• lang - код языка, в котором записан комментарий.

  В качестве значения передаётся код одного из зарегистрированных в системе языков.

  При генерации XML-текста в качестве значения подставляется код того языка, в котором записан правильный вариант ответа.

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

Пример описания одного варианта ответа

Последняя модификация: 15.02.07 01:20

Не проходите мимо! Оставьте Ваш комментарий в форуме! >>>