动作类型详解

通知(Notifications)

通知让动作"喊人来看":当动作被应用,按你的配置给平台用户发提醒(平台内弹窗 + 邮件)。这一篇讲清它能发给谁、内容怎么配、有哪些硬性限制。

原文 Palantir Foundry · Action types
本文来源 · Source 内容整理自 Palantir Foundry 官方文档:
https://www.palantir.com/docs/foundry/action-types/notifications/
原始标题:Notifications

一句话速览

通知(Notifications):通知让动作"喊人来看":当动作被应用,按你的配置给平台用户发提醒(平台内弹窗 + 邮件)。这一篇讲清它能发给谁、内容怎么配、有哪些硬性限制。

1 通知(notification)是什么
通知是通过动作的 Add new rule 下拉菜单添加进去的
2 接收人(recipients)怎么定
Foundry 支持多种指定接收人的方式
3 内容(content)怎么配
内容有两种来源:Template(模板)直接在配置对话框里写;Function(函数)则需要一个已发布的、返回 Notificati…
4 数据权限与脱敏(redaction)
通知不是"谁都能看"
1

通知(notification)是什么

在动作里"加一条规则",让系统在动作运行时去提醒人。

通知是通过动作的 Add new rule 下拉菜单添加进去的。配置一条通知,需要指定两件事:接收人(recipients)内容(content)

Notifications will be sent to each recipient individually. Adding users as CC (carbon copy) recipients to email notifications is not supported.通知会分别发送给每位接收人。邮件通知不支持把用户添加为抄送(CC)接收人。

也就是说:每条通知是"一对一"地送达每个人的,没有抄送这一概念。用户还能在自己的偏好里决定如何接收——有人只在浏览器里看,有人既收平台弹窗也收邮件。如果某人整体关闭了动作通知,他就收不到,但仍可在 Workspace 的"Notifications → See All"里事后查看。

2

接收人(recipients)怎么定

四种指定方式,从"写死"到"用函数算"。点一下,把描述归到正确的方式上。

Foundry 支持多种指定接收人的方式。下面每一行是一个场景,请点击右侧最匹配的方式:

提醒:如果接收人来自对象属性,该属性必须存的是 Foundry 用户/组 ID 字符串;存成普通邮箱地址是发不出去的。直接填邮箱地址发送也不被支持。
3

内容(content)怎么配

模板(Template)直接配,或函数(Function)返回完整通知对象。

内容有两种来源:Template(模板) 直接在配置对话框里写;Function(函数) 则需要一个已发布的、返回 Notification 对象的函数。

模板可配置的组成部分

  • Subject(主题):默认对所有送达方式一致;
  • Body(正文):平台内显示在弹窗里,邮件里渲染在邮件正文中;
  • Link(链接):正文下方一个按钮,文字可自定义,可指向对象参数、Workshop 应用、Carbon workspace、或新建的对象;
  • Advanced Email Configuration(高级邮件配置):用 HTML 做更丰富的排版(仅邮件生效)。

在主题、正文、链接里,可以用 三重花括号 {{{ }}} 引用参数和用户属性——编辑时点一下可用参数,就会自动生成正确的 handlebar 引用。需要"按接收人/参数完全不同内容""邮件与平台用不同主题""用外部系统完整 URL""做 Search Around / 聚合"等场景时,才需要改用函数。

点击揭晓:什么情况下必须改用"函数"来生成通知内容?
4

硬性限制与注意

长度、人数都有上限,超出会被截断或报错。

限制项上限超出会怎样
接收人(模板方式)500 人/次正常上限
接收人(函数方式)50 人/次超限会显示红色错误并导致动作运行失败
主题(Subject)250 字符被截断并加 ...
正文(Body)1,000 字符被截断并加 ...
邮件自定义 HTML51,200 字符被截断并加 ...

注意:这些长度是"渲染后"校验的。如果内容里嵌了对象数据(动态长度),超出部分会被截断并在末尾补 ...

5

数据权限与脱敏(redaction)

用户只能收到自己有权查看的数据;脱敏会影响自定义内容。

通知不是"谁都能看":

  • 用户只能收到包含其有权查看数据的通知;多人接收时,所有接收人都必须能访问内容里渲染的对象数据;
  • 在动作侧栏的 Security & Submission Criteria 标签页底部,有两种失败处理:Require all users to have permissions(默认)——任一接收人无权则整体报错、不改动也不发通知;Require any user to have permissions——只要有一人能看就成功,只有有权者收到;
  • 若实例开启了 Strict / Group Redaction(严格/分组脱敏),自定义通知内容不会被渲染,用户只会收到一句通用提示,点"View"进 Foundry 看全文。
新建对象链接:链接新建对象时,必须引用其主键——因为渲染通知时对象 RID 还没生成。用 Object Explorer 提供的参数选项即可生成正确链接。

一页带走

① 通知 = 喊人看
通过 Add new rule 添加,分别送达每位接收人,无抄送概念。
② 接收人四法
固定 / 来自参数 / 来自对象属性 / 来自函数,从写死到动态算。
③ 内容两源
模板直接写({{{}}} 引用参数)或函数返回 Notification 对象。
④ 上限与权限
主题250/正文1000/邮件HTML 51200 字符;按权限与脱敏规则送达。

延伸阅读 · 相关页面

按主题横向跳转,不必顺着目录一篇篇读。

常见问题速答 · FAQ

关于「通知(Notifications)」,读者最常问的几个问题。

通知(notification)是什么?
通知是通过动作的 Add new rule 下拉菜单添加进去的。配置一条通知,需要指定两件事:接收人(recipients)和 内容(content)。
接收人(recipients)怎么定?
Foundry 支持多种指定接收人的方式。下面每一行是一个场景,请点击右侧最匹配的方式。
内容(content)怎么配?
内容有两种来源:Template(模板)直接在配置对话框里写;Function(函数)则需要一个已发布的、返回 Notification 对象的函数。