跳转至
For the complete DHIS2 documentation index, see llms.txt.
健康
疾病监测
VPD 案件监测

VPD CS 跟踪器安装附件{ #vpd-cs-installation }

总览

VPD CS 跟踪器软件包是独立的，这意味着它可以单独安装。不过，值得注意的是，该软件包包含 IDSR 软件包中的一些元数据。原因是其中有一个比较表，可以对汇总数据和跟踪器数据进行比较。因此，我们建议在安装此软件包之前先安装疾病监测汇总（"IDS"）软件包，尽管这不是强制性要求。

模块的安装包括以下几个步骤：

  1. [准备]（＃preparing-the-metadata-file）具有DHIS2元数据的元数据文件。
  2. 导入 元数据文件到 DHIS2。
  3. [配置]（＃additional-configuration）导入的元数据。
  4. 导入后[Adapting]（＃adapting-the-tracker-program）程序

建议在开始DHIS2中的安装和配置过程之前先通读每个部分。根据要导入到新的DHIS2实例还是具有元数据的DHIS2实例，已识别出不适用的节。在重复或转移到DHIS2的生产实例之前，应在测试/分阶段环境中测试本文档中概述的过程。

要求

为了安装该模块，需要DHIS2上的管理员用户帐户。在DHIS2的生产实例上执行此文档中概述的过程之前，应在测试/分阶段环境中进行测试。

应格外注意确保服务器本身和 DHIS2 应用程序的安全，以限制对所收集数据的访问。有关 DHIS2 系统安全的详细信息不在本文讨论范围之内，请参阅 DHIS2 文档 。

准备元数据文件

注意： 如果您在 DHIS2 的新实例上安装软件包，可以跳过 "准备元数据文件 "部分，直接进入"将元数据文件导入 DHIS2 "部分。

尽管并非总是必要，但在将元数据文件导入DHIS2之前对其进行某些修改通常可能是有利的。

默认数据维度

在早期版本的DHIS2中，默认数据维的UID是自动生成的。因此，尽管所有DHIS2实例都具有默认类别选项，数据元素类别，类别组合和类别选项组合，但这些默认的UID可以不同。 DHIS2的更高版本具有用于默认维度的硬编码UID，并且这些UID在配置包中使用。

为避免导入元数据时发生冲突，建议搜索并替换整个 .json 文件中所有出现的这些默认对象，将 .json 文件中的 UID 替换为导入该文件的数据库的 UID。表 1 显示了应替换的 UID，以及用于识别现有 UID 的 API 端点。 现有的 UID。

目的 用户标识 应用程序接口端点
类别 GLevLNI9wkl .../api/categories.json?filter=name:eq:default。
类别选项 xYerKDKCefk .../api/categoryOptions.json?filter=name:eq:default。
不 bjDvmb4bfuf .../api/categoryCombos.json?filter=name:eq:default。
类别选项组合 HllvX50cXC0 .../api/categoryOptionCombos.json?filter=name:eq:default`。

例如，如果将配置包导入 https://play.dhis2.org/demo，则默认类别选项组合的 UID 可以通过 https://play.dhis2.org/demo/api/categoryOptionCombos.json?filter=name:eq:default识别为 bRowv6yZOF2。

然后，您可以在 .json 文件中用 bRowv6yZOF2 搜索并替换所有出现过的 HllvX50cXC0，因为这是您导入系统中的默认 ID。请注意，搜索和替换操作必须使用纯文本编辑器，而不是 Microsoft Word 等文字处理程序。

指标类型

指标类型是另一种可能导致导入冲突的对象，因为在不同的DHIS2数据库中使用了某些名称（例如“百分比”）。由于指标类型仅由其因子以及是否为无分母的简单数字定义，因此它们是明确的，可以通过搜索和替换UID进行替换。这样可以避免潜在的导入冲突，并避免创建重复的指标类型。表2显示了可以替换的UID以及用于标识现有UID的API端点

目的 用户标识 应用程序接口端点
百分比 hmSnCXmLYwt .../api/indicatorTypes.json?filter=number:eq:false&filter=factor:eq:100`。

追踪实体类型

像指示器类型一样，您的DHIS2数据库中可能已经存在跟踪的实体类型。对跟踪实体类型的引用应该更改以反映系统中的内容，因此您不会创建重复项。表3显示了可以替换的UID以及用于标识现有UID的API端点

目的 用户标识 应用程序接口端点
个人 MCPQUTHX1Ze .../api/trackedEntityTypes.json?filter=name:eq:Person`。

使用根组织单位 UID 进行可视化{ #visualizations-using-root-organisation-unit-uid }

分配给特定组织单位级别或组织单位组的可视化、事件报告、报告表和地图都有一个对根（第 1 级）组织单位的引用。此类对象（如果存在于元数据文件中）包含一个占位符 <OU_ROOT_UID>。使用 .json 文件编辑器中的搜索功能可以识别该占位符，并将其替换为目标实例中 1 级组织单位的 UID。

通用元数据{ #generic-metadata }

该软件包包含一些通常在许多卫生项目中通用或共享的元数据。这些元数据的前缀为 "GEN"，表示它们是通用的，可在 DHIS2 配置的其他部分重复使用。您的数据库中很可能已经有了类似的元素。这些通用元素用于某些指标，并包含在总体监测/IDSR 元数据文件中。

VPD CS 软件包中使用的通用数据元素

目的 用户标识 应用程序接口端点
GEN - 人口 DkmMEcubiPv ../api/dataElements.json?filter=name:like:GEN - Population.
GEN - 人口 < 15 岁 cPLAnOTldta ../api/dataElements.json?filter=name:like:GEN - Population.
GEN - 活产人口 iKxybad85rv ../api/dataElements.json?filter=name:like:GEN - Population.
GEN - 每周人口 iLEkjJcYTJd ../api/dataElements.json?filter=name:like:GEN - Population.

各年龄段的类别选项、类别、类别组合

目的 用户标识 应用程序接口端点
0-4 岁 UPvKbcqTEY3 .../api/categoryOptions.json?filter=name:like:years`。
5 年以上 afpMrUgPzl3 .../api/categoryOptions.json?filter=name:like:years`。
年龄（监测） wAZr8Iv7S64 .../api/categories.json?filter=name:like:Age`"。
年龄（监测） eg8enaFY861 .../api/categoryCombos.json?filter=name:like:Age"。

使用组织单位级地区{ #predictors-using-organisation-unit-level-district } 进行预测

软件包中有许多预测器使用地区组织单位级别（OUL）的占位符。它们的 API 端点是./api/predictors?filter=organisationUnitLevels:!null`。

占位符使用的标签是 。在尝试导入软件包之前，您需要用系统中对应 OUL 的 UID 替换该标签。

导入元数据

.json 元数据文件是通过 DHIS2 的 导入/导出应用程序导入的。建议在尝试实际导入元数据前使用 "模拟运行 "功能来发现问题。如果 "模拟运行 "报告了任何问题或冲突，请参阅下面的[导入冲突]（#处理-导入-冲突）部分。 如果 "试运行"/"验证 "导入无误，请尝试导入元数据。如果导入成功且未出现任何错误，则可以继续配置 模块。在某些情况下，"模拟运行 "时不会显示导入冲突或问题，但在尝试实际导入时会显示。在这种情况下，导入摘要将列出需要解决的任何错误。

通用元数据{ #generic-metadata }

有关通用元数据概览（多个软件包使用相同的元数据对象），请参阅各个软件包的安装附件。

处理导入冲突

注意：如果您要导入一个新的 DHIS2 实例，您不必担心导入冲突，因为您导入的数据库中没有与之冲突的内容。请按照说明导入元数据，然后进入"附加配置"部分。

可能会发生许多不同的冲突，尽管最常见的是配置包中有目标数据库中已经存在名称，简称和/或代码的元数据对象。对于这些问题，有两种替代解决方案，具有不同的优缺点。哪一个更合适将取决于例如发生冲突的对象的类型。

备选方案1

重命名DHIS2数据库中存在冲突的现有对象。这种方法的优点是无需修改.json文件，因为更改是通过DHIS2的用户界面完成的。这很可能不太容易出错。这也意味着配置包将保留原样，例如在使用基于配置包的培训材料和文档时，这可能是一个优势。

备选方案2

重命名.json文件中存在冲突的对象。这种方法的优点是现有的DHIS2元数据保持不变。当存在培训材料或文档（例如链接到所讨论对象的数据字典的SOP）时，这可能是一个因素，并且不存在通过修改用户熟悉的元数据而使用户感到困惑的风险。

请注意，对于备选项1和2，修改可以简单到在名称中添加一个小的前缀/后缀，以最大程度地减少混乱的风险。

备选3

第三种也是更复杂的方法是修改.json文件以重新使用现有的元数据。例如，在某个概念的某个选项集已经存在的情况下（例如“性别”），可以从.json文件中删除该选项集，并且对其UID的所有引用都将替换为数据库中已经存在的相应选项集。这样做的最大优点（不限于直接导入冲突的情况）是避免在数据库中创建重复的元数据。执行这种类型的修改时，需要考虑一些关键因素：

  • 它需要有关DHIS2详细元数据结构的专业知识
  • 该方法不适用于所有类型的对象。特别地，某些类型的对象具有依赖关系，这种依赖关系以这种方式难以解决，例如与分解有关。
  • 将来对配置包的更新将很复杂。

附加配置

成功导入所有元数据后，需要执行一些步骤，模块才能正常运行。

分享中

软件包随附三个用户组：

  • VPD CS 接入
  • VPD CS 管理员
  • VPD CS 数据采集

默认情况下，将以下内容分配给这些用户组

目的 用户组
VPD CS 接入 VPD CS 管理员 VPD CS 数据采集
追踪实体类型 元数据：可查看
数据：可查看		 元数据：可编辑和查看
数据：可查看		 元数据：可查看
数据：可采集和查看
程序 元数据：可查看
数据：可查看		 元数据：可编辑和查看
数据：可查看		 元数据：可查看
数据：可采集和查看
计划阶段 元数据：可查看
数据：可查看		 元数据：可编辑和查看
数据：可查看		 元数据：可查看
数据：可采集和查看
仪表板 元数据：可查看
数据：可查看		 元数据：可编辑和查看
数据：可查看		 元数据：可查看
数据：可查看

您需要根据用户在系统中的角色将其分配到相应的用户组。您可能需要为软件包中的其他对象启用共享，这取决于您的设置。有关配置共享的更多信息，请参阅 DHIS2 文档。

重要提示：在 2.33 和 2.34 版本中存在一个错误，即使选择了 MERGE 作为导入参数，但在导入同一对象后，该错误会覆盖该对象的共享属性。这对对象 Tracked Entity Type - Person（UID：MCPQUTHX1Ze）尤为重要，该对象通常与不同软件包的用户组共享。

如果您的 TET 人员与软件包中的 TET 人员已经匹配，并且您想避免覆盖数据库中该对象的当前共享属性，可以按照以下步骤操作：

  • 从软件包文件中删除此 TET
  • 导入软件包
  • 使用上表更新此 TET 的共享属性。

用户角色

用户将需要用户角色才能参与DHIS2中的各种应用程序。建议以下最低角色：

  1. 跟踪器数据分析：可以查看事件分析并访问仪表板，事件报告，事件可视化器，数据可视化器，数据透视表，报告和地图。
  2. 跟踪器数据捕获：可以添加数据值，更新跟踪的实体，跨组织单位搜索跟踪的实体以及访问跟踪器捕获

有关配置用户角色的更多信息，请参阅 DHIS2 文档。

组织单位

您必须将程序分配给自己的层次结构中的组织单位，以便能够在跟踪器捕获中查看程序。

重复的元数据

注意： 本节仅适用于导入已有元数据的 DHIS2 数据库。如果您使用的是一个新的 DHIS2 实例，请跳过本节，转到"调整跟踪程序"。

即使成功导入了元数据而没有任何导入冲突，元数据中也可能存在重复项-数据元素，跟踪的实体属性或已存在的选项集。正如上面有关解决冲突的部分所述，要牢记的一个重要问题是，在DHIS2中更改元数据的决定还需要考虑与现有元数据有不同关联的其他文档和资源。 ，以及通过配置包导入的元数据。因此，解决重复项不仅是“清理数据库”的问题，而且还要确保做到这一点，例如，不破坏与其他系统的集成，使用培训材料的可能性，破坏SOP等。这将非常很大程度上取决于上下文。

需要牢记的重要一点是，DHIS2 有一些工具可以隐藏元数据中潜在重复的一些复杂问题。例如，如果存在重复的选项集，可以通过[共享]（#sharing）为用户组隐藏这些选项集。

调整跟踪器程序

程序导入后，您可能需要对程序进行某些修改。可以*进行本地改编的例子包括：

  • 向表单添加其他变量。
  • 根据国家惯例修改数据元素/选项名称。
  • 向变量和/或数据输入表单添加翻译。
  • 根据本地案例定义修改程序指标

但是，如果您决定更改或删除任何包含的表格/元数据，强烈建议格外小心。修改可能会破坏功能，例如程序规则和程序指示器。