Home

Install dependencies for running .py script

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

python -m pip install --user requests
python -m pip install --user BeautifulSoup4
python -m pip install --user tabulate
python -m pip install --user qrcode
python -m pip install --user reportlab

python or python3 --> depending on system

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
    • or if needed with path: C:\Users\USER\AppData\Roaming\Python\Python312\Scripts\pyinstaller.exe --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