上传媒体(Media):用媒体集承载海量文件
上传图片、影像、文档这类"媒体"时,Foundry 推荐用媒体引用属性(media reference property)。它背后是媒体集(media set),能撑住数十亿文件,还自带转换与预览能力。
https://www.palantir.com/docs/foundry/action-types/upload-media/
原始标题:Upload media
一句话速览
上传媒体(Media):用媒体集承载海量文件:上传图片、影像、文档这类"媒体"时,Foundry 推荐用媒体引用属性(media reference property)。
什么是媒体引用属性(media reference property)
先弄清"媒体"和"附件"不是一回事。
动作支持通过动作表单或表格上传媒体文件。在 Foundry 大多数场景里,上传到 media reference(媒体引用)属性是推荐方法。
媒体引用属性由 media set(媒体集)支撑。它和附件属性(attachment property)相比有几个关键优势,我们下一步展开。简单说:附件适合"挂在对象上的小文件",媒体集适合"海量、需转换与预览的媒体"。
为什么推荐 media reference 而不是 attachment
四个理由,每一条都对应真实痛点。
上传流程:文件选择器 → 媒体集
用户怎么传,系统怎么存。
用户通过文件选择器(file-picker)界面上传媒体文件;在动作成功提交(submit)后,文件会被持久化(persist)到对应的 media set 中。
如何配置上传媒体的动作
配置落到两处:属性与动作。
详细的配置步骤分两头:
- 配置 media reference property(媒体引用属性)本身;
- 设置 upload media(上传媒体)动作。
也就是说,既要在对象类型侧把属性定义为媒体引用,也要在动作侧把上传媒体的能力接上。两者配齐,用户才能在表单里选文件、提交后落进媒体集。
权限:靠 submission criteria 管,而不是媒体集权限
一个反直觉但重要的点。
通过动作上传媒体的权限,由 action submission criteria(动作提交条件)管理。若用户满足了提交条件,即使对底层 media set 没有权限,也能上传媒体。
不过有个边界:当媒体集第一次被加到对象类型、或被动作类型引用时,会检查媒体集上的 Edit(编辑)权限。把媒体集加入本体(ontology)后,访问控制会从媒体集委派(delegate)给本体——这意味着任何能管理该对象类型动作的人,就能控制"谁可以往这个媒体集上传媒体"。
一页带走
延伸阅读 · 相关页面
按主题横向跳转,不必顺着目录一篇篇读。
常见问题速答 · FAQ
关于「上传媒体(Media):用媒体集承载海量文件」,读者最常问的几个问题。