.. _example:

################
Typische Nutzung
################

In diesem Kapitel wird ein insbesondere für Lehrpersonen typischer matraxi-Ablauf Schritt für Schritt durchgespielt.
Man wird dabei durch viele Bereiche der matraxi-Anwendung und dieser Dokumentation geführt.

Bitte zuvor, falls noch nicht geschehen, :ref:`doc` kurz durchgehen.

Es empfiehlt sich für dieses Kapitel mehrere Browsertabs (oder verschiedene Browser) einzusetzen.
Das erste Tab sollte diese Dokumentation enthalten.
In einem zweiten Tab meldet man sich in der matraxi-Anwendung an.

.. _example_1:

****************************
1. LP erstellt Aufgabenblatt
****************************

Die Lehrperson erstellt ein neues Aufgabenblatt mit dem Titel "Blatt 1".

Der folgende Link führt auf eine andere Seite dieser Dokumentation.
Den Link entweder in einem dritten Browsertab öffnen oder danach die Browser-Funktion "eine Seite zurück" o.ä. nutzen, um hierher zurück zu gelangen.

Aufgabenblatt :ref:`create_sheet`

Im farbigen Balken steht wohin man in der matraxi-Anwendung zu navigieren hat.
Dort dann wie in der Beschreibung unterhalb des Balkens vorgehen.
Wir taufen das Aufgabenblatt "Blatt 1".

Das soeben erstellte Aufgabenblatt ist jetzt geöffnet.
Es soll eine einzige Termumformung mit dem Aufgabentext "Schreibe als Summe mit möglichst wenigen Summanden." und dem Ausgangsterm :math:`(x+1)^2` enthalten.
Wie das gemacht wird steht in

:ref:`set_expression_exercise_text`,

Termumformung :ref:`create_expression_exercise`,

und

Term :ref:`create_expression`

.. _example_2:

***************************
2. LP gibt Aufgabenblatt ab
***************************

Das soeben erstellte Aufgabenblatt "Blatt 1" soll dem Schüler "Zzeno Zzehnder" abgegeben werden.

Aufgabenblatt :ref:`share_sheet`

Gemäss dem farbigen Balken im obigen Link navigiert man auf die Seite der ``Eigenen Aufgabenblätter`` und sucht dort das soeben erstellte "Blatt 1".
Zzeno existiert in jeder Klasse als Testschüler.
Falls man mehrere Klassen unterrichtet, einfach einen der Zzenos auswählen.
Unsere Blattabgabe ist vom Abgabetyp 2 (Absender = LP, Empfänger = S).
Unser ``Abgabeeintrag`` heisst ``Zzeno Zzehnder``.

.. _example_3:

******************
3. S löst Aufgaben
******************

Zzeno löst die Aufgabe auf "Blatt 1".

Man meldet sich jetzt neu als "Zzeno Zzehnder" in der matraxi-Anwendung an.
Dafür muss man sich als Lehrperson zuerst abmelden.

Benutzer :ref:`logout`

Zzeno sieht das zuvor abgegebene Aufgabenblatt unter seinen ``erhaltenen Aufgabenblättern``.
Er soll das

Blatt :ref:`open_sheet`

und die Aufgabe jetzt lösen.
Nacheinander tippt Zzeno in der Eingabezeile verschiedene Terme ein:

.. list-table::
  :header-rows: 1

  * - Ausgabe
    - Eingabe
  * - :math:`x^2+1`
    - x^2+1
  * - :math:`(x+1)(x+1)`
    - (x+1)(x+1)
  * - :math:`x^2+x+x+1`
    - x^2+x+x+1
  * - :math:`x^4+1`
    - x^4+1
  * - :math:`x^2+2x+1`
    - x^2+2x+1

Weitere Infos dazu gibts unter

Term :ref:`create_expression`

und

Term :ref:`correct_expression`

.. _example_4:

*************************************
4. S gibt Aufgabenblatt der LP zurück
*************************************

Zzeno gibt sein gelöstes Aufgabenblatt der Lehrperson wieder zurück.

Aufgabenblatt :ref:`return_sheet`

.. _example_5:

*******************************
5. LP begutachtet Aufgabenblatt
*******************************

Die Lehrperson möchte sehen, wie Zzeno das Aufgabenblatt gelöst hat.

Dafür muss man sich zuerst wieder als Lehrperson anmelden.

Die weiteren Schritte werden erklärt in

:ref:`share`

und

:ref:`open_dependent_sheet`

Die Lehrperson hat nun verschiedene Rückmeldemöglichkeiten, z.B.

Term :ref:`comment_expression`

oder

:ref:`text_exercise`, Textfeld :ref:`create_text_exercise`

oder

Aufgabenblatt :ref:`score_sheet`

Die Lehrperson könnte z.B. beim Term :math:`x^4+1` den Kommentar "Wie müsste der vorherige Term aussehen, damit das stimmen würde?" deponieren und
für Zzeno noch eine neue Termumformung mit dem Ausgangsterm :math:`(x+2)^2` hinzufügen und
das Aufgabenblatt schliesslich mit der Farbe orange bewerten.

.. _example_6:

*************************************
6. LP gibt Aufgabenblatt dem S zurück
*************************************

Die Lehrperson gibt "Blatt 1" wieder zurück an Zzeno.

:ref:`return_dependent_sheet`

Zzeno kann das Aufgabenblatt nun weiter bearbeiten.
Es beginnt also wieder bei :ref:`example_3`.