Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- fn2:datei-upload [2021/01/19 10:07] – christoph
+++ fn2:datei-upload [2023/03/10 09:54] – [Download der Dateien in FN2LM] christoph
@@ Zeile 9: / Zeile 9: @@
 Der Datei-Upload wird in FN2WEB ab Version 2.04.02.000 und in den fn2Modulen ab dem Release vom 18.02.2019 (Version 2.0.6988.25824) unterstützt.
-Seitens der Datenbank werden die Tabellen DATEI_UPLOAD und PRFSTD_ENDGUELTIG benötigt. Zudem werden die Spalten END_TIMESTAMP und ENDGUELTIG in der Tabelle PRFSTD und die Spalte HOCHLADEN in der Tabelle TEILPRF erwartet. Falls diese nicht vorhanden sind, bitte nochmal die veröffentlichten SQL-Skripte aus dem Zeitraum November 2018 bis Februar 2019 durchgehen.
+<wrap important>Bis Release 2.04.09:</wrap>\\
+Seitens der Datenbank werden die Tabellen DATEI_UPLOAD und PRFSTD_ENDGUELTIG benötigt.
+<wrap important>Ab Release 2.04.10:</wrap>\\
+Seitens der Datenbank werden die Tabellen UPLOAD, PRFSTD_UPLOAD und PRFSTD_ENDGUELTIG benötigt.
+Zudem werden die Spalten END_TIMESTAMP und ENDGUELTIG in der Tabelle PRFSTD und die Spalte HOCHLADEN in der Tabelle TEILPRF erwartet. Falls diese nicht vorhanden sind, bitte nochmal die veröffentlichten SQL-Skripte aus dem Zeitraum November 2018 bis Februar 2019 durchgehen.
 Folgend werden die nötigen Konfigurationsparameter mit **beispielhaften** Werten aufgelistet. Auf deren Bedeutung wird im Abschnitt [[datei-upload#Konfiguration]] näher eingegangen.
@@ Zeile 43: / Zeile 49: @@
 erwartet.
+Falls der Menüpunkt zum Hochladen von Arbeiten in FN2SSS ausgeblendet ist, muss aus dem Value des Init-Parameters 'NAV_CONFIG' der Eintrag 'datei_upload' entfernt werden.
 ====FN2XML/WEB-INF/web.xml====
@@ Zeile 54: / Zeile 62: @@
 =====Konfiguration=====
-Viele Aspekte des Datei-Uploads lassen sich bereits jetzt, meist über die im vorhergehenden Abschnitt vorgestellten Parameter, konfigurieren.
+Viele Aspekte des Datei-Uploads lassen sich, meist über die im vorhergehenden Abschnitt vorgestellten Parameter, konfigurieren.
 ====Speicherort====
@@ Zeile 74: / Zeile 82: @@
 ====MIME-Typ====
-Mit dem Parameter FN2SSS.UPLOAD_MIME werden für den Upload zulässige MIME-Typen nach [[https://tools.ietf.org/html/rfc2046|RFC2046]] hinterlegt. Wie schon in der Beschreibung erklärt, müssen die einzelnen Typen mit Doppelpunkten getrennt werden, z.B. würde ein value von
+Mit dem Parameter FN2SSS.UPLOAD_MIME müssen für den Upload zulässige MIME-Typen nach [[https://tools.ietf.org/html/rfc2046|RFC2046]] hinterlegt werden. Wie schon in der Beschreibung erklärt, müssen die einzelnen Typen mit Doppelpunkten getrennt werden, z.B. würde ein value von
   application/pdf:text/plain
 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.
-<WRAP center round important 60%>
-Java kennt von sich aus nur einige wenige Basis MIME-Typen.
+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.
-</WRAP>
-Wenn "exotischere" Typen gewünscht werden, bitten wir um Rücksprache um diese ggf. einfügen zu können. (z.B. zählen schon Word Documente (.doc/.docx) zu den Java-unbekannten Typen)
 ====Begrenzung der Datei/Upload-Größe====
@@ Zeile 91: / Zeile 97: @@
 Die maximal Anzahl an hochladbaren Dateien wird in der Tabelle TEILPRF in der Spalte HOCHLADEN für jede Teilprüfung separat angegeben.
+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.
-=====Optionaler Eintrag in context.xml=====
+Zur Erinnerung:
+kB = 2^10 B = 1024 B
+MB = 2^20 B = 1048576 B
+=====Optionale Einträge in context.xml=====
+<wrap important>**Gilt ab Release** [[releasenotes:fn2web2.04.11|2.04.11]]:</wrap>(WIP)
+  <Parameter description="Sollen bei finaler Abgabe Mails verschickt werden? (true/false)" name="FN2SSS.SEND_MAIL_FINALE_ABGABE" value="true"/>
+Wenn der Parameter vorhanden ist 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. Diese müssen im PO-Modul konfiguriert werden.
+<wrap important>**Gilt ab Version** [[releasenotes:fn2web2.04.08|2.04.08.007]]:</wrap>
+Optional kann der Zeitpunkt angegeben werden, zu dem täglich nach abgabefälligen Uploads gesucht wird.
+  <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.
+<wrap important>**Gilt bis Version** [[releasenotes:fn2web2.04.08|2.04.08.006]]:</wrap>
 Optional kann das Intervall angegeben werden, in dem nach abgabefälligen Uploads gesucht wird.
@@ Zeile 100: / 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=====
+Mit fn2Web-Release [[releasenotes:fn2web2.04.10|2.04.10]] und folgend, werden die zugehörigen Textschnippsel, Überschriften, etc. von Custvalues auf .properties-Dateien umgestellt. Die aktuellen Beispiele für den Datei-Upload, upload_de.properties und upload_en.properties, befinden sich unter .../Konfigurationsdateien/FN2SSS/WEB-INF/classes/de/ihb/flexnow/ss/properties (siehe auch die zugehörigen Patchnotes).
+Die Umarbeitung der Lokalisierung via Properties ist im Moment work in progress. Wir bitten die damit verbundenen Unannehmlichkeiten zu entschuldigen.
+=====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, bzw. im Init-Parameter 'NAV_ROLE_CONFIG' bei einer gewünschten Rolle hinzugefügt werden.
+=====Download von Arbeiten im PA-Modul (WIP)=====
+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 begrenzt 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 können |
+Da das Passwort im Klartext abgelegt wird (analog zum Druck-User), raten wir dringends dazu hierfür einen extra Nutzer anzulegen.
 ======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 weitestgehend 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 119: / Zeile 178: @@
 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: