Marown/swad-core
Marown
/
swad-core
mirror of https://github.com/acanas/swad-core.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Removed edition of questions

Antonio Cañas Vargas 2020-05-18 17:07:19 +02:00
parent fa7bb6eb27
commit e5a91d4fb5
1 changed files with 5 additions and 186 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

191
ASSESSMENT.Tests.en.md

@ -37,198 +37,17 @@ For the types of answers T / F, single choice and multiple choice, the rating ca
## Results
If you are a student, click on **Results** link, then choose a range of dates, and click on **View test results** button. A list will appear with the exams you did in that range of dates. You can see the results and details of each of the exams by clicking on **View test** icon (at the right of the row).
If you are a student, click on _Results_ icon (trophy), then choose a range of dates, and click on **View test results** button. A list will appear with the exams you did in that range of dates. You can see the results and details of each of the exams by clicking on **View test** icon (at the right of the row).
If you are a teacher, click on **Results** link, then select the students whose tests you want to see, choose a range of dates, and click on **View test results** button. A list will appear with all exams made in that range of dates. You can examine the results and details of those exams that the students have marked with _Allow teachers to consult this exam_ by clicking on **View test** icon (at the right of the row).
# Editing questions
## Editing questions previously written
By clicking on _Edit_ icon (pencil) on the top left corner of the box, a form appears in which the teacher chooses what questions he/she wants to edit. The form allows you to choose the tags included in the questions, the types of answers and a range of dates in which they were published.
By clicking on "Show questions" button, a list of questions to be edited appears. The teacher can **remove** or **re-edit** (change) any of the questions from the list by clicking on the corresponding icons. In the case of unique or multiple choice answer, you are also allowed to choose whether to **shuffle** the order of the answers.
By default, the questions are listed in alphabetical order by the stem. They can also be sorted by the number of times they have been answered, and by the mean score. The latter criterion allows the teacher to identify the difficulty of the questions or possible errors in the stem or the answers. For the average score, SWAD stored for each question the total score and the number of times it has been answered.
## Writing a question
By clicking on _New question_ icon (plus sign) on the top left corner of the box or _Edit_ icon (pencil) on an existing question, a new form appears to edit the question.
At the top left of the form you can be select up to five **tags** or descriptors for the question from all the tags that have been written previously on other questions. At the top right new tags may be introduced if not written yet.
Underneath these tags, the **stem** or wording of the question is written.
Under the heading you can select one of the following **types of answers**:
* Integer number
* Real number
* True / False
* Unique choice among several options
* Multiple choice among several options
* Text
Finally the **answers** must be written.
* For an integer type answer you must indicate the correct number.
* For a real type answer you must specify the correct closed interval. For example, if you ask for the value of Pi, [3,140 ... 3,142] could be established as valid range interval. The real numbers can be entered with dots or commas and using exponential notation is allowed.
* In the case of a true / false answer, the correct answer must be chosen.
* In the case of unique or multiple choice answer, you can write from 2 to 10 possible answers and indicate which one or ones are right by the markings on the left of the answers, and you can indicate whether the order of the answers will be shuffled.
* If the answer is text, you should write one or more possible correct answers considering that SWAD is not sensitive to the use of upper / lower case. For example, if the question requests the author of the Theory of General Relativity you can provide the answers "Albert Einstein" or "Einstein" as valid.
For the stem and any of the unique choice, multiple choice or text answers, you can add a **feedback text**. As in other options, it is also possible to incorporate [**multimedia content**](Multimedia.en).
When the form is submitted by clicking on the **Create question** button, a confirmation is obtained. In the confirmation screen you can remove or re-edit the newly written question. In the case of unique or multiple choice answer you are also allowed to choose whether you want SWAD shuffle the order of random answers.
## Exporting / importing test questions
When the teacher is editing one or more questions, he/she can export them to an [XML](https://en.wikipedia.org/wiki/XML) file by clicking on the _Export questions_ link. To import questions from an XML file, he/she can click on the _Import questions_ link. This allows the teacher to copy questions from one course to another. Currently the images associated with the stem and the answers can not be exported or imported.
**Important note**: In the future SWAD will use UTF-8 encoding, but it currently uses Windows-1252 encoding. If you manually edit the XML file in a text editor, you need to save it in Windows-1252 or ISO-8859-1 format.
The following is an example of XML file with multiple questions:
```
<?xml version="1.0" encoding="windows-1252"?>
<test>
<question type="uniqueChoice">
<tags>
<tag>Viajes espaciales</tag>
</tags>
<stem>&#191;Cuál de los siguientes módulos lunares no alunizó?</stem>
<feedback>Todas las respuestas corresponden a módulos que alunizaron en las misiones Apolo 11 a Apolo 17, excepto el módulo Aquarius, de la misión Apolo 13, que no alunizó.</feedback>
<answer shuffle="yes">
<option correct="no">
<text>Eagle</text>
<feedback>Incorrecto. El Eagle alunizó en la misión Apolo 11.</feedback>
</option>
<option correct="no">
<text>Intrepid</text>
<feedback>Incorrecto. El Intrepid alunizó en la misión Apolo 12.</feedback>
</option>
<option correct="yes">
<text>Aquarius</text>
<feedback>Correcto. El Aquarius era el módulo de mando de la misión Apolo 13, que no alunizó.</feedback>
</option>
<option correct="no">
<text>Antares</text>
<feedback>Incorrecto. El Antares alunizó en la misión Apolo 14.</feedback>
</option>
<option correct="no">
<text>Falcon</text>
<feedback>Incorrecto. El Falcon alunizó en la misión Apolo 15.</feedback>
</option>
<option correct="no">
<text>Orion</text>
<feedback>Incorrecto. El Orion alunizó en la misión Apolo 16.</feedback>
</option>
<option correct="no">
<text>Challenger</text>
<feedback>Incorrecto. El Challenger alunizó en la misión Apolo 17.</feedback>
</option>
</answer>
</question>
<question type="text">
<tags>
<tag>Cultura general sobre astronomía</tag>
<tag>Viajes espaciales</tag>
</tags>
<stem>&#191;Cuál es el nombre de la primera misión espacial tripulada que alunizó con éxito?</stem>
<feedback>El Apolo 11 fue la primera misión tripulada en llegar a la superficie de la Luna. La tripulación del Apolo 11 estaba compuesta por el comandante de la misión Neil A. Armstrong; Edwin E. Aldrin Jr., piloto del LEM, apodado Buzz; y Michael Collins, piloto del módulo de mando. El comandante Neil Armstrong fue el primer ser humano que pisó la superficie de la Luna el 21 de julio de 1969 a las 2:56 &#40;hora internacional UTC&#41; al sur del Mar de la Tranquilidad, seis horas y media después de haber alunizado.</feedback>
<answer>
<option>
<text>Apolo 11</text>
<feedback>En español y números arábigos</feedback>
</option>
<option>
<text>Apolo XI</text>
<feedback>En español y números romanos</feedback>
</option>
<option>
<text>Apollo 11</text>
<feedback>En inglés y números arábigos</feedback>
</option>
<option>
<text>Apollo XI</text>
<feedback>En inglés y números romanos</feedback>
</option>
</answer>
</question>
<question type="multipleChoice">
<tags>
<tag>Viajes espaciales</tag>
</tags>
<stem>&#191;Cuáles de los siguientes astronautas pisaron la Luna?</stem>
<feedback>De los cuatro, Armstrong y Aldrin pisaron la Luna en la misión Apolo 11.
Collins se quedó en el módulo de mando de la misma misión Apolo 11, orbitando la Luna. Lovell fue el comandante de la misión Apolo 13, que no llegó a alunizar.</feedback>
<answer shuffle="yes">
<option correct="yes">
<text>Neil A. Armstrong</text>
<feedback>Neil Alden Armstrong fue el primer ser humano en pisar la Luna el 21 de julio de 1969, en la misión Apolo 11.</feedback>
</option>
<option correct="yes">
<text>Edwin E. Aldrin</text>
<feedback>Buzz Aldrin fue la segunda persona en pisar la Luna en la misión Apolo 11.</feedback>
</option>
<option correct="no">
<text>Michael Collins</text>
<feedback>En julio de 1969, Collins, como miembro de la misión lunar Apolo 11, pilotó el módulo de mando &#34;Columbia&#34;, mientras Neil Armstrong y Edwin E. Aldrin realizaban el primer alunizaje.</feedback>
</option>
<option correct="no">
<text>James A. Lovell</text>
<feedback>James Arthur Lovell fue el comandante que trajo de vuelta a salvo a la averiada nave Apolo 13.</feedback>
</option>
</answer>
</question>
<question type="int">
<tags>
<tag>Cultura general sobre astronomía</tag>
<tag>Viajes espaciales</tag>
</tags>
<stem>&#191;Cuántos hombres han pisado la Luna?</stem>
<feedback>12 hombres han pisado la Luna, 2 en cada una de las 6 misiones Apolo de la NASA que alunizaron con éxito:
Apolo 11: Neil Armstrong &#40;1&#186;&#41; y Edwin E. Aldrin &#40;2&#186;&#41;
Apolo 12: Charles Conrad &#40;3&#186;&#41; y Alan L. Bean &#40;4&#186;&#41;
Apolo 14: Alan B. Shephard &#40;4&#186;&#41; y Edgar Mitchell &#40;6&#186;&#41;
Apolo 15: David Scott &#40;7&#186;&#41; y James B. Irwin &#40;8&#186;&#41;
Apolo 16: John Young &#40;9&#186;&#41; y Charles Duke &#40;10&#186;&#41;
Apolo 17: Eugene Cernan &#40;11&#186;&#41; y Harrison Schmitt &#40;12&#186;&#41;</feedback>
<answer>12</answer>
</question>
<question type="float">
<tags>
<tag>Cultura general sobre astronomía</tag>
</tags>
<stem>&#191;Qué distancia aproximada, en km, hay entre la Tierra y la Luna?</stem>
<feedback>La distancia entre la Tierra y la Luna varia desde 356400 km a 406700 km, aproximadamente.</feedback>
<answer>
<lower>356400</lower>
<upper>406700</upper>
</answer>
</question>
<question type="TF">
<tags>
<tag>Cultura general sobre astronomía</tag>
<tag>Viajes espaciales</tag>
</tags>
<stem>El hombre llegó a la Luna por primera vez en el año 1969.</stem>
<feedback>El enunciado es verdadero. El comandante Neil Armstrong, en la misión Apolo 11, fue el primer ser humano que pisó la superficie de la Luna el 21 de julio de 1969 a las 2:56 &#40;hora internacional UTC&#41; al sur del Mar de la Tranquilidad, seis horas y media después de haber alunizado.</feedback>
<answer>true</answer>
</question>
</test>
```
If you are a teacher, click on _Results_ icon (trophy), then select the students whose tests you want to see, choose a range of dates, and click on **View test results** button. A list will appear with all exams made in that range of dates. You can examine the results and details of those exams that the students have marked with _Allow teachers to consult this exam_ by clicking on **View test** icon (at the right of the row).
# Configuring tests
By clicking the _Configure_ icon (a gear) at top left of the box, a form appears in which the teacher can:
* **Disable** or **allow** each of the **tags**. In a self-assessment test, questions having any tag disabled will not appear.
* **Rename** any of the **tags**. Just edit its name and press Enter or click outside the editing area.
* Choose visibility of questions in **plugins**:
* Question bank not downloadable/visible from other applications (SWADroid, iSWAD, TriSWADos). Recommended if you use the tests option to make exams.
* Question bank downloadable/visible from other applications (SWADroid, iSWAD, TriSWADos). Recommended if tests are intended only for self-assessment.
* Set the minimum, default and maximum **number of questions** in a self-assessment test.
* Set the minimum **time** (in seconds) between performing two consecutive examinations by a student. This time is defined by question, and SWAD multiplies it by the number of questions of the last examination. If the elapsed time since the last examination is insufficient, the student will have to wait to make a new one, and will be informed about this.
* Choose **feedback** for students between the following options: