跳转到内容
PynPyn

令牌

令牌是一个标记,Pyn 在为某一位收件人格式化消息时会替换它。在编辑器中输入 @ 插入一个令牌;在 Raw HTML 电子邮件或 Raw HTML Block 中,把它写成 Liquid 标签,{{ principal.preferredName }}。principal 令牌对应已注册的员工,recipient 令牌对应收到消息的人;在发给员工本人的消息中,两者是同一个人。

当值缺失时,令牌会渲染为下表所示的回退文本,除非你在令牌上设置了自己的回退值。姓名、部门和职位来自目录中的员工记录。

令牌 值 回退
date.reference 该注册的参考日期 reference date
principal.preferredName 常用名,否则为显示名称的第一个词 Employee
principal.firstName 显示名称(或法定姓名)的第一个词 Employee
principal.preferredFullName 常用名加上显示名称中的姓氏 Employee
principal.legalName 法定姓名,否则为显示名称 Employee
principal.jobTitle 职位 Job Title
principal.department 部门 department
principal.location 地点 location
principal.startDate 入职日期 start date
principal.startDate.dayAfter 入职日期的后一天 start date
principal.startDate.nextBusinessDay 入职日期之后的下一个工作日 start date
principal.tenure 发送时距司龄起算日期(或入职日期)的整年数:“1 year”、“3 years” tenure
principal.birthday 以日和月表示的生日,例如 “28 Jul” Birthday
principal.nextBirthday 参考日期当天或之后的下一个生日 next Birthday
principal.nextAnniversary 参考日期当天或之后的下一个入职周年纪念日 next Anniversary
principal.managerName 经理的显示名称 Manager
principal.managerPreferredName 经理的常用名 Manager
principal.managerEmail 经理的工作邮箱 manager email
principal.buddy.name 伙伴的显示名称 Buddy
principal.buddy.preferredName 伙伴的常用名 Buddy
principal.buddy.preferredFullName 伙伴的常用名和姓氏 Buddy
principal.buddy.email 伙伴的工作邮箱 buddy email
principal.buddy.startDate.nextBusinessDay 伙伴入职日期之后的工作日 start date
principal.hrbp.name HR 业务伙伴的显示名称 HRBP
principal.hrbp.preferredName HR 业务伙伴的常用名 HRBP
principal.hrbp.preferredFullName HR 业务伙伴的常用名和姓氏 HRBP
principal.hrbp.email HR 业务伙伴的工作邮箱 HRBP email
recipient.preferredName、recipient.firstName、recipient.preferredFullName、recipient.legalName 同上,针对收件人 Employee
recipient.department、recipient.location 同上,针对收件人 department、location
recipient.startDate 收件人的入职日期 start date
recipient.birthday、recipient.nextBirthday、recipient.nextAnniversary 同上,针对收件人 Birthday、next Birthday、next Anniversary
recipient.surveyLink 存储在收件人记录上的一个链接;渲染为链接,或者什么都不显示

电子邮件的 Subject 提供较小的一组:主体和收件人的常用名、生日、下一个生日和下一个周年纪念日。Jira 工单的 Summary 和 Description 提供十二个 principal 令牌:principal.department、principal.email、principal.employeeNumber、principal.jobTitle、principal.legalName、principal.location、principal.managerEmail、principal.managerName、principal.name、principal.preferredFullName、principal.preferredName 和 principal.startDate。

Raw HTML 电子邮件或 Raw HTML Block 按 Liquid 名称解析上面的每一个令牌,另外还有这些:

令牌 值 回退
company.name 工作区的公司名称 company
date.today 发送日期 today
date.tomorrow 发送日期的后一天 tomorrow
principal.name、recipient.name 显示名称 Employee
principal.email、recipient.email 工作邮箱 email address
principal.personalEmail、recipient.personalEmail 个人邮箱 personal email address
principal.endDate、recipient.endDate 离职日期 end date
principal.city、principal.country、recipient.city、recipient.country 城市和国家 city、country
recipient.jobTitle 收件人的职位 Job Title
recipient.tenure 发送时距收件人司龄起算日期(或入职日期)的年数,四舍五入到整年,渲染为 1 year 或 N years tenure

Pyn 不认识的 Liquid 名称会按原样留在电子邮件中。

  • custom.<column>:用来注册此人的邮件合并电子表格中的一列,以驼峰式命名(Start Location 变成 custom.startLocation)。用 Insert widget、Custom Token 插入。回退为列名;没有值的 Custom Token Block 渲染为你的回退文本,或者什么都不显示。见从电子表格注册。
  • 员工字段令牌:员工记录上的任意字段,用 Insert token、Employee Field 选择,应用于主体或收件人,并可输入一个可选的回退值。没有回退值时,缺失的值渲染为空。
  • 日期按收件人的区域设置渲染为星期、日、月和年,例如 “Thu, 22 Oct 2026”。生日渲染为日和月。
  • date.today 和 date.tomorrow 取自该投递的排定时间;在没有发送时间的预览中,它们显示回退文本。
  • 司龄四舍五入到整年,所以入职十一个月的人显示为 “1 year”。
  • 位于加粗或带颜色文本段中的令牌保留该格式。

以下来自 Pyn Classic 的名称仍被接受,但渲染为空:date.nextBusinessDay、每一个 manager.* 令牌(改用 principal.managerName、principal.managerPreferredName 和 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、它们对应的 recipient 版本,以及 recipient.startDate.dayAfter 和 recipient.startDate.nextBusinessDay。