Ga naar inhoud
PynPyn

Tokens

Een token is een markering die Pyn vervangt wanneer een bericht voor één ontvanger wordt opgemaakt. Typ @ in de editor om er een in te voegen; in een Raw HTML-e-mail of een Raw HTML Block schrijf je het als Liquid-tag, {{ principal.preferredName }}. principal-tokens gaan over de ingeschreven medewerker, recipient-tokens over de persoon die het bericht ontvangt; in een bericht aan de medewerker zelf zijn dat dezelfde persoon.

Ontbreekt een waarde, dan toont het token zijn terugvaltekst uit de tabellen hieronder, tenzij je op het token een eigen terugvaltekst instelt. Namen, afdelingen en functietitels komen uit het medewerkersrecord in Directory.

Token Waarde Terugvaltekst
date.reference De referentiedatum van de enrollment reference date
principal.preferredName Roepnaam, anders het eerste woord van de weergavenaam Employee
principal.firstName Eerste woord van de weergavenaam (of de officiële naam) Employee
principal.preferredFullName Roepnaam plus de achternaam uit de weergavenaam Employee
principal.legalName Officiële naam, anders de weergavenaam Employee
principal.jobTitle Functietitel Job Title
principal.department Afdeling department
principal.location Locatie location
principal.startDate Startdatum start date
principal.startDate.dayAfter De dag na de startdatum start date
principal.startDate.nextBusinessDay De eerstvolgende werkdag na de startdatum start date
principal.tenure Hele jaren sinds de diensttijddatum (of startdatum) op het moment van verzenden: “1 year”, “3 years” tenure
principal.birthday Verjaardag als dag en maand, bijvoorbeeld “28 Jul” Birthday
principal.nextBirthday De eerstvolgende verjaardag op of na de referentiedatum next Birthday
principal.nextAnniversary Het eerstvolgende jubileum van de startdatum op of na de referentiedatum next Anniversary
principal.managerName Weergavenaam van de manager Manager
principal.managerPreferredName Roepnaam van de manager Manager
principal.managerEmail Zakelijk e-mailadres van de manager manager email
principal.buddy.name Weergavenaam van de buddy Buddy
principal.buddy.preferredName Roepnaam van de buddy Buddy
principal.buddy.preferredFullName Roepnaam en achternaam van de buddy Buddy
principal.buddy.email Zakelijk e-mailadres van de buddy buddy email
principal.buddy.startDate.nextBusinessDay De werkdag na de startdatum van de buddy start date
principal.hrbp.name Weergavenaam van de HR-businesspartner HRBP
principal.hrbp.preferredName Roepnaam van de HR-businesspartner HRBP
principal.hrbp.preferredFullName Roepnaam en achternaam van de HR-businesspartner HRBP
principal.hrbp.email Zakelijk e-mailadres van de HR-businesspartner HRBP email
recipient.preferredName, recipient.firstName, recipient.preferredFullName, recipient.legalName Als hierboven, voor de ontvanger Employee
recipient.department, recipient.location Als hierboven, voor de ontvanger department, location
recipient.startDate De startdatum van de ontvanger start date
recipient.birthday, recipient.nextBirthday, recipient.nextAnniversary Als hierboven, voor de ontvanger Birthday, next Birthday, next Anniversary
recipient.surveyLink Een link die op het record van de ontvanger is opgeslagen; wordt een link, of niets

Het Subject van een e-mail biedt een kleinere set: de roepnaam, verjaardag, eerstvolgende verjaardag en eerstvolgende jubileum van de principal en de ontvanger. De Summary en Description van een Jira-ticket bieden twaalf principal-tokens: principal.department, principal.email, principal.employeeNumber, principal.jobTitle, principal.legalName, principal.location, principal.managerEmail, principal.managerName, principal.name, principal.preferredFullName, principal.preferredName en principal.startDate.

Een Raw HTML-e-mail of een Raw HTML Block vult elk token hierboven in op basis van zijn Liquid-naam, plus deze:

Token Waarde Terugvaltekst
company.name De bedrijfsnaam van de workspace company
date.today De verzenddatum today
date.tomorrow De dag na de verzenddatum tomorrow
principal.name, recipient.name Weergavenaam Employee
principal.email, recipient.email Zakelijk e-mailadres email address
principal.personalEmail, recipient.personalEmail Persoonlijk e-mailadres personal email address
principal.endDate, recipient.endDate Datum uit dienst end date
principal.city, principal.country, recipient.city, recipient.country Stad en land city, country
recipient.jobTitle De functietitel van de ontvanger Job Title
recipient.tenure Jaren sinds de diensttijddatum (of startdatum) van de ontvanger op het moment van verzenden, afgerond op hele jaren en weergegeven als 1 year of N years tenure

Een Liquid-naam die Pyn niet kent blijft in de e-mail staan zoals getypt.

Eigen tokens en tokens voor medewerkersvelden

Section titled “Eigen tokens en tokens voor medewerkersvelden”
  • custom.<column>: een kolom uit de mailmergespreadsheet waarmee de persoon is ingeschreven, in camelCase (Start Location wordt custom.startLocation). Voeg hem in met Insert widget, Custom Token. Valt terug op de kolomnaam; een Custom Token Block zonder waarde toont je terugvaltekst, of niets. Zie Inschrijven vanuit een spreadsheet.
  • Tokens voor medewerkersvelden: elk veld op het medewerkersrecord, gekozen met Insert token, Employee Field, toegepast op de principal of de ontvanger, met een optionele terugvaltekst die je zelf typt. Zonder die tekst levert een ontbrekende waarde niets op.
  • Datums worden weergegeven in de taalinstelling van de ontvanger als weekdag, dag, maand en jaar, bijvoorbeeld “Thu, 22 Oct 2026”. Verjaardagen als dag en maand.
  • date.today en date.tomorrow komen uit het geplande tijdstip van de delivery; in een preview zonder verzendtijd tonen ze hun terugvaltekst.
  • Diensttijd wordt afgerond op hele jaren, dus iemand die elf maanden in dienst is leest “1 year”.
  • Een token binnen een vetgedrukt of gekleurd stuk tekst behoudt die opmaak.

De volgende namen uit Pyn Classic worden geaccepteerd, maar leveren niets op: date.nextBusinessDay, elk manager.*-token (gebruik principal.managerName, principal.managerPreferredName en principal.managerEmail), principal.homeAddress, principal.employeeNumber, principal.employmentType, principal.mobilePhone, principal.brand, principal.buddy.jobTitle, principal.buddy.location, principal.buddy.startDate, principal.buddy.startDate.dayAfter, principal.returnsFromLeaveOn, de recipient-tegenhangers daarvan, en recipient.startDate.dayAfter en recipient.startDate.nextBusinessDay.