跳转至

Upload media（上传媒体文件）

Actions support uploading media files using an action form or table. For most use cases in Foundry, uploading to media reference properties is the recommended method.

Media reference properties (backed by media sets) offer several advantages over attachment properties:

  • Scalability: Support for billions of files with efficient storage and retrieval.
  • Built-in transformations: Many media transformations and LLM capabilities are supported and easy to use out of the box.
  • Advanced previews: Built-in rendering and rich preview functionality for supported formats.
  • Format support: Support for tailored workflows on both standard formats and specialized formats, such as NITF, GeoTIFF, and DICOM.

Users can upload media files via a file-picker interface, with files persisted to the media set upon successful action submission.

:::callout{theme="warning"} Format conversions only happen after the action completes and the media file has been uploaded to the media set. :::

Configuration

For detailed instructions on configuring media reference properties and setting up media upload actions, see Configure media reference properties and Upload media.

Permissions

Permissions for uploading media via an action are managed by the action submission criteria. If users satisfy the action submission criteria, they do not need any permissions on the backing media set to upload media.

:::callout{theme="neutral"} Edit permission on a media set will be checked when it is added to an object type or referenced by an action type for the first time. Adding a media set to your ontology delegates access control from the media set to the ontology. This means that anyone who can manage actions on the object type, can control who is able to upload media to the media set. :::

中文翻译

上传媒体文件

操作(Action)支持通过操作表单或表格上传媒体文件。在Foundry的大多数使用场景中，建议使用媒体引用属性(Media Reference Properties)进行上传。

媒体引用属性（基于媒体集(Media Sets)）相比附件属性(Attachment Properties)具有以下优势：

  • 可扩展性(Scalability)： 支持数十亿文件的高效存储和检索。
  • 内置转换(Built-in transformations)： 支持多种媒体转换和大语言模型(LLM)功能，开箱即用，操作简便。
  • 高级预览(Advanced previews)： 内置渲染和丰富的预览功能，支持多种格式。
  • 格式支持(Format support)： 支持标准格式和专用格式（如NITF、GeoTIFF和DICOM）的定制化工作流。

用户可以通过文件选择器界面上传媒体文件，文件在操作成功提交后持久化存储到媒体集中。

:::callout{theme="warning"} 格式转换(Format conversions)仅在操作完成且媒体文件已上传至媒体集后才会执行。 :::

配置

有关配置媒体引用属性和设置媒体上传操作的详细说明，请参阅配置媒体引用属性和上传媒体文件。

权限

通过操作上传媒体文件的权限由操作提交条件(Action Submission Criteria)管理。如果用户满足操作提交条件，则无需对底层媒体集拥有任何权限即可上传媒体文件。

:::callout{theme="neutral"} 当媒体集首次添加到对象类型或被操作类型引用时，将检查对该媒体集的编辑权限。将媒体集添加到本体(Ontology)后，访问控制权将从媒体集委托给本体。这意味着，任何能够管理对象类型操作的用户，都可以控制谁能够向该媒体集上传媒体文件。 :::