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">>aaaammjj.hh:mm</span> |
10602 | reyssat | 102 | allows to specify a start time ;</li> |
12664 | bpr | 103 | <li><span class="tt wims_code_words"><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"><20131007.10:30 >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=<20131007.10:30 >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 |