Skriba Wiki
🚀

Schnittstelle für Stammdaten

Last edit: Sep 27, 2021
💡
In der Toggle Box finden Sie eine Übersicht der Themen dieser Seite:
Inhaltsverzeichnis

CSV-Schnittstelle

Damit die Stammdaten der Mitarbeitenden in Skriba immer auf dem aktuellsten Stand sind, ist es am einfachsten die Datenhoheit in ihrem bestehenden HRM-System zu belassen und die Daten mit unserer CSV-Schnittstelle in Skriba zu importieren.

Anforderungen an die Datei

Die generierte CSV-Datei muss die folgenden Anforderungen erfüllen, damit der Import funktioniert:
  • Encoding: UTF-8 ohne BOM
  • Trennzeichen: Semikolon
  • Zeilenende: CR-LF
  • Text: in doppelten Anführungszeichen
  • Escaping: Literale doppelte Anführungszeichen verdoppeln
  • Kopfzeile: muss in der Datei vorhanden sein

Beschreibung der Daten

Mit diesem CSV-Import werden die Stammdaten der Mitarbeitenden in Skriba importiert. In der nachfolgenden Tabelle finden Sie alle Spalten, welche für den Import benötigt werden, sowie eine kurze Beschreibung der Daten, welche im entsprechenden Feld erfasst werden müssen. Es müssen nicht zwingend alle Daten importiert werden. Sie haben folgende Möglichkeiten:
  • Möglichkeit 1: nur Stammdaten, d.h. Personalnummer, Geburtsdatum, Heimatort, Vorname, Nachname, Geschlecht und Austrittsdatum
  • Möglichkeit 2: Stammdaten inkl. Angaben zur Beschäftigung (6 Spalten)
  • Möglichkeit 3: Stammdaten inkl. Angaben zur Beschäftigung und zu Ausbildungen (4 Spalten)
Wenn sie sich für die Möglichkeit 2 entscheiden, müssen bei einer Person zwingend alle sechs Felder zur Beschäftigung erfasst werden. Lassen Sie eines der Felder offen, funktioniert der Import nicht. Das selbe gilt für die Ausbildung. Hier müssen ebenfalls zwingend alle vier Felder erfasst werden.
Vorschau einer CSV-Datei nur mit den Stammdaten
Vorschau einer CSV-Datei nur mit den Stammdaten
 
Hat eine angestellt Person mehrere Beschäftigungen oder mehrere Weiterbildungen absolviert, wird die Person zweimal im File erfasst, wobei die Stammdaten natürlich gleich bleiben.
Vorschau einer Mitarbeiterin, welche zwei Ausbildungen absolviert hat.
Vorschau einer Mitarbeiterin, welche zwei Ausbildungen absolviert hat.
 
Tabelle 1: Beschreibung der benötigten Daten
Tabelle 1: Beschreibung der benötigten Daten

Technische Angaben

Weiter benötigen wir von Ihnen die nachstehenden Informationen um die Schnittstelle aufzusetzen:
  • SFTP-Hostname
  • Benutzername und Passwort (oder SSH Key)
  • Pfad zum Ordner, in welchem sich folgende Datei befindet: mitarbeiter.csv (UTF-8)
  • Port, falls nicht Standard

FAQs

Müssen die Spalten genau in dieser Reihenfolge sein?
Ja, die Daten müssen zwingend in der Reihenfolge gemäss Tabelle 1 oben sein.
Muss ich bei allen Mitarbeitenden eine Beschäftigung erfassen
Nein, wichtig ist nur, dass wenn Sie bei einem Mitarbeitenden die Beschäftigung in Skriba erfasst haben wollen, müssen zwingend alle sechs Felder angegeben werden. Es müssen jedoch nicht alle Mitarbeitenden eine Beschäftigung haben. Sobald in Skriba anschliessend ein Zeugnis erstellt wird, muss jedoch manuell eine Beschäftigung ergänzt werden.