Token
Ein Token ist ein Platzhalter, den Pyn ersetzt, wenn eine Nachricht für einen Empfänger aufbereitet wird. Tippe @ im Editor, um eines einzufügen; in einer Raw-HTML-E-Mail oder einem Raw HTML Block schreibst du es als Liquid-Tag, {{ principal.preferredName }}. principal-Token beziehen sich auf die eingeschriebene Person, recipient-Token auf die Person, die die Nachricht erhält; in einer Nachricht an die Mitarbeitenden selbst sind beide dieselbe Person.
Fehlt ein Wert, zeigt das Token seinen Fallback-Text aus den Tabellen unten, es sei denn, du legst am Token einen eigenen Fallback fest. Namen, Abteilungen und Jobtitel kommen aus dem Mitarbeitendendatensatz in Directory.
Token im Editor
Abschnitt betitelt „Token im Editor“| Token | Wert | Fallback |
|---|---|---|
date.reference |
Das Referenzdatum des Enrollments | reference date |
principal.preferredName |
Rufname, sonst das erste Wort des Anzeigenamens | Employee |
principal.firstName |
Erstes Wort des Anzeigenamens (oder des rechtlichen Namens) | Employee |
principal.preferredFullName |
Rufname plus der Nachname aus dem Anzeigenamen | Employee |
principal.legalName |
Rechtlicher Name, sonst Anzeigename | Employee |
principal.jobTitle |
Jobtitel | Job Title |
principal.department |
Abteilung | department |
principal.location |
Standort | location |
principal.startDate |
Startdatum | start date |
principal.startDate.dayAfter |
Der Tag nach dem Startdatum | start date |
principal.startDate.nextBusinessDay |
Der nächste Werktag nach dem Startdatum | start date |
principal.tenure |
Volle Jahre seit dem Betriebszugehörigkeitsdatum (oder Startdatum) zum Sendezeitpunkt: „1 year“, „3 years“ | tenure |
principal.birthday |
Geburtstag als Tag und Monat, zum Beispiel „28 Jul“ | Birthday |
principal.nextBirthday |
Der nächste Geburtstag am oder nach dem Referenzdatum | next Birthday |
principal.nextAnniversary |
Das nächste Jubiläum des Startdatums am oder nach dem Referenzdatum | next Anniversary |
principal.managerName |
Anzeigename der Führungskraft | Manager |
principal.managerPreferredName |
Rufname der Führungskraft | Manager |
principal.managerEmail |
Geschäftliche E-Mail der Führungskraft | manager email |
principal.buddy.name |
Anzeigename des Buddys | Buddy |
principal.buddy.preferredName |
Rufname des Buddys | Buddy |
principal.buddy.preferredFullName |
Rufname und Nachname des Buddys | Buddy |
principal.buddy.email |
Geschäftliche E-Mail des Buddys | buddy email |
principal.buddy.startDate.nextBusinessDay |
Der Werktag nach dem Startdatum des Buddys | start date |
principal.hrbp.name |
Anzeigename des HR Business Partners | HRBP |
principal.hrbp.preferredName |
Rufname des HR Business Partners | HRBP |
principal.hrbp.preferredFullName |
Rufname und Nachname des HR Business Partners | HRBP |
principal.hrbp.email |
Geschäftliche E-Mail des HR Business Partners | HRBP email |
recipient.preferredName, recipient.firstName, recipient.preferredFullName, recipient.legalName |
Wie oben, für den Empfänger | Employee |
recipient.department, recipient.location |
Wie oben, für den Empfänger | department, location |
recipient.startDate |
Das Startdatum des Empfängers | start date |
recipient.birthday, recipient.nextBirthday, recipient.nextAnniversary |
Wie oben, für den Empfänger | Birthday, next Birthday, next Anniversary |
recipient.surveyLink |
Ein Link, der am Datensatz des Empfängers gespeichert ist; wird als Link gerendert, oder gar nicht |
Der Subject einer E-Mail bietet eine kleinere Auswahl: Rufname, Geburtstag, nächster Geburtstag und nächstes Jubiläum der Hauptperson und des Empfängers. Summary und Description eines Jira-Tickets bieten zwölf principal-Token: principal.department, principal.email, principal.employeeNumber, principal.jobTitle, principal.legalName, principal.location, principal.managerEmail, principal.managerName, principal.name, principal.preferredFullName, principal.preferredName und principal.startDate.
Token für Raw HTML
Abschnitt betitelt „Token für Raw HTML“Eine Raw-HTML-E-Mail oder ein Raw HTML Block löst jedes Token oben über seinen Liquid-Namen auf, dazu diese:
| Token | Wert | Fallback |
|---|---|---|
company.name |
Der Firmenname des Workspace | company |
date.today |
Das Sendedatum | today |
date.tomorrow |
Der Tag nach dem Sendedatum | tomorrow |
principal.name, recipient.name |
Anzeigename | Employee |
principal.email, recipient.email |
Geschäftliche E-Mail | email address |
principal.personalEmail, recipient.personalEmail |
Private E-Mail | personal email address |
principal.endDate, recipient.endDate |
Austrittsdatum | end date |
principal.city, principal.country, recipient.city, recipient.country |
Stadt und Land | city, country |
recipient.jobTitle |
Der Jobtitel des Empfängers | Job Title |
recipient.tenure |
Jahre seit dem Betriebszugehörigkeitsdatum (oder Startdatum) des Empfängers zum Sendezeitpunkt, auf ganze Jahre gerundet und als 1 year oder N years gerendert |
tenure |
Einen Liquid-Namen, den Pyn nicht kennt, lässt es so in der E-Mail stehen, wie du ihn getippt hast.
Eigene Token und Mitarbeitendenfelder
Abschnitt betitelt „Eigene Token und Mitarbeitendenfelder“custom.<column>: eine Spalte aus der Serienbrief-Tabelle, mit der die Person eingeschrieben wurde, in Camel Case benannt (ausStart Locationwirdcustom.startLocation). Füge es mit Insert widget, Custom Token ein. Fällt auf den Spaltennamen zurück; ein Custom Token Block ohne Wert rendert deinen Fallback oder nichts. Siehe Aus einer Tabelle einschreiben.- Mitarbeitendenfeld-Token: jedes Feld des Mitarbeitendendatensatzes, gewählt mit Insert token, Employee Field, angewendet auf die Hauptperson oder den Empfänger, mit einem optionalen Fallback, den du eintippst. Ohne ihn rendert ein fehlender Wert nichts.
Formatierung
Abschnitt betitelt „Formatierung“- Datumsangaben erscheinen in der Locale des Empfängers als Wochentag, Tag, Monat und Jahr, zum Beispiel „Thu, 22 Oct 2026“. Geburtstage erscheinen als Tag und Monat.
date.todayunddate.tomorrowwerden aus der geplanten Zeit der Zustellung genommen; in einer Vorschau ohne Sendezeit zeigen sie ihren Fallback.- Die Betriebszugehörigkeit wird auf ganze Jahre gerundet, sodass jemand mit elf Monaten als „1 year“ erscheint.
- Ein Token innerhalb eines fetten oder farbigen Abschnitts behält diese Formatierung.
Namen, die Pyn nicht mehr füllt
Abschnitt betitelt „Namen, die Pyn nicht mehr füllt“Die folgenden Namen aus Pyn Classic werden akzeptiert, rendern aber nichts: date.nextBusinessDay, jedes manager.*-Token (nutze principal.managerName, principal.managerPreferredName und 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, die recipient-Entsprechungen davon sowie recipient.startDate.dayAfter und recipient.startDate.nextBusinessDay.
Verwandte Seiten
Abschnitt betitelt „Verwandte Seiten“- Eine Nachricht formatieren zum Einfügen von Token, eigenen Token und Mitarbeitendenfeldern.
- Empfänger und Cc wählen dafür, wer in jedem Schritt Hauptperson und Empfänger ist.
- Aus einer Tabelle einschreiben für Spalten mit eigenen Token.
- HiBob-Feldzuordnung für das Bob-Feld hinter jedem Token, wenn HiBob verbunden ist.