动作类型详解

动作日志(Action log)

谁在什么时候、因为什么改了数据?动作日志把"成功的动作提交"建模成本体里的对象,让决策与审计可追溯。这一篇讲清它记什么、在哪配、有何限制。

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

一句话速览

动作日志(Action log):谁在什么时候、因为什么改了数据?动作日志把"成功的动作提交"建模成本体里的对象,让决策与审计可追溯。这一篇讲清它记什么、在哪配、有何限制。

1 动作日志(action log)
动作日志(action log)把成功的动作提交建模为对象类型(object type),以便在本体感知(object-aware)…
2 一次提交 = 一个日志对象
提交一个动作,会生成一个对应的动作日志对象,并自动链接到该动作编辑过的所有对象
1

什么是动作日志(action log)

它把"成功的动作提交"变成本体里可以分析、展示的对象。

动作日志(action log)把成功的动作提交建模为对象类型(object type),以便在本体感知(object-aware)的 Foundry 工具中分析与展示。你可以把它作为决策流程的输入,也能用它监控本体的变更。

"The action log models successful action submissions as object types to be analyzed and displayed in object-aware Foundry tooling."动作日志把成功的动作提交建模为对象类型,以便在本体感知的 Foundry 工具中分析与展示。

生成的动作日志对象类型,显示名自动取为 [Log] <动作类型名>,复数显示名取为 [Logs] <动作类型名>。它的设计目标,是简化"代表决策与数据编辑"的对象类型的生成与维护。

2

什么时候用它:五个能力别搞混

Foundry 提供多个回答"变更"问题的能力,它们不可互换。

你想回答的问题该用的能力
什么决策、谁、何时、在何种语境下做出的?Action log(动作日志)
这个对象每一次编辑的完整历史(不论怎么改的)?Edit history(编辑历史)
动作多久成功/失败一次、花了多长时间?Action metrics(动作指标)
怎么撤销一个动作应用的编辑?Undo / revert(回滚)
动作开始失败时怎么告警?Monitoring(监控)
两条直接结论:① 动作日志只记录成功的提交,不记录失败——失败由动作指标跟踪。② 它只记录通过动作类型做出的编辑;直接写底层数据源或旧的 Foundry Forms 回写不会产生日志对象。
3

在哪配置动作日志

有两个不同的配置入口,分别针对"单个动作"和"整类对象"。

入口一为单个动作类型生成日志对象
在动作类型的 Capabilities 标签里开启。
打开动作类型 → 选 Capabilities 标签 → 找到 Create action log objects 区块(界面描述为"每次成功触发此动作就生成一个对象")→ 打开开关 → 选 Generate object type 创建底层日志对象类型。
入口二要求编辑某类对象的所有动作都带日志
在对象类型的 Datasources 标签里强制。
打开对象类型 → 选 Datasources 标签 → 在 Edits 区开启 Only allow Action types with action logs(界面描述:编辑该类型对象的所有动作都需要动作日志才能运作)。注意:该开关只有在对象类型已开启编辑后才会出现。
4

日志本体:一次提交 = 一个日志对象

动作日志对象类型与动作类型一一对应,并自动链接到被编辑的所有对象。

提交一个动作,会生成一个对应的动作日志对象,并自动链接到该动作编辑过的所有对象。例如一个 Close Alerts 动作类型,一次性把 10 个 Alert 对象的"Status"改为"Closed"——配置日志后,会产出单个日志对象,通过外键链接到全部 10 个 Alert 对象。

互动实验:一次动作 = 一个日志对象
点击按钮,观察动作日志如何建模这次提交。
提示:应用一个动作日志支持的动作类型,需要对该日志对象类型拥有相应权限,就像对动作通过规则/函数创建或修改的其他对象一样。
5

日志里记什么:必填值与可选值

把下列字段分到"必填(Required)"还是"可选(Optional)"(点击每行右侧)。

必填值里还包含"副作用与回滚的溯源"信息,点击揭晓有哪些:

点击这里揭晓 →

6

限制与函数后端动作

设计流程前,先知道这些硬约束;并用函数后端动作时还有额外要求。

  • 属性类型一旦创建即固定:日志属性类型创建后不可改;若源属性类型变了,动作类型会校验失败,需新建属性并改映射。
  • 摘要长度:摘要最多 20 个部分,每个纯文本部分最多 50 字符(参数部分不受此限)。
  • 摘要内容:摘要不能引用对象类型参数。
  • 无回填(No backfill):开启日志不会为已经提交的旧动作补建日志对象,从保存配置那一刻才开始记。
  • 编辑上限:日志对象同样受对象编辑的规模与属性上限约束。
函数后端动作:要为函数后端动作配置动作日志,其底层的 Ontology 编辑函数必须配置 Edits provenance(编辑溯源);否则日志无法记录。

一页带走

① 记成功提交
把成功的动作提交建模为 [Log] 对象;不记失败、不记非动作编辑。
② 两个入口
动作 Capabilities 开日志;对象 Datasources 强制"编辑必带日志"。
③ 一对一映射
一次提交 = 1 个日志对象,自动链接所有被编辑对象。
④ 限制须知
无回填、属性类型固定、摘要有限长;函数后端需 Edits provenance

延伸阅读 · 相关页面

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

常见问题速答 · FAQ

关于「动作日志(Action log)」,读者最常问的几个问题。

什么是动作日志(action log)?
动作日志(action log)把成功的动作提交建模为对象类型(object type),以便在本体感知(object-aware)的 Foundry 工具中分析与展示。你可以把它作为决策流程的输入,也能用它监控本体的变更。
日志本体:一次提交 = 一个日志对象是什么?
提交一个动作,会生成一个对应的动作日志对象,并自动链接到该动作编辑过的所有对象。例如一个 Close Alerts 动作类型,一次性把 10 个 Alert 对象的"Status"改为"Closed"——配置日志后,会产出单个日志对象,通过外键链接到全部 10…