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.
Tokens in de editor
Section titled “Tokens in de editor”| 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.
Tokens voor Raw HTML
Section titled “Tokens voor Raw HTML”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 Locationwordtcustom.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.
Opmaak
Section titled “Opmaak”- 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.todayendate.tomorrowkomen 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.
Namen die Pyn niet meer invult
Section titled “Namen die Pyn niet meer invult”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.
Gerelateerd
Section titled “Gerelateerd”- Een bericht opmaken voor het invoegen van tokens, eigen tokens en medewerkersvelden.
- Ontvangers en Cc kiezen voor wie op elke stap principal en ontvanger zijn.
- Inschrijven vanuit een spreadsheet voor kolommen met eigen tokens.
- HiBob-veldmapping voor het Bob-veld achter elk token wanneer HiBob is gekoppeld.