Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- fn2:datei-upload [2023/03/24 17:30] – christoph
+++ fn2:datei-upload [2024/04/11 10:16] (aktuell) – jhastedt
@@ Zeile 143: / Zeile 143: @@
 =====Automatische Abgabe von Dateien=====
-**TODO**
+Mit fn2Web-Release [[releasenotes:fn2web2.04.11|2.04.11]] wurde die automatische Abgabe von Dateien von FN2XML nach FN2Service ausgelagert um die zugehörigen Benachrichtigungen via Mail besser technisch umsetzen zu können. Die zugehörigen SQL-Statements sind in den Skripten mit den Ids 1238 und 1253 zu finden.
+In der web.xml von FN2Service kann, für den Fall, dass FN2Service nicht auf dem gleichen Server läuft wie FN2SSS, optional ein Parameter mit dem Pfad zu den gespeicherten, hochgeladenen Dateien angegeben werden. Der dort hinterlegte Pfad überschreibt dann die Kombination aus DATEIUPLOADPATH und FN2SSS.UPLOAD_SUFFIX. Befinden sich FN2SSS und FN2Service auf dem gleichen Server, kann der Parameter ignoriert werden.
+  <init-param>
+    <description>Optionaler Pfad für Uploads</description>
+    <param-name>PATH_UPLOADS_OPTIONAL</param-name>
+    <param-value>/optionaler/pfad/falls/FN2Service/auf/anderem/server/</param-value>
+  </init-param>
 =====Download der Dateien in FN2LM=====
@@ Zeile 175: / Zeile 183: @@
 Da das Passwort im Klartext abgelegt wird (analog zum Druck-User), raten wir dringends hierfür einen eigenen Nutzer anzulegen und diesem keine weiteren Rollen zuzuweisen.
+Falls im FN2AUTH Parameter 'ROLLENERLAUBT' (in der web.xml) die Rolle 7 (allgemeiner Nutzer) nicht erlaubt ist, muss dort wenigsten die im SQL-Skript 1238 angelegte Rolle 49 (FN2ServiceIntern) gestattet werden. Siehe auch den Wiki-Eintrag zu [[fn2:service_intern|FN2Service]].
 ======Klausur-Upload======
 Da der Klausur-Upload weitestgehend die gleiche Infrastruktur wie der Datei-Upload nutzt, können die zugehörigen Parameter größtenteils abgeleitet werden:
@@ Zeile 225: / Zeile 234: @@
 | CIPHER           |AES/CBC/PKCS5Padding|     AES mit CBC und PKCS5-Padding    |
 | CIPHER_KEY       |     #########      |       Bitte bei Bedarf erfragen      |
+======Feedback-Upload======
+Ab dem  FN2WEB-Release [[releasenotes:fn2web2024-04|2024-04]] ist der Feedback-Upload für Dozenten in FN2LM möglich, mit dessen Hilfe ein direktes Feedback, zu von den Studenten hochgeladenen Prfstd-Uploads ermöglicht wird.
+Damit die Funktion verwendet werden kann, muss in der context.xml des Tomcats der Parameter **"FN2LM.UPLOAD_FEEDBACK"** hinzugefügt und **value="all"** oder **value="PA"** gesetzt werden.
+  * **Value="all"** bedeutet, dass Feedback-Dateien **sowohl in der Studierendenschnittstelle, als auch im PA-Modul sichtbar sind.**
+  * **Value="PA"** bedeutet, dass Feedback-Dateien **nur im PA-Modul sichtbar sind.**
+  * **Value="false"**, bzw. das Nichtsetzen des Parameters bedeutet, dass das Feature komplett nicht verwendet werden kann.
+  <Parameter description="Schalter, der bestimmt, ob Feedback-Dateien von den Lehrenden hochgeladen werden können (all/PA/false). all=Anzeige PA + SSS, PA=Anzeige nur PA, false=Deaktivieren des Features" name="FN2LM.UPLOAD_FEEDBACK" value="all"/>
+Zusätzlich dazu werden noch die beiden Parameter 'FN2LM.UPLOAD_SUFFIX' und FN2LM.UPLOAD_MIME benötigt.
+  <Parameter description="Suffix fuer den Pfad von FileUploads im LM" name="FN2LM.UPLOAD_SUFFIX" value="LM/"/>
+  <Parameter description="Valide MIME-Typen fuer den KlausurUpload/Feedbackupload im LM, mit Doppelpunkt trennen" name="FN2LM.UPLOAD_MIME" value="application/pdf:text/plain"/>
+Damit im PA-Modul die Feedback-Uploads der Dozenten angezeigt werden, muss in der Tabelle Setup der **param "PA_FEEDBACK_ANZEIGEN"** hinzugefügt und der dazugehörige **value auf "TRUE"** gesetzt werden.
+Zusätzlich benötigt werden die Datenbankskripte mit den Ids: 1308 (neue Tabelle prfstd_feedback), 1309 (neue Rechte, die für den Feedbackupload benötigt werden) und 1310 (neue Flog-Typen, Log-Elemente/Schlüssel für den Feedbackupload).
+Beim ersten Aufruf wird die Seite folgendermaßen aussehen:
+{{:fn2:ersteraufruf.png|}}
+Durch den Klick auf "Feedback hochladen" erscheint eine Upload-Formular. Durch das Auswählen einer Datei und das Klicken auf "Datei auswählen", erscheint folgende Übersicht, bei der mehrere Möglichkeiten zur Auswahl stehen:
+  * Durch das Auswählen einer weiteren Datei lassen sich weitere Dateien auswählen
+  * Ausgewählte Dateien können wieder entfernt werden
+  * Durch das Klicken auf "Dateien hochladen" werden die Datei(en) hochgeladen.
+{{:fn2:uploaddialog.png|}}
+Sobald die Datei(en) (bisher Stand: [[releasenotes:fn2web2024-04|2024-04]] gibt es keine Begrenzung der Anzahl) hochgeladen wurde(n), erscheint unter den Uploads der Studenten ein Balken mit den Überschriften "Feedback Dateiname: Zum Umschalten bitte klicken:", "Datum" und "Löschen". Dieser zeigt an, dass Feedback-Uploads existieren. Damit diese angezeigt werden, muss auf den Balken geklickt werden. Dadurch entsteht folgende Ansicht:
+{{:fn2:aufrufmitfeedback.png|}}
+Es besteht die Möglichkeit, die Feedback-Uploads nochmal zu löschen, oder sich diese, durch einen Klick auf den Dateinamen, anzeigen zu lassen.
+===== Download von Feedback-Dateien in FN2SSS =====
+Sobald das Feedback vom Dozenten hochgeladen wurde, ist es auch für den Studenten in der Studierendenschnittstelle sichtbar. Sobald dieser in dem Bereich für Datei-Uploads die Prüfung auswählt, erscheint dem Studierenden folgende Übersicht:
+{{:fn2:ansichtstudent.png|}}
+Durch einen Klick auf den Dateinamen wird die Datei runtergeladen.
+Die Sichtbarkeit des Bereiches nach einer Verbuchung wird durch das bereits existierende Custvalue "anzeigeDauerErgebnisse" des Projektes "FN2SSS" und dem Korrekturdatum der Prüfung geregelt. Die Anzeige der Prüfungen in FN2LM nach einer Verbuchung wird auf die gleiche Weise geregelt.
+===== Löschen des Feedback-Uploads durch den Dozenten =====
+Die Löschbarkeit eines Feedback-Uploads wird je nach value des Parameters "FN2LM.UPLOAD_FEEDBACK" unterschiedlich eingeschränkt:
+  * **Value="all"**: Sobald ein Student das Feedback heruntergeladen hat, kann es nicht mehr gelöscht werden.
+  * **Value="PA"**: Das Löschen wird anhand des neuen Parameters **"FEEDBACK_LOESCHEN_NACH_FREIGABE"**, der in die **web.xml** des Projektes **FN2LM** eingetragen werden soll, und dem freigabedatum der Prüfung (Feld freigabedatum in der Tabelle prfstd) geregelt. Das **param-value soll eine Ganzzahl** sein. Diese steht für die Anzahl der Tage, in denen der Feedback-Upload nach der Freigabe einer  Prüfung gelöscht werden kann. Falls der Parameter nicht vorhanden ist, oder keinen gültigen Ganzzahlenwert besitzt, wird mit der Zahl 10 (Tage) anstelle des Parameters gerechnet.
+  <init-param>
+		<description>Falls nur eine Anzeige des Feedbacks im PA vorgesehen ist, wird die
+				Löschbarkeit des Feedbacks anhand des Parameters bestimmt
+				((aktuelles Datum - param-value (Zahlenwert entspricht Tagen))&lt;&#061;<!-- <= -->  freigabedatum).
+				Falls ein ungültiger Wert eingetragen wird, wird als Standard der Wert 10 (Tage) für die Rechnung genommen</description>
+		<param-name>FEEDBACK_LOESCHEN_NACH_FREIGABE</param-name>
+		<param-value>10</param-value>
+	</init-param>