动作类型详解

上传附件(Attachment):把文件挂到对象上

附件(attachment)是把文件"挂"在某个对象上的轻量方式。它从 Workshop、Object Explorer 等多处都能上传,权限跟随对象本身,但有明确的类型与大小限制。

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

一句话速览

上传附件(Attachment):把文件挂到对象上:附件(attachment)是把文件"挂"在某个对象上的轻量方式。它从 Workshop、Object Explorer 等多处都能上传,权限跟随对象本身,但有明确的类型与大小限制…

1 附件(attachment)
动作支持从 Workshop、Object Explorer、Object Views、Quiver、Slate 上传附件(atta…
2 参数类型选 Attachment
在参数配置视图(parameter configuration view)里,把参数类型选为 Attachment
3 属性类型选 Attachment
在对象详情视图里,把属性类型选为 Attachment
4 上传时机与自动清理
附件一旦被加入动作表单,就会立即上传到 Foundry
1

什么是附件(attachment)

先理解它的"身份"与"权限来源"。

动作支持从 Workshop、Object Explorer、Object Views、Quiver、Slate 上传附件(attachment)。对附件的查看、编辑、删除权限,与该附件所上传到的对象(object)保持一致。

例如:若用户对某对象有查看(view)权限,就能查看并下载挂在该对象上的附件;若要替换已有附件,则需要对对象有编辑(edit)权限。

提示:你可以上传单个附件,也可以上传一个附件列表(list of attachments)。一次传多份文件时,需要在动作与对象两侧都打开"允许多值"。
2

配置动作类型:参数类型选 Attachment

动作侧的两条硬约束。

参数配置视图(parameter configuration view)里,把参数类型选为 Attachment。附件只能通过 attachment 参数类型上传。

同时有两个底层约束:

  • 对象底层数据集(backing dataset)里对应的列必须是 String
  • 被编辑的对象属性必须是 Attachment 类型。

若要一次上传多份媒体文件,需勾选 Allow multiple values(允许多值)。不过仅此还不够——对象类型侧也要打开允许多值,下一步会讲。

3

配置对象类型:属性类型选 Attachment

对象侧也要打开"允许多值"。

在对象详情视图里,把属性类型选为 Attachment。附件只能上传到 attachment 属性类型。

如果想把多份文件传到一个属性上,需勾选 Allow multiple(允许多值)。此时,对象底层数据集里的该属性必须是 Array(数组)

注意:"动作侧 Allow multiple values" 与 "对象侧 Allow multiple" 要两边同时打开,一次传多份文件才会真正生效。
4

上传时机与自动清理

附件是"先传后提交",取消会怎样?

附件一旦被加入动作表单,就会立即上传到 Foundry。在表单提交(submit)时,对附件的查看/编辑/删除权限,会从用户对底层对象类型的权限推断(inferred)出来。

如果表单提交失败或取消,那份"已上传但尚未真正挂上对象"的附件就不再可直接访问,并在一段时间后被自动永久删除。同理,属于已删除对象的附件、或因属性被删而不再映射到对象的附件,也会最终被自动永久删除。

提交失败/取消时,已上传但未关联的附件会怎样?点击揭晓。
5

规模限制:大小与关联数

两个硬上限要记牢。

附件同时支持 logic-backed 与 function-backed 动作。存在一条全局固定的文件大小上限:200MB

此外,每个附件在其"生命周期"内最多可关联到 10 个对象。一旦关联到 10 个对象,即便其中某些原对象被删,也无法再关联其他对象;达到这个上限后,若想关联到更多对象,只能把文件重新上传为新的附件

动手试:这两条限制分别管什么
单文件大小上限
200MB
全局固定上限;无论逻辑型还是函数型动作都受此约束。

一页带走

① 权限随对象
附件的查看/编辑/删除权限与所属对象一致;替换需对象编辑权。
② 两侧都选 Attachment
动作参数与对象属性都须为 Attachment;底层列是 String(多值为 Array)。
③ 先传后提交
加入表单即上传;提交失败/取消则附件不再可达并最终自动删除。
④ 两个硬上限
单文件 200MB;单个附件最多关联 10 个对象,超限需重新上传。

延伸阅读 · 相关页面

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

常见问题速答 · FAQ

关于「上传附件(Attachment):把文件挂到对象上」,读者最常问的几个问题。

什么是附件(attachment)?
动作支持从 Workshop、Object Explorer、Object Views、Quiver、Slate 上传附件(attachment)。对附件的查看、编辑、删除权限,与该附件所上传到的对象(object)保持一致。
参数类型选 Attachment是什么?
在参数配置视图(parameter configuration view)里,把参数类型选为 Attachment。附件只能通过 attachment 参数类型上传。
属性类型选 Attachment是什么?
在对象详情视图里,把属性类型选为 Attachment。附件只能上传到 attachment 属性类型。
上传时机与自动清理是什么?
附件一旦被加入动作表单,就会立即上传到 Foundry。在表单提交(submit)时,对附件的查看/编辑/删除权限,会从用户对底层对象类型的权限推断(inferred)出来。