Skip to content

Export and Filters

Rüdiger Beck edited this page Mar 12, 2023 · 12 revisions

1# Exports

Benutzerübernahme von ASV-BW

See: https://asv.kultus-bw.de/site/pbs-bw-new/get/documents/KULTUS.Dachmandant/KULTUS/Projekte/asv-bw/ASV_Hilfe/06_typische_ablaeufe.html

And: https://ask.linuxmuster.net/t/asv-bw-exportformat-fuer-schuelerdaten/6125/10

See the ASV-BW filter section below

Benutzerübernahme von LUSD

An hessischen Schulen muss man einen Lehrer/Verwaltungsmenschen konsultieren, der einen Auszug aus der Lehrer- bzw. Schülerdatei erstellen (Excel-, oder Access-Tabelle) darf. Dieser Auszug sollte bei Lehrern wie folgt aussehen:

Zuname;Vorname;Geburtsdatum;Loginname

Die Tabelle der LehrerInnen muss noch um eine Spalte erweitert werden. Sie sieht dann wie folgt aus:

lehrer;Zuname;Vorname;Geburtsdatum;Loginname

statt dem Wort "lehrer" kan auch etwas anderes stehen !

Der Auszug für die Schüler sollte folgendes enthalten:

Klassenname;Zuname;Vorname;Geburtsdatum

Aus diesen Excel- Access-Tabellen generiert man Semikolon getrennte .csv-Dateien.

Umlaute NICHT mehr ersetzen!

For other exports see here:

https://wiki.linuxmuster.net/archiv/dokumentation:sophomorix:schulverwaltungsprogramme

Filters

Filters are executable scripts, that are used not only to copy an import file, but modify it.

A filter script usable in sophomorix must have the following properties:

  • It must be executable
  • I muste be called with a path without whitespace on the server
  • It must accept and use at least the parameters SOURCE and TARGET
    • Example: /path/to/script --opt1 ... SOURCE TARGET
      • SOURCE: absolut path of input file
      • TARGET: absolut path of output file

The filter is called instead of a copy command.

ASV-BW filter

The ASV-BW Filter will order the colums according to the headers in the exported file.

Testing the filter:

/usr/share/sophomorix/filter/asv-csv.filter /path/to/file /path/to/output/file

To use the ASV-BW filter, that is included in sophomorix (=>3.81.9-1), do the following:

  [userfile.students.csv]
          FILTERSCRIPT=/usr/share/sophomorix/filter/asv-csv.filter

sophomorix-newfile will use this filter the next time.

Warning: The script /usr/share/sophomorix/filter/asv-csv.filter is part of the sophomorix4 package and is overwritten on package updates. If you need to modify it. If you have suggestions or improvement create an issue on github.

Atlantis filter

To use the Atlantis filter, that is included in sophomorix, do the following:

  [userfile.students.csv]
          FILTERSCRIPT=/usr/share/sophomorix/filter/atlantis-csv-listenauswahl.filter 2019/20

2019/20 is a parameter passed to the script.

Clone this wiki locally