循序渐进 · 教学 · 本体零件(十)

动作类型(Action Type):让本体"动手"

本体不能只"看"不"动"。动作类型就是让人(或系统)在合规前提下 改变对象、属性和链接的那套定义。这一篇讲清它是什么、由什么组成、什么时候该用。

全部目录 ← 上一篇 动作类型 Action Types 下一篇 →
原文 Palantir Foundry · Action Types Overview 预计阅读 10 分钟 互动演示 + 6 道测验
本文来源 · Source 内容整理自 Palantir Foundry 官方文档:
https://www.palantir.com/docs/foundry/action-types/overview/
原始标题:Action types · Overview

一句话速览

动作类型(Action Type):让本体"动手":本体不能只"看"不"动"。动作类型就是让人(或系统)在合规前提下 改变对象、属性和链接的那套定义。这一篇讲清它是什么、由什么组成、什么时候该用。

1 动作类型 = 一次受治理的变更
在本体里,用户通过动作(action)去改动对象、属性与链接
2 Assign Employee
原文给的例子是 Assign Employee(分配员工)动作类型
3 为什么要用动作类型
原文强调一个核心事实:Foundry 本体不是抽象数据模型,而是把每个本体概念 映射到了组织真实的业务数据
4 它适合什么场景?权限怎么管
动作类型擅长的是捕获人的决策:审批订单、改状态、指派人员、建立关系……
1

一句话:动作类型 = 一次受治理的变更

An action type defines a set of changes a user can take at once.

在本体里,用户通过动作(action)去改动对象、属性与链接。 一次 action 是一笔事务(transaction):基于用户定义的逻辑,改变一个或多个对象的属性。

An action type is the definition of a set of changes or edits to objects, property values, and links that a user can take at once. It also includes the side effect behaviors that occur with action submission. 动作类型,是"用户可一次性执行的一组对对象、属性值、链接的改动"的定义;它还包括随提交一起发生的副作用行为。

重点在"一次性"和"受治理":一个动作类型把要改什么、怎么改、谁有权改、改完顺带做什么 全部打包成一份可复用的定义。业务人员点一下就能完成一整套合规变更。

和函数(function)先分清:动作类型捕获的是人的一次决策与改动; 函数是一段计算逻辑,常为决策提供依据。两者常配合,但本质不同(functions 那篇细讲)。
2

一个例子:Assign Employee

改属性、自动建链接、发通知、做权限校验,一次完成。

原文给的例子是 Assign Employee(分配员工)动作类型。设想 HR 要把 "Melissa Chang" 的岗位改成 "Product Manager":

改属性
定义如何改变某个 Employee 对象的 role 属性值。
要参数
需要"参数定义(parameter)",让员工以标准化表单输入新岗位,而不是随手敲。
自动建链接
可包含规则:自动在 Employee 与新 Manager 之间建立链接。
副作用 + 校验
可附带"通知新旧经理"的副作用;并校验只有 HR 等授权员工才能执行。

于是,HR 只需执行一次动作,就能把 Melissa Chang 切到 Product Manager—— 属性改了、链接建了、相关人通知了、权限也拦住了不该操作的人。

3

一个动作类型由什么组成?

参数、编辑、副作用、校验,四件套。

组成部分作用
Parameters 参数采集用户输入(如"新岗位"),以标准化表单呈现,避免随手填错。
Edits / Operations 编辑与操作对对象、属性值、链接的增改删;可自动按规则建立链接。
Side effects 副作用提交时顺带发生的行为,如发送通知(notify)给相关人。
Validation / Submission criteria 校验与提交条件规定谁能执行、在什么条件下才允许提交(如仅 HR 角色)。
记忆口诀:动作类型 = 要改什么(edits) + 靠什么输入(parameters) + 改完顺带做啥(side effects) + 谁能改(validation)
4

为什么要用动作类型?

本体映射到真实数据,提交即写回,跨应用一致。

原文强调一个核心事实:Foundry 本体不是抽象数据模型,而是把每个本体概念 映射到了组织真实的业务数据。动作带来的改动,正是"把人的决策与洞察"沉淀进数据资产的方式——数据资产因此越用越值钱。

× 手动改底层数据
问题 · 改动散落在 CSV / 数据库,难以治理 · 各应用看到的不是同一份真相 · 谁改的、为什么改,无从追溯
✓ 用动作类型
收益 · 提交即写入本体,所有应用即时反映 · 同一套逻辑与校验在所有前端应用一致 · 改动被记录、受权限与治理约束
写回(writeback):用户编辑后,融入了用户改动的、最新版本的对象数据,会被捕获进该对象类型的 写回数据集(writeback dataset)。这正是"决策沉淀为数据"的落点。
5

它适合什么场景?权限怎么管?

凡是"人要做一次受治理的改动",优先考虑动作类型。

动作类型擅长的是捕获人的决策:审批订单、改状态、指派人员、建立关系……

  • 改动会改变本体中的对象,而不是只做只读计算。
  • 改动需要在提交时做权限校验与副作用(通知、联动)。
  • 同一套逻辑与校验要在所有用户应用里保持一致

权限方面,动作类型在其定义里就内嵌了校验与提交条件: 比如"仅人力资源(HR)等授权员工可执行"。这使得"能动手但要合规"成为默认保障。

别混淆:把外部系统的数据每天同步进数据集,那是本体之下的数据集成(pipeline), 不是动作类型——动作类型改的是已经在本体里的对象,而不是把原料搬进来。
6

动手:该不该用动作类型 / 用哪种?

逐个场景判断。点选项看解析。

7

一次提交,背后发生了什么?

点开看推荐顺序。

点我看推荐顺序 →
上手路径(原文推荐):create an action type(创建动作类型)explore other action types(浏览现有动作类型)入手; 再深入了解 rules(规则)parameters(参数)submission criteria(提交条件)

提示:动作类型与函数、接口常协同——接口定义形状,函数提供计算,动作类型执行受治理的改动。

9

本模块的 37 篇详解

上面是动作类型的"总览"。下面 37 篇从快速开始一路讲到监控与日志,按主题分组,按需查阅或顺着读。

一页带走

① 动作类型 = 受治理的改动
一次性事务:改对象/属性/链接,并带提交时的副作用。
② 四件套
参数 + 编辑 + 副作用 + 校验/提交条件。
③ 映射到真实数据
提交即写入本体、跨应用一致、写回数据集,决策沉淀为数据。
④ 该用才用
要"改动+权限+副作用"用动作类型;只读计算用函数;数据同步用 pipeline。

延伸阅读 · 相关页面

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

常见问题速答 · FAQ

关于「动作类型(Action Type):让本体"动手"」,读者最常问的几个问题。

一句话:动作类型 = 一次受治理的变更是什么?
在本体里,用户通过动作(action)去改动对象、属性与链接。一次 action 是一笔事务(transaction):基于用户定义的逻辑,改变一个或多个对象的属性。
一个例子:Assign Employee是什么?
原文给的例子是 Assign Employee(分配员工)动作类型。设想 HR 要把 "Melissa Chang" 的岗位改成 "Product Manager"。
为什么要用动作类型?
原文强调一个核心事实:Foundry 本体不是抽象数据模型,而是把每个本体概念 映射到了组织真实的业务数据。动作带来的改动,正是"把人的决策与洞察"沉淀进数据资产的方式——数据资产因此越用越值钱。
它适合什么场景?权限怎么管?
动作类型擅长的是捕获人的决策:审批订单、改状态、指派人员、建立关系……