文件
规格
| 标签 | 值 |
|---|---|
| 版本 | 1.0.0（更新于 2024-01-01） |
| 开发者 | Labii Inc. |
| 类型 | 章节 |
| 支持配置 | 是 |
概述
文件小插件是一款全面的文件管理工具，允许用户直接在 Labii 记录中附加、预览、编辑和整理任意类型的文件。它支持通过拖放或文件选择器上传新文件，也支持将以前上传的文件链接到记录。对于图像、Office 文档、PDF、科学结构文件和质粒图谱等受支持的格式，用户无需离开平台即可嵌入预览和编辑文件。其他功能包括文件版本控制、实时病毒扫描、移动端图像裁剪，以及在记录签名后保护附件的签名锁定行为。
使用场景
- 实验记录：将原始数据文件、分析报告、凝胶图像或仪器输出文件直接附加到实验记录中，以便集中记录。
- 合同和协议管理：将已签署协议或支持文档链接到合同条目，方便查阅和审计。
- 科学数据附件：上传化学结构文件、质粒图谱或序列文件，并直接预览或编辑，无需外部软件。
- 受监管工作流程：使用签名锁定行为冻结记录签名后的文件版本，以满足 GLP 或 GMP 环境中的数据完整性要求。
- 协作文件审核：与团队成员共享上传的文件，使其无需下载即可直接在记录中预览内容。
配置
文件小插件无需必需配置即可使用。可选设置用于自定义显示哪些字段以及界面的工作方式。
单击小插件标题中的 Configure（设置）按钮。
调整所需设置（请参阅下方的配置选项）。
单击 Save 应用设置。更改会立即应用于所有使用此小插件的记录。
配置选项
- Fields — 与每个文件条目一起显示的字段。
- Should Hide Column Data — 隐藏默认已上传文件视图中的列数据。
- Should Hide Preview — 隐藏默认已上传文件视图中的嵌入式预览。
- View — 在 Preview（默认，显示文件预览和元数据）和 List（以表格形式显示文件名、大小、类型和上传日期）之间选择。
- Column Referenced — 引用此记录的 ForeignKey 或 ForeignKeys 列。设置后，新上传的文件会自动分配到该列。
- Fields to Copy — 链接文件时要复制的字段。默认为 projects。
界面
预览视图
默认视图显示每个已附加文件的列数据和嵌入式文件预览。操作按钮允许用户切换列数据和预览的可见性、下载原文件或删除文件条目。小插件底部提供拖放上传区域和 Add Existing File 按钮。
预览视图显示已附加文件的嵌入式预览、列元数据和每个文件的操作控件
列表视图
列表视图以结构化表格形式显示文件，包含文件名、大小、类型和上传日期等主要信息。处理大量附件或不需要嵌入式预览时，这种布局更加高效。
列表视图提供紧凑且可排序的附件表格，便于高效浏览
其他功能
上传新文件
将一个或多个文件拖放到上传区域，或单击云朵图标打开文件选择器。
文件会依次上传。每次上传支持的最大文件大小为 5 GB。
上传完成后，每个文件及其预览和元数据会显示在小插件中。
添加现有文件
单击 Add Existing File 按钮。
系统会打开一个对话框。选择一个或多个以前上传的文件，也可以指定要链接的版本。
确认选择。系统会将文件链接到记录，无需重新上传。
Add Existing File 对话框用于链接以前上传的文件，并可选择指定版本
在移动设备上裁剪图像
在移动设备上，点击上传区域可以选择图库中的图像或拍摄新照片。内置裁剪工具允许用户在上传前裁剪图像，确保附件整洁并突出重点。
移动端图像裁剪工具允许用户在上传前调整照片
在移动设备上点击上传区域。
选择 Select from Gallery 或 Take Photo。
使用裁剪工具调整图像边界，使内容清晰准确。
确认裁剪并上传。裁剪后的图像会附加到记录。
版本控制
每当已上传文件的内容发生变化时，系统都会自动创建新版本。所有以前的版本仍可访问，从而提供完整的文件修改历史记录。
病毒扫描
Labii 可以对所有上传的文件执行实时病毒扫描。此功能默认禁用。
若要启用，请前往 Settings → Organization Detail，并将 enable_antivirus_scan 设置为 true。
每个文件都有以下三种状态之一：
- Pending — 等待病毒扫描
- Clean — 已扫描且安全
- Infected — 检测到恶意软件；文件会被锁定并隔离（禁用预览和下载）
系统在检测到恶意软件时会发送通知。
启用实时病毒扫描会使文件上传过程增加约 20 秒。
签名和锁定
记录签名后上传的任何文件都会锁定为签名时的最新版本。如果文件以后被修改，已签署版本仍可供参考，从而在受监管的工作流程中保持数据完整性。
支持的文件类型
| 文件类型 | 后缀 | 预览 | 编辑 |
|---|---|---|---|
| 图片 | *.jpg, *.jpeg, *.png, *.gif, *.bmp | 是 | 是 |
| 图片 | *.tiff | Safari | 是 |
| 视频 | *.mp4, *.mov | 是 | 否 |
| 音频 | *.mp3 | 是 | 否 |
| 文本 | *.txt | 是 | 是 |
| 表格数据 | *.tsv, *.csv | 是 | 是 |
| HTML | *.html | 是 | 是 |
| 代码 | *.js, *.jsx, *.ts, *.tsx, *.mjs, *.cjs, *.json, *.css, *.scss, *.less, *.py, *.r, *.java, *.c, *.cpp, *.h, *.hpp, *.cs, *.go, *.rs, *.rb, *.php, *.swift, *.kt, *.scala, *.pl, *.lua, *.sql, *.sh, *.bash, *.zsh, *.yaml, *.yml, *.xml, *.toml, *.ini, *.env, Dockerfile | 是 | 是 |
| 是 | 否 | ||
| Word | *.docx | 是 | 是 |
| Excel | *.xlsx | 是 | 是 |
| 演示文稿 | *.pptx | 是 | 否 |
| Office 2013 | *.doc, *.xls, *.ppt | 是 | 否 |
| 化学结构 | *.cml, *.inchi, *.mol, *.sdf, *.smi, *.cdx, *.kcj, *.mrv, *.sd | 是 | 是 |
| 质粒 | *.gb, *.gbk, *.ape, *.ab1, *.fas, *.fasta, *.seq, *.sbd, *.dna | 是 | 是 |
| 基因组浏览器 | *.fas, *.fasta, *.fa, *.fna, *.2bit, *.bam, *.cram, *.sam, *.vcf, *.vcf.gz, *.bed, *.bed.gz, *.gff, *.gff.gz, *.gtf, *.gtf.gz, *.bw, *.bigwig, *.wig, *.bedgraph, *.seg, *.cn, *.maf, *.bedpe, *.interact, *.hic, *.cool | 是 | 否 |
最佳实践
文件整理
- 上传前使用描述性文件名，以便无需逐个打开文件即可在列表视图中识别附件。
- 使用 Add Existing File 将共享参考文件（例如标准方案或模板文档）链接到多条记录，避免上传重复副本。
视图选择
- 处理少量文件且嵌入式呈现有帮助时（例如图像、PDF 和结构文件），使用 Preview 视图。
- 记录包含许多附件时，切换到 List 视图；扫描文件名和元数据比呈现预览更高效。
安全性和合规性
- 如果公司接受外部人员或不受信任来源提供的文件，请启用病毒扫描。
- 在受监管的（GLP、GMP）工作流程中，使用签名锁定行为冻结记录签名时的文件版本；除非可以接受生成新版本记录，否则请勿在签名后上传替换文件。
性能
- 单个上传文件应小于 5 GB。对于非常大的数据集，可以考虑拆分为多个文件或使用链接存储引用。
- 请注意，病毒扫描会使每次上传增加约 20 秒；启用此功能时请告知用户。
应避免的常见问题
- 避免删除已签署记录所引用的文件，否则会破坏审计追踪。
- 避免上传文件时不填写相关元数据字段（通过 Fields 配置），不完整的元数据会降低可搜索性和可追溯性。
相关小插件
- 文件预览：仅需预览单个文件而不需要完整列表管理时，可以使用这款轻量替代小插件。