Subversion Repositories wimsdev

!set namelist=Basic types, Specific or advanced types

!set namelist=Basic types, Specific or advanced types

!set symtextlist=text atext raw compose

!set symtextlist=text atext raw compose

There are two basic ways in which an OEF exercise accepts user replies:

There are two basic ways in which an OEF exercise accepts user replies:

multiple choices and freestyle replies. User answers will be analyzed

multiple choices and freestyle replies. User answers will be analyzed

according to the nature of the types. It is also possible to show

according to the nature of the types. It is also possible to show

!href cmd=help&special_parm=feedback feedbacks

!href cmd=help&special_parm=feedback feedbacks

 to the user when the answer meeds a specified condition (usually to warn a

 to the user when the answer meeds a specified condition (usually to warn a

typical error).

typical error).

A multiple choice is defined by giving a list of good choices (one or

A multiple choice is defined by giving a list of good choices (one or

several) and another list of bad choices. <p>

several) and another list of bad choices. <p>

Up to $choicelim simultaneous multiple choice questions can be asked for

Up to $choicelim simultaneous multiple choice questions can be asked for

one exercise, under the current implementation. The number of good and bad

one exercise, under the current implementation. The number of good and bad

choices within one multiple choice question is unlimited (except a limit on

choices within one multiple choice question is unlimited (except a limit on

See

See

!href cmd=help&special_parm=oef help on OEF format

!href cmd=help&special_parm=oef help on OEF format

 for the syntax to define a multiple choice.

 for the syntax to define a multiple choice.

<a id="freestyle"></a>

<a id="freestyle"></a>

A freestyle answer is one which is typed by the user.

A freestyle answer is one which is typed by the user.

Up to $answerlim simultaneous freestyle answers can be asked for one

Up to $answerlim simultaneous freestyle answers can be asked for one

exercise, under the current implementation. <p>

exercise, under the current implementation. <p>

The syntax is as follows:

The syntax is as follows:

<pre>

<pre>

\answer{Texte}{\reponse}{type=...}{option=...}{weight=...}

\answer{Texte}{\reponse}{type=...}{option=...}{weight=...}

</pre>

</pre>

(The last 3 fields are optional.)

(The last 3 fields are optional.)

<p>

<p>

Each freestyle answer can independently take one of the following types.

Each freestyle answer can independently take one of the following types.

!for i=1 to 2

!for i=1 to 2

 !set n=!linecnt $(typelist$i)

 !set n=!linecnt $(typelist$i)

 <ul>

 <ul>

 !for j=1 to $n

 !for j=1 to $n

  !set l=!line $j of $(typelist$i)

  !set l=!line $j of $(typelist$i)

  !distribute item $l into name,title

  !distribute item $l into name,title

  !set name=!replace internal | by , in $name

  !set name=!replace internal | by , in $name

  !set name1=!item 2 to -1 of $name

  !set name1=!item 2 to -1 of $name

  !set name=!item 1 of $name

  !set name=!item 1 of $name

  !default name1=$name

  !default name1=$name

  !if $name isitemof $special_parm or all isitemof $special_parm

  !if $name isitemof $special_parm or all isitemof $special_parm

   !read help/anstype/$name.phtml

   !read help/anstype/$name.phtml

   !if $name iswordof $symtextlist

   !if $name iswordof $symtextlist

    <p>

    <p>

    <b>Remark</b>.

    <b>Remark</b>.

    This type of reply accepts the symtext option. If the word

    This type of reply accepts the symtext option. If the word

    <span class="tt wims_code_words">symtext</span> is declared in the option of the reply, the analysis of

    <span class="tt wims_code_words">symtext</span> is declared in the option of the reply, the analysis of

    the reply will be exactly as for

    the reply will be exactly as for

    !href cmd=help&special_parm=reply,symtext#_symtext symtext

    !href cmd=help&special_parm=reply,symtext#_symtext symtext

, in particular with no preliminary processing of the texts. And all the

, in particular with no preliminary processing of the texts. And all the

symtext options will be understood in this case.

symtext options will be understood in this case.

   !endif

   !endif

  !else

  !else

   !href cmd=help&special_parm=reply,$name#_$name $title

   !href cmd=help&special_parm=reply,$name#_$name $title

   (<span class="tt wims_code_words">$name1</span>) $desc.

   (<span class="tt wims_code_words">$name1</span>) $desc.

  !endif

  !endif

 !next j

 !next j

 </ul>

 </ul>

!next i

!next i

!read help/$lang/embedans.phtml

!read help/$lang/embedans.phtml

<a id="weight"></a>

<a id="weight"></a>

It is possible to give a weight to answers.

It is possible to give a weight to answers.

<p>

<p>

Example :

Example :

<pre>\answer{}{1}{type=numeric}{weight=8}

<pre>\answer{}{1}{type=numeric}{weight=8}

\answer{}{1}{type=numeric}{weight=2}

\answer{}{1}{type=numeric}{weight=2}

</pre>

</pre>

Le niveau de sévérité  sera aussi pris en compte lors du

Le niveau de sévérité  sera aussi pris en compte lors du

calcul fait et le pourcentage sera pris sur un pourcentage fixé

calcul fait et le pourcentage sera pris sur un pourcentage fixé

par le niveau de sévérité.

par le niveau de sévérité.

One can put variables in <span class="tt wims_code_words">weight</span>

One can put variables in <span class="tt wims_code_words">weight</span>

if they are defined before <span class="tt wims_code_variable">\statement</span>.

if they are defined before <span class="tt wims_code_variable">\statement</span>.

<p>

<p>

Example :

Example :

<pre>

<pre>

\text{w = \t = 1 ? 1 : 2}

\text{w = \t = 1 ? 1 : 2}

\answer{}{1}{type=numeric}{weight=\w}

\answer{}{1}{type=numeric}{weight=\w}

\answer{}{1}{type=numeric}{weight=3}

\answer{}{1}{type=numeric}{weight=3}

</pre>

</pre>

 <a id="option"></a>

 <a id="option"></a>

 Dans le cas de plusieurs options, elles sont séparées par des espaces.

 Dans le cas de plusieurs options, elles sont séparées par des espaces.

 For example, <span class="tt wims_code_words">option=default noanalyzeprint</span>

 For example, <span class="tt wims_code_words">option=default noanalyzeprint</span>

Les options possibles à la suite d'une instruction <span class="tt wims_code_variable">answer</span>

Les options possibles à la suite d'une instruction <span class="tt wims_code_variable">answer</span>

<ul>

<ul>

<li><span class="tt wims_code_words">option=default</span> : The option <span class="tt wims_code_words">default</span> is common for all free answers :

<li><span class="tt wims_code_words">option=default</span> : The option <span class="tt wims_code_words">default</span> is common for all free answers :

This option can take

This option can take

the form <span class="tt wims_code_words">default="default_value"</span>. If the

the form <span class="tt wims_code_words">default="default_value"</span>. If the

user gives an empty reply, it is the default_value that will take place.

user gives an empty reply, it is the default_value that will take place.

<li>

<li>

<span class="tt wims_code_words">option=split</span> : In case of type <span class="tt wims_code_words">correspond</span>, <span class="tt wims_code_words">checkbox</span> or <span class="tt wims_code_words">mark</span>,

<span class="tt wims_code_words">option=split</span> : In case of type <span class="tt wims_code_words">correspond</span>, <span class="tt wims_code_words">checkbox</span> or <span class="tt wims_code_words">mark</span>,

there will be partial score.

there will be partial score.

</li>

</li>

<li>

<li>

<span class="tt wims_code_words">option=hide</span> :The condition is used to analyze the

<span class="tt wims_code_words">option=hide</span> :The condition is used to analyze the

answer but will not be printed.

answer but will not be printed.

</li>

</li>

</ul>

</ul>

D'autres options peuvent être utilisables dans des types particuliers de réponses.

D'autres options peuvent être utilisables dans des types particuliers de réponses.

Under certain circumstances, it is desired that freestyle answers be tested

Under certain circumstances, it is desired that freestyle answers be tested

by special conditions (questions with multiple good answers, exercises

by special conditions (questions with multiple good answers, exercises

asking for examples, answers determined by inequalities, etc). This can be

asking for examples, answers determined by inequalities, etc). This can be

done in the following way. <p>

done in the following way. <p>

If the good answer to a freestyle question is an undefined variable, the

If the good answer to a freestyle question is an undefined variable, the

answer to this question will be fed into this variable. The latter can then

answer to this question will be fed into this variable. The latter can then

be used to implement testing conditions. The score given to the exercise is

be used to implement testing conditions. The score given to the exercise is

then determined by the number of testing conditions which are met, rather

then determined by the number of testing conditions which are met, rather

than the number of answers which meet the good answers.

than the number of answers which meet the good answers.

Up to $condlim simultaneous conditions can be defined for one

Up to $condlim simultaneous conditions can be defined for one

exercise, under the current implementation. The syntax is as follows.

exercise, under the current implementation. The syntax is as follows.

\condition{prompt text}{testing conditions}{weight=...}

\condition{prompt text}{testing conditions}{weight=...}

</pre>

</pre>

(The last field is optional.)

(The last field is optional.)

Here are some examples of testing conditions. (<span class="tt wims_code_variable">ans1</span> and

Here are some examples of testing conditions. (<span class="tt wims_code_variable">ans1</span> and

<span class="tt wims_code_variable">ans2</span> are undefined variables appearing in freestyle answers, as

<span class="tt wims_code_variable">ans2</span> are undefined variables appearing in freestyle answers, as

described above.)

described above.)

!href target=wims_mhelp cmd=help&special_parm=if Complete list of relations

!href target=wims_mhelp cmd=help&special_parm=if Complete list of relations

$table_header

$table_header

$table_hdtr<th>Condition</th><th>meaning</th></tr>

$table_hdtr<th>Condition</th><th>meaning</th></tr>

$table_tr<td><tt class="wims_code_variable">ans1>=0 and \ans1<=1</tt></td>

$table_tr<td><tt class="wims_code_variable">ans1>=0 and \ans1<=1</tt></td>

    <td>Good if <span class="tt wims_code_words">ans1</span> is within the interval [0,1].</td></tr>

    <td>Good if <span class="tt wims_code_words">ans1</span> is within the interval [0,1].</td></tr>

    <td>Good if <span class="tt wims_code_words">ans1</span> is 1, 3 or 5.</td></tr>

    <td>Good if <span class="tt wims_code_words">ans1</span> is 1, 3 or 5.</td></tr>

    <td>Good if <span class="tt wims_code_words">ans1</span> and <span class="tt wims_code_words">ans2</span> are the two

    <td>Good if <span class="tt wims_code_words">ans1</span> and <span class="tt wims_code_words">ans2</span> are the two

    roots of the polynomial x<sup>2</sup>-5x+6.</td></tr>

    roots of the polynomial x<sup>2</sup>-5x+6.</td></tr>

    <td>Good if <span class="tt wims_code_words">ans1</span> is a multiple of $m_pi.</td></tr>

    <td>Good if <span class="tt wims_code_words">ans1</span> is a multiple of $m_pi.</td></tr>

See

See

!href cmd=help&special_parm=oef help on oef format

!href cmd=help&special_parm=oef help on oef format

 for the syntax for defining replies.

 for the syntax for defining replies.