Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- fn2:datei-upload [2022/09/21 10:45] – [MIME-Typ] christoph
+++ fn2:datei-upload [2023/04/17 17:39] – christoph
@@ Zeile 86: / Zeile 86: @@
 für .pdf und .txt (und Ähnliche) stehen. Eine Liste mit den gängigsten MIME-Typen ist [[https://wiki.selfhtml.org/wiki/MIME-Type/Übersicht|hier]] zu finden.
-Mit fn2Web-Release [[releasenotes:fn2web2.04.10|2.04.10]] und folgend, werden die hochgeladenen Dateien genauer analysiert um ihren Datei-Typ zu bestimmen. Eine vollständige Liste der unterstützten Typen kann [[https://tika.apache.org/2.4.1/formats.html|hier]] gefunden werden.
+Mit fn2Web-Release [[releasenotes:fn2web2.04.10|2.04.10]] und folgend, werden die hochgeladenen Dateien genauer analysiert um ihren Datei-Typ zu bestimmen. Eine vollständige Liste der unterstützten Typen kann [[https://tika.apache.org/2.4.1/formats.html#Full_list_of_Supported_Formats_in_standard_artifacts|hier]] gefunden werden.
 ====Begrenzung der Datei/Upload-Größe====
@@ Zeile 99: / Zeile 99: @@
 Die Parameter UPLOAD_MAX_FILE_SIZE und REQUEST_SIZE_LIMIT gelten auch für andere Uploads (z.B. Teilnehmerlisten im CSV-Format in FN2LM). Sie müssen in der jeweiligen web.xml eingetragen werden.
+Zur Erinnerung:
+kB = 2^10 B = 1024 B
+MB = 2^20 B = 1048576 B
-=====Optionaler Eintrag in context.xml=====
+=====Optionale Einträge in context.xml=====
+<wrap important>**Gilt ab Release** [[releasenotes:fn2web2.04.11|2.04.11]]:</wrap>
+  <Parameter description="Sollen bei finaler Abgabe Mails an den Dozenten verschickt werden? (true/false)" name="FN2SSS.SEND_MAIL_FINALE_ABGABE_DOZENT" value="true"/>
+  <Parameter description="Sollen bei finaler Abgabe Mails an den Studenten verschickt werden? (true/false)" name="FN2SSS.SEND_MAIL_FINALE_ABGABE_STUDI" value="true"/>
+Wenn die Parameter vorhanden sind und auf 'true' steht, werden bei endgültiger Abgabe [[mail:start|Mails]] an die verantwortlichen Dozenten (mail=503) und den bzw. die betroffenen Studenten (mail=504) verschickt. Die Mails müssen im PO-Modul [[mail:start|konfiguriert]] werden.
 <wrap important>**Gilt ab Version** [[releasenotes:fn2web2.04.08|2.04.08.007]]:</wrap>
@@ Zeile 108: / Zeile 117: @@
   <Parameter description="Uhrzeit, zu der täglich nach verstrichenen Abgabe-Fristen gesucht wird. Format 'HH:mm'" name="FN2SSS.DATEI_UPLOAD_CHECK_TIME" value="00:00"/>
-Der Zeitpunkt defaultet auf 00:00 Uhr wenn der Parameter nicht vorhanden ist oder nicht im richtigen Format ('HH:mm') hinterlegt wurde.
+Der Zeitpunkt defaultet auf 00:00 Uhr, wenn der Parameter nicht vorhanden ist oder nicht im richtigen Format ('HH:mm') hinterlegt wurde.
@@ Zeile 118: / Zeile 127: @@
 Das Intervall hat einen Default-Wert von einer Stunde (wenn der Parameter nicht vorhanden ist) und einen Minimal-Wert von einer halben Stunde.
+=====Deckblatt einfügen=====
+Auf Wunsch kann den in FN2SSS hochgeladenen PDF-Dateien ein via XSLT generiertes Deckblatt beigefügt werden. dafür muss in der web.xml von FN2SSS der Init-Parameter 'ATTACH_PAGE_TO_UPLOAD' vorhanden und auf 'true' stehen:
+  <init-param>
+      <description>Soll ein Deckblatt den Uploads vorangestellt werden? (true/false)</description>
+      <param-name>ATTACH_PAGE_TO_UPLOAD</param-name>
+      <param-value>true</param-value>
+  </init-param>
+Zudem wird eine XSL-Datei 'Upload_Deckblatt.xsl' im XSL-Verzeichnis von FN2XML erwartet ('FN2XML.XSLPATH' in der context.xml). Bei Interesse kann eine Liste der Übergabeparameter bei uns erfragt werden.
 =====Überschriften und Texte=====
@@ Zeile 123: / Zeile 141: @@
 Die Umarbeitung der Lokalisierung via Properties ist im Moment work in progress. Wir bitten die damit verbundenen Unannehmlichkeiten zu entschuldigen.
+=====Automatische Abgabe von Dateien=====
+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=====
-Die jeweils zugehörigen Prüfer können hochgeladene Dateien über den Menüpunkt "Arbeiten herunterladen" in FN2LM zur Korrektur herunterladen. Dazu muss im Init-Parameter "NAV_CONFIG" in der web.xml von FN2LM der Eintrag "abschlussarbeiten" aus dem Value entfernt werden.
+Die jeweils zugehörigen Prüfer können hochgeladene Dateien über den Menüpunkt "Arbeiten herunterladen" in FN2LM zur Korrektur herunterladen. Dazu muss im Init-Parameter 'NAV_CONFIG' in der web.xml von FN2LM der Eintrag "abschlussarbeiten" aus dem Value entfernt werden, bzw. im Init-Parameter 'NAV_ROLE_CONFIG' bei einer gewünschten Rolle hinzugefügt werden, z.B.:
+  <init-param>
+    <description>
+      In diesem Parameter kann angegeben in Abhängigkeit der Rolle eines Benutzers angegeben werden welche Menüpunkte dem Benutzer angezeigt werden:
+      rolle1:menüpunkt1,menüpunkt2;rolle2:menüpunkt2
+    </description>
+    <param-name>NAV_ROLE_CONFIG</param-name>
+    <param-value>2:abschlussarbeiten,prf,prf-zentral,studentendaten</param-value>
+  </init-param>
+In FN2LM werden die hochgeladenen Dateien dann nach den zugehörigen Prüfungen sortiert zum Download aufgelistet. Es können einzelne Dateien oder mehrere gezip heruntergeladen werden. Der ZIP-Datei wird eine Übersichtstabelle in CSV-Format beigelegt, die auf Wunsch auch anonymisiert erstellt wird.
+{{ :fn2:arbeiten_herunterladen_lm.png |}}
+===== Download von Arbeiten im PA-Modul =====
+Ab [[releasenotes:fn2web2.04.11|Release 2.04.11]] können hochgeladene Arbeiten über das PA-Modul herunterlegaden und eingesehen werden:
+{{ :fn2:pa_download-abgabe.png?direct |}}
+Diese Funktion ist auf PDF-Dateien beschränkt und soll hauptsächlich der Kontrolle des Arbeitstitels, der beteiligten Prüfer u.Ä. dienen.
+Hierfür wurde mit [[releasenotes:fn2web2.04.11|Release 2.04.11]] eine neue Rolle 'FN2ServiceIntern' eingeführt, die einem Benutzer zugeordnet werden muss (siehe SQL-Skript 1265). Zudem müssen folgende Einträge in der Setup-Tabelle vorhanden und sinnvoll gefüllt sein:
+^ Parameter        ^    Wert    ^               Erklärung                 ^
+| PA_UPLOAD_ANZEIGEN | true/false | schaltet die Funktion an oder aus |
+| INTERN_USER | Kennung | Die Kennung des FN2ServiceIntern-Nutzers |
+| INTERN_PASS | Passwort | Das Passwort des FN2ServiceIntern-Nutzers |
+| INTERN_SERVER | URL | Die Adresse der FN2Service-Web-App |
+| INTERN_VERZEICHNIS | Dateipfad | Der Pfad (vom fn2Module-Verzeichnis ausgehend) in dem die heruntergeladenen PDFs zwischengespeichert werden sollen |
+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.
 ======Klausur-Upload======
-Da der Klausur-Upload weitestgehend die gleiche Infrastruktur wie der Datei-Upload nutzt, können die zugehörigen Parameter leicht abgeleitet werden:
+Da der Klausur-Upload weitestgehend die gleiche Infrastruktur wie der Datei-Upload nutzt, können die zugehörigen Parameter größtenteils abgeleitet werden:
 Die Parameter-Benamung bleibt gleich, es müssen lediglich die
   * Einträge in der in FN2SSS-web.xml statt dessen in die FN2LM-web.xml
-  * Einträge in der context.xml statt dessen mit FN2LM beginnen
+  * Einträge in der context.xml statt dessen mit 'FN2LM' beginnen
 Selbstverständlich müssen die Werte sinnvoll gewählt werden, z.B. sollte FN2LM.UPLOAD_SUFFIX den Wert "LM/" oder ähnlich haben.
@@ Zeile 146: / Zeile 202: @@
 Ist der Wert negativ, nicht vorhanden oder nicht als Zahl interpretierbar, können beliebig viele Uploads durchgeführt werden.
 =====Verschlüsselung=====
 Wenn gewünscht, können die hochgeladenen Klausuren zusätzlich verschlüsselt werden. Dazu muss in der FN2LM-web.xml ein Init-Parameter ENCRYPT_KLAUSUREN mit dem Wert true hinterlegt werden:
@@ Zeile 170: / Zeile 227: @@
   </init-param>
-Valide Werte können [[https://docs.oracle.com/javase/8/docs/technotes/guides/security/StandardNames.html#impl|hier]] entnommen werden (sind jedoch nicht alle implementiert, bei Bedarf bitte bei uns nachfragen).
+Valide Werte können [[https://docs.oracle.com/javase/8/docs/technotes/guides/security/StandardNames.html#impl|hier]] entnommen werden, sind jedoch nicht alle implementiert. Bei Bedarf bitte bei uns nachfragen.
 Die Parameter sind **alle optional**. Wenn sie nicht vorhanden sind, werden folgende Defaults genutzt: