动作类型详解

配置通知(Set up a notification)

跟着做一遍:给一个"修改工单优先级"的动作加上通知,自动提醒工单上的负责人。这是一篇手把手教程,从前提到发测试通知逐步来。

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

一句话速览

配置通知(Set up a notification):跟着做一遍:给一个"修改工单优先级"的动作加上通知,自动提醒工单上的负责人。这是一篇手把手教程,从前提到发测试通知逐步来。

1 前置条件
本教程假设你已经完成了动作的入门教程(Getting Started),并有一个这样的动作:它接收一个对象 + 一个新优先级参数,然…
2 添加一条通知规则
打开那个"修改工单优先级"的动作,在 Rules 区域点 Add new rule,然后选 Notification
3 配置接收人(recipients)
在 Recipients 下拉里,选 Recipient(s) from property of object parameter
4 配置内容(content)
在内容选项里选 Template——这是最直接、不需要写代码的方式
1

前置条件

开始前,你需要先有一个可编辑的对象和一个会改它的动作。

本教程假设你已经完成了动作的入门教程(Getting Started),并有一个这样的动作:它接收一个对象 + 一个新优先级参数,然后把该对象的 Priority 属性改掉。

此外,你的对象上需要有一个存"负责人"的属性——教程里叫 Case Managers,里面放的是该工单当前负责人的 Foundry 用户 ID。通常你会在应用里用"用户选择器"组件捕获并存储这个 ID,它在 Foundry 各处会显示成完整用户名。

提示:若你只想先验证逻辑,可暂时把接收人写成"固定的自己",等确认无误再换成来自对象属性的动态接收人。
2

添加一条通知规则

在动作的 Rules 区里,选择 Notification。

打开那个"修改工单优先级"的动作,在 Rules 区域点 Add new rule,然后选 Notification。这会打开通知的配置对话框。

1

入口位置where to click

  • 动作编辑器 → Rules
  • Add new ruleNotification
  • 弹出的对话框里分别填接收人与内容
3

配置接收人(recipients)

本例:通知工单对象上"负责人"属性里存的那个用户。

Recipients 下拉里,选 Recipient(s) from property of object parameter。然后:

  • 选择作为动作参数的那个 Alert 对象;
  • 在弹出的提示里,选 Case managers 属性。

配置框里就会显示出"所选对象参数 + 属性"。关键点:接收人必须始终是 Foundry 用户 ID。如果该属性里放的是普通邮箱字符串之类,通知就发不出去。

点击揭晓:教程为什么建议测试时先用"固定接收人"?
4

配置内容(content)

用 Template 直接写,按名字称呼接收人,并带上新旧优先级。

在内容选项里选 Template——这是最直接、不需要写代码的方式。

  • Subject(主题):输入你想说的话。要插入参数引用,打一个 / 再从下拉选参数;如果选的是对象参数,还会让你再选要引用的属性。
  • Body(正文):写一段以接收人名字称呼、说明"谁做了改动"、并报告"之前/之后状态"的文字。
  • 下拉里可选 RecipientCurrent User 及任意参数,自动生成对应用户属性的引用。

这样通知就能"称呼对方名字 + 说明改动前后",比干巴巴一句"有更新"友好得多。

5

配置链接并发送测试

加一个"查看工单"按钮,然后真正跑一次验证。

最后,给通知加一个链接:选 Object View,再选你的工单对象参数,按钮文字填 View Ticket。这样接收人点一下就能跳到 Object Explorer 里那张工单。

保存后,就可以验证了:

  • 建一张测试工单,把自己设为负责人这样才能收到通知。
  • 把动作暴露出来运行通过 Object Explorer,或 Workshop 模块里的一个按钮来触发动作。
  • 检查两种送达你应该同时收到平台内推送和发到你 Foundry 用户资料的邮件。配置视图里也会显示两种预览。
  • 没收到邮件?可能你在 User Settings → Notifications 里关了邮件/平台通知,去那里确认。

一页带走

① 入口在 Rules
Add new rule → Notification,打开配置对话框。
② 接收人取属性
Recipient(s) from property of object parameter,属性须是用户 ID。
③ 内容用 Template
打 / 插入参数,按名称呼接收人并带新旧值。
④ 加链接 + 测试
Object View 链接 + 自己建测试工单跑一次验证。

延伸阅读 · 相关页面

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

常见问题速答 · FAQ

关于「配置通知(Set up a notification)」,读者最常问的几个问题。

前置条件是什么?
本教程假设你已经完成了动作的入门教程(Getting Started),并有一个这样的动作:它接收一个对象 + 一个新优先级参数,然后把该对象的 Priority 属性改掉。
添加一条通知规则是什么?
打开那个"修改工单优先级"的动作,在 Rules 区域点 Add new rule,然后选 Notification。这会打开通知的配置对话框。
配置接收人(recipients)是什么?
在 Recipients 下拉里,选 Recipient(s) from property of object parameter。然后。
配置内容(content)是什么?
在内容选项里选 Template——这是最直接、不需要写代码的方式。