[]
        
在线Demo 免费试用
(Showing Draft Content)

文档的导入与导出

1.功能概述

导出指定的文档,实现文档的快速迁移与分享。

2.文档导出

在执行导出操作时,默认会将所选文档及其关联文档一同导出,包括但不限于所使用的数据集、数据源、图片以及相关联的仪表板等。

这一操作旨在最大程度确保文档在目标系统中完成导入后,与从源系统导出时的状态保持高度一致,完整保留文档的所有相关信息与依赖项 。

2.1选择文档

进入到导出页面,点击“+选择文档”,选择所要导出的文件,支持按照目录或文档类型两种方式选择文档:

image

文档的检索,当文档较多时,为了快读找到需要导出的文档,提供了检索功能,可通过输入关键字快速检索达到所需要的文档:

image

若需要更多更具体的搜索条件,可展开高级搜索框进行高级检索:

image

2.2批量选择文档

当进行服务器或数据库的迁移时,我们需要快速的选择所有的文档,可以根据分类或文档类型批量选择文档。

点击分类或文档类型名称前的复选框,可将该分类或类型下的文档全部选中。

image

2.2导出

选择好所需的文档,点击导出,直接导出或者切换到其他菜单继续选择导出内容,待全部选择完成后一起导出。

image

选中的文件或系统设定选项均会被导出为一个扩展名为zip的压缩包,该压缩包可供后续的导入使用。

该压缩包中默认包含:

  • 选中的文档及其相关联的文档。

  • 选中的系统设置、模版等。

  • 清单文件:名为export.manifest,该清单文件为导出时自动生成的,记录了导出的压缩包中所包含的文档、系统设定等关联信息以及结构。

type=warning

压缩包中的文档名均为该文档的全球唯一标识符(GUID),该GUID在后续的导入中将用于判断目标系统是否存在相同文档的依据。

文档与文档的关联关系也将由GUID进行对应。

清单文件作为导入时的重要依据,不建议手动生成或修改。

3.导入

进入到导入页面,点击“选择文件”,选择需要导入的压缩包:

image

选择需要的压缩包之后,会将压缩包中所包含的文档或系统设定等信息展示出来供操作人员进行确认,确认完成后点击 “导入”,即可开始导入操作。

image

导入时,依据GUID来判断目标系统重是否存在相同的文档,若不存在相同的文件,视为新增;若存在相同的文档,则视为替换,导入的文档将覆盖系统中的内容。

image

导入完成,在列表中展示详细信息,若导入失败,会在“错误信息”列展示失败原因

image

4.文档导出的其他操作

4.1是否导出所选文档的引用文档

默认状态下,导出文档的同时会将其关联的文档一并导出,这样会带来压缩包尺寸以及导入导出性能的问题。

用户可以通过自主选择是否导出特定的关联文档。

type=info

该应用场景通常更多地适用于需要执行多次导入操作的情况:

例如,在测试环境中创建了大量的文档,当产品上线时,将测试系统内的文档导入至正式的生产环境中。

然而,需要注意的是,测试环境中的仪表板会持续处于开发和更新状态。

在此情况下,为了将测试系统中最新的仪表板更新至生产环境,同时确保不会对生产环境中已有的相关数据连接和数据集造成破坏,我们在导出操作时可以选择不导出与之关联的数据连接和数据集。

由于目标系统中原本就存在具有相同GUID的数据连接和数据集,所以即便仅导入仪表板,它在生产环境中也能够正常工作。

选择要导出的文档之后,在文档列表上,找到 导出引用文档 的下拉列表,展开并指定要导出的文档类型。

image

  • 文档类型默认被全部选中,即导出时会导出所有相关联的文档类型。

  • 将某文档类型前面的复选框设为不选中状态,意味着若该文档类型在已选中的文档中被引用,那么在执行导出操作时,将不会对该文档进行导出。

type=warning

注意:

如果不导出引用文档,请确保导入时的系统中存在引用文档(文档GUID一致),否则将导入失败。

4.2导出文档的同时导出文档权限

image

这里的文档权限具体指的是文档的分享权限。当勾选相应的复选框时,在导出文档的操作过程中,会将文档所具有的分享权限信息一并导出。

在将文档导入目标系统时,会使用角色名称来进行匹配操作。若目标系统中存在相同的角色,那么在导入的同时,该文档将会被分享给指定的角色。

例如:用户A创建了一个文档并分享给角色A,导出该文档时勾选“导出文档权限”。导入到目标系统,目标系统中也有一个相同的角色A,那么该文档在导入时会将该文档同时共享给角色A。

4.3导出文档的同时导出文档的运行计划

image

在源系统中,用户给文档添加了一些定时任务,当迁移到目标系统时,希望将这些定时任务同时导入到目标系统当中,避免重复的劳动。

在导出时,勾选“导出文档运行计划”即可。

type=info

与文档运行计划关联的运行模板、以及所有组织、角色、用户、上下文等信息将一并被导出。

4.4导出时为文档赋予分享权限

在执行导出操作时,为导出的文档赋予特定的分享权限,以便在将其导入目标系统时,在角色名称一致的前提下,这些文档在导入的过程中将统一赋予权限模板指定的分享权限。

我们通过创建权限模板,为指定角色添加特定的分享条件,与导出功能搭配使用,来实现导入时统一设定分享权限的目的。如何创建权限模板,请参考 权限模板

例如:

在测试系统中新增了一批仪表板,计划将它们导入至生产环境,并期望为这些文档统一设置分享权限,分享给某些特定角色。此时,我们可以在测试系统与生产环境中分别添加名称相同的角色,并在角色模板中为这些角色指定相应的分享权限。在从测试系统导出文档时,选择已设定好的权限模板,当这些文档被导入生产环境后,被指定了该权限模板的文档将自动具备模板所规定的分享权限 。

在导出页面,在需要指定的文档行中,点击“应用权限模板”,选择所需要的权限模板。导出时,将为该文档赋予所选的权限模板中指定的分享权限。

在执行导入操作时,通过角色名称进行匹配,如果组织和角色名称一致,导入时为该文档赋予相应的分享权限。

image

4.5导出文档列表的批量操作

在导出文档列表页面,点击右上角的“显示复选框”进入到多选模式:

image

**批量删除:**选择多个文档可进行批量删除

image

批量指定权限模版

image

5.文档导出与下载的区别

5.1文档的下载

image

  • 在文档门户中,通过文档的上下文菜单可进行文档的下载。

  • 文档所有者具有下载该文档的权限

  • 仅下载文档本身,与之关联的文档不会同时被下载;

  • 若想将该文档导入到其他环境,仅能通过在文档门户中进行上传操作来进行。

5.2文档的导出

  • 仅系统管理员拥有导入导出的权限

  • 导出所选文档的同时,与其关联的文档将一并被导出,系统可将文档相关的附件以及文档权限的设定一并打包成.zip格式导出。