--- /dev/null
+<p align=center><b>"GIFT"-Format-Dateien importieren</b></p>\r
+\r
+<p>GIFT ist das umfangreichste Format zum Import von Textdateien in das Moodle Quiz-Modul. Es unterstützt\r
+Multiple-Choice-Fragen, Richtig-Falsch- Fragen, Kurzantwort-Fragen, Zuordnungen und Numerische Fragen, genauso\r
+ wie Fragen mit Lückentexten. Verschiedene Fragenanrten können in einer Textdatei kombiniert werden.\r
+ Das Importformat unterstützt auch Kommentarzeilen, Fragenamen, Feedback und die prozentuale Gewichtung der Antworten.</p>\r
+\r
+ <h3>Verschiedene Frageformen</h3>\r
+\r
+ <p><u>Multiple-Choice-Fragen:</u><br />\r
+ Für Multiple-Choice-Fragen wird das Tilde-Zeichen (~) verwandt, um falsche Antworten zu kennzeichnen. Richtige Antworten werden mit dem Gleichheitszeichen (=) markiert.</p>\r
+ <pre> Who's buried in Grant's tomb?{~Grant ~Jefferson =no one}</pre>\r
+<br>\r
+<h3>Lückentexte</h3>\r
+ <p>Das <b>Lückentext</b>format füllt automatisch ein unterstrichenes Leerfeld (wie _____) in den Satz. Die Reihenfolge der Antwortvorgaben ist beliebig. Richtige und falsche Antworten werden wieder mit Tilde (~) und Gleichheitszeichen markiert.</p>\r
+ <pre> Grant is {~buried =entombed ~living} in Grant's tomb.</pre>\r
+ <p>Wenn die Antwort vor der schließenden geschweiften klammer kommt, wird ein unterstrichenes Leerfeld für den Lückentext eingefügt. Alle Fragetypen können in diesem Format geschrieben werden.</p>\r
+ <p>Zwei Fragen werden durch die Eingabe von zwei aufeinander folgenden Absatzzeichen getrennt. Zur Verdeutlichung, die Antworten können auch in separtaen Zeilen eingegeben werden. Beispiel:</p>\r
+<pre> The American holiday of Thanksgiving is celebrated on the {\r
+ ~second\r
+ ~third\r
+ =fourth\r
+ } Thursday of November.\r
+\r
+ Japanese characters originally came from what country? {\r
+ ~India\r
+ =China\r
+ ~Korea\r
+ ~Egypt}</pre>\r
+\r
+ <h3><p>Kurzantwort-Fragen:<br/></h3><br>\r
+ Antworten im Kurzantzwortfragen-Format werden alle durch ein Gleichheitszeichen (=) eingeleitet, das verdeutlicht, dass alle Antworten richtig sind. Falsche Antwortvorgaben (~) sind nicht erforderlich.</p>\r
+ <pre> Who's buried in Grant's tomb?{=no one =nobody}\r
+<br>\r
+\r
+ Two plus two equals {=four =4}.</pre>\r
+ <p>Wenn es nur <u>eine</u> richtige Antwort gibt, kann auf das Gleichheitszeichen für die richtige Antwort verzichtet werden, solange keine Verwechslung mit Richtig-Falsch Fragestellung erfolgen kann.\r
+ <h3><p>Richtig-Falsch-Fragen:<br/></h3>\r
+ Bei diesem Fragetyp kennzeichnet die antwort, ob die Aussage richtig oder falsch ist. Die Antwort sollte als richtig {TRUE} oder falsch {FALSE}, oder abgekürzt {T} oder {F} gekennzeichnet werden.</p>\r
+ <pre> Grant is buried in Grant's tomb.{F}\r
+\r
+ The sun rises in the east.{T}</pre>\r
+\r
+ <h3><p>Zuordnungen:<br/></h3>\r
+ Zuordnungspaare beginnen mit einem Gleichheitszeichen (=) und werden durch das Pfeilsymbol "->" voneinander getrennt. Es sind mindestens drei Vergleichspaare erforderlich.</p>\r
+\r
+<pre> Matching Question. {\r
+ =subquestion1 -> subanswer1\r
+ =subquestion2 -> subanswer2\r
+ =subquestion3 -> subanswer3\r
+ }\r
+\r
+ Match the following countries with their corresponding capitals. {\r
+ =Canada -> Ottawa\r
+ =Italy -> Rome\r
+ =Japan -> Tokyo\r
+ =India -> New Delhi\r
+ }</pre>\r
+<p>Feedback und die prozentuale Gewichtung der Antworten werden hier nicht unterstützt.</p>\r
+ <h3><p>Numerische Fragen:<br/></h3>\r
+ Der Antwortabschnitt für eine numerische Antwort muß mit dem Rautenzeichen (#) beginnen. Nicht exakt richtige, aber akzeptierte Antworten können ebenfalls eingegeben werden. Sie folgen der richtigen Antwort und einem Doppelpunkt. Wenn z.B. die richte Antwort zwiscehn 1,5 und 2,5 liegt dann erfolgt diese Eingabe <u>{#2:0.5}</u>. Das bedeutet 2 mit einer Fehlertoleranz von 0,5 ist korrekt. Wenn keine Fehlertoleranz angegeben wird, wird nur die genaue Antwort als richtig gewertet.</p>\r
+ <pre> When was Ulysses S. Grant born? {#1822}\r
+\r
+ What is the value of pi (to 3 decimal places)? {#3.1415:0.0005}.</pre>\r
+ <p>Zusätzlich können Zahlenantworten auch als Spanne von..bis eingegeben werden. Schreiben Sie dazu in diesem Format {#<i>MinimumValue</i>..<i>MaximumValue</i>}.</p>\r
+ <pre> What is the value of pi (to 3 decimal places)? {#3.141..3.142}.</pre>\r
+ <p>Moodle's Browseroberfläche unterstützt keine Antworten mit verschiedenen richtigen Zahlen. Der Code kann dies jedoch verabeiten und daher ermöglicht das GIFT Format eine Definition derartiger Fragen und Antworten. Dies ist erforderlich wenn verschiedene Antwortspannen richtig sind oder zum Teil auch wenn verschiedene Antworten unterschiedliche Prozentwerte bei der Bewertung ergeben. Verschiedene Antworten müssen durch ein Gleichheitszeichen voneinander getrennt sein wie bei den Kurzantwortfragen.</p>\r
+ <pre> When was Ulysses S. Grant born? {#\r
+ =1822:0\r
+ =%50%1822:2}</pre>\r
+ <p>Hinweis: diese Option wird in der Verwaltung von Moodle-Quiz nicht unterstützt und nicht angezeigt. Der einzige Weg, solche Fragen zu ändern ist durch Löschen der Frage im Moodle-Quiz-Modul und Re-Import der veränderten Frage (oder direkt in phpMyAdmin).</p>\r
+ <h3>Optionen</h3>\r
+ <p>Zusätzlich zu diesen Frageformen bietet dieser Filter folgende Optionen: Kommentarzeilen, Fragenamen, Feedback und eine prozentuale Gewichtung der Antworten bei der Bewertung.</p>\r
+ <p><u>Kommentarzeilen:</u><br />\r
+ Alle Zeilen, die mit einem doppelten backlash-Zeichen (\\) beginnen, werden von diesem Filter ignoriert.\r
+<pre> // Subheading: Numerical questions below\r
+ What's 2 plus 2? {#4}</pre>\r
+ <h3><p>Fragenname:<br/></h3> Der Fragenname wird zu Beginn der Frage geschrieben und durch zweifache Doppelpunkte eingefasst.</p>\r
+<pre> ::Kanji Origins::Japanese characters originally\r
+ came from what country? {=China}\r
+\r
+ ::Thanksgiving Date::The American holiday of Thanksgiving is\r
+ celebrated on the {~second ~third =fourth} Thursday of November.</pre>\r
+ <p>Wenn kein Fragenname angegeben wird wird automatisch durch Voreinstellung eine Bezeichnung vergeben.</p>\r
+<h3><p>Feedback:<br/></h3> Feedback kann für jede Antwort definiert werden. Die Feedbackdefinition folgt der Antwort und wird durch ein(#) von ihr separiert.</p>\r
+<pre> Waas ist die Antwort auf diese Multipli-Choice-Frage?{\r
+ ~falsche Antwort#Feedback Kommentar zur falschen Antwort\r
+ ~eine andere falsche Antwort#Feedback Kommentar zu dieser falschen Antwort\r
+ =richtige Antwort#Very good!}\r
+\r
+ Who's buried in Grant's tomb?{\r
+ =no one#excellent answer!\r
+ =nobody#excellent answer!}\r
+\r
+ Grant is buried in Grant's tomb.{FALSE#No one is buried in Grant's tomb.}</pre>\r
+\r
+<p>Bei Multiple-ChoiceFragen wird der Kommentar nur für die ausgewählte Antwort angezeigt. Bei Kurzantwortfragen wird der Kommegar nur bei der richtigen Antwort angezeigt. Bei Richtig-Falsch-Fragen wird ein Kommentar bei der falschen Antwort gezeigt.Im obigen Beispiel wird der Feedback-Kommentar nur bei der falschen Antwort (hier: richtig) angezeigt.</p>\r
+\r
+<p><h3>Prozentuale Gewichtung der Antworten</h3><br />\r
+Eine prozentuale Gewichtung der Antworten ist bei den Kurzantwortfragen und bei Multiple-Choice-Fragen möglich. Der Prozentwert folgt dem Tilde-Zeichen (bei Multiple-Choice-Fragen) oder dem Gleichheitszeichen (bei KurzantwortFragen). Eingegeben wird der Zahlwert zwischen den Prozentzeichen (%50%). Diese Option kann mit Komentaren kombiniert werden.</p>\r
+<pre> Difficult question.{~wrong answer ~%50%half credit answer =full credit answer}\r
+\r
+ ::Jesus' hometown::Jesus Christ was from {\r
+ ~Jerusalem#This was an important city, but the wrong answer.\r
+ ~%25%Bethlehem#He was born here, but not raised here.\r
+ ~%50%Galilee#You need to be more specific.\r
+ =Nazareth#Yes! That's right!}.\r
+\r
+ ::Jesus' hometown:: Jesus Christ was from {\r
+ =Nazareth#Yes! That's right!\r
+ =%75%Nazereth#Right, but misspelled.\r
+ =%25%Bethlehem#He was born here, but not raised here.}</pre>\r
+<p>Die Beispiele sind die gleiche Frage als Multiple-Choice Frage und als Kurzantwort-Frage.</p>\r
+\r
+<p><font size="-1">Hinweis: Hier können auch Prozentwerte angegeben werden, die bei Moodle im Quiz-Modul nicht erfasst werden können. Die Berechnung erfolgt dennoch richtig. Die Anzeige für den Lehrer in Moodle erfolgt u.U. jedoch nicht korrekt wenn sie innerhalb des Quizmoduls weiter bearbeitet wird. Die Anzeige für die Teilnehmer ist dennoch richtig. Das Pulldownmenu in Moodle's Quiz-Modul erlaubt nur bestimmte Werte. Wenn der in der Import-Datei eingetragene Wert damit nicht völlig übereinstimmt erfolgt eine fehlerhafte Anzeige in der Ansicht von Moodle. Wenn Sie nun eine Bearbeitung des Quiz innerhalb von Moodle vornehmen wird der Wert entsprechend den Möglichkeiten von Moodle angepasst und geändert.</font></p>\r
+\r
+<p><h3>Mehrere Antworten</h3><br />\r
+Die Option Mehrere Antworten ermöglicht Fragen bei denen mehrere Antworten als richtig bezeichnet werden müssen, um die Antwort insgesamt als vollständig richtig zu beantworten. Damit nicht bei einer einzelnen abgegeben Antwort die volle Punktzahl vergeben wird, müssen alle richtigen Antworten mit einem entsprechenden Bewertungsgewicht versehen werden.</p>\r
+<pre> What two people are entombed in Grant's tomb? {\r
+ ~No one\r
+ ~%50%Grant\r
+ ~%50%Grant's wife\r
+ ~Grant's father }</pre>\r
+<p>Hinweis: Es gibt kein Gleichheitszeichen (=) für eine Antwort und die Summe der Gewichtungen darf 100% nicht überschreiten, sonst erfolgt eine Fehlermeldung durch Moodle. Damit ein 100 % Wert nicht durch anklicken aller Antworten ereicht wird, müssen negative Gewichtugen für falsche Antworten vergeben werden.</p>\r
+<pre> What two people are entombed in Grant's tomb? {\r
+ ~%-50%No one\r
+ ~%50%Grant\r
+ ~%50%Grant's wife\r
+ ~%-50%Grant's father }</pre>\r
+\r
+ <p><h3>Andere Optionen:</h3><br />\r
+ Andere Optionen sind durch Anpassung des Importfilters <b>gift/format.php</b> möglich. </p>\r
+<p>Kurzantwortfragen können die Groß- und Kleinschreibung der Antworten berücksichtigen durch eine Änderung der Zeile<br />\r
+ <tt>$question->usecase = 0; // Ignore case</tt></p>\r
+<p></p>\r
+<h3>Troubleshooting</h3>\r
+<p>Die Textdateibezeichnung muß mit der Bezeichnung in Ihrer Moodle Installaton übereinstimmen. </p>\r
+<p>Hier finden Sie einen Beispieltext: <a href="../../../../mod/quiz/format/gift/examples.txt">gift/examples.txt</a>.</p>\r
+<p></p>\r
+<h3>Credits</h3>\r
+<p>Dieser Filter wurde gemeinsam von mehreren Mitgliedern der Moodle Community geschrieben. Ursprünglich wurde er für das Lückentextformat von Martin Dougiamas, Thomas Robb und anderen geschrieben. Paul Tsuchido Shew erweiterte den Filter im Dezember 2003 unter Mitwirkung von Vorschlägen aus der Community um weitere Frageformate. Der Name GIFT ist ein Akronym aus "General Import Format Technology" oder irgendsoetwas. Das ist aber für die Bezeichnung eines Filters zu lang: deshalb einfach GIFT.</p>\r
+ <p><font size="-1">GIFT documentation by Paul Tsuchido Shew, 13 Jan 2004.</font></p>
\ No newline at end of file
--- /dev/null
+<p align="center"><b>Upload users</b></p>
+
+<p>Beachten Sie bitte: <strong>es ist normalerweise nicht erforderlich Anwender in großen Mengen nach Moodle zu importieren</strong> - um den eigenen Arbeitsaufwand zu begrenzen sollten anderre Formen der Bestätigung von Teilnehmern geprüft werden, die keine manuelle Erfassung erfordern, wie die Verbindung zu bestehenden externen Datenbanken oder die Einrichtung von Zugängen durch die Teilnehmer selber. Weitere Hinweise dazu finden Sie im Bereich Anmeldung /Authentifikation im Administrationsmenu.</p>
+<p>Wenn Sie dennoch eine große Zahl von Anwendern aus einer Textdatei importieren wollen, müssen Sie die Textdatei folgendermaßen aufbauen:</p>
+
+<ul>
+ <li>Jede Zeile der Datei enthält einen einzelnen Datensatz</li>
+ <li>Jeder Datensatz besteht aus einer Reihe von Datenfeldern, die durch Kommas getrennt sind</li>
+ <li>Der erste Datensatz der Datei (erste Zeile) enthält eine Liste der Feldnamen. Diese Zeile legt das Format der restlichen Zeilen fest. Die Feldnamen entsprechen den Datensätzen, die im Anmeldeformular in der Datenbank genutzt werden.
+ <blockquote>
+ <p><strong>Erforderliche Datenfeldnamen:</strong> diese Datenfeldnamen müssen in der ersten Zeile eingetragen werden und für jeden Nutzer definiert werden</p>
+ <p></p>
+ <font color="#990000" face="Courier New, Courier, mono">username, password, firstname, lastname, email</font></p>
+</p>
+ <p><strong>Default Datenfeldnamen:</strong> diese sind optional - wenn diese nicht eingebunden werden, werden die Werte für diese Felder vom Basiseintrag übernommen, die bei jeder Neuanmeldung voreingestellt sind. (Der Spracheintrag für Deutsch lautet 'de'.</p>
+ <p><font color="#990000" face="Courier New, Courier, mono">institution, department, city, country, lang, timezone</font> </p>
+ <p><strong>Optionale Datenfeldnamen: </strong>all diese Einträge sind völlig freigestellt. Als Kursname (course1,2, etc) werden die Kurzbezeichnungen der Kurse genutzt - wenn die Kurse angelegt sind, werden die Teilnehmer dann in den Kursen automatisch angemeldet.</p>
+ <p> <font color="#990000" face="Courier New, Courier, mono">idnumber, icq, phone1, phone2, address, url, description, mailformat, maildisplay, htmleditor, autosubscribe, course1, course2, course3, course4, course5</font></p>
+ </blockquote>
+ </li>
+ <li>Wenn Sie Kommas in den Datenfeldern verwenden müssen, nutzen Sie die Eingabe &#44 - das Skript wird diese dann automatisch in ein Komma umwandeln. </li>
+ <li>Für Boole-sche Felder verwenden Sie 0 für falssch und 1 für richtig/wahr. </li>
+ <li>Anmerkung: Wenn ein Nutzer bereits in der Moodle Nutzerdatenbank registriert ist, wird er für die neuen Kurse als Teilnehmer eingetragen ohne die anderen Daten zu aktualisieren.</li>
+</ul>
+
+
+<p>Hier ist ein Beispiel für eine gültige Importdatei:<br>
+</p>
+<p><font size="-1" face="Courier New, Courier, mono">username, password, firstname, lastname, email, lang, idnumber, maildisplay, course1<br>
+jonest, verysecret, Tom, Jones, jonest@someplace.edu, en, 3663737, 1, Intro101<br>
+reznort, somesecret, Trent, Reznor, reznort@someplace.edu, en_us, 6736733, 0, Advanced202</font></p>
--- /dev/null
+<P ALIGN=CENTER><B>Analyse der Bewertungen</B></P>
+
+<P>Diese Analyse befasst sich gleichermaßen mit den Bewertungen der Beispielaufgaben, wie mit den Bewertungen während der Selbstbewertungsphase durch die anderen Teilnehmer/innen. Es berücksichtigt die besseren Bewertungen aus den Bewertungen der Dozent/innen und der Teilnehmer/innen Diese "guten" Bewertungen werden dann für die Berechnung der Gesamtnote verwandt.</p>
+
+<p>Die Analyse wird am besten erst dann durchgeführt, wenn die Bewertungen der Dozent/innen vorliegen. Diese Bewertung kann als Maßstab (Benchmark) für die Einschätzungen der Bewertungen der Teilnehmer/innen genutzt werden. Der/die Dozent/in muß <b>nicht</b> alle Übungsaufgaben und alle eingereichten Arbeiten bewerten. Damit die Analyse nun aber aussagekräftig ist, sollte der/die Dozent/in mehr Arbeiten bewertet haben als die Teilnehmer/innen dies im Durchschnitt getan haben. Je mehr Bewertungen des/der Dozent/in vorliegen, desto verlässlicher wird auch das Ergebnis dieser Analyse sein. </p>
+
+<p>Die Analyse wird sinnvollerweie mehrfach durchgeführt, jedesmal wenn eine oder mehrere der verfügbaren Optionen geändert wurde. Die verschiedenen Optionen werden durch die Einstellungen oben auf der Seite gesteuert. </p>
+
+<ol><li>Auf der Ebene der Fehleranalyse wird beim Laden der Bewertungen der Dozent/innen die Gewichtung ihrer Bewertungen im Vergleich mit den Bewertungen anderer Teilnehmer/inen definiert. Wenn das Gewicht der Dozent/innen-Bewertung hoch sein soll,, dann sollte er/sie über den niedrigsten durchschnittlichen Fehler in der Tabelle verfügen. Wenn er/die Dozent/in nicht als erstes in der Liste aufgeführt wird, sollte der Wert fürt den/die Dozent/in erhöht werden, bis er/sie die niedrigste Rate hat. Das führt dazu, dass die Dozent/innen-Bewertungen dominieren und gleichlautende Bewertungen der Teilnehmer/innen ebenfalls an der Spitze der Tabelle aufgeführt werden. Bewertungen anderer Teilnehmer/innen, die sich am Ende der Tabelle befinden, verweisen darauf, dass sie Bewertungen abgegeben haben, die von der Bewertung des/der Dozent/in abweichen. Je mehr Bewertungen des/der Dozent/in vorhanden sind, desto weniger ist es erforderlich die Gewichtung zu korrigieren. Diese Option nimmt keinen Einfluß auf die Berechnung der Schlußnote. In dieser Berechnung der Note wird ein Durchschnittswert aller vorhandenen Noten ermittelt, gleich ob sie von den Dozent/innen oder den Teilnehmer/innen stammen.
+</li>
+
+<li>Die Gewichtung für die Benotung der Aufgaben wird in der Berechnung der Schlußnote berücksichtigt. Ein einfaches Formular dient der Berechnung der Leistung der Teilnehmer/innen. Es ist das Verhältbis guter Beurteilungen im Vergleich zur maximalen Zahl der möglichen Einschätzungen. Wenn z.B. 3 Einschätzunge zu den Übungsaufgaben und 5 Einschätzungen zu den eingereichten Arbeiten abgegeben werden sollen und ein/e Teilnehmer/in hat 7 Beurteilungen vorgenommen und eine ist herausgenommen worden (siehe unten), dann wird ihre Bewertungsleistung mit (7-1)/8, also 75 % ermittelt. Die Gesamtnote wird nun aus der gewichteten Kombination der Bewertungsleistungen und den Bewertungen der eigenen Aufgabenstellung errechnet. Die Gewichtungen der ebiden Faktoren sind immer zunächst auf 1 gesetzt. Beide Teile werden danach gleich stark gewichtet. Wenn Sie nun die Gewichtung für die eigene Lösung der Aufgabe auf 0,5 setzen zählt diese 33 % der Gesamtbewertung, da die Gewichtung für die Bewertunegn an derer Arbeiten weiterhin bei 1 steht. 0,5 + 1 = 33% / 66 % </li>
+<li>Der Prozentsatz der Bewertungen, der bei der Berechnung der Gesamtnote nicht berücksichtigt wird, kann auf zwei verschiedene Arten festgelegt werden.
+<ul><li>Wenn die Teilnehmer/innen alle Bewertungen vorgenommen haben, können sie die volle Punktzahl nur dann erreichen wenn keine Bewertungen bei der Berechnung herausfallen. Wenn diese Option auf 30 % eingestellt wird, wird erreicht, dass die durchschnittliche Bewertungsleistung aus 70% der Bewertungen errechnet wird (30 % fallen für die Bewertung weg)..</li>
+<li>Alternativ kann die Zahl der nicht berücksichtigten Bewertungen in der vierten Spalte der Tabelle eingestellt werden.
+</ul>
+</ol>
+<p>Zusätzlich zur Fehlertabelle listet die Analyse die Bewertungen aller Bewertungen und Noten auf. Diese Tabelle sollte durchgesehen werden, um festzustellen, ob die Noten nachvollziehbar sind. Wenn viele Bewertungen herausfallen, kann es sein, dass einige Arbeiten gar nicht bewertet werden und die Basis für die Errechnung der Schlußnote sehr niedrig ist. Die Analyse zeigt die Zahl der eingereichten Arbeiten am Anfang der Tabelle und kurz vor der Notentabelle an. Diese beiden Zahlen sollten identisch sein. Wenn eine oder mehrere Arbeiten unbewertet sind und der /die Dozent/in die Zhal der nicht berücksichtigten Arbeiten nicht verändern will, muß er/sie die Arbeit selbst bewerten und die Analyse wiederholen. Es ist unbedingt erforderlich, dass alle Arbeiten bewertet werden, bevor die Schlußnote veröffentlicht wird.
+</p>
+<p>Berücksichtigen Sie das Gleichgewicht zwischen der Zahl der herausfallenden Bewertungen und der Gesamtbenotung. Je mehr Bewertungen herausfallen, desto niedriger wird die Punktzahl der Gesamtnote bei der Addition ausfallen. Wenn schlechte Bewertungen nicht aus der Gesamtnote herausgenommen werden, werden die Teilnehmer/innen sich über Qualität der Bewertungen beschweren. Vorausgesetzt, dass ausreichend Arbeiten von dem/der Dozent/in bewertet wurden, ist ein Wert von 15 % bis 30 % an herausfallenden Bewertungen begründbar.
+
+</p>
+<p>Hinweis: Diese Analysen benötigen einige Zeit und erfordern einen iterativen Prozess. Mit Verzögerungen muß daher gerechnet werden.
+</p>
projects / moodle.git / commitdiff