通知(Notifications)
通知让动作"喊人来看":当动作被应用,按你的配置给平台用户发提醒(平台内弹窗 + 邮件)。这一篇讲清它能发给谁、内容怎么配、有哪些硬性限制。
https://www.palantir.com/docs/foundry/action-types/notifications/
原始标题:Notifications
一句话速览
通知(Notifications):通知让动作"喊人来看":当动作被应用,按你的配置给平台用户发提醒(平台内弹窗 + 邮件)。这一篇讲清它能发给谁、内容怎么配、有哪些硬性限制。
通知(notification)是什么
在动作里"加一条规则",让系统在动作运行时去提醒人。
通知是通过动作的 Add new rule 下拉菜单添加进去的。配置一条通知,需要指定两件事:接收人(recipients) 和 内容(content)。
也就是说:每条通知是"一对一"地送达每个人的,没有抄送这一概念。用户还能在自己的偏好里决定如何接收——有人只在浏览器里看,有人既收平台弹窗也收邮件。如果某人整体关闭了动作通知,他就收不到,但仍可在 Workspace 的"Notifications → See All"里事后查看。
接收人(recipients)怎么定
四种指定方式,从"写死"到"用函数算"。点一下,把描述归到正确的方式上。
Foundry 支持多种指定接收人的方式。下面每一行是一个场景,请点击右侧最匹配的方式:
内容(content)怎么配
模板(Template)直接配,或函数(Function)返回完整通知对象。
内容有两种来源:Template(模板) 直接在配置对话框里写;Function(函数) 则需要一个已发布的、返回 Notification 对象的函数。
模板可配置的组成部分
- Subject(主题):默认对所有送达方式一致;
- Body(正文):平台内显示在弹窗里,邮件里渲染在邮件正文中;
- Link(链接):正文下方一个按钮,文字可自定义,可指向对象参数、Workshop 应用、Carbon workspace、或新建的对象;
- Advanced Email Configuration(高级邮件配置):用 HTML 做更丰富的排版(仅邮件生效)。
在主题、正文、链接里,可以用 三重花括号 {{{ }}} 引用参数和用户属性——编辑时点一下可用参数,就会自动生成正确的 handlebar 引用。需要"按接收人/参数完全不同内容""邮件与平台用不同主题""用外部系统完整 URL""做 Search Around / 聚合"等场景时,才需要改用函数。
硬性限制与注意
长度、人数都有上限,超出会被截断或报错。
| 限制项 | 上限 | 超出会怎样 |
|---|---|---|
| 接收人(模板方式) | 500 人/次 | 正常上限 |
| 接收人(函数方式) | 50 人/次 | 超限会显示红色错误并导致动作运行失败 |
| 主题(Subject) | 250 字符 | 被截断并加 ... |
| 正文(Body) | 1,000 字符 | 被截断并加 ... |
| 邮件自定义 HTML | 51,200 字符 | 被截断并加 ... |
注意:这些长度是"渲染后"校验的。如果内容里嵌了对象数据(动态长度),超出部分会被截断并在末尾补 ...。
数据权限与脱敏(redaction)
用户只能收到自己有权查看的数据;脱敏会影响自定义内容。
通知不是"谁都能看":
- 用户只能收到包含其有权查看数据的通知;多人接收时,所有接收人都必须能访问内容里渲染的对象数据;
- 在动作侧栏的 Security & Submission Criteria 标签页底部,有两种失败处理:Require all users to have permissions(默认)——任一接收人无权则整体报错、不改动也不发通知;Require any user to have permissions——只要有一人能看就成功,只有有权者收到;
- 若实例开启了 Strict / Group Redaction(严格/分组脱敏),自定义通知内容不会被渲染,用户只会收到一句通用提示,点"View"进 Foundry 看全文。
一页带走
延伸阅读 · 相关页面
按主题横向跳转,不必顺着目录一篇篇读。
常见问题速答 · FAQ
关于「通知(Notifications)」,读者最常问的几个问题。