Subversion Repositories wimsdev

Rev

Rev 13838 | Rev 14555 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
3453 bpr 1
!if $wims_read_parm!=$empty
2
 !goto $wims_read_parm
3
!endif
2210 bpr 4
 
8690 bpr 5
:general
10602 reyssat 6
<h2 id="general">Introduction</h2>
8690 bpr 7
 
10602 reyssat 8
<p>
9
A sheet allows to propose to students a list of WIMS exercises.
10
The student activity can then be scored and monitored.
11
</p>
12
 
13
To construct the sheets of the class, one may
14
<ul><li>
15
import sheets found through the search engine (click on
16
the title of the sheet then on the link
17
<span class="tt wims_code_words">$wims_name_import</span>)
18
and change it if necessary
19
</li><li>
20
create a new sheet using the link
21
<span class="tt wims_code_words">$wims_name_add_sheet</span>
22
then build the content of the sheet by inserting one by one
12664 bpr 23
the exercises found from the search engine or from the classe
10602 reyssat 24
exercises (the link
25
<span class = "tt wims_code_words"> $wims_name_add_sheet </span>
26
is visible when you go to work with the selected exercise)
27
or insert a source file from a list of exercises found for instance
28
in a wims document.
29
</li></ul>
30
The sheets are numbered in the order of creation / integration in the class.
31
It is possible to rearrange the layout sheets for students using
32
the link <span class="tt wims_code_words">$wims_name_reorder</span>.
33
 
8690 bpr 34
!if $wims_read_parm!=$empty
35
 !exit
36
!endif
37
 
38
:statut
10602 reyssat 39
<h2 id="statut">Status of a worksheet</h2>
13838 bpr 40
There are four possible values for a sheet status:
10602 reyssat 41
<span class="wims_emph">
42
!replace internal , by ,$ $ in $(wims_name_shstatus).
43
</span>
44
<p>
45
<span class="wims_emph">$(wims_name_shstatus[1]) :</span>
46
This is the initial status of a sheet. In this status, the sheet is not
47
visible by the participants.
48
</p><p>
49
<span class="wims_emph">$(wims_name_shstatus[2]) :</span>
50
when we click on
51
<span class="tt wims_code_words">$(wims_name_actionlist[1])</span>,
12664 bpr 52
the sheet becomes visible by the participants
10602 reyssat 53
(they can work on the exercises if no parameter in the field
54
<span class="tt wims_code_words">$(name_shinfo[6])</span>
55
prevents it), its content
56
is no longer editable except the titles and explanatory texts of the sheet and
57
exercises, the field
12664 bpr 58
<span class="tt wims_code_words">$(name_shinfo[6])</span>
10602 reyssat 59
as well as the fields
60
<span class="tt wims_code_words">$wims_name_feedbackexo</span> of the exercises.
61
</p><p>
62
From the status
63
<span class="tt wims_code_words">$(wims_name_shstatus[2])</span>,
64
the sheet may be changed to the status
65
<span class="tt wims_code_words">$(wims_name_shstatus[3])</span>
66
by clicking on the button
67
 <span class="tt wims_code_words">$(wims_name_actionlist[2])</span>.
68
It's not possible to return to the status
69
<span class="tt wims_code_words">$(wims_name_shstatus[1])</span>.
70
</p><p>
71
<span class="wims_emph">$(wims_name_shstatus[3]) :</span>
72
the participant can work on the sheet but his work is not accounted for.
73
</p><p>
74
Once the sheet is expired, it can be made invisible to students by clicking
75
<span class="tt wims_code_words">$(wims_name_actionlist[4])</span>,
76
but its status can also be turned to
77
<span class="tt wims_code_words">$(wims_name_shstatus[2])</span>.
78
 </p>
79
!if $wims_read_parm!=$empty
80
 !exit
81
!endif
8690 bpr 82
 
2210 bpr 83
:dependancies
8690 bpr 84
<h2 id="dependancies">$(name_shtab[6])</h2>
85
<p>
10602 reyssat 86
It means that a participant must get
3921 bpr 87
  required scores in other exercises of the worksheet before he/she can do
7402 bpr 88
  this one. For example,
5901 bpr 89
  <span class="tt wims_code_words">1:50,2:30,3+4+5:60</span>
2210 bpr 90
  means that the
91
  participant must get 50% success on exercise 1, 30% success on exercise 2,
92
  and an average of 60% success on exercises 3, 4, 5.
93
 
8690 bpr 94
</p>
4044 bpr 95
 
3453 bpr 96
!if $wims_read_parm!=$empty
97
 !exit
98
!endif
2210 bpr 99
 
100
:allowtype
10602 reyssat 101
!! !read adm/title.phtml 1\
102
!! Score registration
103
<h2 id="allowtype">Information about score registration.</h2>
2210 bpr 104
 
12664 bpr 105
You can impose a restriction, for instance about time, on score
10602 reyssat 106
recording. Several options are available:
107
<ul>
12664 bpr 108
 <li><span class="tt wims_code_words">$(name_allowtype[1])</span> :
10602 reyssat 109
the scores will be recorded.</li>
12664 bpr 110
 <li><span class="tt wims_code_words">$(name_allowtype[2])</span> :
10602 reyssat 111
no score will be recorded.</li>
12664 bpr 112
 <li><span class="tt wims_code_words">$(name_allowtype[3])</span> :
113
an input field,
114
<span class="tt wims_code_words">$(name_shinfo[6])</span>,
10602 reyssat 115
appears and you can specify a time range and the
116
IP addresses from which the scores will be recorded.
117
This restriction is written using three expressions (which are optional):
118
<br/>
119
 <ul>
12664 bpr 120
  <li><span class="tt wims_code_words">&gt;aaaammjj.hh:mm</span>
10602 reyssat 121
allows to specify a start time ;</li>
12664 bpr 122
  <li><span class="tt wims_code_words">&lt;aaaammjj.hh:mm</span>
10602 reyssat 123
allows to specify an end time ;</li>
12664 bpr 124
  <li><span class="tt wims_code_words">192.168. </span>
10602 reyssat 125
which lets you specify an IP range ;</li>
126
 </ul>
12664 bpr 127
The dates and times must be in the SERVER local time and these
10602 reyssat 128
three expressions must be separated from each other by spaces.
129
 <p>
130
Example :
131
<span class="tt wims_code_words">&lt;20131007.10:30 &gt;20131001.10:00 127.0.</span>
12664 bpr 132
allows the recording of notes between two dates and only for IP
10602 reyssat 133
numbers beginning with
134
 <span class="tt wims_code_words">127.0</span>.
135
</p>
136
</li>
3947 bpr 137
 
12664 bpr 138
<li><span class="tt wims_code_words">$(name_allowtype[4])</span> :
10602 reyssat 139
this option may be chosen to individualize access restrictions using a
140
<span class="tt wims_code_words">technical variable</span>
12664 bpr 141
 (this technique variable is defined for each participant either
142
manually using the technical variables management module or using
143
a <span class="tt wims_code_words">$wims_name_Vote</span>).
10602 reyssat 144
When choosing this option, a menu allows you to select the technical
12664 bpr 145
variable used as a differentiation criterion and a table allows
146
the setting of the filter (using the same format as above)
10602 reyssat 147
for each possible value of the variable.
148
<br/>
12664 bpr 149
In the case of a technical variable defined using the model
150
<span class="tt wims_code_words"> individualized access</span>
151
of a  <span class="tt wims_code_words">$wims_name_Vote</span>
10602 reyssat 152
specific to the time slot reservation creation,
153
the table is pre-filled with the data proposed in the
154
  creation of the vote. These data can be modified,
155
but the changes are not reflected on the vote.
156
</li>
157
</ul>
158
!if $tv_listtechvar!=$empty
159
 the technical variables currently available in your class are:
12664 bpr 160
 !read adm/vfilter/listvar.phtml
10602 reyssat 161
!else
12664 bpr 162
 There is no technical variable currently defined in your class.
10602 reyssat 163
To use this option, you should first define a technical variable.
164
!endif
165
!if $wims_read_parm!=$empty
166
 !exit
167
!endif
3947 bpr 168
 
10602 reyssat 169
:variable
170
<p>
12664 bpr 171
In order to individualize the access restrictions, it is possible
10602 reyssat 172
to put a variable (in the example below, write
173
<span class="tt wims_code_words">\timelimit</span>).
174
This variable must be defined for each participant according
175
the previous rules, or manually in the properties of
176
a participant's account (technical variable).
177
</p><p>
178
Example : write
179
<span class="tt wims_code_words">timelimit=&lt;20131007.10:30 &gt;20131001.10:00</span>
12664 bpr 180
in the "Technical variable" input field of the properties account
10602 reyssat 181
of a student.
182
For participants for which this variable is empty,
183
the score recording is closed.
184
</p><p>
185
You can add this variable using the spreadsheet link.
12664 bpr 186
If the restriction is choosen by a participant (registration by
10602 reyssat 187
certain dates for example), it is possible to create and use a vote
188
in guided mode (See corresponding help).
189
</p>
8690 bpr 190
!if $wims_read_parm!=$empty
191
 !exit
192
!endif
4528 bpr 193
 
194
:feedback
10602 reyssat 195
<h2 id="feedback">$(name_shtab[10])</h2>
4528 bpr 196
 
12664 bpr 197
You can provide in this field a link to a WIMS document
10602 reyssat 198
or exercise. The link to this resource appears when the score is
199
strictly less than a preset note (out of 10).
12664 bpr 200
The second item is the limit rating (out of 10), the first item is
10602 reyssat 201
the address as follows (abbreviated):
202
<ul><li>
12664 bpr 203
Exercise from a public module or document  :
10602 reyssat 204
<span class="tt wims_address">module=xxx</span>
205
(as in <span class="wims_button disabled">$wims_name_about</span>).
206
</li><li>
12664 bpr 207
Exercise in the class :
10602 reyssat 208
<span class="tt wims_address">module=classes/fr&exo=_file_name_</span>
12664 bpr 209
where <span class="tt">_file_name_</span>
10602 reyssat 210
is the file name of the exercise
211
(without the extension <span class="tt">.oef</span>).
212
</li><li>
213
Document in the class  :
214
<span class="tt wims_address">module=adm/doc&doc=c1&+block=_block_name_</span>
215
</li></ul>
7402 bpr 216
 
10602 reyssat 217
Additonal parameters may be added (see
218
<span class="wims_button disabled">$wims_name_about</span>).
219
 
12664 bpr 220
For instance, in the example below, if the score is less than 5,
221
the student will be led to the document
10602 reyssat 222
<span class="tt">c2</span> of the class, more specifically
223
on the page corresponding to the block
224
<span class="tt">aaa</span> of this document.
225
 
226
<pre>module=adm/doc&doc=c2&+block=aaa,5</pre>
227
 
228
In the example below, there will be a
12664 bpr 229
link to an exercise of the module H6/set/oefset.fr whose source is
10602 reyssat 230
named traduction1 (the score of the student on this exercise
231
will not be recorded in the class).
232
 
233
<pre>module=H6/set/oefset.fr&cmd=new&exo=traduction1,10</pre>
234
 
235
By writing two numbers (the second of which is positive), the button
236
appears when the score is between the second number
237
and the first number: for example, if you put
238
<pre>module=H6/set/oefset.fr&cmd=new&exo=traduction1,11,10</pre>
12664 bpr 239
the button appears when the score is 10 and the word
10602 reyssat 240
$wims_name_feedbackplus
12664 bpr 241
is writen. If the second number is 0, the behavior is the same as
10602 reyssat 242
if it did not exist.
243
 
12664 bpr 244
You can also insert a help link in the sheet by first selecting a
10602 reyssat 245
WIMS resource and following the link
246
<span  class="wims_button disabled">$wims_name_addh</span>
247
 in the left menu.
248
 
249
!!if $wims_read_parm!=$empty
12664 bpr 250
!exit
10602 reyssat 251
!!endif
252
 
7402 bpr 253
:series
10602 reyssat 254
<p>
255
In general, the exercises of a series are randomly chosen
256
and at least one exercise for each type is proposed if the requested
257
number allows it.
258
</p><p>
259
You asked in the expert setting for a non random order,
260
you can change here the order of exercises in a series.
261
</p>
12703 bpr 262
!exit
12664 bpr 263
 
13192 bpr 264
:score
265
!changeto adm/lang/help.score.en
266
 
267
:exotrymax
13838 bpr 268
<h2 id="exotrymax">Maximal number of attempts</h2>
269
This parameter defines a maximal number <span class="tt">n</span>
270
of attempts to be used in the calculation of grades when score recording is open on the sheet.
271
<p>
272
If you do not want to set a maximum value, leave this field empty.
273
</p>
274
<p>
275
<strong>Attempt or try</strong>: working on a series of exercices counts
276
as an attempt whether or not an answer is supplied
277
and whether or not score recording is enabled.
278
</p>
279
If a postive number <span class="tt">n</span> is supplied
280
<ul><li>
281
one still may work on the exercise after this number is attained;
282
</li><li>
283
the attempt counter is incremented only when score recording is open on the sheet by the teacher.
284
</li><li>
285
the grade calculation uses only the scores for the <span class="tt">n</span>
286
first attempts with score recording activated. Therefore, the required point number for the exercice
287
cannot exceed <span class="tt">10 x n,</span> as this is the maximum number of points
288
a participant might obtain for the exercice.
289
</li></ul>
13192 bpr 290
!exit
291
 
12703 bpr 292
:weight
13838 bpr 293
!read lang/help.phtml.en weight
12763 bpr 294
!exit
12703 bpr 295
 
12763 bpr 296
:weightexo
13838 bpr 297
!set wims_backslash_insmath=yes
298
<h2 id="weightexo">Weight of an exercise in the sheet</h2>
299
The weight of an exercise in the sheet is used in the calculation of three work
300
estimators on a sheet
301
 - <span class="wims_code_variable">$(wims_name_thsheet[5]),
302
$(wims_name_thsheet[10]), $(wims_name_thsheet[13])</span>
303
and in the calculation of the score <span class="wims_code_variable">$(wims_name_thsheet[7])</span> de la feuille.
304
<ul><li> The value of the indicator <span class="wims_code_variable">$(wims_name_thsheet[5])</span>
305
is the weighted arithmetic mean of the scores from the exercises of the sheet,
306
each weight being the product of the weight
307
of the exercise in the sheet by the required points number.
308
A similar rule is used to compute the value of
309
<span class="wims_code_variable">$(wims_name_thsheet[10])</span>
310
and <span class="wims_code_variable">$(wims_name_thsheet[13])</span>.
311
</li><li> The grade <span class="wims_code_variable">$(wims_name_thsheet[7])</span>
312
 on the sheet is a weighted mean of the quality note obtained for each exercise,
313
 the weight being the product of the the weight of the exercise in the sheet by the
314
 the running total estimator on the exercise.
315
</li></ul>
316
<p>
317
A value of 0 means you do not want the scores from this exercise to be used.
318
</p>
319
Example: This spreadsheet shows the results for a student on a sheet with 3 exercises:
320
$table_header
321
  <thead>
322
  $table_hdtr
323
    <th scope="col" data-sort-method="number">$(wims_name_thsheet[1])</th>
324
    <th scope="col">$(wims_name_thsheet[2])</th>
325
    <th scope="col" data-sort-method="number">$(wims_name_thsheet[3])</th>
326
    <th scope="col" data-sort-method="number">$(wims_name_thsheet[4])</th>
327
  !!qualite
328
    <th scope="col" data-sort-method="number">$(wims_name_thsheet[7])</th>
329
    <th scope="col" data-sort-method="number">$(wims_name_thsheet[5])</th>
330
  </tr>
331
  </thead>
332
  <tbody>
333
<tr><td> 1 </td><td>Exo 1</td><td>20</td><td>2</td><td>5.5</td><td>60%</td></tr>
334
<tr><td> 2 </td><td>Exo 2</td><td>10</td><td>3</td><td>6.5</td><td>25%</td></tr>
335
<tr><td> 3 </td><td>Exo 3</td><td>10</td><td>0</td><td>8.5</td><td>100%</td></tr>
336
  </tbody>
337
$table_end
338
<ul><li>
339
The score $(wims_name_thsheet[5]) on the sheet is
340
\(\frac{2\times 20 \times 60 + 3 \times 10 \times 80 + 0}{2\times 20 + 3 \times 10}\% = 68.57\%\)
341
</li><li>
342
The score $(wims_name_thsheet[7]) on the sheet is
343
\(\frac{2\times 60 \times 5.5 + 3 \times 80 \times 6.5 + 0}{2\times 60 + 3 \times 80} = 6.17\)
344
</li></ul>
345
!if $wims_read_parm!=$empty
346
  !exit
14042 guerimand 347
!endif
12763 bpr 348
 
13826 bpr 349
:exodescshow
13838 bpr 350
If you check <span class="tt">$wims_name_yes</span>, the exercise description
351
will appear in the exercise header, not only in the list of the exercise in the sheet
352
!if $wims_read_parm!=$empty
353
  !exit
14042 guerimand 354
!endif