~/upload/
Daten werden jeweils um 03:00 Uhr und um 15:00 Uhr automatisch importiert.
Durch den Klick auf importieren, kann der Mechanismus auch manuell getriggert werden.
Notiz: Je nach Größe der Datei kann dieser Prozess 1-2 Stunden benötigen.
Bei erfolgreicher Übermittlung erhalten Sie auch die Information, wann dieser Import erfolgreich durchgeführt worden ist.
Honestly Server
Hostname:datafeed.honestly.com
Verzeichnis: ~/upload/
Authentifizierung
Die Authentifizierung funktioniert über eine passwortlose Authentifizierung (ssh key authentication). Auf diese Weise kann der zugehörige öffentliche Schlüssel mit Honestly über einen ungesicherten Kanal wie beispielsweise E-Mail geteilt werden. The öffentliche Schlüssel muss im ssh-rsa Format zugesendet werden. Beispiel: Öffentlicher Schlüssel
CSV Datei
Der Dateiname muss employees.csv lauten. Die Datei muss mit dem UTF-8 Zeichensatz ohne BOM enkodiert sein. Die Daten müssen mit einem Komma separiert sein. Die Daten müssen mit doppelten Anführungszeichen umschlossen sein. Die erste Zeile der Datei muss die Spaltennamen enthalten. Die Reihenfolge spielt dabei keine Rolle. Die Spaltenüberschriften müssen genau so geschrieben werden wie unten im Beispiel und es muss auf Groß- und Kleinschreibung geachtet werdenErforderliche Spalten
Die folgenden Spalten müssen in der CSV Datei enthalten sein. Darüber hinaus muss für jeden Mitarbeiter ein Wert vorhanden sein, sonst wird dieser nicht importiert.Die ImportId eines Mitarbeiters kann nachgehend nicht angepasst werden und wird beim ersten Upload durch die Datei gesetzt. In den meisten Fällen wird hier die HR ID des Mitarbeiters verwendet.
Optional: Die Sprache des Mitarbeiters
Optional: Zusätzliche Mitarbeitergruppen
Basierend auf der Konfiguration von Mitarbeitergruppen in der Webanwendung können zusätzliche Mitarbeiterdaten einbezogen werden, um detailliertere Einblicke zu erhalten. Daher muss die CSV-Datei um diese zusätzlichen Spalten im String-Datenformat erweitert werden. In der Web-Anwendung kann der Benutzer auswählen, welche Mitarbeiterdaten tatsächlich als Filter auf dem Dashboard angezeigt werden sollen.Optional: Rollen und Berechtigungen
Mitarbeiter haben Zugang zu den Ergebnissen auf der Grundlage ihrer “berichtet an”-Beziehung, zusätzlich zu der Berechtigung für bestimmte Mitarbeitergruppen. ReportsToId oder PermissionGroup und PermissionGroupValue können leer sein.
Verwenden Sie
*, um Benutzern Zugang auf alle Daten zu gewähren
Verfügbare Rollen
Beispieldatei mit einer Abteilungs- und Standort-Mitarbeitergruppe
Name: employees.csv Inhalt:“ImportId”,“Email”,“Firstname”,“Lastname”,“Language”,“Department”,“Location”,“ReportsToId”,“Role”,“PermissionGroup”,“PermissionGroupValue” “1”,“john@norealmail.com”,“John”,“Smith”,“en”,“IT”,“Germany”,"",“Admin”,"","" “2”,“anna@norealmail.com”,“Anna”,“Peters”,“de”,“Sales”,“Switzerland”,"",“Analyst”,"","" “3”,“lucas@norealmail.com”,“Lucas”,“Jansen”,“nl”,“Customer Success”,“Germany”,“1”,“Manager”,“Location”,“Germany” “4”,“afrodita@norealmail.com”,“Afrodita”,“Shehu”,“sq”,“Finance”,“UK”,"",“Manager”,“Location”,“Germany” “5”,“harun@norealmail.com”,“Harun”,“Divjak”,“bs”,“Marketing”,“UK”,“4”,“Manager”,“Location”,“UK”
Import Mechanismus
Diese Datei wird zweimal täglich importiert (gegen 02:00 - 04:00 Uhr morgens und 14:00 - 16:00 Uhr nachmittags). Nach einem erfolgreichen Import wird die Importdatei aus dem Ordner entfernt.Wenn Sie den automatischen Upload wählen, werden alle 12 Stunden alle manuellen Änderungen überschrieben.
- Import cancelled because of errors while loading employees data from integration
- Employee with email EMAIL already exists with import id IMPORT_ID, and cannot be imported with id NEW_IMPORT_ID.
-
Cannot create employee: EMAIL
This covers errors while creating an employee that are not covered by the “Employee with email … already exists” error -
Cannot update employee: EMAIL
This covers system errors while trying to update an employee - Import: skip employee because email already exists EMAIL
-
Import cancelled:
There are ‘COUNT_CURRENT_EMPLOYEES’ employees in your account, and the update was going to delete ‘COUNT_DELETE_EMPLOYEES’ employees.
To prevent accidental deletion of too much data import is cancelled if it would delete more than MAX_ALLOWED_DELETED_PERCENTAGE 20% of employees.
In your account this means ‘MAX_ALLOWED_DELETED_ABSOLUTE_COUNT’ employees.
- Row number ROW_NUMBER in csv file is missing ImportId. Import is cancelled to prevent data corruption.
- Cannot read employee from csv file row number ROW_NUMBER. Ignoring bad employee record ImportId: IMPORT_ID
- Import file has bad/empty header
- Bad CSV
- No entries in file
- CSV header is missing mandatory field: MANDATORY_FIELD