Zum Inhalt springen
PynPyn

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

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.

  • custom.<column>: eine Spalte aus der Serienbrief-Tabelle, mit der die Person eingeschrieben wurde, in Camel Case benannt (aus Start Location wird custom.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.
  • 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.today und date.tomorrow werden 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.

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.