动作类型详解

把动作用起来:在 Object Explorer 与 Workshop 中触发

动作类型(action type)建好之后,要去哪里、怎么让用户真正点下那个按钮?这一篇讲配置与应用的位置。

原文 Palantir Foundry · Action types 预计阅读 8 分钟 互动演示 + 5 道测验
本文来源 · Source 内容整理自 Palantir Foundry 官方文档:
https://www.palantir.com/docs/foundry/action-types/use-actions/
原始标题:Use actions in the platform · Action types

一句话速览

把动作用起来:在 Object Explorer 与 Workshop 中触发:动作类型(action type)建好之后,要去哪里、怎么让用户真正点下那个按钮?这一篇讲配置与应用的位置。

1 single 与 bulk
文档用两个术语区分动作的范围
2 在 Object View 的 Actions 区块配置
在 Object View 里用 Actions section(动作区块)添加动作时,你可以
3 Object Explorer 的三个入口
在 Object Explorer 中,动作会自动出现在三处
4 在 Workshop 用 Button group 触发
在 Workshop 里,动作通过 Button group widget(按钮组组件)来配置和触发
1

动作如何出现在各处:single 与 bulk

同一个动作类型,会按"当前选了什么"自动出现在合适的位置。

文档用两个术语区分动作的范围:

  • single action type(单对象动作):使用对象引用参数(object reference parameter),一次针对一个对象。
  • bulk action type(批量动作):使用对象引用列表参数(object reference list parameter),一次针对一组对象。

下面每个位置都只列出"对当前选择适用"的动作类型。在批量上下文(比如列表视图里多选了对象)中,就只会出现"对象列表参数匹配所选对象类型"的批量动作。

提示:理解 single / bulk 的区别,是后面看 Object Explorer、Workshop 入口的前提。
2

在 Object View 的 Actions 区块配置

把动作加进对象视图,它就成了页面上的一个按钮。

Object View 里用 Actions section(动作区块)添加动作时,你可以:

  • 把任意动作作为区块里的一个按钮(button)
  • 给每个按钮设置自己的标签(label)颜色(color)
  • 把默认的"点击就弹表单"改成"用默认值立即应用(apply immediately)"——前提默认值合法;
  • 指定:当某个不可见参数不合法时,按钮是隐藏还是禁用(思路是:可见参数还能在打开表单后修正);
  • 给每个参数提供默认值:可以是当前对象的某个属性值,也可以是"本地值"(当前用户、当前时间戳、当前对象,或手动输入的值);
  • 覆盖每个参数的可见性

正因为能覆盖默认值与标签,你可以用同一个"通用动作"做出多个结构化版本——比如"延迟 10 分钟""延迟 30 分钟"等按钮。

3

Object Explorer 的三个入口

动作会自动出现在 Object Explorer 的几个下拉里。

Object Explorer 中,动作会自动出现在三处:

  1. Exploration View 的 Actions 下拉在右上角。基于"当前这组对象",自动填入适用的批量(bulk)动作。
  2. Object View 的 Object Actions 下拉在右上角。基于"当前对象",自动填入适用的单对象与批量动作类型。
  3. Object View 的 Linked objects view section在顶部。基于"所选对象",自动填入适用的单对象 / 批量动作类型。

也就是说,你不用手动登记——只要动作类型的参数范围与当前选择匹配,下拉里就会出现它。

4

在 Workshop 用 Button group 触发

Workshop 的 Button group 组件配置项与 Object View 类似,但更灵活。

Workshop 里,动作通过 Button group widget(按钮组组件)来配置和触发。它的配置项和 Object View 的 Actions 区块基本相同,还有几个扩展:

  • 有三种布局(layout)可选;
  • 按钮有更多显示选项:左/右图标、极简样式(minimal)、标签样式(tag);
  • 除了触发动作,单个按钮还能触发 Workshop 事件、打开 URL,或导出对象集(object set)

还有一个区别:Workshop 里按钮的默认值除了"当前用户 / 当前时间戳",还可以是一个 变量(variable)。这让动作能直接接到 Workshop 应用的状态上。

Workshop 的 Button group 比 Object View 的 Actions 区块"多"出的能力之一是什么?点我看推荐 →

Each location below lists only the action types applicable to the current selection.下面每个位置都只列出对当前选择适用的动作类型。

一页带走

① single vs bulk
单对象用对象引用参数,批量用对象引用列表参数,按选择自动出现。
② Object View 配按钮
Actions 区块可设标签/颜色/默认值/可见性,一个动作变多个版本。
③ Explorer 三入口
Exploration View、Object View 的 Object Actions、Linked objects 三处下拉。
④ Workshop 更灵活
Button group 还能触发事件/URL/导出,默认值可为变量。

延伸阅读 · 相关页面

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