fix: improve csv import explanation

This commit is contained in:
Gregor Kleen 2020-01-15 16:35:04 +01:00
parent 5fb99a3d4b
commit 729a8e8bce
2 changed files with 43 additions and 19 deletions

View File

@ -10,37 +10,52 @@ $newline never
diesem Fall wird die fehlende Spalte so behandelt als enthielte sie in #
jeder Zeile eine leere Zelle).<br />
Spalten werden an ihrer Überschrift identifiziert. #
Die Überschrift darf daher nicht verändert oder entfernt werden.
Die Überschrift darf daher nicht verändert oder entfernt werden.<br />
Das verwendete Separator-Zeichen (Komma, Semikolon, Tabulator, #
...) wird beim Import automatisch erkannt.<br />
Beim Import wird stets die selbe Zeichenkodierung erwartet, wie #
sie auch für den CSV-Export eingestellt ist.
<dt .deflist__dt>Änderungen
<dd .deflist__dd>
Einige Zellen können durch den Import verändert werden.<br />
Nicht-änderbare Zellen werden ignoriert, falls diese verändert wurden.
Bei den meisten Zellen wird durch den Import der Stand der #
Datenbank dem Inhalt der Zelle angepasst (z.B. ein #
Klausurergebnis).<br />
Bei Zellen, wo dies nicht möglich ist (z.B. die #
Maximalpunktezahl einer Teilaufgabe), werden etwaige #
Unterschiede zum Stand der Datenbank ignoriert.
<dt .deflist__dt>Vorschau
<dd .deflist__dd>
Es wird eine Vorschau angezeigt, bevor irgendetwas tatsächlich geändert wird.<br />
In der Vorschau können dann auch nur teilweise Änderungen ausgewählt werden.
Es wird eine Vorschau angezeigt, bevor irgendetwas tatsächlich #
geändert wird.<br />
In der Vorschau kann dann auch eine beliebige Teilmenge der #
Änderungen zur Anwendung ausgewählt werden.
<dt .deflist__dt>Leere Zellen
<dd .deflist__dd>
Löschbare Zellen werden durch leere Zellen gelöscht oder auf eindeutige Werte gesetzt.
Löschbare Zellen werden durch leere Zellen gelöscht oder auf #
eindeutige Werte gesetzt.
<dt .deflist__dt>Konsistenz
<dd .deflist__dd>
<p>
Es werden nur konsistente Änderungen akzeptiert!
<p>
Daraus folgt, dass es sinnvoll sein kann, gewisse Zellen frei zu lassen; #
ändert man z.B. die Studienfachzuordnung eines Teilnehmers ab, #
so müsste man auch Abschluss und Fachsemester passend ändern.<br />
Da diese jedoch eindeutig sind, kann man diese Zellen einfach frei lassen.
Daraus folgt, dass es sinnvoll sein kann, gewisse Zellen frei #
zu lassen; ändert man z.B. die Studienfachzuordnung eines #
Teilnehmers ab, so müsste man auch Abschluss und #
Fachsemester passend ändern.<br />
Da diese jedoch eindeutig sind, kann man diese Zellen einfach #
frei lassen.
<dt .deflist__dt>Zeilen Identifikation
<dd .deflist__dd>
Mehrere Spalten werden zur Identifikation der Zeile verwendet.<br />
Es muss nicht in jeder Spalte der Zeile ein Wert vorhanden sein, #
so lange die Identifikation noch eindeutig ist.<br />
Sind mehrere Werte vorhanden, so müssen diese natürlich zueinander passen.
Mehrere Spalten werden zur Identifikation der Zeile #
verwendet.<br />
Es muss nicht in jeder Spalte der Zeile ein Wert vorhanden #
sein, so lange die Identifikation noch eindeutig ist.<br />
Sind mehrere Werte vorhanden, so müssen diese natürlich #
zueinander passen.
<dt .deflist__dt>Zeilen hinzufügen
<dd .deflist__dd>
Es können auch neue Zeilen hinzugefügt werden, sofern ausreichend #
eindeutige Informationen vorhanden sind; #
Es können auch neue Zeilen hinzugefügt werden, sofern #
ausreichend eindeutige Informationen vorhanden sind; #
z.B. können so Prüfungsteilnehmer nachgemeldet werden.
<dt .deflist__dt>Zeilen löschen
<dd .deflist__dd>

View File

@ -10,11 +10,20 @@ $newline never
the column will be treated as if every cell contained within it was #
empty).<br />
Columns are identified based on their heading. #
Thus column headings may not be modified or removed.
Thus column headings may not be modified or removed.<br />
The separator character (comma, semicolon, tabulator, ...) is #
detected automatically during import.<br />
Imported files are expected to use the character encoding, that #
is configured for CSV-export.
<dt .deflist__dt>Edits
<dd .deflist__dd>
Some cells can be changed when importing.<br />
Cells that cannot be changed are ignored, if they were changed.
For most cells, importing changes the current state of the #
database to reflect the content of the imported cell (i.e. exam #
results).<br />
For some cells this is not possible (i.e. the maximum number of #
points of an exam part). #
In that case all differences between the current state of the #
database and the content of the imported cell are ignored.
<dt .deflist__dt>Preview
<dd .deflist__dd>
Before any edits are applied a preview is shown of what would be done.<br />