跳转至
For the complete DHIS2 documentation index, see llms.txt.
用户指南
交换数据

导入/导出应用

在初级卫生系统中，HMIS 通常是一个分布式应用项目。 在基层卫生系统中，HMIS 通常涉及分布式应用项目，即同一项目在不同的地理位置（初级保健中心 在不同的地理位置（初级保健中心、社区保健中心、医院、地区和州）运行同一个应用项目。 其中许多地理位置都没有互联网连接，因此只能离线工作。 因此，它们只能离线工作。在某些时候（通常是在区 通常在地区一级）需要同步数据，以便为特定地理区域建立一个综合数据库。 在某些时候（通常是在地区一级），数据需要同步，以便为特定地理区域建立一个综合数 据库。为此 为此，重要的是能够从一个地点（离线工作，例如在医疗机构）导出数据。 为此，重要的是能够从一个地点（离线工作，如卫生机构一级）导出数据，并导入到另一 个地点（如地区一级）。 导入另一个地点（如地区一级）。 因此，这种导出和导入功能是 HMIS 的一项重要功能。 这一功能也在一定程度上帮助我们克服了对互联网的依赖。 在没有网络连接的地方，可通过 USB 密钥传输数据更新；在有网络连接的地方，可通过电子邮件传输数据更新。 传输数据更新，或在互联网连接有限的地方通过电子邮件传输数据更新。 连接。DHIS2 提供了强大的导入导出功能，以满足这些需求。 满足这些需求。

要访问导入/导出应用，请在顶部标题栏中搜索 进出口。导入/导出应用项目提供了许多服务详细信息 可以在下面找到。

汇入资料

导入进度记录器

无论您导入什么数据（"数据"、"事件"、"组织单位几何图形"、"元数据 "或 "跟踪实体 "数据），都可以通过页面顶部的 "任务摘要 "查看导入进度。

导入摘要

导入请求完成后，我们会在导入表单上方显示导入摘要。 导入表格。任何冲突或错误都会显示在导入主摘要下的表格中。 下的表格中显示。

元数据导入

可以从侧边栏单击来访问元数据导入 元数据导入。

  1. 选择要上传的文件

  2. 选择一种格式：JSON、CSV 或 XML 格式

  3. 选择适当的设置：

    • authSubset
    • 导入报告模式
    • 预热模式
    • 导入策略
    • 原子模式
    • 合并模式

  4. 如果要调整以下一项或多项，请单击**高级选项**。 导入前请进行以下设置：

    • 冲洗模式
    • 跳过分享
    • 跳过验证
    • 异步
    • 包容性策略

  5. 点击**导入**按钮，该按钮将上传文件并启动 导入过程。

提示

强烈建议在导入数据前使用 "干运行 "选项**进行测试。 导入数据前进行测试；以确保您能控制对您的 元数据，并检查是否存在数据元素不同步或 组织单位名称

注意

如果一个组织单位（例如，"Nduvuibu MCHP"）对 ID 为 "aaaU6Kr7Gtpidn "的对象有未知引用，则表示 ID 为 "aaaU6Kr7Gtpidn "的对象不在导入的文件中，而且在现有数据库中也找不到该对象。

您可以使用 标识符 选项来控制是否允许导入具有此类无效引用的对象。如果您选择导入无效的引用，则必须稍后在 DHIS2 中手动更正引用。

DXF2中的匹配标识符

DXF2格式目前支持匹配两个标识符，即 内部DHIS2标识符（称为UID），也使用外部 标识符称为“代码”。进口商尝试搜索时 对于引用（例如上面的引用），它将首先转到UID字段， 然后转到代码字段。这使您可以从旧版导入 系统中没有每个元数据对象的UID。即如果你是 从旧版系统导入设施数据，您可以省略ID 完整字段（DHIS2将为您填写），然后将 代码字段中的旧系统自己的标识符，此标识符为 必须是唯一的。这不仅适用于组织单位，而且 用于各种元数据，从而可以轻松地从其他系统导入。

资料汇入

可以通过单击侧边栏上的数据来访问数据导入 进口。

  1. 选择要上传的文件

  2. 选择一种格式：JSON、CSV、XML、ADX 或_PDF_。

  3. 选择适当的设置：

    • 战略
    • 预热缓存

  4. 如果要调整以下一项或多项，请单击**高级选项**。 导入前请进行以下设置：

    • 数据元素ID方案
    • 组织单位ID方案
    • ID方案
    • 跳过现有支票

  5. 点击**导入**按钮，该按钮将上传文件并启动 导入过程。

提示

**强烈建议您先使用空运行选项**进行测试 导入数据；确保您可以控制自己的任何更改 元数据，并检查数据元素不同步或 组织单位名称

PDF资料

DHIS2支持以PDF格式导入数据。这可以用来 导入由离线PDF数据输入表单生成的数据。请参阅 **数据集管理**一节中介绍了如何生成PDF的详细信息 可用于离线数据输入的表格。

要导入 PDF 数据文件，请导航至侧菜单中的_PDF 数据导入_项。 侧菜单中的_PDF 数据导入_项。上传完成的 PDF 文件，然后单击_导入_。

事件汇入

事件导入可从侧边栏点击事件 导入。

  1. 选择一种格式：JSON 或 CSV。

  2. 如果要调整以下一项或多项，请单击**高级选项**。 导入前请进行以下设置：

    • 事件ID方案
    • 数据元素ID方案
    • 组织单位ID方案
    • ID方案

  3. 点击**导入**按钮，该按钮将上传文件并启动 导入过程。

地球引擎进口{ #ee_import }

地球引擎导入可从侧边栏点击地球引擎 导入。

使用 Google 地球引擎从 WorldPop 导入高分辨率人口数据。使用此导入项目需要 Google Earth Engine 帐户 才能使用此导入项目。

选择应导入哪些地球引擎数据{ #select-which-earth-engine-data-should-be-imported }

表格的第一部分用于配置要导入的地球引擎数据。

  1. 选择要导入的地球引擎数据集。目前的选择是 人口 和 人口年龄组。

  2. 选择数据集后，必须选择一个时段。一次只能导入一个时段。

  3. 选择数据的四舍五入方式。默认情况下，数据不四舍五入。

  4. 选择要导入数据的组织单位。如果选择设施级组织单位，则必须为设施选择相关几何图形。如果没有设施的关联几何体，地球引擎就无法确定人口数量。

选择数据元素，将地球引擎数据导入{ #select-the-data-elements-to-import-the-earth-engine-data-into }

配置好地球引擎数据集后，需要选择将数据导入哪个数据元素。对于有分类组（如 "人口年龄组"）的数据集，DHIS2 数据元素必须有与地球引擎数据集分类组相匹配的类别选项组合形式的分类。

为地球引擎导入配置数据元素

在配置包含地球引擎数据的 DHIS2 数据元素时，如果您计划将数据导入多个组织单位级别，请确保在数据元素配置中将这些级别添加为聚合级别。

某些地球引擎数据集包含分类组，DHIS2 数据元素必须配置相应的类别选项组合。例如，"人口年龄组 "数据集按性别（男、女）和 5 岁年龄组分列。

在 DHIS2 中，这意味着您必须有一个男性/女性类别和一个 5 岁年龄组类别 (<1yr, 1-4yr, 5-9yr, 10-14yr... 80+yr). These are combined into a category combination.

提示：要使类别选项组合与地球引擎分类组自动匹配，请在每个类别选项组合中添加一个与地球引擎组名称相匹配的代码。例如，在 "人口年龄组 "中，组的名称是F_0、F_1、F_5......，M_0、M_1、M_5......。

运行导入{ #run-the-import }

选择数据元素和类别选项组合后，预览按钮就会启用。查看要导入的数据后，您可以先进行模拟运行，也可以继续实际导入。

组织单位几何图形导入{ #geometry_import }

在侧边栏点击 "组织单位几何图形导入 "即可进入。支持两种 几何格式：GeoJSON 和 GML。GeoJSON 是 格式，也可用于导入相关几何图形（集水区）。 (集水区）。

GeoJSON 导入{ #geojson_import }

  1. 使用 GeoJSON 格式上传文件。

  2. 默认情况下，GeoJSON 地物 id 应与组织单位 id 匹配。

  3. 检查 将 GeoJSON 属性与组织单位方案匹配，以通过 一个特征属性。键入 GeoJSON 属性名称并选择 组织单位标识方案（Id、Code 或 Name）。

  4. 选中 ** 作为关联几何图形导入** 以导入 GeoJSON 地物 作为相关几何图形的组织单位（如集水区）。 选择要导入数据的几何属性。这需要 应用于 Organisatiot unit 的 GeoJSON 类型的属性。这个 属性可在维护应用项目中定义。

  5. 点击**开始导入**按钮，上传文件并开始导入。 导入过程。

提示

强烈建议在导入数据前使用 "干运行 "选项**进行测试。 导入数据，以确保您能控制对组织单位几何图形的任何更改。 组织单位几何图形的任何更改。

GML 导入{ #gml_import }

  1. 使用 GML（地理标记语言）格式上传文件。

  2. 点击**导入**按钮，该按钮将上传文件并启动 导入过程。

跟踪实体导入{ #tei_import }

跟踪实体导入可从侧边栏访问，方法是 单击跟踪实体导入。

  1. 选择要上传的 JSON 文件

  2. 选择适当的设置：

    • authSubset
    • 导入报告模式
    • 预热模式
    • 导入策略
    • 原子模式
    • 合并模式

  3. 如果要调整以下一项或多项，请单击**高级选项**。 导入前请进行以下设置：

    • 冲洗模式
    • 跳过分享
    • 跳过验证
    • 融入战略
    • 数据元素ID方案
    • 事件ID方案
    • 组织单位ID方案
    • ID方案

  4. 点击**导入**按钮，该按钮将上传文件并启动 导入过程。

提示

强烈建议在导入数据前使用 "干运行 "选项**进行测试。 导入数据，以确保您能控制对 跟踪实体的任何更改。

汇出资料

元数据导出

单击侧边栏上的，可以访问元数据导出 元数据导出。

  1. 选择您要导出的对象列表。

  2. 选择一种格式：JSON

  3. 选择压缩类型：zip、gzip 或 uncompressed 压缩类型

  4. 决定是否选中 跳过共享和访问设置____________________________。

  5. 点击**导出元数据**，这将打开一个新的网络浏览器窗口 这将为您提供一个可下载到本地计算机的文件。

具有依赖项的元数据导出

具有依赖项的元数据导出使您可以为以下内容创建罐头导出 元数据对象。这种类型的导出将包括元数据对象 和元数据对象的相关对象；即元数据 与主要对象一起属于

表：对象类型及其依赖关系

CSV元数据导入 { #webapi_csv_metadata_import } 导出中包含的依赖项
数据集 数据元素

章节

指标

指标类型

属性

数据输入表

图例集

图例

类别组合

类别

类别选项

类别选项组合

选项集
程式 数据输入表

跟踪实体

项目阶段

项目属性

项目指标



项目规则

项目规则动作

项目规则变量
项目属性
数据元素

类别组合

类别

类别选项

类别选项组合

选项集
不 类别组合

类别

类别选项

Category 选项组合

属性
仪表板 仪表板项目

图表

事件图表

数据透视表

事件报告

地图


报告
资源
POST / api / metadata?classKey = CLASS-KEY 数据元素

类别组合

类别

类别选项

类别选项组合

选项集

属性

图例集

图例
选项集 Validation rule

  1. 选择对象类型：数据集_、程序_、类别组合_、 仪表板、数据元素组_或_选项集。

  2. 选择对象。

  3. 选择一种格式：JSON

  4. 选择压缩类型：Zip、GZip 或 Uncompressed 压缩类型

  5. 单击**导出元数据依赖关系**，将打开一个新的 网络浏览器窗口，该窗口会提供一个文件，供您下载到您的 本地计算机。

资料汇出

可以通过单击数据从侧边栏访问数据导出 出口。

  1. 选择要从哪个组织单位导出。

  2. 选择是否要导出包括组织的后代 在步骤 1 中选择的单元或仅手动选择的单元 组织单位。

  3. 选择要导出的数据集。

  4. 设置开始和结束日期。

  5. 选择一种格式：JSON、CSV、XML 或 ADX 格式

  6. 选择压缩模式：Zip、GZip 或 未压缩

  7. 如果要调整以下一项或多项，请单击**高级选项**。 导出前请进行以下设置：

    • 包括已删除
    • 数据元素ID方案
    • 组织单位ID方案
    • ID方案

  8. 点击**导出数据**，将打开一个新的网络浏览器窗口 这将为您提供一个可下载到本地计算机的文件。

活动导出

通过单击事件可以从边栏中访问事件导出 出口。

您可以 JSON 或 CSV 格式导出事件或跟踪器数据。

  1. 选择一个组织单位。

  2. 选择包含：

    • 选定：仅导出所选 组织单位

    • 正下方：导出事件数据，包括第一个 组织单位的级别，以及 作为所选组织单位本身。

    • 以下全部_：导出所有组织单位的事件数据 以及被选中的组织 装置本身。

  3. 选择一个项目和一个项目阶段（如果适用）。

  4. 设置开始日期和结束日期。

  5. 选择一种格式：JSON 或 CSV。

  6. 选择压缩模式：Zip、GZip 或 Uncompressed。

  7. 如果要调整以下一项或多项，请单击**高级选项**。 导出前请进行以下设置：

    • 包括已删除
    • 数据元素ID方案
    • 组织单位ID方案
    • ID方案

  8. 点击**导出事件**，将打开一个新的网络浏览器窗口 这将为您提供一个可下载到本地计算机的文件。

跟踪实体导出{ #tei_export }

跟踪实体导出可从侧边栏访问，方法是 点击跟踪实体导出。

您可以 JSON 或 CSV 格式导出跟踪的实体。

  1. 选择应包括的组织单位。选择组织单位有三种模式：

    • 可访问：选择与当前用户相关联的数据视图组织单位

    • Capture：用于选择与当前用户相关联的数据视图组织单元。

    • 手动选择组织单元：手动选择组织单元。

  2. 如果选择_手动选择组织单位_，则会出现更多选项：

    • 选定：仅导出所选 组织单位

    • 正下方：导出数据，包括第一个 组织单位的级别，以及 作为所选组织单位本身。

    • 以下全部_：导出所有组织单位的事件数据 以及被选中的组织 装置本身。

  3. 决定是按_项目_还是按_跟踪实体类型_进行筛选。

  4. 决定在导出中包含哪些状态

  5. 决定在导出中包含哪些后续状态

  6. 选择一种格式：JSON 或 CSV。

  7. 如果要调整以下一项或多项，请单击**高级选项**。 导出前请进行以下设置：

    • 按上次更新日期筛选
    • 按指定用户筛选
    • 包括已删除
    • 数据元素ID方案
    • 事件ID方案
    • 组织单位ID方案
    • ID方案

  8. 单击**导出跟踪实体**，将打开一个新的 网络浏览器窗口，该窗口会提供一个文件，供您下载到您的 本地计算机。

v41+ 版中 Tracker 的导入/导出更改{ #v41_tracker_changes }

导入/导出应用项目已升级为使用新的跟踪器 API 来导入和导出跟踪的实体和事件。废弃的跟踪器 API](https://docs.dhis2.org/en/develop/using-the-api/dhis-core-version-master/tracker-deprecated.html) 将在 v42 中移除，因此建议所有应用项目尽快升级。

这为跟踪实体和事件的导入/导出体验的一致性和可靠性带来了很多好处，例如更好的验证、错误报告以及使用更可靠的作业调度工作流程。

这些优点有几个重要的注意事项。首先，导出文件的新格式与以前版本的应用项目不兼容，因此 v41 的导出文件无法导入以前的版本，而以前版本的导出文件也无法导入 v41。我们还放弃了对 XML 格式的支持，只支持 JSON 和 CSV。有关这些更改的更多信息，请参阅 Tracker API 文档 。

v41+中改进的错误报告](resources/images/import_export/v41_error_reports.png)

工作概述

在侧边栏点击 工作概述_。

此页面允许您查看您在此会话中启动的所有导入的进度。 导入的进度。您可以在左侧看到所有任务的列表，在右侧看到特定选定任务的详情。 左侧是所有任务的列表，右侧是所选任务的详细信息。

按导入作业类型过滤

默认情况下，所有导入类型的任务都会显示在任务列表中，但您可以 但您可以点击作业列表上方的作业类型筛选器来筛选您感兴趣的类别。 类型筛选器。

重新创建上一份工作

点击页面底部的 点击页面底部的 Recreate job （创建任务）按钮，重新创建之前运行的导入任务。 从列表中选择一个作业。这将带您进入正确的导入 页面，并按照您选择重新创建的作业填写所有表格细节。 重新创建。

方案

许多导入和导出页面中使用的各种方案也称为标识符方案，用于映射元数据对象。 也称为标识符方案，用于在导入时将元数据对象映射到其他元数据 映射到其他元数据，并将元数据作为导出的一部分。 导出。

表：可用值

ID, UID Parameter name
CODE 与 DHIS2 编码匹配,主要用于与外部系统交换数据。
NAME 在 DHIS2 名称上匹配,请注意这使用的是可用的 object.name,而不是翻译后的名称。还请注意,名称并不总是唯一的,在这种情况下,不能使用它们。
ATTRIBUTE:ID 与 DHIS2 名称匹配，请注意这使用的是_object.name_，而不是翻译后的名称。还请注意，名称并不总是唯一的，在这种情况下，不能使用它们。
请注意,标识符方案不是一个独立的功能,需要与数据值导入、元数据导入和
GeoJson 导入等资源结合使用。 根据元数据属性进行匹配，需要将该属性分配给要匹配的类型，并将唯一属性设置为 true。它的主要用途也是与外部系统交换数据，与 CODE 相比，它有一些优势，因为可以添加多个属性，所以可以用于与多个系统同步。

ID方案

ID 方案适用于所有类型的对象，但可被更具体的对象类型覆盖。 更具体的对象类型。