动作类型详解

动作回滚(Action reverts)

点错了、删错了怎么办?Foundry 允许你在动作刚提交后立刻"撤销"。这一篇讲清回滚是什么、能回滚谁、以及那些容易踩的坑。

原文 Palantir Foundry · Action types 预计阅读 9 分钟 互动演示 + 6 道测验
本文来源 · Source 内容整理自 Palantir Foundry 官方文档:
https://www.palantir.com/docs/foundry/action-types/action-reverts/
原始标题:Undo or revert Actions

一句话速览

动作回滚(Action reverts):点错了、删错了怎么办?Foundry 允许你在动作刚提交后立刻"撤销"。这一篇讲清回滚是什么、能回滚谁、以及那些容易踩的坑。

1 回滚(revert)
在 Ontology Manager 里,动作回滚(action revert)允许一个动作在应用之后立即被撤销(undone)
2 只限 Object Storage v2
动作回滚仅适用于 Object Storage v2(OSv2):也就是说,只有修改或创建 OSv2 对象类型的动作才能被回滚
3 配置一个可回滚的动作
在动作的 Form 标签页里,打开 Allow revert after action submission(提交后允许回滚)开关…
4 删除动作的特别处理
执行了删除(delete)动作、且想撤销删除,但那条回滚提示已经不在了——此时可选的"补救"只有两条路
1

什么是回滚(revert)

回滚就是"撤销"——在动作刚被应用后,立刻把它做的编辑还原回去。

在 Ontology Manager 里,动作回滚(action revert)允许一个动作在应用之后立即被撤销(undone)。做法很简单:任意一次成功的动作应用后,在成功提示(success message)里选择 Undo 即可。

"Action reverts in Ontology Manager allow an action to be reverted (that is, undone) immediately after the action has been applied."本体管理器中的动作回滚,允许一个动作在应用之后立即被撤销(即撤销)。

新建的动作默认就是可回滚的(revertible)。但要记住下面这条铁律——

关键:那一条成功提示(toast)是你唯一能撤销动作的时机。尤其在执行删除(delete)动作时,更要抓紧这条提示。
2

谁能回滚:只限 Object Storage v2

回滚不是对所有动作都开放,它依赖底层的对象存储版本。

动作回滚仅适用于 Object Storage v2(OSv2):也就是说,只有修改或创建 OSv2 对象类型的动作才能被回滚。如果你的对象类型还停留在 OSv1,需要先迁移到 OSv2。

可以回滚
动作只修改 / 创建 OSv2 对象类型 → 默认可回滚(新建动作)。 OSv1 可参考官方迁移指南升级到 v2。
不能回滚
动作只修改 OSv1 对象类型 → 无法回滚。 提示里不会出现可用的 Undo。
3

如何配置一个可回滚的动作

默认行为已经很友好,但了解开关在哪里仍然重要。

在动作的 Form 标签页里,打开 Allow revert after action submission(提交后允许回滚)开关,保存回本体后该动作即可回滚。

默认规则:2024 年 5 月之后创建、且只修改 OSv2 对象类型的动作,这个开关默认就是开启的。而 2024 年 5 月之前存在、但修改 OSv2 对象的动作,默认不会开启,需要手动打开。

点击揭晓:目前回滚动作还有什么身份限制?

点击这里揭晓 →

4

限制与注意事项(Caveats)

回滚会失败,也有"管不到"的地方。先来动手感受一下"唯一时机"。

互动实验:回滚的机会只有一次
你刚刚成功执行了一个动作。下方是成功后弹出的提示(toast)。

回滚会失败的两种情况

  • 对象已有后续编辑:只要该对象被做过任何后续编辑(哪怕是不同的属性),这个动作就无法回滚——它必须仍然是该对象"最近一次"编辑。
  • 开关被关过:如果提交后回滚开关被关掉过(哪怕后来又打开),该动作也无法回滚。

点击揭晓:回滚会不会把"副作用"也一起撤销?

点击这里揭晓 →

5

删除动作的特别处理

如果删除的 toast 已经消失,撤销就不是点一下那么简单了。

执行了删除(delete)动作、且想撤销删除,但那条回滚提示已经不在了——此时可选的"补救"只有两条路:

  • 迁移到一个新的对象类型,并用函数(functions)把想要的编辑复制过去;
  • 直接丢弃(drop)该对象类型上的所有编辑。
记住:删除动作一旦错过 toast,就没有"一键撤销"。所以删除前务必确认,或提前用动作日志(action log)留痕。

一页带走

① 回滚 = 撤销
成功提示里的 Undo 是唯一时机,删除动作尤其要抓紧。
② 只限 OSv2
仅修改/创建 OSv2 对象类型的动作可回滚,OSv1 不行。
③ 配置与限制
Form 标签开关;对象有后续编辑或开关被关过则无法回滚。
④ 副作用不回滚
回滚只还原对象编辑,不撤销通知/webhook 等副作用。

延伸阅读 · 相关页面

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

常见问题速答 · FAQ

关于「动作回滚(Action reverts)」,读者最常问的几个问题。

什么是回滚(revert)?
在 Ontology Manager 里,动作回滚(action revert)允许一个动作在应用之后立即被撤销(undone)。做法很简单:任意一次成功的动作应用后,在成功提示(success message)里选择 Undo 即可。
只限 Object Storage v2是什么?
动作回滚仅适用于 Object Storage v2(OSv2):也就是说,只有修改或创建 OSv2 对象类型的动作才能被回滚。如果你的对象类型还停留在 OSv1,需要先迁移到 OSv2。
如何配置一个可回滚的动作?
在动作的 Form 标签页里,打开 Allow revert after action submission(提交后允许回滚)开关,保存回本体后该动作即可回滚。
限制与注意事项(Caveats)是什么?
点击揭晓:回滚会不会把"副作用"也一起撤销?