Zum Inhalt springen
PynPyn

Employee File

Employee File macht aus einer Tabelle dein Mitarbeitendenverzeichnis. Jede Zeile ist eine Person, jede Spalte eine Pyn-Eigenschaft, und jeder Upload ist deine vollständige Belegschaft: Zeilen werden anhand der employeeId hinzugefügt oder aktualisiert, und wer in der Datei fehlt, wird als aus dieser Quelle entfernt markiert. Pyn validiert die Datei, bevor etwas gespeichert wird, und sagt dir, welche Zeilen und Spalten es nicht lesen konnte.

  • Du bist Admin oder Owner.
  • Bereite eine CSV-, XLS- oder XLSX-Datei vor, deren Spaltenüberschriften die Eigenschaftsnamen unten sind. Download Sample File gibt dir eine CSV mit allen Spalten und fünf Beispielzeilen.
  • Jede Zeile braucht employeeId und primaryEmail. Für Mitarbeitende in einem Land mit mehreren Zeitzonen gib eine timeZone an; für die USA, Kanada und Australien reicht ein postalCode zusammen mit dem country. Sonst wird die Zeile abgewiesen.
The Installed view with the Employee File panel open, showing Download Sample File and Upload.
Die Integration Employee File unter Installed mit geöffnetem Upload-Panel.
  1. Öffne in Pyn Settings in der linken Navigation, dann Available unter Integrations.

  2. Wähle die Kachel Employee File; ihr Titelbild zeigt File Upload. Pyn erstellt die Integration und öffnet ihr Panel: „Upload a spreadsheet of your employees to get started. Use the sample file to see the expected columns.“ Kann die Integration nicht erstellt werden, zeigt ein Dialog mit dem Titel Add Employee File: „We could not create the Employee File integration. Please try again or contact support.“

  3. Wähle Download Sample File und baue deine Datei darauf auf und behalte die Kopfzeile bei.

  4. Wähle Upload und deine Datei. Das Panel zeigt Uploading…, während es validiert und speichert.

  5. Bei Erfolg zeigt es „Success! Uploaded n records. Head over to the Directory to see employees after processing completes. This can take a minute or two.“

Schlagen Zeilen fehl, listet das Panel die ersten fünf unter „There were n errors found in the uploaded file:“ mit Zeile und Problem sowie der Anzahl der übrigen, zum Beispiel Unknown country: "Engalnd", Could not determine timezone from country "United States". Add a postal code or choose a time zone. oder Invalid birthday format. Expected MM-dd, dd/MM, yyyy-MM-dd or ISO8601 datetime. Solange eine Zeile fehlschlägt, wird nichts gespeichert. Korrigiere die aufgeführten Zeilen und lade die ganze Datei erneut hoch.

Spalte Pflicht Hinweise
employeeId Ja Deine stabile ID für die Person; Uploads gleichen darüber ab
primaryEmail Ja Geschäftliche E-Mail, auch zum Abgleich von Slack- und Google-Konten genutzt
displayName, legalName, preferredName, jobTitle
personalEmail, secondaryEmail, avatarUri Die private E-Mail wird fürs Pre-Boarding genutzt
status active, inactive oder leave; leer bedeutet active
startDate, terminationDate, tenureDate yyyy-MM-dd oder yyyy/MM/dd oder eine Datumszelle in einer .xls- oder .xlsx-Datei; ein Datum, das es nicht gibt, wird abgewiesen
birthday MM-dd, dd/MM, yyyy-MM-dd oder ein ISO-Datum mit Uhrzeit
country, postalCode, timeZone Land als Name oder ISO-Code; Zeitzone als IANA-Name wie Europe/London. Eine Zahlenzelle in einer .xls- oder .xlsx-Datei wird so gelesen, wie die Tabelle sie anzeigt, eine Postleitzahl im Format 00000 behält also ihre führenden Nullen
businessUnit, department, division, location, team Werden zu Demografien und Gruppen
managerId, buddyId, hrbpId, mentorId Die employeeId der verbundenen Person

Es gibt keine geplante Aktualisierung; die Datei wird gelesen, wenn du sie hochlädst. Der Tab Advanced listet Fields in Employee File mit einer Anzahl pro Spalte. Du kannst auch jeweils eine einzelne Person mit Add employee in Employees hinzufügen, was nach Full name*, Preferred name, Work email, Personal email, Start date*, Country*, Time zone* und Manager fragt und sie als kommenden Neuzugang anlegt.

Öffne ein oder zwei Minuten nach dem Upload Employees. Aktive Zeilen erscheinen unter Active, künftige Startdaten unter Upcoming und Zeilen mit dem status inactive unter Inactive. Öffne eine Person, um ihre Verknüpfung zur Führungskraft zu prüfen.

Es gibt keine Zugangsdaten. Lade eine neue Datei hoch, um Daten zu ändern, und lade immer alle hoch: Eine Zeile, die in einer späteren Datei fehlt, wird als aus dieser Quelle entfernt markiert, und die Person gilt als inaktiv; steht sie in einer späteren Datei wieder, kommt sie mit dem status dieser Zeile zurück. Deactivate behält die Daten, ignoriert aber Uploads; Activate aktiviert sie wieder.

Was du siehst Was es bedeutet
„The uploaded file was empty“ Keine Datenzeilen unter der Kopfzeile, oder die Kopfzeile fehlt.
Ein Zeilenfehler, der country oder postalCode nennt Der Ländername wurde nicht erkannt, oder die Postleitzahl ergab keine Zeitzone. Ergänze timeZone.
Eine Führungskraft ist nicht verknüpft managerId passt zu keiner employeeId einer Zeile.
Jemand erscheint doppelt employeeId und E-Mails der Person haben sich zwischen den Uploads alle geändert, nichts passte also zum früheren Datensatz. Halte IDs und E-Mails stabil.