Subversion Repositories wimsdev

Rev

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