动作类型详解

上传媒体(Media):用媒体集承载海量文件

上传图片、影像、文档这类"媒体"时,Foundry 推荐用媒体引用属性(media reference property)。它背后是媒体集(media set),能撑住数十亿文件,还自带转换与预览能力。

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

一句话速览

上传媒体(Media):用媒体集承载海量文件:上传图片、影像、文档这类"媒体"时,Foundry 推荐用媒体引用属性(media reference property)。

1 媒体引用属性(media reference property)
动作支持通过动作表单或表格上传媒体文件
2 文件选择器 → 媒体集
用户通过文件选择器(file-picker)界面上传媒体文件;在动作成功提交(submit)后,文件会被持久化(persist)到对…
3 配置上传媒体的动作
详细的配置步骤分两头
4 靠 submission criteria 管,而不是媒体集权限
通过动作上传媒体的权限,由 action submission criteria(动作提交条件)管理
1

什么是媒体引用属性(media reference property)

先弄清"媒体"和"附件"不是一回事。

动作支持通过动作表单表格上传媒体文件。在 Foundry 大多数场景里,上传到 media reference(媒体引用)属性是推荐方法

媒体引用属性由 media set(媒体集)支撑。它和附件属性(attachment property)相比有几个关键优势,我们下一步展开。简单说:附件适合"挂在对象上的小文件",媒体集适合"海量、需转换与预览的媒体"。

2

为什么推荐 media reference 而不是 attachment

四个理由,每一条都对应真实痛点。

可扩展Scalability
支持数十亿(billions)文件,存取都高效。
媒体集为大规模媒体存储与检索而生,远超附件通常的承载量级。
内置转换Built-in transformations
开箱即用地支持多种媒体转换与 LLM 能力。
不用自己搭管道,就能做格式转换、AI 处理等。
高级预览Advanced previews
对支持的格式提供内置渲染与富预览。
用户在界面里就能直接看内容,不用先下载。
格式支持Format support
兼顾标准格式与专业格式,如 NITF、GeoTIFF、DICOM。
对遥感、地理、医疗影像等专业场景很友好。
动手试:看清两种上传方式的定位
media reference
海量
背后是 media set;几十亿文件、内置转换与富预览,适合专业媒体。
attachment
轻量
挂在对象上的小文件;从 Workshop / Object Explorer 等多处上传,权限随对象。
3

上传流程:文件选择器 → 媒体集

用户怎么传,系统怎么存。

用户通过文件选择器(file-picker)界面上传媒体文件;在动作成功提交(submit)后,文件会被持久化(persist)到对应的 media set 中。

"Format conversions only happen after the action completes and the media file has been uploaded to the media set."格式转换只在动作完成、文件已上传到媒体集之后才会发生。
格式转换(format conversion)发生在什么时机?点击揭晓。
4

如何配置上传媒体的动作

配置落到两处:属性与动作。

详细的配置步骤分两头:

  • 配置 media reference property(媒体引用属性)本身;
  • 设置 upload media(上传媒体)动作。

也就是说,既要在对象类型侧把属性定义为媒体引用,也要在动作侧把上传媒体的能力接上。两者配齐,用户才能在表单里选文件、提交后落进媒体集。

提示:若你只想先理解概念,记住"属性侧定义 + 动作侧启用"这个两步结构即可;具体点击项随 Foundry 版本可能略有差异,以你实例里的配置向导为准。
5

权限:靠 submission criteria 管,而不是媒体集权限

一个反直觉但重要的点。

通过动作上传媒体的权限,由 action submission criteria(动作提交条件)管理。若用户满足了提交条件,即使对底层 media set 没有权限,也能上传媒体

不过有个边界:当媒体集第一次被加到对象类型、或被动作类型引用时,会检查媒体集上的 Edit(编辑)权限。把媒体集加入本体(ontology)后,访问控制会从媒体集委派(delegate)给本体——这意味着任何能管理该对象类型动作的人,就能控制"谁可以往这个媒体集上传媒体"。

通过动作上传媒体的权限主要靠什么控制?点击揭晓。

一页带走

① 媒体引用是推荐项
media reference 背后是 media set,适合海量、需转换与预览的媒体。
② 四大优势
可扩展(数十亿)、内置转换、高级预览、专业格式(NITF/GeoTIFF/DICOM)。
③ 提交后才落库
文件在动作成功提交后持久化到 media set,格式转换也在之后。
④ 权限靠提交条件
满足 submission criteria 即可上传,无需 media set 权限;首次加入本体时检查 Edit。

延伸阅读 · 相关页面

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

常见问题速答 · FAQ

关于「上传媒体(Media):用媒体集承载海量文件」,读者最常问的几个问题。

一句话速览是什么?
上传媒体(Media):用媒体集承载海量文件:上传图片、影像、文档这类"媒体"时,Foundry 推荐用媒体引用属性(media reference property)。
上传流程:文件选择器 → 媒体集是什么?
用户通过文件选择器(file-picker)界面上传媒体文件;在动作成功提交(submit)后,文件会被持久化(persist)到对应的 media set 中。