fradrive/templates/i18n/table/csv-import-explanation/en-eu.hamlet
2019-10-29 14:21:23 +01:00

55 lines
2.4 KiB
Plaintext

$newline never
<h3>Remarks regarding CSV import
<dl .deflist>
<dt .deflist__dt>Data formatting
<dd .deflist__dd>
When importing the format expected (per column) is the same as it would be #
produced when exporting (see <i>Column & cell format</i> under #
<i>CSV export</i>).<br />
Columns may be permuted arbitrarily or left out completely (in that case #
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.
<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.
<dt .deflist__dt>Preview
<dd .deflist__dd>
Before any edits are applied a preview is shown of what would be done.<br />
In the preview an arbitrary subset of edits may be selected for #
application.
<dt .deflist__dt>Empty cells
<dd .deflist__dd>
Cells which may be deleted are deleted or set to uniquely determined #
values if the corresponding cell is empty during import.
<dt .deflist__dt>Consistency
<dd .deflist__dd>
<p>
Only consistent edits are ever made!
<p>
Thus it can be useful to leave certain cells empty. #
For example when changing the associated field of study for a course #
participant one would have to change the degree and semester to match if #
they are not left empty.<br />
If they are left empty they are automatically filled in if their values #
can be uniquely determined (which is usually the case).
<dt .deflist__dt>Identification of rows
<dd .deflist__dd>
Multiple columns may be used to identify each row.<br />
Thus not every cell used to identify a row needs to be filled, as long as #
the row can still be uniquely identified.<br />
If multiple columns used for identification are not empty their values #
need to be consistent.
<dt .deflist__dt>Adding rows
<dd .deflist__dd>
Additional rows may be added as long as sufficient information is #
provided. #
For example course participants may be added this way.
<dt .deflist__dt>Deleting rows
<dd .deflist__dd>
Rows that are missing in the imported file are offered up for deletion #
during the edit preview.