Zum Inhalt springen
Developer

Qualifikationen

Ihr legt die Qualifikationen eurer Mitarbeitenden an, etwa Ausbildungen oder Lizenzen, mit Beschreibung und Rangfolge.

Format
CSV (Komma oder Semikolon), UTF-8
Rechte
Personal (schreiben)
Beispieldateien
AFS_QUALIFICATION_beispiel_technisch.csv (technische Spaltennamen)
AFS_QUALIFICATION_beispiel_anwender.csv (deutsche Spaltennamen)

Kurz gesagt: Mit dieser Datei legt ihr die Qualifikationen an, zum Beispiel eine Übungsleiterlizenz oder einen Erste-Hilfe-Kurs, oder ändert bestehende. Der Dateiname muss AFS_QUALIFICATION enthalten.

Wofür ihr das braucht

Qualifikationen beschreiben, welche Ausbildungen oder Nachweise eure Mitarbeitenden haben. Sie sind die Grundlage, um Personen für Aufgaben einzuteilen. Mit einer Tabelle richtet ihr alle Qualifikationen auf einmal ein.

Bevor ihr startet

  • Rechte: Ihr braucht das Schreibrecht für den Bereich Personal.
  • Sicherung: Ein Import lässt sich nicht auf Knopfdruck zurücknehmen. Zieht vor größeren Änderungen einen Export der betroffenen Daten unter Einstellungen → Export.

Datei vorbereiten

  • Dateiname: Muss AFS_QUALIFICATION enthalten, z. B. AFS_QUALIFICATION_qualifikationen.csv. Die Schreibweise muss genau so sein, Groß- und Kleinschreibung zählt.
  • Format: CSV. Trennzeichen ist Semikolon ; oder Komma ,. Texte mit Trennzeichen setzt ihr in Anführungszeichen "…".
  • Kopfzeile: Die erste Zeile enthält die Spaltennamen. Die Spalte QUALIFICATION_ID muss ausgeschrieben vorkommen, in Groß- oder Kleinschreibung. Die deutsche Schreibweise Qualifikation ID erkennt vynst nicht.
  • Nummer: QUALIFICATION_ID ist eure eigene Nummer der Qualifikation. Sie wird bei späteren Importen wiedererkannt. Leerzeichen am Anfang oder Ende werden nicht entfernt.
  • Ja/Nein: ja oder nein, auch 1 oder 0 und true oder false.

Spalten

Spalte Pflicht Inhalt Beispiel
QUALIFICATION_ID ja Eure Nummer der Qualifikation. Auch erlaubt: qualification_id und QUALIFICATION_IDENTIFIER. Die Spalte muss diesen Namen tragen, sonst erkennt vynst die Datei nicht. UEL-C
NAME nein Name der Qualifikation. Auch erlaubt: Name. Leer lässt den bisherigen Namen stehen. Übungsleiter C Lizenz
INTERNAL_DESCRIPTION nein Interne Beschreibung, für euch. Auch erlaubt: Interne Beschreibung. Lizenz gültig vier Jahre
EXTERNAL_DESCRIPTION nein Beschreibung für die Außendarstellung. Auch erlaubt: Beschreibung, Externe Beschreibung. Lizenziert
DELETED nein Ja/Nein: als gelöscht markieren. Auch erlaubt: Gelöscht. nein
RANKING nein Rangfolge als ganze Zahl. Leer lässt den bisherigen Wert stehen. 2
IMPORT_IDENTIFIER_PREFIX nein Vorsatz für die Nummer, wenn ihr einen eigenen verwenden wollt. Ohne diese Spalte gilt AFS_QUALIFICATION_. Lasst die Zelle nicht leer, sonst fehlt der Vorsatz. AFS_QUALIFICATION_

Beispiel

QUALIFICATION_ID;NAME;INTERNAL_DESCRIPTION;EXTERNAL_DESCRIPTION;DELETED;RANKING;IMPORT_IDENTIFIER_PREFIX
ERSTHELFER;Erste Hilfe;;Kurs mit Nachweis;nein;1;AFS_QUALIFICATION_
UEL-C;Übungsleiter C Lizenz;Lizenz gültig vier Jahre;Lizenziert;nein;2;AFS_QUALIFICATION_

Beispieldateien: AFS_QUALIFICATION_beispiel_technisch.csv mit den technischen Spaltennamen, AFS_QUALIFICATION_beispiel_anwender.csv mit den deutschen Spaltennamen.

Die Qualifikationen Erste Hilfe und Übungsleiter C Lizenz stehen danach in vynst zur Verfügung. Die Spalte RANKING legt die Rangfolge fest. Die Anwender-Datei enthält dieselben Zeilen mit den deutschen Spaltennamen. Die Spalte QUALIFICATION_ID heißt dort ebenfalls so, weil die Erkennung diesen Namen braucht.

So geht’s

  1. Öffnet Einstellungen → Import.
  2. Klickt auf Hinzufügen und wählt die Datei aus. Der Dateiname muss AFS_QUALIFICATION enthalten.
  3. Die Datei erscheint in der Liste und wird im Hintergrund verarbeitet. Prüft danach das Protokoll.

Gut zu wissen

  • Erneuter Import: Eine bekannte Nummer aktualisiert die vorhandene Qualifikation. Eine neue Nummer legt eine neue Qualifikation an. Behaltet die Nummern bei.
  • Leere Zellen: Ein leerer Name, eine leere Rangfolge oder ein leerer Wert bei DELETED lassen den bisherigen Wert stehen. Eine leere Beschreibung wird dagegen geleert.
  • Verknüpfungen: Gleichwertigkeiten zwischen Qualifikationen gehören nicht zur Datei. Pflegt sie nach dem Import in vynst.
  • Unbekannte Werte: Steht bei DELETED etwas anderes als ja, nein, 1, 0, true oder false, gilt der Wert als nein.

Wenn etwas nicht klappt

Meldung im Protokoll Bedeutung Was tun
FAILED: No matching processor found. Dateiname oder Kopfzeile passen zu keinem Import Dateiname mit AFS_QUALIFICATION und die Spalte QUALIFICATION_ID prüfen
FAILED: User missing rights to import. Euch fehlt das Recht Personal Administrator fragen
Error: skipped empty line Leere Zeile, wird übersprungen Nichts tun oder leere Zeilen entfernen
Error: skipped missing identifier QUALIFICATION_ID fehlt oder ist 0. Die Zeile steht direkt darunter als LINE-DATA. Nummer ergänzen
Error: less then one line Die Datei enthält keine Datenzeilen Datei prüfen

Siehe auch

  • Trainerqualifikationen: Qualifikationen für Trainerinnen und Trainer.
  • Import-Überblick: Allgemeines zu Dateien, Kopfzeilen und Protokoll.