Employee File
Employee File maakt van een spreadsheet je medewerkersdirectory. Elke rij is één medewerker, elke kolom een eigenschap in Pyn, en elke upload is je volledige personeelsbestand: rijen worden toegevoegd of bijgewerkt op employeeId, en wie in het bestand ontbreekt wordt gemarkeerd als verwijderd uit deze bron. Pyn valideert het bestand voordat er iets wordt opgeslagen en vertelt je welke rijen en kolommen het niet kon lezen.
Voordat je begint
Section titled “Voordat je begint”- Je bent admin of owner.
- Maak een CSV, XLS of XLSX waarvan de kolomkoppen de namen van de eigenschappen hieronder zijn. Download Sample File geeft je een CSV met elke kolom en vijf voorbeeldrijen.
- Elke rij heeft
employeeIdenprimaryEmailnodig. Geef voor medewerkers in een land met meerdere tijdzones eentimeZone; voor de VS, Canada en Australië volstaat eenpostalCodesamen met hetcountry. Anders wordt de rij geweigerd.

Koppelen
Section titled “Koppelen”-
Open in Pyn Settings in de linkernavigatie, en dan Available onder Integrations.
-
Selecteer de tegel Employee File; de omslag leest File Upload. Pyn maakt de integratie aan en opent het paneel: “Upload a spreadsheet of your employees to get started. Use the sample file to see the expected columns.” Kan de integratie niet worden aangemaakt, dan meldt een dialoogvenster met de titel Add Employee File: “We could not create the Employee File integration. Please try again or contact support.”
-
Selecteer Download Sample File en gebruik het als basis voor je bestand, met behoud van de kopregel.
-
Selecteer Upload en kies je bestand. Het paneel toont Uploading… terwijl het valideert en opslaat.
-
Bij succes leest het “Success! Uploaded n records. Head over to the Directory to see employees after processing completes. This can take a minute or two.”
Mislukken er rijen, dan toont het paneel de eerste vijf onder “There were n errors found in the uploaded file:” met de rij en het probleem, en een aantal voor de rest, bijvoorbeeld Unknown country: "Engalnd", Could not determine timezone from country "United States". Add a postal code or choose a time zone. of Invalid birthday format. Expected MM-dd, dd/MM, yyyy-MM-dd or ISO8601 datetime. Er wordt niets opgeslagen zolang een rij mislukt. Herstel de genoemde rijen en upload het hele bestand opnieuw.
Wat er wordt gesynchroniseerd
Section titled “Wat er wordt gesynchroniseerd”| Kolom | Verplicht | Opmerkingen |
|---|---|---|
employeeId |
Ja | Je stabiele id voor de persoon; uploads matchen erop |
primaryEmail |
Ja | Zakelijk e-mailadres, ook gebruikt om Slack- en Google-accounts te matchen |
displayName, legalName, preferredName, jobTitle |
||
personalEmail, secondaryEmail, avatarUri |
Het persoonlijke e-mailadres wordt gebruikt voor pre-boarding | |
status |
active, inactive of leave; leeg betekent active |
|
startDate, terminationDate, tenureDate |
yyyy-MM-dd of yyyy/MM/dd, of een datumcel in een .xls- of .xlsx-bestand; een datum die niet bestaat wordt geweigerd |
|
birthday |
MM-dd, dd/MM, yyyy-MM-dd of een ISO-datum-tijd |
|
country, postalCode, timeZone |
Land als naam of ISO-code; tijdzone als IANA-naam zoals Europe/London. Een getalcel in een .xls- of .xlsx-bestand wordt gelezen zoals het blad hem toont, dus een postcode in een 00000-notatie houdt zijn voorloopnullen |
|
businessUnit, department, division, location, team |
Worden demografieën en groepen | |
managerId, buddyId, hrbpId, mentorId |
Het employeeId van de gerelateerde persoon |
Er is geen geplande verversing; het bestand wordt gelezen wanneer je het uploadt. Het tabblad Advanced toont Fields in Employee File met een aantal per kolom. Je kunt ook één persoon tegelijk toevoegen met Add employee in Employees, dat vraagt om Full name*, Preferred name, Work email, Personal email, Start date*, Country*, Time zone* en Manager, en de persoon toevoegt als aankomende joiner.
Testen
Section titled “Testen”Open Employees een minuut of twee na de upload. Actieve rijen verschijnen onder Active, toekomstige startdatums onder Upcoming, en een status van inactive onder Inactive. Open een persoon om de koppeling met de manager te controleren.
Opnieuw koppelen of ontkoppelen
Section titled “Opnieuw koppelen of ontkoppelen”Er zijn geen inloggegevens. Upload een nieuw bestand om gegevens te wijzigen, en upload altijd iedereen: een rij die in een later bestand ontbreekt, wordt gemarkeerd als verwijderd uit deze bron en de persoon wordt als inactief weergegeven; staat die persoon in een later bestand weer op de lijst, dan komt hij terug met de status van die rij. Deactivate behoudt de gegevens maar negeert uploads; Activate schakelt ze weer in.
Problemen oplossen
Section titled “Problemen oplossen”| Wat je ziet | Wat het betekent |
|---|---|
| “The uploaded file was empty” | Geen gegevensrijen onder de kopregel, of de kopregel ontbreekt. |
Een rijfout die country of postalCode noemt |
De landnaam is niet herkend, of de postcode leverde geen zone op. Voeg timeZone toe. |
| Een manager is niet gekoppeld | managerId komt met geen enkele employeeId van een rij overeen. |
| Iemand staat er twee keer in | Zijn of haar employeeId en e-mailadressen zijn tussen twee uploads allemaal veranderd, dus niets matchte met het eerdere record. Houd id’s en e-mailadressen stabiel. |
Gerelateerd
Section titled “Gerelateerd”- Integrations voor de HRIS-alternatieven.
- Employees om de geüploade records te controleren en één persoon toe te voegen.
- Synchronisatiefrequentie en matching voor hoe id’s en e-mailadressen matchen.
- Sample Data om Pyn in plaats daarvan met een fictief personeelsbestand uit te proberen.