---
order: 8
navTitle: 文件管理
---
# 文件管理

右键选中的资源文件，可对资源文件进行操作管理，如对资源进行[查看](#check)、[编辑]()、[重命名](#rename)、[导入和导出](#import-export)、[刷新](#refresh)等操作，也可查看当前资源的[基本信息](#basic-information)，元数据文件管理通用操作如下图所示：

![元数据文件管理](./images/2021-08-11-16-59-01.png)

## 文件操作{#operate}

可对资源文件进行查看、重命名、移动、导入、导出、收藏等基础操作。

### 查看{#check}

查看文件有两种方式：

1.点击**查看**选项，可全屏展示当前文件的内容，不显示操作工具栏，如下所示：

![查看](./images/2021-08-11-17-03-47.png)

2.使用URL查看，常规使用文件路径作为URL进行查看，也可以使用文件ID作为URL进行查看。以查看DEMO项目BI模块的大屏`仓库运输数字化大屏`为例：

- **使用文件路径作为URL进行查看**

`仓库运输数字化大屏`的文件路径为`https://demo.succbi.com/v5/DEMO/ana/dash/viz/Warehouse%20Logistics.dash`，在浏览器输入此路径可以直接查看。

- **使用文件ID作为URL进行查看**

  - **使用背景**：在实现从第三方平台跳转至系统特定页面的过程中，若采用文件路径直接作为URL进行跳转，那么一旦目标文件被重命名，就需要及时更新第三方平台上的跳转链接。若未能及时作出调整，系统将无法识别已变更的文件路径，导致跳转失败。
    此时更为稳健的做法是在跳转链接中采用文件的唯一标识符（即文件ID）而非其物理路径。这样一来，即便文件在系统中经历了重命名或位置变动，跳转链接也能持续有效，无需频繁修改第三方平台的配置。

  - **配置方法**：将查看链接的URL设置为：域名+上下文+/fid/ID即可自动识别跳转，即便更改文件名也无需再次修改URL。其中ID为目标文件的高级属性，它是文件的唯一ID，在创建文件时自动生成且后续一般不会更改。仓库运输数字化大屏的属性ID为`XYk4pLsxK9KAFBkGSBE61B`，那么可以设置查看的URL为`https://demo.succbi.com/v5/fid/XYk4pLsxK9KAFBkGSBE61B`

  - **文件ID**：点击文件的**属性**，在**高级**处的ID即为文件ID

![查看](./images/2024-08-30-17-22-01.png)

:::tip
特别注意：当希望查看的页面是门户时，不能直接使用.app的文件ID，而是需要使用.tpg的文件ID
:::

### 重命名{#rename}

点击**重命名**，弹出重命名对话框，可修改文件的名称和描述，在数据加工、分析、应用等资源中被引用的文件重命名后，文件能够自动更新重构。

![重命名](./images/2021-08-11-18-31-36.png)

### 移动{#move}

点击**移动到**选项，弹出文件资源所在模块下的目录结构对话框，同时定位当前文件所在目录，选择其他目录，则可以将文件移动到选中目录；也可点击对话框左下角**新建文件夹**按钮，移动到新的目录中。在数据加工、分析、应用等资源中被引用的文件移动位置后，文件能够自动更新重构。

系统也提供了快捷移动文件的操作方法：选中文件，长按鼠标左键拖入到其他目录，会弹出确认对话框，点击确定即可快捷移动文件。

若只在当前目录下拖动文件，可修改文件的顺序。目录下的文件顺序被修改后，右键弹出管理菜单会增加**重置为默认排序**的选项，点击即可还原为最开始的顺序。

![移动](./images/2021-08-11-17-14-55.png)

:::tip
快捷移动文件中，如果想要放在目录的下级文件夹中，可将文件拖入目录上，停留2s，该目录会自动展开，想要移动到多层目录下，同理使用此方法即可。
:::

### 复制{#copy}

点击**复制到**选项，与移动到一样，弹出文件所在资源模块下的目录结构对话框，可将文件复制到选中目录。

数据中的模型表复制稍有不同，在对话框左下角会多出一个**创建新表**的选项，勾选它，复制模型表的同时会创建一个新的物理表，两者区别如下：

![复制](./images/2021-08-10-09-22-31.png)

- **直接复制**：和原来的表指向同一个物理表模型
- **勾选创建新表复制**：会创建一个新的物理表模型
  - 复制模型数据：勾选创建新表后，会弹出**复制模型数据**的选项，勾选它可以将模型表中的数据复制到新的物理表模型中

### 导入和导出{#import-export}

使用文件的导入和导出功能，可以将文件做备份，避免数据丢失，同时也可以将文件导出后再其他项目中导入，方便少量文件的迁移。

点击**导出**选项，可将文件导出为`scz`文件，导出的文件名称会带上文件的类型，比如导出`柱形图`仪表板，则导出文件名为`柱形图.dash`。

![导出](./images/2021-08-11-17-23-23.png)

点击**导入**选项，可将刚刚导出的`scz`文件导入到系统的对应模块中，导入时如果文件名称没有同名文件，可直接导入成功，弹出成功提示框；如果有同名文件，则会弹出对话框，选择解决冲突的处理方式：

![导入](./images/2021-08-11-17-28-22.png)

- **自动重命名**：导入的文件名称将自动重命名，与同名文件共存，重名的表尾部加入后缀\_1，默认为该选项
- **替换同名文件**：导入的文件将替换同名文件，删除已存在的表，最后只保留导入文件

当文件有冲突时，可点击对话框左下角**详细信息**按钮，查看同名文件资源的详细信息。

[数据模块](../data-gov/model/README.md)中导入和导出与其他模块中的导入导出稍有不同，数据表可以导入导出数据表，在导出时可勾选**导出模型关联的数据表**选项，则会将当前模型表的数据表一并导出，如果数据量较大，不建议勾选该选项，推荐使用数据库备份方式进行数据备份或迁移，可查看文档[迁移数据源配置](../devops/upgrade/migrate.md#configuration)。

![导出模型](./images/2021-08-10-10-23-04.png)

在导入时一并导入关联的数据表，如果数据表有同名文件，则会弹出对话框，可选择**自动重命名**、**覆盖同名表**、**清空表**三种解决数据表冲突的处理方式，具体可查看文档[导入物理表](../data-connect/dbtable-mgr.md#import)

:::tip
导入文件时，只能将导出的scz文件导入进对应模块中，比如从分析模块中导出的文件，不能导入进数据模块和应用模块。
:::

### 删除{#delete}

点击**删除**选项，会弹出删除确认对话框，在对话框中可以显示该文件被多少资源引用，点击**详细信息**按钮，可查看详细的资源被引用情况，点击路径可打开引用该模型表的资源文件。

![删除](./images/2021-08-11-17-35-09.png)

### 收藏{#collect}

点击**收藏**选项，可将当前文件放于用户的收藏夹中，收藏可快速找到常用文件。收藏夹的位置位于右上角五角星图标处，点击即可查看收藏的文件。

![收藏](./images/2021-08-11-17-36-33.png)

### 刷新{#refresh}

点击**刷新**选项，可刷新元数据缓存的数据，把最新的数据显示出来。比如A和B两个用户同时修改同一个文件，A已经修改保存，B点击刷新，则可将A修改的内容刷新并同步显示出来，刷新成功后，顶部会出现刷新成功的提示框。

## 文件基本信息{#basic-information}

点击**属性**选项，可以查看文件的基本信息、高级信息，数据模型可查看对应模型信息；除数据模型之外的文件资源，例如仪表板、报表等可查看缩略图信息，具体如下所示：

|数据文件|可视化文件|
|--|--|
|![数据文件基本信息](./images/2021-08-10-16-57-29.png)|![可视化文件基本信息](./images/2021-08-11-17-57-38.png)|

- **基本信息**：
  - 类型：显示文件的类型，比如模型表为`tbl`、仪表板为`dash`、应用为`app`等
  - 路径：文件在当前项目中的路径，如`/DEMO/ana/图表/图形/面积图.dash`，如需要引入当前文件资源路径，可在此处查看该路径
  - 版本：记录文件修改的版本，每一次修改保存后，都会记录一次，历史版本管理可查看[元数据历史版本管理](#historic-version)
  - 创建：文件的创建时间以及创建用户
  - 修改：文件的修改时间以及修改用户
  - 描述：文件的描述信息，在新建文件命名或重命名中可设置描述信息
  - 标签：只有模型表会显示标签，对文件进行标识，方便管理模型表，在菜单的标签中进行设置
- **高级信息**：
  - ID：文件的唯一ID，在创建文件时自动生成
- **缩略图信息**：数据模型没有缩略图信息
  - 默认：PC端的缩略图
  - 手机：移动端的缩略图
  - 上传：系统会自动生成缩略图，点击上传按钮可自定义缩略图
  - 重置缩略图：重置为系统默认生成的缩略图
- **模型信息**：只有数据模型有模型信息
  - 输出表：模型表的目标数据库表，可查看文档[输出物化的数据表](../data-process/data-output/README.md#materialized)
  - 磁盘空间：模型表所占系统的磁盘空间大小
  - 调度计划：所在的调度计划名称，调度计划可参考文档[调度管理](../schedule/README.md)
  - 提取状态：模型表上一次提取数据的状态，包含在加工界面手动提取以及调度计划提取
    - 已提取：提取数据成功，则显示已提取状态
    - 未提取：新建的数据加工或对加工做修改并保存，未执行提取数据，则显示未提取
    - 取消：提取数据过程中点击取消按钮，则显示取消状态
    - 异常：提取数据出现异常导致失败，则显示异常状态，手动提取出现异常可直接弹出异常信息对话框，调度计划中出现异常，可通过调度[日志](../schedule/README.md#log)查看异常信息
  - 提取时间：上一次提取数据的时间
  - 提取耗时：上一次提取数据所耗费的时间
  - 数据期：为模型属性中设置的数据期类型，可查看文档[数据期类型](../data-gov/model/model-settings.md#data-period)

### 文件历史版本管理{#historic-version}

文件每做一次修改保存后，都会记录一次版本，记录历史版本，可以查看文件的修改记录以及还原历史版本。

点击**历史版本**按钮可以弹出历史版本对话框，可以查看版本号、名称、修改时间、修改人以及对历史版本进行编辑、还原、查看代码差异、查看结构差异等操作，版本号为`r0`的为最初版本，版本号后面带有星号`*`的为当前版本：

![历史版本管理](./images/2021-08-11-17-52-54.png)

- **编辑**：点击编辑按钮，可打开新标签页到文件的当前历史版本，可在其基础上重新修改
- **还原**：点击还原，可将最新版本还原到该历史版本，当前版本没有还原按钮
- **差异**：点击差异，可以查看当前历史版本与上一次历史版本的代码差异，通过代码的差异可以看出做了什么修改，最初版本没有差异按钮
- **结构差异**：只有模型表有该选项，点击结构差异，可以查看当前历史版本与上一次历史版本的结构差异，如移除字段或者修改字段类型，最初版本没有结构差异按钮
- **刷新**：点击左上角刷新按钮，可刷新历史版本数据，勾选右上角的**自动刷新**选项，系统可自动刷新历史版本

当历史版本数大于0时，会出现**重置为系统默认**按钮，WAR包里会自动带上系统项目的元数据，系统元数据被修改后，可通过点击该按钮将数据重置为包中的初始数据，新建的项目，在war包里没有对应元数据，不能进行重置操作。