Skip to content
t-markmann edited this page Aug 24, 2023 · 4 revisions

Install dependencies for running .py script

Install python dependencies as you like and as it works in your environment. For example:

python3 -m pip install --user requests
python3 -m pip install --user BeautifulSoup4
python3 -m pip install --user tabulate
python3 -m pip install --user qrcode
python3 -m pip install --user reportlab\

You can now run the python script. Make sure the .py file is executable.

Build release packages

Please note: you don't have to build release packages to run the script! Having release packages is just a comfortable way to let other admins/users use this tool (without dealing with python dependencies).

Make sure you have all the Python packages installed. Including pyinstaller.

  • python3 -m pip install --user pyinstaller
  • git clone https://github.com/t-markmann/nc-userimporter.git
  • cd nc-userimporter
  • build with pyinstaller
    • Win / Linux: pyinstaller --onefile nc-userimporter.py
    • MAC: ~/Library/Python/3.7/bin/pyinstaller --onefile nc-userimporter.py
  • Pack it up. Exclude from zip/tgz file: nc-userimporter.py

TODO: Documentation

Neue Funktionen:

  • wählbarer Name der csv-Datei (zum Import verschiedener Nutzergruppen)
  • automatische Transformation von Umlauten für den Nutzernamen
  • optionales automatisches Generieren eines Passwortes, wenn dieses nicht in der csv-Datei festgelegt ist
  • Generierung fehlender Gruppen während des Nutzerimports
  • Generierung einer PDF-Datei für jeden angelegten Benutzer mit Login-Daten und QR-Code für die Nextcloud-App
  • Wahlweise Generierung von einzelnen PDF-Dokumenten oder einem Gesamtdokument
  • Spezieller Nutzer-Import-Modus für EduDocs-Nutzer (www.edudocs.org), der einen sicheren Import von Schüler- und Lehrerdaten gewährleistet:
    • man kann zeitgleich nur eine spezifizierte Nutzergruppe wie Lehrkraefte oder SchuelerInnen importieren. Das heißt, man muss mehrere csv-Dateien anlegen, die nacheinander importiert werden.
    • Wenn Lehrkraefte importiert werden, wird die Nutzergruppe SchuelerInnen automatisch gelöscht und umgekehrt.
    • Schüler können nicht automatisch Gruppenadmin werden.
    • PDF-Generierung im EduDocs-Design