Ga naar inhoud
PynPyn

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.

  • 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 employeeId en primaryEmail nodig. Geef voor medewerkers in een land met meerdere tijdzones een timeZone; voor de VS, Canada en Australië volstaat een postalCode samen met het country. Anders wordt de rij geweigerd.
The Installed view with the Employee File panel open, showing Download Sample File and Upload.
De integratie Employee File onder Installed, met het uploadpaneel open.
  1. Open in Pyn Settings in de linkernavigatie, en dan Available onder Integrations.

  2. 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.”

  3. Selecteer Download Sample File en gebruik het als basis voor je bestand, met behoud van de kopregel.

  4. Selecteer Upload en kies je bestand. Het paneel toont Uploading… terwijl het valideert en opslaat.

  5. 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.

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.

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.

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.

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.